Enum cookie::Expiration

source · [−]

pub enum Expiration {
    DateTime(OffsetDateTime),
    Session,
}

Expand description

A cookie’s expiration: either session or a date-time.

An Expiration is constructible via Expiration::from() with an Option<OffsetDateTime> or an OffsetDateTime:

None -> Expiration::Session
Some(OffsetDateTime) -> Expiration::DateTime
OffsetDateTime -> Expiration::DateTime

use cookie::Expiration;
use time::OffsetDateTime;

let expires = Expiration::from(None);
assert_eq!(expires, Expiration::Session);

let now = OffsetDateTime::now();
let expires = Expiration::from(now);
assert_eq!(expires, Expiration::DateTime(now));

let expires = Expiration::from(Some(now));
assert_eq!(expires, Expiration::DateTime(now));

Variants

`DateTime(OffsetDateTime)`

Expiration for a “permanent” cookie at a specific date-time.

`Session`

Expiration for a “session” cookie. Browsers define the notion of a “session” and will automatically expire session cookies when they deem the “session” to be over. This is typically, but need not be, when the browser is closed.

Implementations

source

impl Expiration

source

pub fn is_datetime(&self) -> bool

Returns true if self is an Expiration::DateTime.

Example

use cookie::Expiration;
use time::OffsetDateTime;

let expires = Expiration::from(None);
assert!(!expires.is_datetime());

let expires = Expiration::from(OffsetDateTime::now());
assert!(expires.is_datetime());

source

pub fn is_session(&self) -> bool

Returns true if self is an Expiration::Session.

Example

use cookie::Expiration;
use time::OffsetDateTime;

let expires = Expiration::from(None);
assert!(expires.is_session());

let expires = Expiration::from(OffsetDateTime::now());
assert!(!expires.is_session());

source

pub fn datetime(self) -> Option<OffsetDateTime>

Returns the inner OffsetDateTime if self is a DateTime.

Example

use cookie::Expiration;
use time::OffsetDateTime;

let expires = Expiration::from(None);
assert!(expires.datetime().is_none());

let now = OffsetDateTime::now();
let expires = Expiration::from(now);
assert_eq!(expires.datetime(), Some(now));

source

pub fn map<F>(self, f: F) -> Self where
F: FnOnce(OffsetDateTime) -> OffsetDateTime,

Applied f to the inner OffsetDateTime if self is a DateTime and returns the mapped Expiration.

Example

use cookie::Expiration;
use time::{OffsetDateTime, Duration};

let now = OffsetDateTime::now();
let one_week = Duration::weeks(1);

let expires = Expiration::from(now);
assert_eq!(expires.map(|t| t + one_week).datetime(), Some(now + one_week));

let expires = Expiration::from(None);
assert_eq!(expires.map(|t| t + one_week).datetime(), None);