technitium 0.4.0

Typed async Rust client for the Technitium DNS Server API
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

use serde::{Deserialize, Serialize};

use crate::types::record::RecordType;

/// DNS transport protocol for query resolution.
#[derive(Debug, Clone, PartialEq, Eq, Serialize, Deserialize)]
pub enum DnsProtocol {
    Udp,
    Tcp,
    Tls,
    Https,
    Quic,
}

impl std::fmt::Display for DnsProtocol {
    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
        match self {
            Self::Udp => write!(f, "Udp"),
            Self::Tcp => write!(f, "Tcp"),
            Self::Tls => write!(f, "Tls"),
            Self::Https => write!(f, "Https"),
            Self::Quic => write!(f, "Quic"),
        }
    }
}

/// A single DNS record in a query response.
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "PascalCase")]
pub struct DnsRecord {
    /// The record name.
    pub name: String,
    /// The record type.
    #[serde(rename = "Type")]
    pub record_type: RecordType,
    /// Record-specific data.
    #[serde(flatten)]
    pub data: serde_json::Value,
}

/// Wrapper for the DNS client resolve response.
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "camelCase")]
pub(crate) struct DnsResolveResponse {
    pub result: DnsQueryResult,
}

/// Result of a DNS query resolution.
#[derive(Debug, Clone, Deserialize)]
#[serde(rename_all = "PascalCase")]
pub struct DnsQueryResult {
    /// Answer section records.
    #[serde(default)]
    pub answer: Vec<DnsRecord>,
    /// Authority section records.
    #[serde(default)]
    pub authority: Vec<DnsRecord>,
    /// Additional section records.
    #[serde(default)]
    pub additional: Vec<DnsRecord>,
    /// All other fields (metadata, EDNS, etc.).
    #[serde(flatten)]
    pub extra: serde_json::Value,
}