6 个版本
新版本 0.2.1 | 2024 年 8 月 9 日 |
---|---|
0.2.0 | 2024 年 4 月 25 日 |
0.1.0 | 2024 年 3 月 4 日 |
0.1.0-beta.3 | 2023 年 12 月 18 日 |
0.1.0-beta.2 | 2023 年 11 月 24 日 |
#2074 in 异步
93 每月下载量
在 3 个 Crates 中使用 (通过 compio)
145KB
3K SLoC
Compio
每个核心一个线程的 Rust 运行时,具有 IOCP/io_uring/polling。这个名字来自“基于完成的 I/O”。这个 crate 受 monoio 的启发。
为什么不选择 Tokio?
Tokio 是一个优秀的通用异步运行时。然而,它是基于 poll 的,甚至在 Windows 上使用 未记录的 API。我们希望有一些新的高级 API 来执行 IOCP/io_uring。
与 tokio-uring
不同,这个运行时不基于 Tokio。这主要是因为在 mio
中没有控制 IOCP 的公共 API,并且 tokio
在 mio
达到 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 群组。在贡献之前,请查阅我们的 贡献指南。
依赖项
~0.8–11MB
~141K SLoC