mirror of
https://github.com/Nanaloveyuki/BitLogger.git
synced 2026-05-30 15:42:25 +00:00
Nanaloveyuki
87 lines
2.2 KiB
Markdown
87 lines
2.2 KiB
Markdown
---
|
|
name: parse-logger-config-text
|
|
group: api
|
|
category: config
|
|
update-time: 20260512
|
|
description: Parse raw JSON text into a typed LoggerConfig without building the runtime logger yet.
|
|
key-word:
|
|
- parse
|
|
- config
|
|
- json
|
|
- public
|
|
---
|
|
|
|
## Parse-logger-config-text
|
|
|
|
Parse JSON text into a typed `LoggerConfig`. This API is useful when you want validation and inspection of config data before turning it into a runtime logger.
|
|
|
|
### Interface
|
|
|
|
```moonbit
|
|
pub fn parse_logger_config_text(input : String) -> LoggerConfig raise ConfigError {}
|
|
```
|
|
|
|
#### input
|
|
|
|
- `input : String` - Raw JSON text matching the supported logger config schema.
|
|
|
|
#### output
|
|
|
|
- `LoggerConfig` - Parsed typed configuration value.
|
|
|
|
### Explanation
|
|
|
|
Detailed rules explaining key parameters and behaviors
|
|
|
|
- Parsing is separated from runtime construction.
|
|
- This API is ideal for validating, editing, or inspecting config values before calling `build_logger(...)`.
|
|
- Supported keys are intentionally constrained to stable built-in sink shapes and formatter options.
|
|
- The error surface is `ConfigError` rather than silent fallback behavior.
|
|
|
|
### How to Use
|
|
|
|
Here are some specific examples provided.
|
|
|
|
#### When Need Validation Before Runtime Build
|
|
|
|
When config should be reviewed before creating the logger:
|
|
```moonbit
|
|
let config = parse_logger_config_text(raw) catch {
|
|
err => return
|
|
}
|
|
let logger = build_logger(config)
|
|
```
|
|
|
|
In this example, parsing and building remain separate phases.
|
|
|
|
#### When Need To Inspect Parsed Values
|
|
|
|
When config should be normalized into typed values first:
|
|
```moonbit
|
|
let config = parse_logger_config_text(raw) catch {
|
|
err => return
|
|
}
|
|
println(config.target)
|
|
```
|
|
|
|
In this example, the parsed object can be inspected or rewritten before runtime use.
|
|
|
|
### Error Case
|
|
|
|
e.g.:
|
|
- If `input` is invalid JSON, parsing raises `ConfigError`.
|
|
|
|
- If supported fields have wrong types or unsupported enum text, parsing raises `ConfigError`.
|
|
|
|
### Notes
|
|
|
|
Notes are here.
|
|
|
|
1. Prefer this API when you need typed config inspection before building.
|
|
|
|
2. Prefer `parse_and_build_logger(...)` when one-step bootstrapping is enough.
|
|
|
|
3. Keep external config files aligned with the supported stable schema.
|
|
|
|
4. Parsed config remains reusable across multiple runtime builders if needed.
|