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
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
// Pedantic clippy: only allow genuinely noise-level lints.
// items_after_statements: function-scoped `static LazyLock` is idiomatic Rust.
// struct_field_names: _us/_ms suffixes on timing fields are intentional clarity.
// similar_names: geoip_cc_b/geoip_cn_b etc are clear in context.
// needless_continue: used intentionally for clarity in drain loop.
//! `domain_status` library: core URL scanning functionality
//!
//! This library provides high-level APIs for scanning URLs and capturing comprehensive
//! metadata including HTTP status, TLS certificates, DNS information, technology
//! fingerprints, and more.
//!
//! # Example
//!
//! ```no_run
//! use domain_status::{Config, run_scan};
//! use tokio;
//!
//! # #[tokio::main]
//! # async fn main() -> Result<(), Box<dyn std::error::Error>> {
//! let config = Config {
//! file: std::path::PathBuf::from("urls.txt"),
//! max_concurrency: 50,
//! rate_limit_rps: 20,
//! ..Default::default()
//! };
//!
//! let report = run_scan(config).await?;
//! println!("Processed {} URLs: {} succeeded, {} failed",
//! report.total_urls, report.successful, report.failed);
//! # Ok(())
//! # }
//! ```
//!
//! # Requirements
//!
//! This library requires a Tokio runtime. Use `#[tokio::main]` in your application
//! or ensure you're calling library functions within an async context.
//!
//! # Stability and API guarantees
//!
//! - **Stable:** Exit codes (see project docs), [`Config`] validation rules, and public function signatures and types follow `SemVer`.
//! - **Primary embed API:** [`Config`] + [`run_scan`] + [`export`] + [`summary`] (+ typed errors / exit codes).
//! - **Advanced (may narrow further in 0.x):** [`whois`], [`GeoIpService`], [`cli`].
//! - **Crate-private:** initialization helpers, most config constants/header names, fetch/fingerprint/storage internals.
//! - **May change:** Exact wording of error messages, the internal error chain and downcasting behavior, and default config values (e.g. timeouts, limits) may change in patch or minor releases to improve safety or diagnostics.
pub
// Re-export public API
pub use evaluate_exit_code;
pub use ;
pub use ;
// Reachable from `StartupError::StatusServer(_)` — surface the type so callers
// matching on that variant can name it.
pub use ;
pub use GeoIpService;
pub use ;
pub use ;
pub use StatusServerLifecycleError;
pub use ;
pub use ;
// Low-level insert helpers used by the crate's own integration tests under
// `tests/`. These are NOT a stable public API — they expose internals of the
// SQLite write pipeline, with all the surface that requires (column lists,
// FK ordering, retry semantics). Gated behind the `test-utils` feature so the
// default published crate doesn't include them in its semver surface.
//
// Enable with `cargo test --features test-utils` (already part of `just test`,
// `just ci`, and the CI workflow's `--all-features` invocation).
pub use ;
pub use seed_whois_cache;
pub use print_io_error_hint_if_applicable;
pub use ;