feat(chriskohlhoff.asio): import asio; — 将 Asio 1.38.1 适配为 C++23 模块 (separate compilation)

[wellwei]

摘要

新增 chriskohlhoff.asio@1.38.1 — 将 Asio 1.38.1 暴露为 C++23 模块 import asio;。
采用 ASIO_SEPARATE_COMPILATION 模式（编译 */src/asio.cpp），是现有 header-only 版 compat.asio 的模块伴侣包。

新增文件

文件	说明
pkgs/c/chriskohlhoff.asio.lua	Form B inline 描述符，含 37 个 asio 头文件 include、~55 条 using 导出、191 行中文使用文档（含限制、迁移指南）
tests/examples/asio-module/mcpp.toml	测试项目配置
tests/examples/asio-module/tests/core.cpp	核心：io_context/strand/thread_pool/cancellation_signal
tests/examples/asio-module/tests/coroutine.cpp	协程：awaitable/co_spawn/use_awaitable/this_coro
tests/examples/asio-module/tests/experimental.cpp	实验性：channel/concurrent_channel/use_promise
tests/examples/asio-module/tests/network.cpp	TCP acceptor/socket + UDP 全链路
tests/examples/asio-module/tests/surface.cpp	export 编译时验证 ≈ 25 条 static_assert

修改文件

文件	改动
mcpp.toml	workspace.members 添加 "tests/examples/asio-module"

导出的 API 范围

• 核心 IO: io_context, execution_context, post/dispatch/defer, make_work_guard, steady_timer/system_timer, thread_pool, make_strand, any_io_executor, system_executor/system_context
• 取消: cancellation_signal, cancellation_type, bind_cancellation_slot, cancellation_state
• 网络: tcp/udp(address/socket/acceptor/resolver/endpoint), socket_base, connect, async_read/async_write, read/write/read_until
• 缓冲区: mutable_buffer, const_buffer, buffer
• 协程: awaitable, co_spawn, use_awaitable, this_coro::*
• 实验性: experimental::channel, concurrent_channel, use_promise
• 完成令牌: detached/detached_t, use_future, deferred/deferred_t, redirect_error, bind_executor, bind_allocator, append/prepend/consign/as_tuple
• 关联特质: associated_executor, associated_allocator, associated_cancellation_slot
• 信号: signal_set
• 错误: error_code, error::make_error_code, error::operation_aborted

不可用的组件（需额外依赖/平台相关）

SSL/TLS、Unix domain sockets、POSIX descriptors、Windows handles、serial_port、pipes、file I/O、spawn()（需 Boost.Context，已禁用）、deadline_timer（已废弃）。详见描述符注释。

验证

mcpp test -p asio-module => 5/5 passed
mcpp test -p asio        => 6/6 passed (header-only 回归)
mcpp test -p spdlog,nlohmann.json,marzer.tomlplusplus => 全部通过

mcpp add chriskohlhoff.asio@1.38.1  ✅ 

[Sunrisepeak]

compat.asio-m

模块化的包, 不用加compat 。namespace可以用库作者或组织的名字或缩写 不用 asio-m 具体参考

• https://github.com/mcpplibs/mcpp-index/blob/main/pkgs/f/fmtlib.fmt.lua
• https://github.com/mcpplibs/mcpp-index/blob/main/pkgs/n/nlohmann.json.lua