Struct CookiePolicy 

pub struct CookiePolicy { /* private fields */ }

Policy governing cookie construction (RFC-006 §4).

Build with CookiePolicy::production_strict for the standard profile, or use the builder methods to customise. HttpOnly=true cannot be disabled (RFC-006 §13.2: “A production profile should reject Secure=false”).

Implementations

impl CookiePolicy

pub fn production_strict(name: impl Into<String>, max_age: Duration) -> Self

Standard production policy: HttpOnly; Secure; SameSite=Strict; Path=/. Domain is omitted to produce a host-only cookie (RFC-006 §5, implementation note: omitting Domain avoids subdomain leakage).

pub fn production_lax(name: impl Into<String>, max_age: Duration) -> Self

Production policy with SameSite=Lax for cross-site top-level flows.

pub fn local_development(name: impl Into<String>, max_age: Duration) -> Self

Development-only policy: Secure=false; SameSite=Lax. The caller must document why this is acceptable; it must not be used in production.

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

Override Path. Defaults to /.

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

Set an explicit Domain attribute. Pass None to produce a host-only cookie (the default and recommended choice).

pub fn name(&self) -> &str

The configured cookie name.

pub fn max_age_duration(&self) -> Duration

The configured max-age as a Duration.

pub fn is_secure(&self) -> bool

Whether this policy requires the Secure attribute.

pub fn build_set_cookie(&self, secret: &str) -> String

Build a Set-Cookie header value that delivers secret to the client.

secret must be the plaintext session or token secret — the only moment it crosses the wire. The caller must not log the returned string.

pub fn build_clear_cookie(&self) -> String

Build a Set-Cookie header value that clears this cookie (e.g. logout).

Uses Max-Age=0 with the same path/domain/name so browsers delete the existing cookie (RFC-006 §4 “clear cookie helper mirrors path/domain/name”).

Trait Implementations

impl Clone for CookiePolicy

fn clone(&self) -> CookiePolicy

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CookiePolicy

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

Formats the value using the given formatter.

impl Eq for CookiePolicy

impl PartialEq for CookiePolicy

fn eq(&self, other: &CookiePolicy) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CookiePolicy