select_proxy() — requests Function Reference

Architecture documentation for the select_proxy() function in utils.py from the requests codebase.

Function python CoreAPI SessionLifecycle calls 1 called by 3

Entity Profile

CoreAPI→ SessionLifecycle→ select_proxy() — requests Function Reference

Dependency Diagram

graph TD
  60571fa2_2c29_a402_f268_a16ac679a1da["select_proxy()"]
  2c39b9da_e317_5e6c_bbac_8362bac2110c["utils.py"]
  60571fa2_2c29_a402_f268_a16ac679a1da -->|defined in| 2c39b9da_e317_5e6c_bbac_8362bac2110c
  b63a634d_66d8_29cd_773b_da0e87ccd411["get_connection_with_tls_context()"]
  b63a634d_66d8_29cd_773b_da0e87ccd411 -->|calls| 60571fa2_2c29_a402_f268_a16ac679a1da
  a177b992_27e6_4822_1c3a_48567aa04e20["get_connection()"]
  a177b992_27e6_4822_1c3a_48567aa04e20 -->|calls| 60571fa2_2c29_a402_f268_a16ac679a1da
  19bcbaca_551c_4599_bbfe_015fc1d38ffa["request_url()"]
  19bcbaca_551c_4599_bbfe_015fc1d38ffa -->|calls| 60571fa2_2c29_a402_f268_a16ac679a1da
  3429da06_bfa7_f55e_ca34_e7199d2cf1df["get()"]
  60571fa2_2c29_a402_f268_a16ac679a1da -->|calls| 3429da06_bfa7_f55e_ca34_e7199d2cf1df
  style 60571fa2_2c29_a402_f268_a16ac679a1da fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/requests/utils.py lines 826–849

def select_proxy(url, proxies):
    """Select a proxy for the url, if applicable.

    :param url: The url being for the request
    :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
    """
    proxies = proxies or {}
    urlparts = urlparse(url)
    if urlparts.hostname is None:
        return proxies.get(urlparts.scheme, proxies.get("all"))

    proxy_keys = [
        urlparts.scheme + "://" + urlparts.hostname,
        urlparts.scheme,
        "all://" + urlparts.hostname,
        "all",
    ]
    proxy = None
    for proxy_key in proxy_keys:
        if proxy_key in proxies:
            proxy = proxies[proxy_key]
            break

    return proxy