#debian #dpkg #deb #control

macro debcontrol_struct_derive

Automatic Debian control file parsing for structs (proc macro)

4 releases (2 breaking)

0.3.1 Sep 4, 2021
0.3.0 Aug 5, 2021
0.2.0 Aug 4, 2021
0.1.0 Aug 4, 2021

#11 in #dpkg


Used in 2 crates

MIT/Apache

9KB
176 lines

debcontrol_struct

Build Latest version Documentation License

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

~1.5MB
~36K SLoC