How pccria/logd works
logd is a Dart/Flutter structured logging engine and package family. Applications create hierarchical loggers, emit contextual entries, and route them to handlers and destinations; formatting and optional background-isolate processing support that path. The README also documents specialized HTTP inspection, compact TOON output, HTML/Markdown rendering, SQLite persistence, and network shipping/dashboard capabilities. Core source was not sampled, so core relationships below rely on README statements; satellite package internals and their wiring are represented only at package-directory level.
Main entry points: handler.dart Handler Routing · logger.dart Hierarchical Logger · logd_network/lib Network Shipping · logd_dio/lib Dio Inspection
Components 22
Logging Core
- Hierarchical Logger
packages/logd/lib/src/logger/logger.dart - Ambient Context
packages/logd/lib/src/logger/log_context.dart - Log Entries
packages/logd/lib/src/logger/log_entry.dart - Log Buffer
packages/logd/lib/src/logger/log_buffer.dart
Handler Processing
- Handler Routing
packages/logd/lib/src/handler/handler.dart - Filtering
packages/logd/lib/src/handler/filter - Formatters
packages/logd/lib/src/handler/formatter - Async Offload
packages/logd/lib/src/handler/engine/async_handler.dart - Core Sinks
packages/logd/lib/src/handler/sink
Output Packages
- Console Output
packages/logd/lib/src/handler/target_handlers/console_handler.dart - TOON Output
packages/logd_toon/lib - HTML Sessions
packages/logd_html/lib - Markdown Output
packages/logd_markdown/lib - SQLite Store
packages/logd_sqlite/lib - Network Shipping
packages/logd_network/lib - Browser Dashboard
packages/logd_network/lib
Integrations
- Dio Inspection
packages/logd_dio/lib
Other components
- Dart / Flutter App
- HTTP Service
- WebSocket Service
- HTTP Log Receiver
scripts/servers/http/main.py - Socket Log Receiver
scripts/servers/socket/main.py
Connections 22
- Dart / Flutter App → Hierarchical Logger: emits logs
README.md - Hierarchical Logger → Ambient Context: propagates context
README.md - Hierarchical Logger → Handler Routing: routes logs
README.md - Hierarchical Logger → Log Entries: creates entries
- Hierarchical Logger → Log Buffer: buffers logs
- Handler Routing → Filtering: filters records
- Handler Routing → Formatters: formats records
- Handler Routing → Async Offload: offloads work
README.md - Handler Routing → Core Sinks: writes output
- Handler Routing → Console Output: routes to
README.md - Handler Routing → TOON Output: routes to
README.md - Handler Routing → HTML Sessions: routes to
README.md - Handler Routing → Markdown Output: routes to
README.md - Handler Routing → SQLite Store: persists to
README.md - Handler Routing → Network Shipping: ships logs
README.md - Network Shipping → Browser Dashboard: streams to
README.md - Network Shipping → HTTP Service: ships batches
README.md - Network Shipping → WebSocket Service: streams logs
README.md - Dart / Flutter App → Dio Inspection: inspects HTTP
README.md - Dio Inspection → Ambient Context: forwards traces
README.md - HTTP Service → HTTP Log Receiver: receives POST
- WebSocket Service → Socket Log Receiver: receives stream