#debian #control #dpkg #deb

debcontrol-struct-with-oma-decontrol

Automatic Debian control file parsing for structs

1 unstable release

0.3.1 Nov 20, 2023

#7 in #dpkg

MIT/Apache

13KB
245 lines

debcontrol_struct

Build Latest version Documentation License REUSE status

Automatic Debian control file parsing for structs.

Usage

In order to use this crate, you have to add the following dependencies into your project's Cargo.toml file:

[dependencies]
debcontrol_struct = "0.3.1"

Example

After the crate is installed, you can enjoy the DebControl derive!

By defining the following structure:

use debcontrol::{Paragraph, Field};
use debcontrol_struct::DebControl;

#[derive(DebControl)]
struct DerivedStruct {
    first: String,
    multiple_words: String,
    optional: Option<String>,
}

You can then automatically parse the structure from a debcontrol Paragraph:

let input = &debcontrol::parse_str(
    "First: Hello\n\
     Multiple-Words: World\n"
).unwrap()[0];

let derived = DerivedStruct::from_paragraph(&input).unwrap();
assert_eq!("Hello", derived.first);
assert_eq!("World", derived.multiple_words);
assert_eq!(None, derived.optional);

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this project by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

Dependencies

~0.8–1.3MB
~25K SLoC