Files
BitLogger/docs/changes/0.3.0.md
T
2026-05-08 17:08:27 +08:00

40 lines
2.2 KiB
Markdown

## BitLogger Update Changes
version 0.3.0
### Feature
- feat: add `config.mbt` as a minimal JSON-backed logger configuration layer
- feat: add `TextFormatterConfig`, `QueueConfig`, and `LoggerConfig` public config types
- feat: add `TextFormatterConfig::new(...)`, `QueueConfig::new(...)`, and `LoggerConfig::new(...)` constructors for explicit config assembly
- feat: add `SinkKind` and `SinkConfig` for sink-specific configuration
- feat: add `TextFormatterConfig::to_formatter()` for bridging parsed config into runtime formatter setup
- feat: add `parse_logger_config_text(...)` for JSON config parsing
- feat: add `logger_config_to_json(...)` and `stringify_logger_config(...)` for config serialization
- feat: add `RuntimeSink`, `ConfiguredLogger`, `build_logger(...)`, and `parse_and_build_logger(...)` for config-driven logger assembly
- feat: add `ConfiguredLogger::drain(...)`, `ConfiguredLogger::pending_count()`, and `ConfiguredLogger::dropped_count()` queue observability helpers
- feat: support config keys `min_level`, `target`, `timestamp`, `sink.kind`, `sink.path`, `sink.append`, `sink.auto_flush`, `sink.text_formatter`, and `queue`
- feat: support config-driven sink assembly for `console`, `json_console`, `text_console`, and `file`
- feat: use `maria/json_parser` as the first external dependency for practical config loading
### Test
- test: cover parsing of core logger config fields
- test: cover nested formatter and queue config parsing
- test: cover config stringify and parse roundtrip behavior
- test: cover config-built queued text logger flushing and pending count behavior
- test: cover partial drain behavior for config-built queued logger
- test: cover dropped-count reporting for bounded config-built queue
### Example
- docs: update `examples/basic` with JSON config loading example
- docs: update `examples/basic` to use `parse_and_build_logger(...)` with explicit error handling in `main`
- docs: update root README, English README, and Mooncake README with config usage notes
- chore: ignore local `.mooncakes/` cache directory in git
### Notes
- current config scope is still intentionally constrained to stable built-in sink shapes
- queue wrapping remains synchronous drain-based delivery, not async runtime scheduling