15 releases (9 breaking)

0.10.0 Nov 27, 2023
0.9.0 Feb 12, 2023
0.8.0 Nov 25, 2022
0.7.0 Jun 9, 2022
0.3.0 Nov 18, 2021

#98 in Web programming

Download history 18080/week @ 2024-08-18 16651/week @ 2024-08-25 16598/week @ 2024-09-01 17472/week @ 2024-09-08 19094/week @ 2024-09-15 19799/week @ 2024-09-22 21008/week @ 2024-09-29 18123/week @ 2024-10-06 18065/week @ 2024-10-13 21669/week @ 2024-10-20 18523/week @ 2024-10-27 23868/week @ 2024-11-03 20336/week @ 2024-11-10 22493/week @ 2024-11-17 19088/week @ 2024-11-24 25057/week @ 2024-12-01

88,023 downloads per month
Used in 53 crates (22 directly)

MIT license

26KB
455 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.7–8.5MB
~75K SLoC