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
60
61
62
63
64
65
66
67
68
69
70
71
72

//! Error types for `hornet-bind9`.

use miette::Diagnostic;
use thiserror::Error;

/// Top-level error returned by all public parse/write/validate functions.
#[derive(Debug, Error, Diagnostic)]
pub enum Error {
    #[error("Parse error in {file}: {message}")]
    #[diagnostic(code(hornet_bind9::parse))]
    Parse {
        file: String,
        message: String,
        #[source_code]
        src: miette::NamedSource<String>,
        #[label("here")]
        span: miette::SourceSpan,
    },

    #[error("Validation error: {0}")]
    #[diagnostic(code(hornet_bind9::validate))]
    Validation(#[from] ValidationError),

    #[error("I/O error: {0}")]
    #[diagnostic(code(hornet_bind9::io))]
    Io(#[from] std::io::Error),

    #[error("Write error: {0}")]
    #[diagnostic(code(hornet_bind9::write))]
    Write(String),
}

/// A single validation finding.
#[derive(Debug, Clone, Error)]
#[error("{severity}: {message}")]
pub struct ValidationError {
    pub severity: Severity,
    pub message: String,
    pub location: Option<ErrorLocation>,
}

/// Diagnostic severity level.
#[derive(Debug, Clone, PartialEq, Eq, PartialOrd, Ord)]
pub enum Severity {
    Info,
    Warning,
    Error,
}

impl std::fmt::Display for Severity {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Severity::Info => write!(f, "info"),
            Severity::Warning => write!(f, "warning"),
            Severity::Error => write!(f, "error"),
        }
    }
}

/// Source location attached to a diagnostic.
#[derive(Debug, Clone)]
pub struct ErrorLocation {
    pub file: String,
    pub line: usize,
    pub column: usize,
}

/// Convenience alias.
pub type Result<T> = std::result::Result<T, Error>;

#[cfg(test)]
mod error_tests;