hornet-bind9 0.1.0

Parse, write, and validate BIND9 named.conf configuration files and DNS zone files
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
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59

//! Serialise the AST back to valid BIND9 configuration text.
//!
//! The [`WriteOptions`] struct controls formatting behaviour (indent size,
//! whether to normalise keywords to their modern aliases, etc.).

pub mod named_conf;
pub mod zone_file;

pub use named_conf::write_named_conf;
pub use zone_file::write_zone_file;

/// Controls how output is formatted.
#[derive(Debug, Clone)]
pub struct WriteOptions {
    /// Number of spaces per indent level (default 4).
    pub indent: usize,
    /// Emit `primary` / `secondary` instead of legacy `master` / `slave`.
    pub modern_keywords: bool,
    /// Always emit explicit class on zone/view statements.
    pub explicit_class: bool,
    /// Insert blank lines between top-level statements.
    pub blank_between_statements: bool,
}

impl Default for WriteOptions {
    fn default() -> Self {
        Self {
            indent: 4,
            modern_keywords: true,
            explicit_class: false,
            blank_between_statements: true,
        }
    }
}

/// Internal helper — write N spaces of indentation.
pub(super) fn indent(out: &mut String, depth: usize, opts: &WriteOptions) {
    for _ in 0..depth * opts.indent {
        out.push(' ');
    }
}

/// Escape a string for use in a BIND9 quoted literal.
pub(super) fn escape(s: &str) -> String {
    let mut out = String::with_capacity(s.len() + 2);
    for c in s.chars() {
        match c {
            '"' => out.push_str("\\\""),
            '\\' => out.push_str("\\\\"),
            _ => out.push(c),
        }
    }
    out
}

/// Wrap a string in double quotes.
pub(super) fn quoted(s: &str) -> String {
    format!("\"{}\"", escape(s))
}