性能出色

• 使用 io_uring 发送非阻塞、批量、零拷贝系统调用
• 高效的上下文切换，具有合作式多任务处理
• 无原子调度器，如需则手动并行化

编译速度快

• 使用 [cargo 特性](#编译时间标志) 仅编译所需内容
• 最小依赖
• 最小化宏的使用

快速入门

安装 Rust 并 创建一个新的 cargo 项目。

将 uringy 添加为依赖项：cargo add uringy

然后替换 src/main.rs 为

// No need for async main
#[uringy::start]
fn main() {
    let handle = uringy::fiber::spawn(|| tcp_echo_server(9000)); // No need for async block

    uringy::signals().filter(Signal::is_terminal).next().unwrap();
    uringy::println!("gracefully shutting down");
    handle.cancel(); // Cancellation propagates throughout the entire fiber hierarchy

    // Automatically waits for all fibers to complete
}

// No need for async functions
fn tcp_echo_server(port: u16) {
    let listener = uringy::net::TcpListener::bind(("0.0.0.0", port)).unwrap();
    uringy::println!("listening for TCP connections on port {port}"); // No need for .await
    let mut connections = listener.incoming();
    while let Ok((stream, _)) = connections.next() {
        uringy::fiber::spawn(move || handle_connection(stream));
    }
}

fn handle_connection(tcp: TcpStream) {
    let (mut r, mut w) = stream.split();
    let _ = std::io::copy(&mut r, &mut w); // TcpStream implements std::io's Read and Write
}

使用以下命令运行您的项目：cargo run --release

如果您使用的是 macOS，请使用 Linux 虚拟机 或 docker 容器。如果您使用的是 Windows，请使用 WSL。

更多信息，请查看示例目录。

编译时标志

目前没有 cargo 标志。

与其他运行时的比较

支持的 Rust 版本

MSRV 是 1.75.0（2023 年 12 月发布）。请在终端中运行 rustc --version 检查您的 Rust 版本。

支持的 Linux 内核版本

最低内核版本是 6.1（2022 年 12 月发布）。请在终端中运行 uname -r 检查您的内核版本。

许可

Uringy 在MIT 许可证下授权。这是一个宽容的许可证，基本上意味着您可以做任何想做的事情。