File: //usr/local/lib/python3.10/dist-packages/requests_toolbelt/__pycache__/sessions.cpython-310.pyc
o
���g � @ s* d dl Z ddlmZ G dd� de j�ZdS )� N� )�urljoinc sF e Zd ZdZdZd� fdd� Z� fdd�Z� fdd�Zd d
� Z� 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 s |r|| _ tt| ��� d S �N)�base_url�superr �__init__)�selfr �� __class__� �E/usr/local/lib/python3.10/dist-packages/requests_toolbelt/sessions.pyr D s zBaseUrlSession.__init__c s* | � |�}tt| �j||g|�R i |��S )z3Send the request after generating the complete URL.)�
create_urlr r �request)r �method�url�args�kwargsr
r r
r I s
���zBaseUrlSession.requestc s, | � |j�|_tt| �j|g|�R i |��S )z6Prepare the request after generating the complete URL.)r r r r �prepare_request)r r r r r
r r
r P s
���zBaseUrlSession.prepare_requestc C s t | j|�S )z+Create the URL based off this partial path.)r r )r r r r r
r W s zBaseUrlSession.create_urlr )
�__name__�
__module__�__qualname__�__doc__r r r r r �
__classcell__r r r
r
r s ;r )�requests�_compatr �Sessionr r r r r
�<module> s