sagittarius 0.1.0

A fast, self-hosted DNS sinkhole in a single Rust binary
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

//! Blocklist ingestion subsystem (SPEC §6).
//!
//! Handles the full lifecycle of external blocklist sources:
//!
//! ```text
//! ┌─────────┐   HTTP(S)   ┌─────────┐   text   ┌───────────┐   merge   ┌────────────┐
//! │ fetch   │ ──────────► │ parse   │ ────────► │ aggregate │ ────────► │  matchset  │
//! └─────────┘             └─────────┘           └───────────┘           └────────────┘
//!      ▲
//!      │ scheduler (periodic refresh)
//! ```
//!
//! Each stage is a separate sub-module, added as the corresponding epic tasks
//! are implemented:
//!
//! | Sub-module | Epic task | Responsibility |
//! |---|---|---|
//! | [`fetch`] | E7.1 | HTTP GET with conditional-request support (ETag / Last-Modified) |
//! | [`parse`] | E7.2 | Parse `hosts` and `domain-list` formats into a normalized `Name` set |
//! | [`aggregate`] | E7.3 | Merge parsed entries into the in-memory [`crate::resolver::matchset`] |
//! | [`scheduler`] | E7.4 | Periodic refresh loop driven by the storage layer |

pub mod aggregate;
pub mod fetch;
pub mod parse;
pub mod scheduler;