#cookies #tower #axum

tower-cookies

Cookie manager middleware for tower

16 releases (10 breaking)

0.11.0 Jan 1, 2025
0.10.0 Nov 27, 2023
0.9.0 Feb 12, 2023
0.8.0 Nov 25, 2022
0.3.0 Nov 18, 2021

#28 in HTTP server

Download history 29441/week @ 2025-01-11 24625/week @ 2025-01-18 26600/week @ 2025-01-25 27343/week @ 2025-02-01 30426/week @ 2025-02-08 29286/week @ 2025-02-15 36396/week @ 2025-02-22 37550/week @ 2025-03-01 39932/week @ 2025-03-08 39144/week @ 2025-03-15 25219/week @ 2025-03-22 26728/week @ 2025-03-29 25554/week @ 2025-04-05 21098/week @ 2025-04-12 25122/week @ 2025-04-19 23783/week @ 2025-04-26

100,799 downloads per month
Used in 68 crates (28 directly)

MIT license

26KB
453 lines

License Crates.io Docs.rs

tower-cookies

A cookie manager middleware built on top of tower.

Example

With axum:

use axum::{routing::get, Router};
use std::net::SocketAddr;
use tower_cookies::{Cookie, CookieManagerLayer, Cookies};

#[tokio::main]
async fn main() {
    let app = Router::new()
        .route("/", get(handler))
        .layer(CookieManagerLayer::new());

    let addr = SocketAddr::from(([127, 0, 0, 1], 3000));
    let listener = tokio::net::TcpListener::bind(&addr).await.unwrap();
    axum::serve(listener, app.into_make_service())
        .await
        .unwrap();
}

async fn handler(cookies: Cookies) -> &'static str {
    cookies.add(Cookie::new("hello_world", "hello_world"));

    "Check your cookies."
}

A complete CRUD cookie example in examples/counter.rs

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

Contributing

We appreciate all kinds of contributions, thank you!

Note on README

Most of the readme is automatically copied from the crate documentation by cargo-sync-readme. This way the readme is always in sync with the docs and examples are tested.

So if you find a part of the readme you'd like to change between <!-- cargo-sync-readme start --> and <!-- cargo-sync-readme end --> markers, don't edit README.md directly, but rather change the documentation on top of src/lib.rs and then synchronize the readme with:

cargo sync-readme

(make sure the cargo command is installed):

cargo install cargo-sync-readme

If you have rusty-hook installed the changes will apply automatically on commit.

License

This project is licensed under the MIT license.

Dependencies

~2.6–8MB
~61K SLoC