1 个不稳定版本

0.1.0 2024年6月17日

#1655 in 异步


用于 compio

MIT 许可证

360KB
8K SLoC

Compio

MIT licensed crates.io docs.rs Check Test Telegram

基于IOCP/io_uring/polling的每个核心的Rust运行时。这个名字来源于“基于完成I/O”。这个crate受到了monoio的启发。

为什么不使用Tokio?

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

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

为什么不使用monoio/tokio-uring/glommio?

它们不支持Windows。

快速入门

compio作为依赖项添加

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

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

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群组。在贡献之前,请查看我们的贡献指南

依赖项

~2–12MB
~129K SLoC