1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55
//! 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 [`async-compat`] adapter to futures and I/O //! types. //! //! # Examples //! //! Connect to an HTTP website, make a GET request, and pipe the response to the standard output: //! //! ``` //! use smol::{io, net, prelude::*, Unblock}; //! //! fn main() -> io::Result<()> { //! smol::block_on(async { //! let mut stream = net::TcpStream::connect("example.com:80").await?; //! let req = b"GET / HTTP/1.1\r\nHost: example.com\r\nConnection: close\r\n\r\n"; //! stream.write_all(req).await?; //! //! let mut stdout = Unblock::new(std::io::stdout()); //! io::copy(stream, &mut stdout).await?; //! Ok(()) //! }) //! } //! ``` //! //! There's a lot more in the [examples] directory. //! //! [`async-compat`]: https://docs.rs/async-compat //! [examples]: https://github.com/stjepang/smol/tree/master/examples //! [get-request]: https://github.com/stjepang/smol/blob/master/examples/get-request.rs #![forbid(unsafe_code)] #![warn(missing_docs, missing_debug_implementations, rust_2018_idioms)] #[cfg(doctest)] doc_comment::doctest!("../README.md"); #[doc(inline)] pub use { async_executor::{Executor, LocalExecutor, Task}, async_io::{block_on, Async, Timer}, blocking::{unblock, Unblock}, futures_lite::{future, io, pin, prelude, ready, stream}, }; #[doc(inline)] pub use { async_channel as channel, async_fs as fs, async_lock as lock, async_net as net, async_process as process, }; mod spawn; pub use spawn::spawn;