1 个不稳定版本

0.8.1 2022年11月14日
0.2.0 2022年6月6日
0.1.0 2022年5月25日

#1918 in 解析器实现


用于 远程包

Apache-2.0

330KB
4.5K SLoC

RPM-RS

一个用于解析和创建 RPM 文件的纯 Rust 库。

目标

  • 易于使用的 API
  • 纯 Rust 编写,便于在大型项目中使用
  • 与 Spec 文件的独立性。用于打包的纯编程接口。
  • 与 CentOS 7 / Fedora 兼容(我可能还会扩展 SUSE 的测试用例)

非目标

RPM 有很多晦涩的功能。我不想重新实现它们所有。这个库专注于我认为有用的功能。这个库不会构建像 rpmbuild 一样的软件。它旨在对需要打包为 RPM 的成品进行打包。

状态

  • RPM 创建
  • 基本的 RPM 读取
  • RPM 签名和签名验证
  • RPM 读取的高层 API

示例

use rpm;
use rpm::signature::pgp::{Signer,Verifier};

let raw_secret_key = std::fs::read("/path/to/gpg.secret.key")?;
let pkg = rpm::RPMBuilder::new("test", "1.0.0", "MIT", "x86_64", "some awesome package")
            .compression(rpm::Compressor::from_str("gzip")?)
            .with_file(
                "./awesome-config.toml",
                RPMFileOptions::new("/etc/awesome/config.toml").is_config(),
            )?
            // file mode is inherited from source file
            .with_file(
                "./awesome-bin",
                RPMFileOptions::new("/usr/bin/awesome"),
            )?
             .with_file(
                "./awesome-config.toml",
                // you can set a custom mode and custom user too
                RPMFileOptions::new("/etc/awesome/second.toml").mode(0o100744).user("hugo"),
            )?
            .pre_install_script("echo preinst")
            .add_changelog_entry("me", "was awesome, eh?", 123123123)
            .add_changelog_entry("you", "yeah, it was", 12312312)
            .requires(Dependency::any("wget"))
            .build_and_sign(Signer::load_from_asc_bytes(&raw_secret_key)?)
let mut f = std::fs::File::create("./awesome.rpm")?;
pkg.write(&mut f)?;

// reading
let raw_pub_key = std::fs::read("/path/to/gpg.key.pub")?;
let rpm_file = std::fs::File::open("test_assets/389-ds-base-devel-1.3.8.4-15.el7.x86_64.rpm")?;
let mut buf_reader = std::io::BufReader::new(rpm_file);
let pkg = rpm::RPMPackage::parse(&mut buf_reader)?;
// verifying
pkg.verify_signature(Verifier::load_from_asc_bytes(&raw_pub_key)?)?;

依赖项

~7–16MB
~196K SLoC