1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75
//! # rpm-rs
//!
//! A library providing API to parse rpms as well as
//! creating rpms from individual files.
//!
//! # Example
//!
//! ```rust
//!
//! use rpm::{
//! signature::pgp::{
//! Signer,
//! Verifier
//! }
//! };
//! use std::str::FromStr;
//!
//! # fn main() -> Result<(), Box<dyn std::error::Error>> {
//! let raw_secret_key = std::fs::read("./test_assets/secret_key.asc")?;
//! let pkg = rpm::RPMBuilder::new("test", "1.0.0", "MIT", "x86_64", "some awesome package")
//! .compression(rpm::Compressor::from_str("gzip")?)
//! .with_file(
//! "./test_assets/awesome.toml",
//! rpm::RPMFileOptions::new("/etc/awesome/config.toml")
//! .is_config(),
//! )?
//! // file mode is inherited from source file
//! .with_file(
//! "./test_assets/awesome.py",
//! rpm::RPMFileOptions::new("/usr/bin/awesome"),
//! )?
//! .with_file(
//! "./test_assets/awesome.toml",
//! // you can set a custom mode and custom user too
//! rpm::RPMFileOptions::new("/etc/awesome/second.toml")
//! .mode(rpm::FileMode::regular(0o644))
//! .user("hugo"),
//! )?
//! .pre_install_script("echo preinst")
//! .add_changelog_entry("me", "was awesome, eh?", 123123123)
//! .add_changelog_entry("you", "yeah, it was", 12312312)
//! .requires(rpm::Dependency::any("wget"))
//! .build_and_sign(
//! Signer::load_from_asc_bytes(&raw_secret_key)?
//! )?;
//! let mut f = std::fs::File::create("./target/awesome.rpm")?;
//! pkg.write(&mut f)?;
//!
//! // reading
//! let raw_pub_key = std::fs::read("./test_assets/public_key.asc")?;
//! let rpm_file = std::fs::File::open("./target/awesome.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)?)?;
//! # Ok(())
//! # }
//! ```
mod errors;
pub use crate::errors::*;
pub(crate) mod constants;
pub use crate::constants::*;
mod sequential_cursor;
mod rpm;
pub use crate::rpm::*;
#[cfg(test)]
mod tests;
#[cfg(all(test, feature = "test-with-podman"))]
mod compat_tests;