
    .Ph                     @    d dl Z ddlmZ  G d de j                  ZdS )    N   )urljoinc                   B     e Zd ZdZdZd fd	Z fdZ fdZd Z xZ	S )BaseUrlSessionaq  A Session with a URL that all requests will use as a base.

    Let's start by looking at a few examples:

    .. code-block:: python

        >>> from requests_toolbelt import sessions
        >>> s = sessions.BaseUrlSession(
        ...     base_url='https://example.com/resource/')
        >>> r = s.get('sub-resource/', params={'foo': 'bar'})
        >>> print(r.request.url)
        https://example.com/resource/sub-resource/?foo=bar

    Our call to the ``get`` method will make a request to the URL passed in
    when we created the Session and the partial resource name we provide.
    We implement this by overriding the ``request`` method of the Session.

    Likewise, we override the ``prepare_request`` method so you can construct
    a PreparedRequest in the same way:

    .. code-block:: python

        >>> from requests import Request
        >>> from requests_toolbelt import sessions
        >>> s = sessions.BaseUrlSession(
        ...     base_url='https://example.com/resource/')
        >>> request = Request(method='GET', url='sub-resource/')
        >>> prepared_request = s.prepare_request(request)
        >>> r = s.send(prepared_request)
        >>> print(r.request.url)
        https://example.com/resource/sub-resource

    .. note::

        The base URL that you provide and the path you provide are **very**
        important.

    Let's look at another *similar* example

    .. code-block:: python

        >>> from requests_toolbelt import sessions
        >>> s = sessions.BaseUrlSession(
        ...     base_url='https://example.com/resource/')
        >>> r = s.get('/sub-resource/', params={'foo': 'bar'})
        >>> print(r.request.url)
        https://example.com/sub-resource/?foo=bar

    The key difference here is that we called ``get`` with ``/sub-resource/``,
    i.e., there was a leading ``/``. This changes how we create the URL
    because we rely on :mod:`urllib.parse.urljoin`.

    To override how we generate the URL, sub-class this method and override the
    ``create_url`` method.

    Based on implementation from
    https://github.com/kennethreitz/requests/issues/2554#issuecomment-109341010
    Nc                 h    |r|| _         t          t          |                                            d S N)base_urlsuperr   __init__)selfr	   	__class__s     Z/var/www/html/test/jupyter/venv/lib/python3.11/site-packages/requests_toolbelt/sessions.pyr   zBaseUrlSession.__init__D   s4     	%$DMnd##,,.....    c                 x    |                      |          } t          t          |           j        ||g|R i |S )z3Send the request after generating the complete URL.)
create_urlr
   r   request)r   methodurlargskwargsr   s        r   r   zBaseUrlSession.requestI   sT    ooc""2u^T**2C

 
 
"(
 
 	
r   c                     |                      |j                  |_         t          t          |           j        |g|R i |S )z6Prepare the request after generating the complete URL.)r   r   r
   r   prepare_request)r   r   r   r   r   s       r   r   zBaseUrlSession.prepare_requestP   sV    oogk22:u^T**:

 
 
$
 
 	
r   c                 ,    t          | j        |          S )z+Create the URL based off this partial path.)r   r	   )r   r   s     r   r   zBaseUrlSession.create_urlW   s    t}c***r   r   )
__name__
__module____qualname____doc__r	   r   r   r   r   __classcell__)r   s   @r   r   r      s        9 9v H/ / / / / /

 
 
 
 

 
 
 
 
+ + + + + + +r   r   )requests_compatr   Sessionr    r   r   <module>r#      sa          S+ S+ S+ S+ S+X% S+ S+ S+ S+ S+r   