deb 0.5.20

Utilities for working with files and formats commonly found when working with Debian's project tooling, or infrastructure.
Documentation 
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

field_name = {
    ('!'..'9' | ';'..'~')+
}

field_value = {
    // this is technically wrong, but it's the only way I can deal with the
    // de-facto standard. We need to remove the non-printables and stuff,
    // but we see adoption of unicode (rightly!) in fields like Maintainer,
    // or Uploaders. Using a glob like above is going to cause us a headache.

    ( !("\n") ~ ANY )*
}

comment = {
    "#" ~ field_value ~ "\n"
}

field = {
    field_name ~
    ":" ~
    field_value? ~
    (
      "\n" ~
      ((" " ~ field_value) | comment)
    )* ~
    "\n"?
}

paragraph = {
    (comment | field)+
}

single_paragraph = {
    SOI ~ paragraph ~ "\n"* ~ EOI
}

multiple_paragraphs = {
    SOI ~ ((paragraph | comment)* ~ "\n"* ~ EOI)
}