简介

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斗争的尽头。