proxy-watch

The operating system's proxy settings for Python, layered with http_proxy, https_proxy, all_proxy and no_proxy, and the route each URL takes under them. Windows, macOS and Linux (GNOME, KDE) settings are read directly, not through a helper command.

pip install proxy-watch

import proxy_watch

snapshot = proxy_watch.read()
route = snapshot.route("https://example.com/")
if route.kind == "steps":
    print(route.steps)  # ["direct"] or proxy URLs, credentials included
else:
    print(route.kind)   # "pac", "pac-inline" or "wpad": the caller runs the script

snapshot.to_dict() gives the whole configuration as dicts and lists: the mode in effect, each proxy's host, port and credentials, the bypass rules, and every source's own mode. repr() masks passwords; to_dict() holds them.

PAC

route(url, pac=...) chooses who runs a PAC configuration:

script= runs a PAC body you fetched yourself, and wpad=True lets the OS discover one (Windows, macOS). route.engine says which engine answered. QuickJS's default policy answers as if off every network (myIpAddress() is 127.0.0.1 and dnsResolve answers None), so a script that picks a proxy by network needs a PacPolicy that says where the machine is.

Watching

def on_change(err, snapshot):
    if err:
        print(err)
    else:
        print(snapshot.route("https://example.com/").kind)

with proxy_watch.watch(on_change) as watcher:
    ...

on_change runs on the watch's own thread after each change.

Wheels

One abi3 wheel per platform serves CPython 3.10 and later: Linux x86-64 and AArch64 (manylinux2014 and musllinux 1.2), Linux ARMv7 (manylinux2014), macOS x86-64 and arm64, Windows x86-64 and ARM64. QuickJS is built into each of them.

The free-threaded build has no stable ABI before 3.15, so CPython 3.14t takes a wheel of its own on each of those platforms. The module runs without the GIL: importing it leaves sys._is_gil_enabled() false. 3.13t is not supported.

License

MIT OR Apache-2.0. Each wheel carries THIRD-PARTY-LICENSES.txt for the Rust crates, the C sources and the Rust standard library linked into it.