Enum cookie::Expiration

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

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

impl Expiration

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());

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());

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));

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);

Trait Implementations

impl Clone for Expiration

fn clone(&self) -> Expiration

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Expiration

impl Debug for Expiration

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

Formats the value using the given formatter.

impl Eq for Expiration

impl<T: Into<Option<OffsetDateTime>>> From<T> for Expiration

fn from(option: T) -> Self

Performs the conversion.

impl Hash for Expiration

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

pub fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Expiration> for Expiration

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralEq for Expiration

impl StructuralPartialEq for Expiration