From 1c75c98e3c716b8729b7be369fe770f00e13eca9 Mon Sep 17 00:00:00 2001 From: Nanaloveyuki Date: Fri, 15 May 2026 10:13:36 +0800 Subject: [PATCH] =?UTF-8?q?=F0=9F=9A=9A=20Move=20`bitlogger`&`bitlogger-as?= =?UTF-8?q?ync`=20to=20`src`&=20`src-async`?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 13 ++++++------- docs/README-en.md | 11 +++++------ examples/async_basic/moon.pkg | 4 ++-- examples/basic/moon.pkg | 2 +- moon.mod.json | 2 +- .../BitLoggerAsync_test.mbt | 0 .../async_logger_native.mbt | 0 .../async_logger_stub.mbt | 0 {bitlogger_async => src-async}/moon.pkg | 2 +- {bitlogger => src}/BitLogger.mbt | 0 {bitlogger => src}/BitLogger_test.mbt | 0 {bitlogger => src}/BitLogger_wbtest.mbt | 0 {bitlogger => src}/README.mbt.md | 0 {bitlogger => src}/config.mbt | 0 {bitlogger => src}/file_backend_native.mbt | 0 {bitlogger => src}/file_backend_stub.mbt | 0 {bitlogger => src}/filters.mbt | 0 {bitlogger => src}/formatter.mbt | 0 {bitlogger => src}/global.mbt | 0 {bitlogger => src}/level.mbt | 0 {bitlogger => src}/logger.mbt | 0 {bitlogger => src}/moon.pkg | 0 {bitlogger => src}/patchers.mbt | 0 {bitlogger => src}/record.mbt | 0 {bitlogger => src}/sinks.mbt | 0 25 files changed, 16 insertions(+), 18 deletions(-) rename {bitlogger_async => src-async}/BitLoggerAsync_test.mbt (100%) rename {bitlogger_async => src-async}/async_logger_native.mbt (100%) rename {bitlogger_async => src-async}/async_logger_stub.mbt (100%) rename {bitlogger_async => src-async}/moon.pkg (86%) rename {bitlogger => src}/BitLogger.mbt (100%) rename {bitlogger => src}/BitLogger_test.mbt (100%) rename {bitlogger => src}/BitLogger_wbtest.mbt (100%) rename {bitlogger => src}/README.mbt.md (100%) rename {bitlogger => src}/config.mbt (100%) rename {bitlogger => src}/file_backend_native.mbt (100%) rename {bitlogger => src}/file_backend_stub.mbt (100%) rename {bitlogger => src}/filters.mbt (100%) rename {bitlogger => src}/formatter.mbt (100%) rename {bitlogger => src}/global.mbt (100%) rename {bitlogger => src}/level.mbt (100%) rename {bitlogger => src}/logger.mbt (100%) rename {bitlogger => src}/moon.pkg (100%) rename {bitlogger => src}/patchers.mbt (100%) rename {bitlogger => src}/record.mbt (100%) rename {bitlogger => src}/sinks.mbt (100%) diff --git a/README.md b/README.md index 226643f..dc91f75 100644 --- a/README.md +++ b/README.md @@ -18,9 +18,9 @@ BitLogger 是一个使用 MoonBit 编写的结构化日志库，目标是提供 | 模块 / 能力 | native / llvm | js / wasm / wasm-gc | | --- | --- | --- | -| `bitlogger` 主包 | 支持 | 支持 | +| `src` 主包 | 支持 | 支持 | | `file_sink(...)` | 支持 | 不支持, `native_files_supported()` 返回 `false` | -| `bitlogger_async` | 支持原生 worker 语义 | 支持兼容实现 | +| `src-async` | 支持原生 worker 语义 | 支持兼容实现 | | `examples/async_basic` | 支持 | 受 `async fn main` 入口限制, 当前不提供 | ## ❇️ 关键特性 @@ -30,7 +30,7 @@ BitLogger 是一个使用 MoonBit 编写的结构化日志库，目标是提供 - 配置驱动：支持 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 和跨端兼容实现。 +- 异步层：提供独立 `src-async` package，支持 queue、worker lifecycle、runtime state 和跨端兼容实现。 ## 🚀 快速开始 @@ -55,8 +55,8 @@ let logger = async_logger(console_sink(), target="async.demo") ## 📂 仓库结构 -- `bitlogger/`: 主日志库 package。 -- `bitlogger_async/`: 基于 `moonbitlang/async` 的异步日志层。 +- `src/`: 主日志库 package。 +- `src-async/`: 基于 `moonbitlang/async` 的异步日志层。 - `docs/api/`: 单接口粒度 API 文档。 - `examples/basic/`: 最小同步示例。 - `examples/async_basic/`: 异步 logger 示例。 @@ -65,6 +65,5 @@ let logger = async_logger(console_sink(), target="async.demo") - [Mooncake 文档页](https://mooncakes.io/docs/Nanaloveyuki/BitLogger) - [English README](./docs/README-en.md) -- [bitlogger package README](./bitlogger/README.mbt.md) +- [src package README](./src/README.mbt.md) - [API 索引](./docs/api/index.md) - diff --git a/docs/README-en.md b/docs/README-en.md index 2e59fc2..41ec3c2 100644 --- a/docs/README-en.md +++ b/docs/README-en.md @@ -12,9 +12,9 @@ BitLogger is designed to provide composable, configurable, and cross-target logg | Module / capability | native / llvm | js / wasm / wasm-gc | | --- | --- | --- | -| `bitlogger` core package | Supported | Supported | +| `src` core package | Supported | Supported | | `file_sink(...)` | Supported | Not available, `native_files_supported()` returns `false` | -| `bitlogger_async` | Native worker semantics | Compatibility implementation | +| `src-async` | Native worker semantics | Compatibility implementation | | `examples/async_basic` | Supported | Not shipped currently because `async fn main` entry support is still limited | ## Key Features @@ -49,8 +49,8 @@ let logger = async_logger(console_sink(), target="async.demo") ## Repository Layout -- `bitlogger/`: core logging package. -- `bitlogger_async/`: async logging layer built on `moonbitlang/async`. +- `src/`: core logging package. +- `src-async/`: async logging layer built on `moonbitlang/async`. - `docs/api/`: one-file-per-interface API documentation. - `examples/basic/`: minimal synchronous example. - `examples/async_basic/`: async logger example. @@ -59,7 +59,7 @@ let logger = async_logger(console_sink(), target="async.demo") - [Mooncake package page](https://mooncakes.io/docs/Nanaloveyuki/BitLogger) - [Chinese README](../README.md) -- [bitlogger package README](../bitlogger/README.mbt.md) +- [src package README](../src/README.mbt.md) - Selected API docs in `docs/api/`: - [logger-new.md](./api/logger-new.md) - [async-logger.md](./api/async-logger.md) @@ -71,4 +71,3 @@ let logger = async_logger(console_sink(), target="async.demo") - `docs/README-en.md` no longer acts as an API catalog. - Detailed API references, config fields, runtime control helpers, and lifecycle surfaces now live under `docs/api/`. - For concrete runnable flows, prefer `examples/`. - diff --git a/examples/async_basic/moon.pkg b/examples/async_basic/moon.pkg index f67357c..0347e10 100644 --- a/examples/async_basic/moon.pkg +++ b/examples/async_basic/moon.pkg @@ -1,6 +1,6 @@ import { - "Nanaloveyuki/BitLogger/bitlogger" @lib, - "Nanaloveyuki/BitLogger/bitlogger_async" @lib_async, + "Nanaloveyuki/BitLogger/src" @lib, + "Nanaloveyuki/BitLogger/src-async" @lib_async, "moonbitlang/async" @async, } diff --git a/examples/basic/moon.pkg b/examples/basic/moon.pkg index 2241850..05f243c 100644 --- a/examples/basic/moon.pkg +++ b/examples/basic/moon.pkg @@ -1,5 +1,5 @@ import { - "Nanaloveyuki/BitLogger/bitlogger" @lib, + "Nanaloveyuki/BitLogger/src" @lib, } options( diff --git a/moon.mod.json b/moon.mod.json index 630c1a1..0b57618 100644 --- a/moon.mod.json +++ b/moon.mod.json @@ -5,7 +5,7 @@ "maria/json_parser": "0.1.1", "moonbitlang/async": "0.19.0" }, - "readme": "README.mbt.md", + "readme": "src/README.mbt.md", "repository": "https://github.com/Nanaloveyuki/BitLogger", "license": "MIT", "keywords": [ diff --git a/bitlogger_async/BitLoggerAsync_test.mbt b/src-async/BitLoggerAsync_test.mbt similarity index 100% rename from bitlogger_async/BitLoggerAsync_test.mbt rename to src-async/BitLoggerAsync_test.mbt diff --git a/bitlogger_async/async_logger_native.mbt b/src-async/async_logger_native.mbt similarity index 100% rename from bitlogger_async/async_logger_native.mbt rename to src-async/async_logger_native.mbt diff --git a/bitlogger_async/async_logger_stub.mbt b/src-async/async_logger_stub.mbt similarity index 100% rename from bitlogger_async/async_logger_stub.mbt rename to src-async/async_logger_stub.mbt diff --git a/bitlogger_async/moon.pkg b/src-async/moon.pkg similarity index 86% rename from bitlogger_async/moon.pkg rename to src-async/moon.pkg index d2ca93a..ec928fb 100644 --- a/bitlogger_async/moon.pkg +++ b/src-async/moon.pkg @@ -1,5 +1,5 @@ import { - "Nanaloveyuki/BitLogger/bitlogger" @bitlogger, + "Nanaloveyuki/BitLogger/src" @bitlogger, "maria/json_parser" @json_parser, "moonbitlang/async" @async, "moonbitlang/async/aqueue" @aqueue, diff --git a/bitlogger/BitLogger.mbt b/src/BitLogger.mbt similarity index 100% rename from bitlogger/BitLogger.mbt rename to src/BitLogger.mbt diff --git a/bitlogger/BitLogger_test.mbt b/src/BitLogger_test.mbt similarity index 100% rename from bitlogger/BitLogger_test.mbt rename to src/BitLogger_test.mbt diff --git a/bitlogger/BitLogger_wbtest.mbt b/src/BitLogger_wbtest.mbt similarity index 100% rename from bitlogger/BitLogger_wbtest.mbt rename to src/BitLogger_wbtest.mbt diff --git a/bitlogger/README.mbt.md b/src/README.mbt.md similarity index 100% rename from bitlogger/README.mbt.md rename to src/README.mbt.md diff --git a/bitlogger/config.mbt b/src/config.mbt similarity index 100% rename from bitlogger/config.mbt rename to src/config.mbt diff --git a/bitlogger/file_backend_native.mbt b/src/file_backend_native.mbt similarity index 100% rename from bitlogger/file_backend_native.mbt rename to src/file_backend_native.mbt diff --git a/bitlogger/file_backend_stub.mbt b/src/file_backend_stub.mbt similarity index 100% rename from bitlogger/file_backend_stub.mbt rename to src/file_backend_stub.mbt diff --git a/bitlogger/filters.mbt b/src/filters.mbt similarity index 100% rename from bitlogger/filters.mbt rename to src/filters.mbt diff --git a/bitlogger/formatter.mbt b/src/formatter.mbt similarity index 100% rename from bitlogger/formatter.mbt rename to src/formatter.mbt diff --git a/bitlogger/global.mbt b/src/global.mbt similarity index 100% rename from bitlogger/global.mbt rename to src/global.mbt diff --git a/bitlogger/level.mbt b/src/level.mbt similarity index 100% rename from bitlogger/level.mbt rename to src/level.mbt diff --git a/bitlogger/logger.mbt b/src/logger.mbt similarity index 100% rename from bitlogger/logger.mbt rename to src/logger.mbt diff --git a/bitlogger/moon.pkg b/src/moon.pkg similarity index 100% rename from bitlogger/moon.pkg rename to src/moon.pkg diff --git a/bitlogger/patchers.mbt b/src/patchers.mbt similarity index 100% rename from bitlogger/patchers.mbt rename to src/patchers.mbt diff --git a/bitlogger/record.mbt b/src/record.mbt similarity index 100% rename from bitlogger/record.mbt rename to src/record.mbt diff --git a/bitlogger/sinks.mbt b/src/sinks.mbt similarity index 100% rename from bitlogger/sinks.mbt rename to src/sinks.mbt