pywry.auth.callback_server¶

Local HTTP callback server for OAuth2 redirect handling in native mode.

OAuthCallbackServer¶

OAuthCallbackServer(host: str = '127.0.0.1', port: int = 0)

Ephemeral localhost HTTP server for capturing OAuth2 redirects.

Parameters:

Name	Type	Description	Default
`host`	`str`	Bind address (default `"127.0.0.1"`).	`'127.0.0.1'`
`port`	`int`	Port number (`0` for auto-assign).	`0`

Initialize the callback server.

redirect_uri: str

Get the redirect URI for this callback server.

Returns:

Type	Description
`str`	The full redirect URI (e.g. `http://127.0.0.1:54321/callback`).

start() -> str

Start the callback server on a daemon thread.

Returns:

Type	Description
`str`	The redirect URI to use with the OAuth2 provider.

wait_for_callback(timeout: float = 120.0) -> dict[str, Any] | None

Block until the callback is received or timeout expires.

Parameters:

Name	Type	Description	Default
`timeout`	`float`	Maximum seconds to wait (default 120).	`120.0`

Returns:

Type	Description
`dict or None`	Callback parameters (`code`, `state`, `error`, `error_description`) or `None` if timeout expired.

stop() -> None

Force-shutdown the callback server.