Adapters¶

Helpers to wire PIA proxy into clients.

httpx¶

Build an httpx.Client(proxies=...) mapping.

Parameters:

Name	Type	Description	Default
`s`	`PiaSettings \| None`	Optional settings. Defaults to :class:`PiaSettings()`.	`None`

Returns:

Type	Description
`dict[str, str]`	Dict mapping scheme to proxy URL (both `http` and `https`).

Examples:

:: >>> True True

Playwright¶

Build a Playwright proxy= dict.

Parameters:

Name	Type	Description	Default
`s`	`PiaSettings \| None`	Optional settings. Defaults to :class:`PiaSettings()`.	`None`

Returns:

Type	Description
`dict[str, Any]`	Dict suitable for `chromium.launch(proxy=...)` or per-context.

Examples:

:: >>> True True

Selenium¶

Mutate Selenium Options to add proxy arguments.

Parameters:

Name	Type	Description	Default
`options`	`Any`	A WebDriver Options object (e.g., `ChromeOptions`).	required
`s`	`PiaSettings \| None`	Optional settings. Defaults to :class:`PiaSettings()`.	`None`

Returns:

Type	Description
`Any`	The same options object (mutated in place).

Notes

For Chrome-family drivers we inject --proxy-server=<url>. For username/password, Selenium often requires using a proxy auth extension or a driver-level auth dialog; many headless environments prefer no auth proxies or pre-configured credentials.

Examples:

:: >>> True True