3
P\ @ s* d dl Z ddlmZ G dd de jZdS ) N )urljoinc s: e Zd ZdZdZd fdd Z fddZdd Z ZS )
BaseUrlSessiona A Session with a URL that all requests will use as a base.
Let's start by looking at an 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/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 so most uses of a
Session are covered. (This, however, precludes the use of PreparedRequest
objects).
.. 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| j d S )N)base_urlsuperr __init__)selfr ) __class__ /usr/lib/python3.6/sessions.pyr 8 s zBaseUrlSession.__init__c s$ | j |}tt| j||f||S )z3Send the request after generating the complete URL.)
create_urlr r request)r methodurlargskwargs)r r
r r
= s
zBaseUrlSession.requestc C s t | j|S )z+Create the URL based off this partial path.)r r )r r r
r
r r D s zBaseUrlSession.create_url)N) __name__
__module__ __qualname____doc__r r r
r
__classcell__r
r
)r r r s
. r )ZrequestsZ_compatr ZSessionr r
r
r
r s