Tokio (software)
![]() | |
Original author(s) | Carl Lerche |
---|---|
Initial release | December 23, 2020 |
Stable release | 1.39.2[1] ![]() |
Repository | |
Written in | Rust |
Operating system | macOS, Windows, Linux, FreeBSD, WebAssembly |
Type | Asynchronous runtime |
License | MIT License |
Website | tokio |
Tokio is a software library for the Rust programming language. It provides a runtime and functions that enable the use of asynchronous I/O, allowing for concurrency in regards to task completion.[2][3][4]
Tokio was released in August 2016 for Rust, a general-purpose programming language. Developed by Carl Lerche, Tokio began as a network application framework and supports features such as socket listening and broadcasting, allowing messages to be transferred between computers.
History
[edit]Tokio began in August 2016 by Carl Lerche as a network application framework for Rust built on futures, allowing for network-based middleware and a non-blocking, or asynchronous, implementation of readiness interest to the reactor. Tokio was inspired by Finagle, a Scala-based asynchronous remote procedure call (RPC) system developed at Twitter for Java virtual machines (JVM), allowing distributed systems to communicate within a JVM. Tokio utilizes the lower-level Rust crate mio
, itself using system calls such as epoll (Linux), kqueue (FreeBSD), and the input/output completion port (IOCP) API (Windows). For Linux it can also use io_uring via tokio-uring.[5][6][7] The name "Tokio" is derived from Tokyo and mio.[8] The preliminary version of Tokio was released in January 2017,[9] followed by a full release in December 2020.[10][11] In 2017, Tokio received a grant from the Mozilla Open Source Support fund.[12] In April 2021, Tokio funded its first paid contributor, Alice Ryhl, for her work both developing the project and assisting its users.[13][14]
While Rust has supported asynchronous functions since version 1.39, released in November 2019,[15] it provides no facilities to execute them, requiring an external runtime for that purpose.[16] Tokio provides a runtime that uses a multi-threaded work stealing scheduler.[10] Rust's futures are lazily evaluated, requiring functions to call .await
before they do any work.[17] When .await
is invoked, Tokio's runtime may pause the original future until its I/O completes, and unpauses a different task that is ready for further processing.[18]
Users of Tokio include the development teams behind Discord and AWS Lambda.[10] The JavaScript and TypeScript runtime Deno uses Tokio under the hood, in comparison to the JavaScript runtime Node.js, which uses the libuv library.[19]
Features
[edit]Asynchronous code
[edit]Tokio allows for the usage of asynchronous functions in Rust through the creation of an asynchronous runtime. This can be accomplished through the #[tokio::main]
macro.[18]
For example:
#[tokio::main]
async fn main() -> Result<()> {
let url = "http://en.wiki.x.io/";
let text = reqwest::get(url).await?.text().await?;
println!("{}", text);
Ok(())
}
In this example, the reqwest
crate is used to request the HyperText Markup Language (HTML) for English Wikipedia. To ensure that the request is not immediately handled, Tokio wraps the function call into an asynchronous runtime, waiting for the request to complete before calling println()
.
Tokio also includes a version of the Rust standard library that is designed for being used asynchronously. For example, tokio::fs::read_to_end()
, which reads the contents of a file, is the asynchronous version of std::fs::read_to_end()
.[20] In addition, Tokio supports io_uring, a Linux asynchronous I/O syscall interface, in a separate crate named tokio-uring
.[10][21]
The coroutine model
[edit]Tokio further allows users to create tasks, which are stackless coroutines, using a tokio::spawn()
function. Tasks run at the user level, providing concurrency even when there is only a single thread.[22]
Socket listening
[edit]Tokio is capable of listening on a socket through a non-blocking approach.[5] In particular, the TcpListener
structure binds a Transmission Control Protocol (TCP) socket listener to an address and asynchronously executes function.[23]
Broadcasting
[edit]Tokio provides a broadcast channel type, allowing for messages to be broadcast to multiple receivers. Upon sending a message, it is received by such receivers. This enables real-time communication and distributed systems, among other applications.[24]
References
[edit]- ^ "Release 1.39.2". 27 July 2024. Retrieved 28 July 2024.
- ^ Chanda, Abhishek (2018). Network Programming with Rust: Build fast and resilient network servers and clients by leveraging Rust's memory-safety and concurrency features. Birmingham: Packt Publishing. ISBN 978-1-78862-171-7. OCLC 1028194311.
- ^ Sharma, Rahul (2019). Mastering Rust : learn about memory safety, type system, concurrency, and the new features of Rust 2018 edition. Vesa Kaihlavirta (Second ed.). Birmingham, UK. ISBN 978-1-78934-118-8. OCLC 1090681119.
{{cite book}}
: CS1 maint: location missing publisher (link) - ^ De Simone, Sergio (2021-01-06). "Rust Asynchronous Runtime Tokio Reaches 1.0". InfoQ. Retrieved 2021-11-21.
- ^ a b Lerche, Carl (August 3, 2016). "Announcing Tokio". Retrieved December 11, 2022.
- ^ "Finagle: A Protocol-Agnostic RPC System". August 19, 2011. Retrieved December 11, 2022.
- ^ Gomez, Guillaume; Boucher, Antoni (2018). Rust Programming By Example: Enter the World of Rust by Building Engaging, Concurrent, Reactive, and Robust Applications. Birmingham: Packt Publishing. ISBN 9781788470308.
- ^ Lerche, Carl (August 3, 2016). "I enjoyed visiting Tokio (Tokyo) the city and I liked the "io" suffix and how it plays w/ Mio as well. I don't know... naming is hard so I didn't spend too much time thinking about it". Reddit. Retrieved December 11, 2022.
- ^ Lerche, Carl; Crichton, Alex; Turon, Aaron. "Announcing Tokio 0.1". Retrieved December 11, 2022.
- ^ a b c d Krill, Paul (2021-01-08). "Tokio Rust runtime reaches 1.0 status". InfoWorld. Retrieved 2021-09-03.
- ^ Lerche, Carl. "Announcing Tokio 1.0". Retrieved December 11, 2022.
- ^ "Mozilla Awards $365,000 to Open Source Projects as part of MOSS". LWN.net. Retrieved 2021-11-21.
- ^ "Welcoming Alice Ryhl as the first paid Tokio contributor". Tokio. Retrieved 2021-11-28.
- ^ Allen Wyma (12 November 2021). "Tokio Ecosystem with Alice Ryhl". Rustacean Station (Podcast). Retrieved 2021-11-26.
- ^ "Rust Gets Zero-Cost Async/Await Support in Rust 1.39". InfoQ. Retrieved 2021-11-28.
- ^ "The Async Ecosystem". Asynchronous Programming in Rust. Retrieved 2021-11-28.
- ^ Matsakis, Niko (2019-11-07). "Async-await on stable Rust!". Rust Blog. Retrieved 2021-11-28.
- ^ a b "Hello Tokio". Tokio. Retrieved 2021-11-28.
- ^ Rappl Moraza, Florian (2022). Modern Frontend Development with Node.js: A Compendium for Modern JavaScript Web Development Within the Node.js Ecosystem. Birmingham, UK. ISBN 9781804617380.
{{cite book}}
: CS1 maint: location missing publisher (link) - ^ "I/O". Tokio. Retrieved December 11, 2022.
- ^ "Announcing tokio-uring: io-uring support for Tokio". Tokio. Retrieved 2021-11-28.
- ^ Sintes, Tony (April 13, 2001). "Four for the ages". InfoWorld. Retrieved January 5, 2023.
- ^ Eguia Moraza, Iban (2018). Rust high performance : learn to skyrocket the performance of your Rust applications. Birmingham, UK. ISBN 978-1-78847-823-6. OCLC 1033544275.
{{cite book}}
: CS1 maint: location missing publisher (link) - ^ Blandy, Jim; Orendoff, Jason; Tindall, Leonara (2019). Programming Rust. Sebastopol. ISBN 9781492052548.
{{cite book}}
: CS1 maint: location missing publisher (link)
External links
[edit]- Official website
- Tokio on GitHub
- Tokio on crates.io