mirror of
https://github.com/Nanaloveyuki/BitLogger.git
synced 2026-05-30 23:52:27 +00:00
📝 Update More API Document
This commit is contained in:
@@ -0,0 +1,60 @@
|
||||
---
|
||||
name: default-logger-config
|
||||
group: api
|
||||
category: config
|
||||
update-time: 20260520
|
||||
description: Create the default LoggerConfig used by config-driven logger builders.
|
||||
key-word:
|
||||
- logger
|
||||
- config
|
||||
- default
|
||||
- public
|
||||
---
|
||||
|
||||
## Default-logger-config
|
||||
|
||||
Create the default `LoggerConfig` used by config-driven logger builders. This helper is useful when callers want the library's baseline top-level config value explicitly before customization.
|
||||
|
||||
### Interface
|
||||
|
||||
```moonbit
|
||||
pub fn default_logger_config() -> LoggerConfig {
|
||||
```
|
||||
|
||||
#### output
|
||||
|
||||
- `LoggerConfig` - Default top-level logger config.
|
||||
|
||||
### Explanation
|
||||
|
||||
Detailed rules explaining key parameters and behaviors
|
||||
|
||||
- This helper returns the same baseline config shape used by `LoggerConfig::new()` defaults.
|
||||
- It includes the default minimum level, empty target, disabled timestamp, default sink config, and no queue wrapper.
|
||||
- It is useful for explicit config composition when callers want a known baseline object.
|
||||
|
||||
### How to Use
|
||||
|
||||
Here are some specific examples provided.
|
||||
|
||||
#### When Need A Baseline Top-level Config Value
|
||||
|
||||
When config code prefers to start from the full default object:
|
||||
```moonbit
|
||||
let config = default_logger_config()
|
||||
```
|
||||
|
||||
In this example, the default logger config is available as a concrete value for later adjustment or serialization.
|
||||
|
||||
### Error Case
|
||||
|
||||
e.g.:
|
||||
- There is no failure path for retrieving the default config value.
|
||||
|
||||
- If runtime construction is needed immediately, pass the config to `build_logger(...)` or use a runtime logger constructor directly.
|
||||
|
||||
### Notes
|
||||
|
||||
1. This helper is the top-level default config entry point.
|
||||
|
||||
2. It is useful for explicit config-first workflows and tests.
|
||||
Reference in New Issue
Block a user