cookie-monster 0.2.0

A Cookie library for managing HTTP Cookies, with Axum integration.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77

# cookie-monster
[![CI/CD](https://github.com/joeydewaal/cookie-monster/actions/workflows/ci.yml/badge.svg)](https://github.com/joeydewaal/cookie-monster/actions/workflows/ci.yml)
[![Current Crates.io Version](https://img.shields.io/crates/v/cookie-monster.svg)](https://crates.io/crates/cookie-monster)
[![Documentation](https://docs.rs/cookie-monster/badge.svg)](https://docs.rs/cookie-monster)

A Cookie library for parsing and managing HTTP Cookies.

### Features
* `jiff`, adds support for the [jiff](https://docs.rs/jiff/latest/jiff/) crate.
* `chrono`, adds support for the [chrono](https://docs.rs/chrono/latest/chrono/) crate.
* `time`, adds support for the [time](https://docs.rs/time/latest/time/index.html) crate.
* `percent-encode`, percent-encode/decode cookies.
* `axum`, adds integration with the [axum](https://docs.rs/axum/latest/axum/) crate.
* `http`, adds integration with the [http](https://docs.rs/http/latest/http/) crate.


### Install
```toml
# Cargo.toml
[dependencies]
cookie-monster = "0.1"

# Integration with the `time` crate
cookie-monster = { version = "0.1", features = ["time"] }
# Integration with the`chrono` crate
cookie-monster = { version = "0.1", features = ["chrono"] }
# Integration with the `jiff` crate
cookie-monster = { version = "0.1", features = ["jiff"] }

# Adds support for percent-encoding/decoding cookies.
cookie-monster = { version = "0.1", features = ["percent-encoding"] }

# Integration with the `axum` crate.
cookie-monster = { version = "0.1", features = ["axum"] }

# Integration with the `http` crate.
cookie-monster = { version = "0.1", features = ["http"] }
```

### Axum example

```rust
use axum::response::IntoResponse;
use cookie_monster::{Cookie, CookieJar, SameSite};

static COOKIE_NAME: &str = "session";

async fn handler(mut jar: CookieJar) -> impl IntoResponse {
    if let Some(cookie) = jar.get(COOKIE_NAME) {
        // Remove cookie
        println!("Removing cookie {cookie:?}");
        jar.remove(Cookie::named(COOKIE_NAME));
    } else {
        // Set cookie.
        let cookie = Cookie::build(COOKIE_NAME, "hello, world")
        .http_only()
        .same_site(SameSite::Strict);

        println!("Setting cookie {cookie:?}");
        jar.add(cookie);
    }
    // Return the jar so the cookies are updated
   jar
}
```

### Minimum Supported Rust Version (MSRV)
The cookie-monster crate has rust version 1.85 as MSRV.

### Honorable mention
This crate takes a lot of inspiration from the [cookie](https://crates.io/crates/cookie) crate.


### License
This project is licensed under the [MIT license].

[MIT license]: https://github.com/joeydewaal/cookie-monster/blob/main/LICENSE