Proxy auto-config and auto-discovery for Python.
PyPAC: Proxy auto-config for Python
PyPAC is a pure-Python library for finding proxy auto-config (PAC) files and making HTTP requests that respect them. PAC files are often used in organizations that need fine-grained and centralized control of proxy settings. PyPAC supports Python 2.7 and 3.3+.
PyPAC provides a subclass of a Requests Session, so you can start using it immediately, with any PAC file transparently discovered and honoured:
>>> from pypac import PACSession >>> session = PACSession() >>> session.get('http://example.org') ...
If a PAC file isn’t found, then PACSession acts exactly like a regular Session.
PyPAC can find PAC files according to the DNS portion of the Web Proxy Auto-Discovery (WPAD) protocol. On Windows, PyPAC can also obtain the PAC file URL from the Internet Options dialog, via the registry.
Basic proxy authentication can be specified in the PACSession constructor:
>>> from pypac import PACSession >>> from requests.auth import HTTPProxyAuth >>> session = PACSession(proxy_auth=HTTPProxyAuth('user', 'password')) >>> session.get('http://example.org') ...
To use NTLM authentication with proxies, install requests-ntlm and set PACSession.auth to an HttpNtlmAuth instance.
When looking for a PAC file using DNS WPAD, the local machine’s fully-qualified hostname is checked against the Mozilla Public Suffix List to prevent requesting any PAC files outside the scope of the organization. If the hostname’s TLD isn’t in the Public Suffix List, then everything up to the final node is used in the search path. For example, a hostname of foo.bar.local will result in a search for a PAC file from wpad.bar.local and wpad.local.
PyPAC uses the tld library to match TLDs.
The DHCP portion of the Web Proxy Auto-Discovery (WPAD) protocol is not implemented.
PyPAC currently works with Requests by including a subclass of Session. No ready-to-use solutions are included for other HTTP libraries, though PyPAC has all the building blocks needed to make one easily.
Pull requests to add these features are welcome.
- Require Js2Py >= 0.43 for Python 3.6 support, and to avoid needing to monkeypatch out pyimport.
- First release.
Release history Release notifications | RSS feed
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size||File type||Python version||Upload date||Hashes|
|Filename, size pypac-0.2.1-py2.py3-none-any.whl (17.9 kB)||File type Wheel||Python version py2.py3||Upload date||Hashes View|
Hashes for pypac-0.2.1-py2.py3-none-any.whl