Struct Cookie 

pub struct Cookie { /* private fields */ }

Cookie builder with fluent API

Example

use ferro_rs::Cookie;
use std::time::Duration;

let cookie = Cookie::new("session", "abc123")
    .http_only(true)
    .secure(true)
    .max_age(Duration::from_secs(3600));

Implementations

impl Cookie

pub fn new(name: impl Into<String>, value: impl Into<String>) -> Self

Create a new cookie with the given name and value

Default options:

• HttpOnly: true
• Secure: true
• SameSite: Lax
• Path: “/”

pub fn name(&self) -> &str

Get the cookie name

pub fn value(&self) -> &str

Get the cookie value

pub fn http_only(self, value: bool) -> Self

Set the HttpOnly flag (default: true)

HttpOnly cookies are not accessible via JavaScript, protecting against XSS.

pub fn secure(self, value: bool) -> Self

Set the Secure flag (default: true)

Secure cookies are only sent over HTTPS connections.

pub fn same_site(self, value: SameSite) -> Self

Set the SameSite attribute (default: Lax)

Controls when the cookie is sent with cross-site requests.

pub fn max_age(self, duration: Duration) -> Self

Set the cookie’s max age

The cookie will expire after this duration.

pub fn path(self, path: impl Into<String>) -> Self

Set the cookie path (default: “/”)

pub fn domain(self, domain: impl Into<String>) -> Self

Set the cookie domain

pub fn to_header_value(&self) -> String

Build the Set-Cookie header value

pub fn forget(name: impl Into<String>) -> Self

Create a cookie that deletes itself (for logout)

Example

let forget = Cookie::forget("session");
response.cookie(forget)

pub fn forever(name: impl Into<String>, value: impl Into<String>) -> Self

Create a permanent cookie (5 years)

Trait Implementations

impl Clone for Cookie

fn clone(&self) -> Cookie

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Cookie

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.