Compio

一个基于 IOCP/io_uring/polling 的每个核心一个线程的 Rust 运行时。这个名字来源于 "基于完成的 IO"。这个 crate 受 monoio 的启发。

为什么不选择 Tokio?

Tokio 是一个优秀的通用异步运行时。然而，它是基于 poll 的，甚至在 Windows 上使用了 未记录的 API。我们希望有一些新的高级 API 来执行 IOCP/io_uring。

与 tokio-uring 不同，这个运行时不基于 Tokio。这主要是因为在 mio 中没有公开 API 来控制 IOCP，并且 tokio 在 mio 达到 1.0 之前不会公开 API 来控制 mio。

为什么不选择 monoio/tokio-uring/glommio?

它们不支持 Windows。

快速入门

将 compio 添加为依赖项

compio = { version = "0.10.0", features = ["macros"] }

然后我们可以使用高级 API 来执行文件系统和网络 IO。

use compio::{fs::File, io::AsyncReadAtExt};

#[compio::main]
async fn main() {
    let file = File::open("Cargo.toml").await.unwrap();
    let (read, buffer) = file.read_to_end_at(Vec::with_capacity(1024), 0).await.unwrap();
    assert_eq!(read, buffer.len());
    let buffer = String::from_utf8(buffer).unwrap();
    println!("{}", buffer);
}

您还可以手动控制低级驱动程序。请参阅仓库中的 driver 示例。

贡献

在 Compio 的任何级别都有贡献的机会。无论您是刚开始接触 Rust 还是经验丰富的专家，我们都可以利用您的帮助。如果您对 Compio 有任何疑问，欢迎加入我们的 Telegram 群组。在贡献之前，请查看我们的 贡献指南。