How dimonbyte/hostlistdownloader works
HostlistDownloader is a cross-platform CLI for fetching configured blocklists and whitelists, then cleaning, transforming, and consolidating them. The principal run initializes configuration and local storage, validates and downloads sources, and generates combined outputs. Separate CLI capabilities include search, duplicate analysis, source management, and update checks. Relationships among unsampled management stages are shown only where documented in the README or referenced by inspected files; the source excerpts are partial.
Main entry points: Program.cs Application entry · HostlistOrchestrator.cs Update orchestration · ArgumentParser.cs Argument commands · IOManager.cs Local files
Components 19
CLI and configuration
- Application entry
src/HostlistDownloaderCLI/Program.cs - Argument commands
src/HostlistDownloaderCLI/Modules/ArgumentParsing/ArgumentParser.cs - Settings
src/HostlistDownloaderCLI/Modules/WindowsSystem/Config/AppConfig.cs - Config validation
src/HostlistDownloaderCLI/Modules/WindowsSystem/Config/AppConfigHealthChecker.cs - Local files
src/HostlistDownloaderCLI/Modules/WindowsSystem/IO/IOManager.cs
Source fetching
- Source manifests
src/HostlistDownloaderCLI/Modules/HostlistManagement/SourceManager.cs - URL security
src/HostlistDownloaderCLI/Modules/Network/URLSecurityValidator.cs - Concurrent downloads
src/HostlistDownloaderCLI/Modules/Network/DownloadController.cs
Hostlist processing
- Update orchestration
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Integrity checks
src/HostlistDownloaderCLI/Modules/HostlistManagement/HostlistIntegrityValidator.cs - Format and merge
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/TransformationEngine.cs - Combined lists
src/HostlistDownloaderCLI/Modules/WindowsSystem/IO/IOManager.cs
Local operations
- Domain search
src/HostlistDownloaderCLI/Modules/HostlistManagement/SearchManager.cs - Duplicate analysis
src/HostlistDownloaderCLI/Modules/HostlistManagement/HostlistDuplicateAnalyser.cs - Application update check
src/HostlistDownloaderCLI/Modules/Network/UpdateChecker.cs - Network availability
src/HostlistDownloaderCLI/Modules/Network/NetworkChecker.cs - Logging
src/HostlistDownloaderCLI/Modules/Helpers/TraceLogger.cs
Other components
- CLI user
- Hostlist URLs
Connections 28
- CLI user → Application entry: runs
README.md - Application entry → Local files: initializes
src/HostlistDownloaderCLI/Program.cs - Application entry → Settings: initializes
src/HostlistDownloaderCLI/Program.cs - Application entry → Config validation: validates
src/HostlistDownloaderCLI/Program.cs - Application entry → Argument commands: parses
src/HostlistDownloaderCLI/Program.cs - Argument commands → Update orchestration: dispatches
src/HostlistDownloaderCLI/Modules/ArgumentParsing/ArgumentParser.cs - Argument commands → Settings: edits settings
src/HostlistDownloaderCLI/Modules/ArgumentParsing/ArgumentParser.cs - Argument commands → Domain search: dispatches
src/HostlistDownloaderCLI/Modules/ArgumentParsing/ArgumentParser.cs - Argument commands → Duplicate analysis: dispatches
src/HostlistDownloaderCLI/Modules/ArgumentParsing/ArgumentParser.cs - Application entry → Update orchestration: starts update
src/HostlistDownloaderCLI/Program.cs - Application entry → Network availability: checks access
src/HostlistDownloaderCLI/Program.cs - Application entry → Application update check: checks release
src/HostlistDownloaderCLI/Program.cs - Application entry → Logging: logs run
src/HostlistDownloaderCLI/Program.cs - Update orchestration → Source manifests: reconciles URLs
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Update orchestration → URL security: validates URLs
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Update orchestration → Concurrent downloads: downloads sources
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Hostlist URLs → Concurrent downloads: serves lists
README.md - Concurrent downloads → Local files: writes files
src/HostlistDownloaderCLI/Modules/Network/DownloadController.cs - Update orchestration → Integrity checks: validates output
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Update orchestration → Format and merge: generates lists
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Format and merge → Combined lists: writes outputs
README.md - Domain search → Local files: searches files
src/HostlistDownloaderCLI/Modules/HostlistManagement/SearchManager.cs - Duplicate analysis → Local files: analyzes files
src/HostlistDownloaderCLI/Modules/HostlistManagement/HostlistDuplicateAnalyser.cs - Source manifests → Local files: tracks sources
src/HostlistDownloaderCLI/Modules/HostlistManagement/SourceManager.cs - Update orchestration → Settings: reads settings
src/HostlistDownloaderCLI/Modules/HostlistManagement/Generation/HostlistOrchestrator.cs - Concurrent downloads → Hostlist URLs: fetches URLs
README.md - Config validation → Settings: checks settings
src/HostlistDownloaderCLI/Modules/WindowsSystem/Config/AppConfigHealthChecker.cs - Application entry → Domain search: dispatches search
src/HostlistDownloaderCLI/Program.cs