netscape-cookie-file-parser 0.2.0

Parse Netscape/curl cookie jar files while preserving raw cookie bytes.
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

/// One parsed cookie record from a Netscape cookie file.
///
/// String-like fields are byte buffers rather than `String`s because cookie jar
/// files seen in the wild may contain non-UTF-8 octets.
#[derive(Debug, Clone, PartialEq, Eq)]
pub struct Cookie {
    /// Cookie domain with one leading dot removed, matching curl's behavior.
    pub domain: Vec<u8>,
    /// Whether the original tail-match field was `TRUE`, case-insensitively.
    pub tail_match: bool,
    /// Sanitized cookie path.
    ///
    /// Relative and malformed paths are normalized to `/`; non-root paths have
    /// one trailing slash removed.
    pub path: Vec<u8>,
    /// Whether the original secure field was `TRUE`, case-insensitively.
    pub secure: bool,
    /// Expiration timestamp parsed as an unsigned integer.
    pub expires: u64,
    /// Raw cookie name bytes.
    pub name: Vec<u8>,
    /// Raw cookie value bytes.
    pub value: Vec<u8>,
    /// Whether this line used curl's `#HttpOnly_` cookie marker.
    pub http_only: bool,
    /// Recognized security prefix in the cookie name.
    pub prefix: CookiePrefix,
}

/// Case-sensitive cookie name prefixes recognized by the parser.
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum CookiePrefix {
    /// No recognized cookie prefix.
    None,
    /// Cookie name starts with `__Secure-`.
    Secure,
    /// Cookie name starts with `__Host-`.
    Host,
}

// The prefix checks are intentionally case-sensitive: cookie prefixes are part
// of the cookie name contract, not ordinary case-insensitive cookie metadata.
pub(crate) fn cookie_prefix(name: &[u8]) -> CookiePrefix {
    if name.starts_with(b"__Secure-") {
        CookiePrefix::Secure
    } else if name.starts_with(b"__Host-") {
        CookiePrefix::Host
    } else {
        CookiePrefix::None
    }
}