mirror of
https://github.com/tower-rs/tower.git
synced 2025-09-27 13:00:43 +00:00
77760198f1
This adds a guide that explains how to implement a middleware from scratch without taking any shortcuts. It walks through implementing `Timeout` as it exists in Tower today. The hope is that once users have read [the previous guide](https://tokio.rs/blog/2021-05-14-inventing-the-service-trait) followed by this one they should be fully equipped to implement their own middleware.
Tower Guides
These guides are meant to be an introduction to Tower. At least basic Rust experience is assumed. Some experience with asynchronous Rust is also recommended. If you're brand new to async Rust, we recommend the Asynchronous Programming in Rust book or the Tokio tutorial.
Additionally, some of these guides explain Tower from the perspective of HTTP servers and clients. However, Tower is useful for any network protocol that follows an async request/response pattern. HTTP is used here because it is a widely known protocol, and one of Tower's more common use-cases.
Guides
- "Inventing the
Servicetrait" walks through how Tower's fundamentalServicetrait could be designed from scratch. If you have no experience with Tower and want to learn the absolute basics, this is where you should start. - "Building a middleware from scratch" walks through how to build the
Timeoutmiddleware as it exists in Tower today, without taking any shortcuts.