rat_quickdns 0.2.4

A high-performance, feature-rich DNS client library with support for multiple transport protocols, load balancing, caching, and filtering
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

//! RatQuickDNS - 高性能DNS查询库
//!
//! 提供UDP/TCP/DOH/DOT多协议支持、智能决策、缓存、健康检查和客户端IP转发(EDNS Client Subnet)功能

#![warn(missing_docs)]
#![warn(clippy::all)]
#![deny(unsafe_code)]

pub mod types;
pub mod transport;
pub mod resolver;
pub mod error;
pub mod builder;
pub mod upstream_handler;
pub mod dns_response;
pub mod logger;
pub mod config;
pub mod utils;

#[cfg(feature = "python-bindings")]
pub mod python_api;

pub use types::*;
pub use transport::Transport;
pub use resolver::CoreResolver;
pub use builder::resolver::CoreResolverStats;
pub use error::{DnsError, Result};
pub use builder::{
    DnsResolverBuilder, SmartDnsResolver, DnsQueryRequest, DnsQueryResponse, DnsRecord,
    QueryStrategy, PerformanceMetrics, SmartDecisionEngine, LoggerInitStrategy
};
pub use builder::resolver::UpstreamStatus;
pub use dns_response::{DnsResponseBuilder, DnsResponseWrapper};
pub use logger::{init_dns_logger, init_dns_logger_silent, dns_format};

// DNS日志宏已经通过#[macro_export]自动导出到crate根部，无需重新导出
pub use config::{StrictDnsConfig, StrictConfigBuilder, ConfigError};

// 重新导出rat_logger基础日志宏到crate根部，供DNS宏使用
pub use rat_logger::{error, warn, info, debug, trace};


// 注意：移除了 quick_dns 宏，因为它包含兜底行为
// 用户现在必须使用 StrictDnsConfig 明确配置所有参数
// 
// 迁移示例：
// 旧代码: quick_dns!()
// 新代码: 
//   let config = StrictDnsConfig::builder()
//       .strategy(QueryStrategy::Smart)
//       .timeout(Duration::from_secs(5))
//       .retry_count(3)
//       .enable_cache(true)
//       .cache_ttl(Duration::from_secs(3600))
//       .enable_upstream_monitoring(true)
//       .upstream_monitoring_interval(Duration::from_secs(30))
//       .port(53)
//       .concurrent_queries(10)
//       .buffer_size(4096)
//       .enable_stats(true)
//       .emergency_threshold(0.3)
//       .add_upstream(UpstreamSpec::new("8.8.8.8:53".to_string(), "udp".to_string(), 1))
//       .build()?;
//   SmartDnsResolver::from_config(config)?