request_url() — requests Function Reference

Architecture documentation for the request_url() function in adapters.py from the requests codebase.

Function python CoreAPI SessionLifecycle calls 2 called by 1

Entity Profile

CoreAPI→ SessionLifecycle→ request_url() — requests Function Reference

Dependency Diagram

graph TD
  19bcbaca_551c_4599_bbfe_015fc1d38ffa["request_url()"]
  5fdf5d52_8295_768a_e20f_c6cefb721b91["HTTPAdapter"]
  19bcbaca_551c_4599_bbfe_015fc1d38ffa -->|defined in| 5fdf5d52_8295_768a_e20f_c6cefb721b91
  66fc1563_b020_b369_a505_bc9abe7cf66d["send()"]
  66fc1563_b020_b369_a505_bc9abe7cf66d -->|calls| 19bcbaca_551c_4599_bbfe_015fc1d38ffa
  60571fa2_2c29_a402_f268_a16ac679a1da["select_proxy()"]
  19bcbaca_551c_4599_bbfe_015fc1d38ffa -->|calls| 60571fa2_2c29_a402_f268_a16ac679a1da
  854e0492_04c3_d168_774f_5fad19ef1319["urldefragauth()"]
  19bcbaca_551c_4599_bbfe_015fc1d38ffa -->|calls| 854e0492_04c3_d168_774f_5fad19ef1319
  style 19bcbaca_551c_4599_bbfe_015fc1d38ffa fill:#6366f1,stroke:#818cf8,color:#fff

Relationship Graph

Source Code

src/requests/adapters.py lines 525–555

    def request_url(self, request, proxies):
        """Obtain the url to use when making the final request.

        If the message is being sent through a HTTP proxy, the full URL has to
        be used. Otherwise, we should only use the path portion of the URL.

        This should not be called from user code, and is only exposed for use
        when subclassing the
        :class:`HTTPAdapter <requests.adapters.HTTPAdapter>`.

        :param request: The :class:`PreparedRequest <PreparedRequest>` being sent.
        :param proxies: A dictionary of schemes or schemes and hosts to proxy URLs.
        :rtype: str
        """
        proxy = select_proxy(request.url, proxies)
        scheme = urlparse(request.url).scheme

        is_proxied_http_request = proxy and scheme != "https"
        using_socks_proxy = False
        if proxy:
            proxy_scheme = urlparse(proxy).scheme.lower()
            using_socks_proxy = proxy_scheme.startswith("socks")

        url = request.path_url
        if url.startswith("//"):  # Don't confuse urllib3
            url = f"/{url.lstrip('/')}"

        if is_proxied_http_request and not using_socks_proxy:
            url = urldefragauth(request.url)

        return url