Skip to content

WriteOptions

WriteOptions controls how Hornet serialises an AST back to BIND9 text.

use hornet_bind9::writer::WriteOptions;

pub struct WriteOptions {
    pub indent: usize,
    pub modern_keywords: bool,
    pub explicit_class: bool,
    pub blank_between_statements: bool,
}

Fields

indent

Type: usize Default: 4

Number of spaces per indentation level.

// 4-space indent (default)
let opts = WriteOptions { indent: 4, ..Default::default() };

// 2-space indent
let opts = WriteOptions { indent: 2, ..Default::default() };

Example output with indent: 4:

options {
    directory "/var/cache/bind";
    recursion yes;
};

Example output with indent: 2:

options {
  directory "/var/cache/bind";
  recursion yes;
};

modern_keywords

Type: bool Default: true

When true, legacy BIND8 zone type keywords are replaced with their BIND9 modern equivalents:

Legacy Modern
master primary
slave secondary 
// Normalise to modern keywords (default)
let opts = WriteOptions { modern_keywords: true, ..Default::default() };

// Preserve legacy keywords
let opts = WriteOptions { modern_keywords: false, ..Default::default() };

explicit_class

Type: bool Default: false

When true, the DNS class (IN) is always emitted on zone and view statements, even when it matches the default.

let opts = WriteOptions { explicit_class: true, ..Default::default() };

Example output with explicit_class: true:

zone "example.com" IN {
    type primary;
};

Example output with explicit_class: false (default):

zone "example.com" {
    type primary;
};

blank_between_statements

Type: bool Default: true

When true, a blank line is inserted between top-level statements in the output.

// With blank lines (default)
let opts = WriteOptions { blank_between_statements: true, ..Default::default() };

// No blank lines between statements
let opts = WriteOptions { blank_between_statements: false, ..Default::default() };

Default values

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

Complete example

use hornet_bind9::{parse_named_conf, write_named_conf};
use hornet_bind9::writer::WriteOptions;

let conf = parse_named_conf(input)?;

let opts = WriteOptions {
    indent: 2,
    modern_keywords: true,
    explicit_class: false,
    blank_between_statements: false,
};

let output = write_named_conf(&conf, &opts);

Next Steps