rust-io

Lingua Seeker 的 PyO3 门面 crate，将 net-io 和 files-io 注册为 rust_io Python 模块的子模块。

概览

rust-io 是唯一构建为 cdylib（.so/.pyd）的 crate，通过 import rust_io 加载。它本身不包含业务逻辑，仅负责：

1. 创建 rust_io.net 子模块，注册 net-io 的所有 #[pyfunction]
2. 创建 rust_io.files 子模块，注册 files-io 的所有 #[pyfunction] 和 #[pyclass]
3. 通过 sys.modules 注册子模块，使其可通过 import rust_io.net / import rust_io.files 直接访问

公开 API

rust-io 本身不定义业务 API，完整 API 参考见各子 crate：

rust_io.net 注册的函数

rust_io.files 注册的函数/类

架构

rust-io/src/
└── lib.rs    # #[pymodule] rust_io — 注册 net 和 files 子模块

子模块注册机制

#[pymodule]
fn rust_io(m: &Bound<'_, PyModule>) -> PyResult<()> {
    // 1. 创建子模块
    let net = PyModule::new(m.py(), "net")?;
    // 2. 添加函数
    net.add_function(wrap_pyfunction!(net_io::py::fetch_one, &net)?)?;
    // ... 更多函数
    // 3. 注册到父模块 + sys.modules
    register_submodule(m, "rust_io.net", &net)?;

    let files = PyModule::new(m.py(), "files")?;
    files.add_class::<files_io::py::file::File>()?;
    // ... 更多函数
    register_submodule(m, "rust_io.files", &files)?;
    Ok(())
}

register_submodule 辅助函数完成两步操作：

1. parent.add_submodule(submodule) — 注册到父模块
2. sys.modules["rust_io.net"] = submodule — 使 import rust_io.net 可用

使用示例

# 通过 rust_io 门面访问所有功能
import rust_io

# 或直接导入子模块
import rust_io.net as net_io
import rust_io.files as files_io

# 文献搜索
result = await net_io.fetch_one("crossref", "search", {"query": "CRISPR"})

# 文件操作
f = files_io.File("/tmp/output.txt")
f.write("hello")
print(f.read(as_text=True))

构建

# 从 backend/ 目录构建（maturin 会自动解析 Cargo.toml 中的 path 依赖）
cd backend
uv run maturin develop --release -m libs/rust-io/Cargo.toml

构建产物为 rust_io.so（Linux/macOS）或 rust_io.pyd（Windows），包含 net-io 和 files-io 的全部代码（静态链接）。

依赖