pigeon.middleware.components.host¶

Module Contents¶

class pigeon.middleware.components.host.Manager¶

Used to manage settings and load specified middleware which is only loaded at runtime.

To override settings either the method Manager.override or the Manager.__get_attr__ method is used:

# override settings using a module or similar behaving object
my_settings: types.ModuleType = ...
Manager.override(my_settings)

# override settings one at a time by accessing the attributes (__getattr__)
Manager.my_setting = my_value

classmethod override(new_settings: types.ModuleType | Any)¶

Overrides current settings with new settings provided.

Parameters:: new_settings – New settings to override old ones with

class pigeon.middleware.components.host.HTTPRequest(method: str, path: str, headers: dict = None, get: dict = None, data=None, files=None, protocol: str = '1.1', content_type=None, **kwargs)¶

Bases: pigeon.http.message.HTTPMessage

An HTTP message (obv either response or request)

property is_error¶

class pigeon.middleware.components.host.HTTPResponse(headers: dict = None, data: str = None, status: int = 200, cookies=None, protocol: str = '1.1', content_type=None, **kwargs)¶

Bases: pigeon.http.message.HTTPMessage

An HTTP message (obv either response or request)

property is_error¶

pigeon.middleware.components.host.error(code: int, request: pigeon.http.request.HTTPRequest | None = None) → pigeon.http.response.HTTPResponse | str¶: Returns the HTTPResponse for the error code provided, request parameter optional

class pigeon.middleware.components.host.HostComponent¶

Bases: pigeon.middleware.components.MiddlewareComponent

Middleware component that can be used by a preprocessor or postprocessor to process requests.

classmethod preprocess(request: pigeon.http.HTTPRequest) → pigeon.http.HTTPRequest¶

classmethod allowed_host(request: pigeon.http.HTTPRequest) → bool¶: Checks if the Host header in the request has a valid hostname.