smol-rs / smol

smol A small and fast async runtime. This crate simply re-exports other smaller async crates (see the source). To use tokio-based libraries with smol, apply the [ ] adapter to futures and I/O types. See the [ ] crate if you want a no proc-macro, fast compiling, easy-to-use async main and/or multi-threaded Executor setup out of the box. Examples Connect to an HTTP website, make a GET request, and pipe the response to the standard output: There's a lot more in the [examples] directory. [ ]: https://docs.rs/async-compat/latest/async_compat/ [ ]: https://docs.rs/smol-macros/latest/smol_macros/ [examples]: https://github.com/smol-rs/smol/tree/master/examples Subcrates • [async-channel] - Multi-producer multi-consumer channels • [async-executor] - Composable async executors • [async-fs] - Async filesystem primitives • [async-io] - Async adapter for I/O types, also timers • [async-lock] - Async locks (barrier, mutex, reader-writer lock, semaphore) • [async-net] - Async networking primitives (TCP/UDP/Unix) • [async-process] - Async interface for working with processes • [async-task] - Task abstraction for building executors • [blocking] - A thread pool for blocking I/O • [futures-lite] - A lighter fork of [futures] • [polling] - Portable interface to epoll, kqueue, event ports, and wepoll [async-io]: https://github.com/smol-rs/async-io [polling]: https://github.com/smol-rs/polling [nb-connect]: https://github.com/smol-rs/nb-connect [async-executor]: https://github.com/smol-rs/async-executor [async-task]: https://github.com/smol-rs/async-task [blocking]: https://github.com/smol-rs/blocking [futures-lite]: https://github.com/smol-rs/futures-lite [smol]: https://github.com/smol-rs/smol [async-net]: https://github.com/smol-rs/async-net [async-process]: https://github.com/smol-rs/async-process [async-fs]: https://github.com/smol-rs/async-fs [async-channel]: https://github.com/smol-rs/async-channel [concurrent-queue]: https://github.com/smol-rs/concurrent-queue [event-listener]: https://github.com/smol-rs/event-listener [async-lock]: https://github.com/smol-rs/async-lock [fastrand]: https://github.com/smol-rs/fastrand [futures]: https://github.com/rust-lang/futures-rs TLS certificate Some code examples are using TLS for authentication. The repository contains a self-signed certificate usable for testing, but it should **not** be used for real-world scenarios. Browsers and tools like curl will show this certificate as insecure. In browsers, accept the security prompt or use on the command line to bypass security warnings. The certificate file was generated using minica and openssl: Another useful tool for making certificates is [mkcert]. [mkcert]: https://github.com/FiloSottile/mkcert MSRV Policy The Minimum Supported Rust Version (MSRV) of this crate is **1.85**. As a **tentative** policy, the MSRV will not advance past the current Rust version provided by Debian Stable. At the time of writing, this version of Rust is *1.85*. However, the MSRV may be advanced further in the event of a major ecosystem shift or a security vulnerability. License Licensed under either of • Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0) • MIT license (LICENSE-MIT or http://opensource.org/licenses/MIT) at your option. Contribution Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.