API reference
The in-source rustdoc on docs.rs is the canonical per-item API reference for tako — here is the per-crate link list.
This site is the long-form guide. The canonical, per-item API reference is the in-source rustdoc published on docs.rs. Every public type, trait, function, and feature flag is documented there, generated directly from the source, so it never drifts from the code.
When this site and the rustdoc disagree about a single API, the rustdoc wins — it is generated from the exact released source. This site wins for intent, recommended patterns, and how the pieces fit together.
Where to read it
Application code depends only on the umbrella crate and reaches everything
through the tako::* path, so the umbrella docs are the entry point:
tako-rs— the umbrella. Start here. Everything intended for applications is re-exported undertako::*.
Per-crate rustdoc
The sub-crates are implementation detail — you rarely name them directly — but their rustdoc is published for browsing the source-level layout:
| Crate | docs.rs | Owns |
|---|---|---|
tako-rs | docs.rs/tako-rs | Umbrella re-export (tako::*), cargo features, prelude |
tako-rs-core | docs.rs/tako-rs-core | Router, handlers, middleware/plugin traits, body/request/response, state, signals, queue |
tako-rs-extractors | docs.rs/tako-rs-extractors | Concrete request extractors |
tako-rs-server | docs.rs/tako-rs-server | HTTP/1.1, HTTP/2, HTTP/3, TLS, raw TCP/UDP/Unix, PROXY protocol, compio variants |
tako-rs-streams | docs.rs/tako-rs-streams | WebSocket, SSE, file streaming, static files, WebTransport |
tako-rs-plugins | docs.rs/tako-rs-plugins | Bundled middleware and plugins |
tako-rs-macros | docs.rs/tako-rs-macros | The #[tako::route] / #[tako::get] attribute family |
tako-rs-server-pt | docs.rs/tako-rs-server-pt | Thread-per-core entry point |
Import from the umbrella (tako::router::Router), not the sub-crate
(tako_rs_core::...). Use the migration guide
when upgrading to the 2.1 API.
Building the docs locally
To read the rustdoc for the exact version you depend on, build it from your own checkout:
cargo doc -p tako-rs --no-deps --openAdd the features you use so the gated items appear — for example
--features "http2 tls plugins". See the feature
reference for the full flag list.
Last updated on