【Rust每周一库】smol - 异步rumtime

简介

smol是一个轻量而高效的异步runtime。它采用了对标准库进行扩展的方式，整个runtime只有大约1500行代码。作者stjepang大神是大名鼎鼎crossbeam的作者。而他之前参与tokio和async-std的开发的经验和思考，产生出了从头开始构建的smol这个库。实际上在达到和tokio以及async-std相似的性能的前提下，smol代码短线精悍，完全没有依赖mio库，API更加简单，并且没有unsafe代码！而且，它还兼容tokio和async-std。让我们看个简单的例子

Tcp服务器端和客户端

首先是一个echo服务器端

use std::net::{TcpListener, TcpStream};


use futures::io;
use smol::{Async, Task};


/// 原封不动返回输入流
async fn echo(stream: Async<TcpStream>) -> io::Result<()> {
    io::copy(&stream, &mut &stream).await?;
    Ok(())
}


fn main() -> io::Result<()> {
    smol::run(async {
        // 创建listener
        let listener = Async::<TcpListener>::bind("127.0.0.1:7000")?;
        println!("Listening on {}", listener.get_ref().local_addr()?);
        println!("Now start a TCP client.");


        // 接受客户端请求
        loop {
            let (stream, peer_addr) = listener.accept().await?;
            println!("Accepted client: {}", peer_addr);


            // 起一个task回应客户端
            Task::spawn(echo(stream)).unwrap().detach();
        }
    })
}

然后是一个客户端

use std::net::TcpStream;


use futures::io;
use futures::prelude::*;
use smol::Async;


fn main() -> io::Result<()> {
    smol::run(async {
        // 包装出异步的标准输入/输出
        let stdin = smol::reader(std::io::stdin());
        let mut stdout = smol::writer(std::io::stdout());


        // 连接服务器端
        let stream = Async::<TcpStream>::connect("127.0.0.1:7000").await?;
        println!("Connected to {}", stream.get_ref().peer_addr()?);
        println!("Type a message and hit enter!\n");


        // stdin -> 服务器；服务器返回 -> stdout
        future::try_join(
            io::copy(stdin, &mut &stream),
            io::copy(&stream, &mut stdout),
        )
        .await?;


        Ok(())
    })
}

官方还提供了很多其他的例子可以参考。

兼容性

smol具有非常好的兼容性，比如说可以兼容tokio和async-std

use std::time::{Duration, Instant};
use anyhow::{Error, Result};
fn main() -> Result<()> {    smol::run(async {        // 使用async-std的sleep        let start = Instant::now();        println!("Sleeping using async-std...");        async_std::task::sleep(Duration::from_secs(1)).await;        println!("Woke up after {:?}", start.elapsed());
        // 使用tokio的sleep        let start = Instant::now();        println!("Sleeping using tokio...");        tokio::time::delay_for(Duration::from_secs(1)).await;        println!("Woke up after {:?}", start.elapsed());
        Ok(())    })}

• 注意，兼容tokio需要开启以下feature

[dependencies]smol = { version = "0.1", features = ["tokio02"] }
小结

是不是很厉害呢？感觉看到了async成熟的曙光，也似乎看到了tokio和async-std斗争的尽头。