orionis.view.globals.url

THE ORIONIS API

Build with clarity.

Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.

module documentation

(source)

Undocumented

Async Function	`_absolute_url`	Build a URL from a path, prefixing the current request base URL.
Async Function	`_request_base_url`	Return the base URL of the request currently in scope.
Function	`_to_secure_url`	Rewrite an already built URL so it uses the HTTPS scheme.
Constant	`_ABSOLUTE_PREFIXES`	Undocumented
Constant	`_INSECURE_PREFIX`	Undocumented
Constant	`_SCHEMELESS_PREFIX`	Undocumented
Constant	`_SECURE_PREFIX`	Undocumented

async def _absolute_url(app: IApplication, path: str, query: dict[str, Any]) -> str: (source) ¶

Build a URL from a path, prefixing the current request base URL.

Parameters
app:`IApplication`	Application container used for service resolution.
path:`str`	Absolute URL or application-relative path.
query:`dict[str, Any]`	Query string values appended to the resulting URL.

Returns
`str`	Absolute URL when a request is in scope, otherwise the normalised path.

async def _request_base_url(app: IApplication) -> str: (source) ¶

Return the base URL of the request currently in scope.

Parameters
app:`IApplication`	Application container used for service resolution.

Returns
`str`	Base URL without a trailing slash, or an empty string when no request is in scope.

def _to_secure_url(url: str) -> str: (source) ¶

Rewrite an already built URL so it uses the HTTPS scheme.

Parameters
url:`str`	URL to normalise. Relative paths and HTTPS URLs are returned untouched, since no host can be inferred for the former.

Returns
`str`	URL served over HTTPS whenever a host is present.

_ABSOLUTE_PREFIXES: tuple[str, ...] = (source) ¶

Undocumented

Value

('http://', 'https://', '//')

Undocumented

Value

'http://'

Undocumented

Value

'//'

Undocumented

Value

'https://'