📖 介绍

BitLogger 是一个使用 MoonBit 编写的结构化日志库，目标是提供可组合、可配置、可跨端编译的日志基础设施。

🧭 后端兼容

模块 / 能力	native / llvm	js / wasm / wasm-gc
bitlogger 主包	支持	支持
file_sink(...)	支持	不支持, native_files_supported() 返回 false
bitlogger_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 与运行时状态读取。
• 异步层：提供独立 bitlogger_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()
})

📂 仓库结构

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

🔗 文档入口

• Mooncake 文档页
• English README
• bitlogger package README
• API 索引