cookie-rs 0.5.0

library for working with HTTP cookies
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
78
79
80
81
82
83
84
85
86
87
88

use std::error::Error;
use std::fmt;
use std::num::ParseIntError;

#[non_exhaustive]
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ParseError {
    EmptyName,
    MissingPair(MissingPair),
    UnknownAttribute(String),
    ParseMaxAgeError(ParseIntError),
    ParseSameSiteError(ParseSameSiteError),
    ParseDecodeError,
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum ParseSameSiteError {
    UnknownValue(String),
}

#[derive(Debug, Clone, PartialEq, Eq)]
pub enum MissingPair {
    NameValue,
    Domain,
    Expires,
    MaxAge,
    Path,
    SameSite,
}

impl Error for ParseError {}

impl Error for ParseSameSiteError {}

impl From<MissingPair> for ParseError {
    fn from(value: MissingPair) -> Self {
        Self::MissingPair(value)
    }
}

impl From<ParseIntError> for ParseError {
    fn from(value: ParseIntError) -> Self {
        Self::ParseMaxAgeError(value)
    }
}

impl From<ParseSameSiteError> for ParseError {
    fn from(value: ParseSameSiteError) -> Self {
        Self::ParseSameSiteError(value)
    }
}

impl fmt::Display for ParseError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            ParseError::EmptyName => write!(f, "the provided name is empty."),
            ParseError::MissingPair(pair) => write!(f, "missed pair: {pair}"),
            ParseError::UnknownAttribute(attr) => write!(f, "unknown attribute: {attr}"),
            ParseError::ParseMaxAgeError(err) => write!(f, "failed to parse Max-Age: {err}"),
            ParseError::ParseSameSiteError(err) => write!(f, "failed to parse SameSite: {err}"),
            ParseError::ParseDecodeError => write!(f, "failed to decode percent-encoded value."),
        }
    }
}

impl fmt::Display for ParseSameSiteError {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            ParseSameSiteError::UnknownValue(value) => {
                write!(f, "unknown SameSite value: {value}")
            }
        }
    }
}

impl fmt::Display for MissingPair {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        let pair_name = match self {
            MissingPair::NameValue => "Name-Value",
            MissingPair::Domain => "Domain",
            MissingPair::Expires => "Expires",
            MissingPair::MaxAge => "Max-Age",
            MissingPair::Path => "Path",
            MissingPair::SameSite => "SameSite",
        };
        write!(f, "{pair_name}")
    }
}