#moonbit-log

#Project Status

• CCF OSC2026 MoonBit 赛道参赛项目
• moon check --deny-warn 通过
• moon test 163/163 通过
• 代码规模: 4,100+ 行 MoonBit 源码
• 零外部依赖，仅使用 MoonBit 标准库

#Features

#日志级别 (6)

#处理器 (21)

#格式器 (14)

#性能工具

• Stopwatch: 微秒/毫秒/秒计时
• Benchmark: 重复执行基准测试，自动计算均值/标准差/吞吐量
• ThroughputMeter: 滑动窗口吞吐量测量

#配置系统

• LogConfig + Builder 模式 + 工厂方法
• 代码/JSON 双模式配置
• 按名称选择 handler(format)/output 组合

#全局 Logger

#Build & Test

# 编译检查（零警告）
moon check --target all --deny-warn

# 运行全部 163 个测试
moon test --target all

# 格式化代码
moon fmt

# 构建 WASM-GC
moon build --target wasm-gc --release

# 构建 JS
moon build --target js --release

#Quick Start

import {
  "leppard/moonbit-log" @log
}

[deps]
leppard/moonbit-log = { version = "1.0.0" }

#基本使用

fn main {
  @log.init_default_console()
  @log.g_info("Hello, moonbit-log!")
  @log.g_info("User login", [("user_id", "42"), ("ip", "10.0.0.1")])
}

#JSON 日志

@log.init_default_json()
@log.g_info("Order created", [
  ("order_id", "ORD-001"),
  ("amount", "299.00"),
  ("currency", "CNY")
])

#审计日志

let fmt = @log.audit_formatter("|")
let audit = @log.AuditHandler::new(@log.Level::Info, fmt, 100)
let logger = @log.Logger::new()
logger.add_handler(@log.make_handler(fn(e) { audit.log(e) }, fn() {}, fn() {}))
logger.log_with(@log.Level::Info, "数据导出", [("user", "admin"), ("records", "1000")])
println(audit.entries().length())

#文件/缓冲输出

let handler = @log.FileHandler::new(
  @log.Level::Info,
  @log.json_formatter(),
  100
)
let logger = @log.Logger::new()
logger.add_handler(@log.make_handler(fn(e) { handler.log(e) }, fn() { handler.flush() }, fn() { handler.close() }))
logger.info("写入缓冲")

#文件轮转

let handler = @log.RotatingFileHandler::new(
  @log.Level::Info,
  @log.text_formatter(),
  10,
  5
)
let logger = @log.Logger::new()
logger.add_handler(@log.make_handler(fn(e) { handler.log(e) }, fn() { handler.flush() }, fn() { handler.close() }))
// 超过 10 行自动轮转，保留 5 个历史文件

#异步批处理

let handler = @log.ConsoleHandler::new(@log.Level::Debug, @log.compact_formatter())
let batch = @log.AsyncLogger::new(
  @log.make_handler(fn(e) { handler.log(e) }, fn() { handler.flush() }, fn() { handler.close() }),
  64
)
batch.log(@log.LogEntryBuilder::new(@log.Level::Info, "异步消息").build())
batch.flush()

#性能基准

let r = @log.benchmark("计算测试", 1000, fn() {
  let mut x = 0
  x = x + 1
  @log.ignore(x)
})
println(@log.benchmark_report(r))

#配置系统

@log.configure(
  level: @log.Level::Debug,
  format: "compact",
  output: "console"
)
@log.g_debug("配置已生效")

#API Reference

#Logger

#Handler 通用接口

• log(self, LogEntry) -> Unit — 记录日志条目
• flush(self) -> Unit — 刷新缓冲
• close(self) -> Unit — 关闭并释放资源

#Stopwatch

#LogEntry

#Project Structure

moonbit-log/
├── logger.mbt              # Logger 核心
├── log_entry.mbt           # LogEntry / LogEntryBuilder
├── level.mbt               # Level 枚举 / enabled / from_string
├── handler.mbt             # HandlerFn 函数式 Handler
├── formatter.mbt           # text / compact / json / audit / custom
├── console_handler.mbt     # ConsoleHandler
├── file_handler.mbt        # FileHandler (缓冲批量输出)
├── json_handler.mbt        # JsonHandler
├── text_handler.mbt        # TextHandler (带前缀)
├── memory_handler.mbt      # MemoryHandler (内存存储+检索)
├── audit_handler.mbt       # AuditHandler (审计日志)
├── multi_handler.mbt       # MultiHandler (多路分发)
├── advanced_handlers.mbt   # RotatingFile / LevelFilter / Sampling / Dedup / RingBuffer / RateLimited
├── extra_handler_utils.mbt # Null / Condition / Throttled / Counting / kv / banner / csv
├── extra_formatters.mbt    # logfmt / xml / pretty(ANSI)
├── template_formatter.mbt  # pattern / stats / multi_line
├── async_logger.mbt        # AsyncLogger / BatchingLogger / EntryTransformer
├── config.mbt              # LogConfig + 工厂方法 + JSON 配置
├── global_logger.mbt       # 全局 Logger 单例
├── stopwatch.mbt           # Stopwatch / Benchmark / ThroughputMeter
├── entry_utils.mbt         # 条目工具函数
├── log_test.mbt            # 基础测试 (~50 用例)
├── extended_test.mbt       # 扩展测试 (~50 用例)
├── edge_case_test.mbt      # 边界情况测试 (~63 用例)
├── cmd/example/main.mbt    # CLI 示例
├── moon.mod                # 模块元数据
└── moon.pkg                # 包配置

#竞品对比

#License

#参赛信息

• 赛事: CCF 开源创新大赛 (OSC 2026) · MoonBit 赛道
• 命名空间: leppard/moonbit-log
• 仓库: https://gitlink.org.cn/leppard/moonbit-log
• 代码行数: 4,127
• 源文件: 24
• 测试用例: 163