BitLogger

模块 / 能力	native / llvm	js / wasm / wasm-gc
`src` 主包	支持	支持
`file_sink(...)`	支持	不支持, `native_files_supported()` 返回 `false`
`src-async`	支持原生 worker 语义	支持兼容实现
`examples/async_basic`	支持	受 `async fn main` 入口限制, 当前不提供

❇️ 关键特性

结构化日志基础能力：level、record、formatter、sink、target、context field。
组合式设计：支持 filter、patch、fanout、split、callback、queued sink 等组合能力。
配置驱动：支持 JSON 配置解析、导出与 build_logger(...) / build_async_logger(...) 运行时组装。
文本格式化：支持 text_formatter(...)、template、style tag、color_mode / style_markup。
Native 文件输出：支持 file sink、基础 size rotation、reopen、failure counter 与运行时状态读取。
异步层：提供独立 src-async package，支持 queue、worker lifecycle、runtime state 和跨端兼容实现。

🚀 快速开始

let logger = Logger::new(console_sink(), min_level=Level::Info, target="demo")
  .with_timestamp()
  .with_context_fields([field("service", "bitlogger")])

logger.info("starting", fields=[field("port", "8080")])

异步入口示例：

let logger = async_logger(console_sink(), target="async.demo")
@async.with_task_group(group => {
  group.spawn_bg(() => logger.run())
  logger.info("started")
  logger.shutdown()
})

📂 仓库结构

src/: 主日志库 package。
src-async/: 基于 moonbitlang/async 的异步日志层。
docs/api/: 单接口粒度 API 文档。
examples/basic/: 最小同步示例。
examples/async_basic/: 异步 logger 示例。

README.md

2026 MoonBit 国产基础软件生态开源大赛参赛作品

📖 介绍

🧭 后端兼容

❇️ 关键特性

🚀 快速开始

📂 仓库结构

🔗 文档入口