Source API

HeaderParser

class parser_header.HeaderParser(data=None, **kwargs)

Bases: object

Comprehensive HTTP header parser supporting all standard and custom headers.

Initialize HeaderParser.

Parameters:

• data (Optional[InputType]) – Raw header string/bytes

• **kwargs (Any) – Header key-value pairs to set directly Underscores in keys are converted to hyphens e.g., HeaderParser(content_type=”application/json”, user_agent=”Mozilla”)

SPECIAL_HEADERS = {'accept', 'authorization', 'cache-control', 'content-disposition', 'content-type', 'cookie', 'proxy-authenticate', 'set-cookie', 'www-authenticate'}

BOOLEAN_HEADERS = {'dnt', 'sec-gpc', 'upgrade-insecure-requests'}

SEC_CH_UA_PATTERN = re.compile('"([^"]+)";v="([^"]+)"')

__init__(data=None, **kwargs)

Initialize HeaderParser.

Parameters:

• data (str | bytes | None) – Raw header string/bytes

• **kwargs (Any) – Header key-value pairs to set directly Underscores in keys are converted to hyphens e.g., HeaderParser(content_type=”application/json”, user_agent=”Mozilla”)

parse(data=None, **kwargs)

Parse raw HTTP headers into structured dictionary.

Parameters:

• data (str | bytes | None) – Raw header string/bytes

• **kwargs (Any) – Additional headers as key=value pairs Underscores in keys are converted to hyphens

Returns:

Dict with parsed headers

Return type:

Dict[str, Any]

set(name=None, value=None, **kwargs)

Set header(s).

Parameters:

• name (str | None) – Header name (optional if using kwargs)

• value (Any | None) – Header value (required if name is provided)

• **kwargs (Any) – Header key=value pairs Underscores in keys are converted to hyphens

Returns:

self for chaining

Return type:

HeaderParser

Examples

parser.set(‘Content-Type’, ‘application/json’) parser.set(content_type=’application/json’, user_agent=’Mozilla’) parser.set(‘X-Custom’, ‘value’, accept=’/’)

set_raw(name=None, value=None, **kwargs)

Set header(s) without parsing the value.

Parameters:

• name (str | None) – Header name

• value (Any | None) – Header value (stored as-is)

• **kwargs (Any) – Header key=value pairs

Returns:

self for chaining

Return type:

HeaderParser

remove(*names)

Remove header(s) by name.

clear()

Clear all headers.

update(data=None, **kwargs)

Update headers from dict and/or kwargs.

Parameters:

• data (Dict[str, Any] | None) – Dictionary of headers

• **kwargs (Any) – Additional headers

Returns:

self for chaining

Return type:

HeaderParser

get(name, default=None)

Get header value by name (case-insensitive).

__setitem__(name, value)

Set header with bracket notation.

__delitem__(name)

Delete header with bracket notation.

keys()

values()

items()

to_dict(stringify=False)

Get all headers as dictionary.

Parameters:

stringify (bool) – If True, convert all values to strings

to_raw()

Convert parsed headers back to raw format.

to_requests_headers()

Convert to format suitable for requests library.

property cookies: CookieParser

Access cookie parser.

get_cookie(name, default=None)

Get specific cookie value.

set_cookie(name=None, value=None, **kwargs)

Set cookie(s).

Parameters:

• name (str | None) – Cookie name

• value (str | None) – Cookie value

• **kwargs (str) – Cookie key=value pairs

Returns:

self for chaining

Return type:

HeaderParser

get_cookies_as_header()

Get all cookies formatted as Cookie header value.

get_cookies_as_dict()

Get all cookies as dictionary.

property content_type: str | None

Get Content-Type value.

property content_length: int | None

Get Content-Length as integer.

property user_agent: str | None

Get User-Agent value.

property origin: str | None

Get Origin value.

property referer: str | None

Get Referer value.

is_ajax()

Check if request is AJAX/XHR.

is_cors()

Check if request is CORS.

get_sec_fetch_metadata()

Get all Sec-Fetch-* headers.

get_client_hints()

Get all Client Hints (Sec-CH-*) headers.

classmethod from_dict(headers)

Create HeaderParser from dictionary.

classmethod from_kwargs(**kwargs)

Create HeaderParser from keyword arguments.

classmethod from_requests_response(response)

Create HeaderParser from requests Response object.

CookieParser

class parser_header.CookieParser(data=None, **kwargs)

Bases: object

Parser for HTTP cookies with multiple extraction methods.

Initialize CookieParser.

Parameters:

• data (Optional[InputType]) – Raw header string/bytes containing cookie entries

• **kwargs (str) – Cookie key-value pairs to set directly e.g., CookieParser(session=”abc”, user=”john”)

__init__(data=None, **kwargs)

Initialize CookieParser.

Parameters:

• data (str | bytes | None) – Raw header string/bytes containing cookie entries

• **kwargs (str) – Cookie key-value pairs to set directly e.g., CookieParser(session=”abc”, user=”john”)

parse(data=None, **kwargs)

Parse cookies from raw header data and/or kwargs.

Parameters:

• data (str | bytes | None) – Raw header string/bytes containing cookie entries

• **kwargs (str) – Additional cookies as key=value pairs

Returns:

Dict of cookie name-value pairs

Return type:

Dict[str, str]

set(name=None, value=None, **kwargs)

Set cookie(s).

Parameters:

• name (str | None) – Cookie name (optional if using kwargs)

• value (str | None) – Cookie value (required if name is provided)

• **kwargs (str) – Cookie key=value pairs Underscores in keys are converted to hyphens

Returns:

self for chaining

Return type:

CookieParser

Examples

cookies.set(‘session’, ‘abc123’) cookies.set(session=’abc’, user=’john’) cookies.set(‘token’, ‘xyz’, refresh_token=’123’)

remove(*names)

Remove cookie(s) by name.

clear()

Clear all cookies.

update(data=None, **kwargs)

Update cookies from dict and/or kwargs.

Parameters:

• data (Dict[str, str] | None) – Dictionary of cookies

• **kwargs (str) – Additional cookies

Returns:

self for chaining

Return type:

CookieParser

to_cookie_header(data=None, **kwargs)

Convert parsed cookies to Cookie header format.

Parameters:

• data (str | bytes | None) – Optional new data to parse first

• **kwargs (str) – Additional cookies to include

Returns:

Cookie header string (name=value; name2=value2)

Return type:

str

to_dict(data=None, **kwargs)

Get cookies as dictionary.

Parameters:

• data (str | bytes | None) – Optional new data to parse first

• **kwargs (str) – Additional cookies to include

Returns:

Dict of cookie name-value pairs

Return type:

Dict[str, str]

get(name, default=None)

Get a specific cookie value.

__getitem__(name)

Get cookie by name with bracket notation.

__setitem__(name, value)

Set cookie with bracket notation.

__delitem__(name)

Delete cookie with bracket notation.

keys()

values()

items()

classmethod from_dict(cookies)

Create CookieParser from dictionary.

classmethod from_kwargs(**kwargs)

Create CookieParser from keyword arguments.

HeaderValue

class parser_header.HeaderValue(value, params=<factory>)

Bases: object

Represents a parsed header value with optional parameters.

value: str

params: Dict[str, str]

__init__(value, params=<factory>)

Exceptions

class parser_header.exceptions.ParserError

Bases: Exception

Base exception for parser errors.

class parser_header.exceptions.InvalidHeaderError

Bases: ParserError

Raised when header format is invalid.

class parser_header.exceptions.InvalidCookieError

Bases: ParserError

Raised when cookie format is invalid.

class parser_header.exceptions.EncodingError

Bases: ParserError

Raised when encoding/decoding fails.