mirror of
https://github.com/Nanaloveyuki/BitLogger.git
synced 2026-07-24 00:42:18 +00:00
Nanaloveyuki
109 lines
3.4 KiB
Markdown
109 lines
3.4 KiB
Markdown
---
|
|
name: async-logger-state-new
|
|
group: api
|
|
category: async
|
|
update-time: 20260613
|
|
description: Construct an AsyncLoggerState snapshot from explicit runtime, queue, lifecycle, and failure values.
|
|
key-word:
|
|
- async
|
|
- logger
|
|
- state
|
|
- public
|
|
---
|
|
|
|
## Async-logger-state-new
|
|
|
|
Construct an `AsyncLoggerState` snapshot from explicit runtime, queue, lifecycle, and failure values. This is the low-level constructor behind the public async logger state shape used in diagnostics.
|
|
|
|
### Interface
|
|
|
|
```moonbit
|
|
pub fn AsyncLoggerState::new(
|
|
runtime : AsyncRuntimeState,
|
|
pending_count : Int,
|
|
dropped_count : Int,
|
|
is_closed : Bool,
|
|
is_running : Bool,
|
|
has_failed : Bool,
|
|
last_error : String,
|
|
flush_policy : AsyncFlushPolicy,
|
|
) -> AsyncLoggerState {
|
|
```
|
|
|
|
#### input
|
|
|
|
- `runtime : AsyncRuntimeState` - Embedded backend-level runtime snapshot.
|
|
- `pending_count : Int` - Current async queue backlog.
|
|
- `dropped_count : Int` - Current dropped-record count.
|
|
- `is_closed : Bool` - Whether the logger has been closed.
|
|
- `is_running : Bool` - Whether the logger worker loop is currently running.
|
|
- `has_failed : Bool` - Whether the logger has recorded a runtime failure state.
|
|
- `last_error : String` - Latest error text, or an empty string when no failure has been recorded.
|
|
- `flush_policy : AsyncFlushPolicy` - Active async flush policy for the logger.
|
|
|
|
#### output
|
|
|
|
- `AsyncLoggerState` - Full async logger snapshot containing the supplied runtime, queue, lifecycle, and failure values.
|
|
|
|
### Explanation
|
|
|
|
Detailed rules explaining key parameters and behaviors
|
|
|
|
- This constructor simply packages the supplied fields into one public snapshot value.
|
|
- It does not inspect a live logger instance by itself.
|
|
- `AsyncLogger::state()` is the higher-level API that reads these values from a concrete logger.
|
|
- The constructed value matches the same public shape used by async logger serializers.
|
|
|
|
### How to Use
|
|
|
|
Here are some specific examples provided.
|
|
|
|
#### When Need A Hand-built Async Logger Snapshot
|
|
|
|
When tests or adapters should construct a full async logger state explicitly:
|
|
```moonbit
|
|
let state = AsyncLoggerState::new(
|
|
runtime=AsyncRuntimeState::new(AsyncRuntimeMode::Compatibility, false),
|
|
pending_count=0,
|
|
dropped_count=0,
|
|
is_closed=false,
|
|
is_running=true,
|
|
has_failed=false,
|
|
last_error="",
|
|
flush_policy=AsyncFlushPolicy::Never,
|
|
)
|
|
```
|
|
|
|
In this example, a complete async logger snapshot is assembled directly without querying a live logger instance.
|
|
|
|
#### When Need Structured Diagnostics Input Before Serialization
|
|
|
|
When code should prepare a typed logger state value for later export:
|
|
```moonbit
|
|
let state = AsyncLoggerState::new(
|
|
runtime=async_runtime_state(),
|
|
pending_count=logger.pending_count(),
|
|
dropped_count=logger.dropped_count(),
|
|
is_closed=logger.is_closed(),
|
|
is_running=logger.is_running(),
|
|
has_failed=logger.has_failed(),
|
|
last_error=logger.last_error(),
|
|
flush_policy=logger.flush_policy(),
|
|
)
|
|
```
|
|
|
|
In this example, callers still use the direct constructor while making each diagnostic input explicit.
|
|
|
|
### Error Case
|
|
|
|
e.g.:
|
|
- This constructor itself does not have a normal failure mode; it only packages the provided values.
|
|
|
|
- If callers want a snapshot directly from one live logger instance, `AsyncLogger::state()` is the simpler API.
|
|
|
|
### Notes
|
|
|
|
1. Use this helper when code should construct an `AsyncLoggerState` value explicitly.
|
|
|
|
2. Pair it with `async_logger_state_to_json(...)` or `stringify_async_logger_state(...)` when the snapshot should be exported.
|