BitLogger

BitLogger is a structured logging library for MoonBit projects.

Overview

BitLogger gives you consistent levels, targets, structured fields, configurable text output, native file logging, and an async logging layer.

Quick Start

let logger = build_logger(
  text_console(
    min_level=Level::Info,
    target="demo",
    text_formatter=TextFormatterConfig::new(show_timestamp=false, separator=" | "),
  ),
)

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

Start with console(...), json_console(...), text_console(...), or file(...), then add with_queue(...) or with_file_rotation(...) only when needed.

Use Logger::new(...) when you want to assemble custom sink graphs directly.

Support Status

Currently verified targets: native, js, wasm, wasm-gc
llvm is still treated as experimental in the current release context
File output is a native capability; check native_files_supported() in cross-target code
src-async is available, while examples/async_basic is still shipped as a native entry example

Main Features

Structured logs with levels, targets, messages, and fields
Multiple outputs: console, JSON console, text console, and file
Custom text formatting with templates, style tags, and color control
Config-based builders: build_logger(...) and build_async_logger(...)
Composition helpers: queue, filter, patch, fanout, split, callback
Separate async package under src-async

Examples

examples/console_basic/: minimal console and JSON console example
examples/text_formatter/: text formatting and template example
examples/style_tags/: style tags and colored output example
examples/config_build/: config-based build example
examples/presets/: common preset combinations
examples/file_rotation/: native file logging and rotation example
examples/async_basic/: async logging example

Documentation

Common entry points: text_console(...), file(...), with_queue(...), build_logger(...), build_async_logger(...)

2.2 KiB Raw Blame History