a *Na @s*ddlZddlmZGdddejZdS)N)urljoincs:eZdZdZdZd fdd ZfddZddZZS) BaseUrlSessionaA 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 Ncs|r ||_tt|dS)N)base_urlsuperr__init__)selfr __class__u/private/var/folders/js/6pj4vh5d4zd0k6bxv74qrbhr0000gr/T/pip-target-22xwyzbs/lib/python/requests_toolbelt/sessions.pyr8szBaseUrlSession.__init__cs*||}tt|j||g|Ri|S)z3Send the request after generating the complete URL.) create_urlrrrequest)rmethodurlargskwargsr r r r=s  zBaseUrlSession.requestcCs t|j|S)z+Create the URL based off this partial path.)rr)rrr r r r DszBaseUrlSession.create_url)N) __name__ __module__ __qualname____doc__rrrr __classcell__r r r r rs / r)requests_compatrSessionrr r r r s