linecache 0.2.2

工业级异步行缓存（比 Python `linecache` 快 50~200 倍） (自动内存限制版本)。High-Performance Asynchronous Line Cache Library (Auto-Memory Limit Version)
Documentation

linecache — 工业级异步行缓存（比 Python linecache 快 50~200 倍）

crates.io Documentation License

一个 完全兼容 Python linecache 行为 的 Rust 异步实现，专为亿级调用、长运行服务、语料随机采样设计。

为什么选择它？

特性 linecache-rs Python linecache
性能 50~200× 更快（零分配） 每次 open+readlines
内存控制 精确权重驱逐（防 OOM） 无限制
并发安全 完全 async + lock-free 全局锁
文件变更检测 自动（mtime+size） 需手动 clearcache
随机行/字符 零分配 O(1) 不支持

快速开始

use linecache::AsyncLineCache;

#[tokio::main]
async fn main() -> std::io::Result<()> {
    let cache = AsyncLineCache::new();

    // 零分配随机采样（推荐用于大模型语料）
    if let Some(line) = cache.random_line("corpus.txt").await? {
        println!("随机语料: {}", line);
    }

    // 随机一个字符（完整支持 Unicode）
    if let Some(ch) = cache.random_sign("text.txt").await? {
        println!("随机字符: {ch}");
    }

    // 按行读取（1-based）
    if let Some(line42) = cache.get_line("data.txt", 42).await? {
        println!("第 42 行: {line42}");
    }

    // 获取所有行
    if let Some(lines) = cache.get_lines("config.txt").await? {
        println!("共 {} 行", lines.len());
    }

    Ok(())
}