Struct JarCookie 

pub struct JarCookie {
    pub name: String,
    pub value: String,
    pub domain: String,
    pub path: String,
    pub expires: Option<SystemTime>,
    pub secure: bool,
    pub http_only: bool,
    pub creation_time: SystemTime,
}

An enhanced cookie representation using SystemTime for expiration tracking.

This struct provides URL-based matching, Set-Cookie header parsing, and serialization. It is designed to work alongside the existing Cookie from cookie.rs while adding SystemTime-based expiration and simpler URL-based matching.

Fields

name: String

Cookie name

value: String

Cookie value

domain: String

Domain this cookie belongs to (e.g., “example.com”)

path: String

Path scope (usually “/”)

expires: Option<SystemTime>

Expiration time; None means session cookie (no persistent expiry)

secure: bool

Only send over HTTPS connections

http_only: bool

Not accessible to JavaScript (client-side only)

creation_time: SystemTime

When this cookie was created

Implementations

impl JarCookie

pub fn new(name: &str, value: &str, domain: &str) -> Self

Create a new basic session cookie.

Arguments

• name - Cookie name
• value - Cookie value
• domain - Domain the cookie belongs to

pub fn matches_url(&self, url: &str, is_secure: bool) -> bool

Check whether this cookie should be sent for the given URL.

Matching rules:

1. Secure cookies are only sent over HTTPS (is_secure = true)
2. The URL must contain the cookie’s domain
3. The URL must match the cookie’s path scope
4. The cookie must not have expired

Arguments

• url - The request URL string to match against
• is_secure - Whether the connection uses HTTPS

Returns

true if this cookie should be included in requests to the given URL.

pub fn to_header_value(&self) -> String

Format this cookie as a Set-Cookie header value string.

Produces output like: name=value; Domain=example.com; Path=/

pub fn parse_set_cookie(header_value: &str) -> Option<Self>

Parse a cookie from a Set-Cookie response header value.

Supports standard attributes:

• Domain= - cookie domain scope
• Path= - cookie path scope
• Expires= - expiration timestamp (RFC 7231 / RFC 850 / asctime formats)
• Secure - HTTPS-only flag
• HttpOnly - JavaScript-inaccessible flag
• Max-Age= - relative expiration in seconds

Arguments

• header_value - The raw Set-Cookie header value string

Returns

Some(JarCookie) on successful parse, None if the header is malformed.

Example

use aria2_core::http::cookie_storage::JarCookie;

let cookie = JarCookie::parse_set_cookie(
    "session=abc123; Domain=example.com; Path=/; Secure; HttpOnly"
).unwrap();
assert_eq!(cookie.name, "session");
assert_eq!(cookie.domain, "example.com");
assert!(cookie.secure);
assert!(cookie.http_only);

Trait Implementations

impl Clone for JarCookie

fn clone(&self) -> JarCookie

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for JarCookie

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for JarCookie

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for JarCookie

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for JarCookie

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.