deb822-derive

Crates.iodeb822-derive
lib.rsdeb822-derive
version0.3.1
created_at2024-08-29 10:51:23.811981+00
updated_at2025-12-07 04:56:30.016987+00
descriptionDerive macro for deb822 style paragraphs
homepagehttps://github.com/jelmer/deb822-lossless
repositoryhttps://github.com/jelmer/deb822-lossless
max_upload_size
id1355963
size14,924
Jelmer Vernooij (jelmer)

documentation

README

This crate provides a basic proc-macro for converting a Deb822Paragraph into a Rust struct and vice versa.

You probably want to use the deb822_lossless crate instead, with the derive feature enabled.

Example

use deb822_lossless::Deb822;

#[derive(Deb822)]
struct Foo {
    field1: String,
    field2: Option<String>,
}

let paragraph: deb822::Deb822Paragraph = "field1: value1\nfield2: value2".parse().unwrap();
let foo: Foo = paragraph.into();

Field Formatting Attributes

The derive macros support field formatting attributes to control how fields are serialized:

single_line

Forces the field value to be on a single line.

#[derive(ToDeb822)]
struct Package {
    #[deb822(field = "Package", single_line)]
    name: String,
}

multi_line

Ensures continuation lines start with a space character, following deb822 format conventions.

#[derive(ToDeb822)]
struct Package {
    #[deb822(field = "Description", multi_line)]
    description: String,
}

folded

Strips leading and trailing whitespace from each line and joins them with spaces, implementing RFC 822 folding behavior.

#[derive(ToDeb822)]
struct Package {
    #[deb822(field = "Depends", folded)]
    depends: String,
}
Commit count: 616

cargo fmt