smol

A small and fast async runtime in Rust.

https://discord.gg/5RxMVnr

Goals

• Small - 1500 lines of code.
• Simple - Well-documented, easy to maintain.
• Fast - Based on [async-task], [crossbeam], and [piper].
• Safe - Just 1 line of unsafe code for Windows support.
• Portable - Linux, Android, macOS, iOS, Windows, FreeBSD, OpenBSD, NetBSD, DragonFly BSD.

Features

• Async I/O - TCP, UDP, Unix domain sockets, and custom FDs/sockets.
• Thread-local executor - For non-send futures.
• Work-stealing executor - adapts to uneven workload.
• Blocking executor - For files, processes, and standard I/O.
• Timer - Efficient userspace timers.

Documentation

cargo doc --document-private-items --no-deps --open

TODO Crate recommendations

TODO certificate and private key

// To access the HTTPS version, import the certificate into Chrome/Firefox:
// 1. Open settings and go to the certificate 'Authorities' list
// 2. Click 'Import' and select certificate.pem
// 3. Enable 'Trust this CA to identify websites' and click OK
// 4. Restart the browser and go to https://127.0.0.1:8001
//
// The certificate was generated using minica and openssl:
// 1. minica --domains localhost -ip-addresses 127.0.0.1 -ca-cert certificate.pem
// 2. openssl pkcs12 -export -out identity.pfx -inkey localhost/key.pem -in localhost/cert.pem

Examples

• Async-h1 client
• Async-h1 server
• Chat Client
• Chat Server
• Compat reqwest
• Compat tokio
• Ctrl-c
• Hyper Client
• Hyper Server
• Linux Inotify
• Linux Timefd
• Process Output
• Process Run
• Read Dir
• Read File
• Simple Client
• Simple Server
• Stdin to Stdout
• Tcp Client
• Tcp Server
• Thread Pool
• Timer Sleep
• Timer Timeout
• TLS Client
• TLS Server
• Unix Signal
• Web Crawler
• Websocket Client
• WebSocket Server
• Windows Uds

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}