/usr/lib/python2.7/site-packages/requests
Edit: /usr/lib/python2.7/site-packages/requests/api.pyc (6968B)
ó
æÈ[c @ sq d Z d d l m Z d „ Z d d „ Z d „ Z d „ Z d d d „ Z d d „ Z d d „ Z
d
„ Z d S( sž
requests.api
~~~~~~~~~~~~
This module implements the Requests API.
:copyright: (c) 2012 by Kenneth Reitz.
:license: Apache2, see LICENSE for more details.
i ( t sessionsc
K s2 t j ƒ } | j d | d | | SWd QXd S( s” Constructs and sends a :class:`Request
`.
:param method: method for the new :class:`Request` object.
:param url: URL for the new :class:`Request` object.
:param params: (optional) Dictionary, list of tuples or bytes to send
in the body of the :class:`Request`.
:param data: (optional) Dictionary, list of tuples, bytes, or file-like
object to send in the body of the :class:`Request`.
:param json: (optional) A JSON serializable Python object to send in the body of the :class:`Request`.
:param headers: (optional) Dictionary of HTTP Headers to send with the :class:`Request`.
:param cookies: (optional) Dict or CookieJar object to send with the :class:`Request`.
:param files: (optional) Dictionary of ``'name': file-like-objects`` (or ``{'name': file-tuple}``) for multipart encoding upload.
``file-tuple`` can be a 2-tuple ``('filename', fileobj)``, 3-tuple ``('filename', fileobj, 'content_type')``
or a 4-tuple ``('filename', fileobj, 'content_type', custom_headers)``, where ``'content-type'`` is a string
defining the content type of the given file and ``custom_headers`` a dict-like object containing additional headers
to add for the file.
:param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
:param timeout: (optional) How many seconds to wait for the server to send data
before giving up, as a float, or a :ref:`(connect timeout, read
timeout) ` tuple.
:type timeout: float or tuple
:param allow_redirects: (optional) Boolean. Enable/disable GET/OPTIONS/POST/PUT/PATCH/DELETE/HEAD redirection. Defaults to ``True``.
:type allow_redirects: bool
:param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
:param verify: (optional) Either a boolean, in which case it controls whether we verify
the server's TLS certificate, or a string, in which case it must be a path
to a CA bundle to use. Defaults to ``True``.
:param stream: (optional) if ``False``, the response content will be immediately downloaded.
:param cert: (optional) if String, path to ssl client cert file (.pem). If Tuple, ('cert', 'key') pair.
:return: :class:`Response ` object
:rtype: requests.Response
Usage::
>>> import requests
>>> req = requests.request('GET', 'https://httpbin.org/get')
t methodt urlN( R t Sessiont request( R R t kwargst session( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR s +c K s& | j d t ƒ t d | d | | S( s[ Sends a GET request.
:param url: URL for the new :class:`Request` object.
:param params: (optional) Dictionary, list of tuples or bytes to send
in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
t allow_redirectst gett params( t
setdefaultt TrueR ( R R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR ? s c K s | j d t ƒ t d | | S( sé Sends an OPTIONS request.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
R t options( R
R R ( R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR N s c K s | j d t ƒ t d | | S( så Sends a HEAD request.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
R t head( R
t FalseR ( R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR
[ s c K s t d | d | d | | S( sÀ Sends a POST request.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, list of tuples, bytes, or file-like
object to send in the body of the :class:`Request`.
:param json: (optional) json data to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
t postt datat json( R ( R R R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR h s c K s t d | d | | S( s¿ Sends a PUT request.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, list of tuples, bytes, or file-like
object to send in the body of the :class:`Request`.
:param json: (optional) json data to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
t putR ( R ( R R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR w s c K s t d | d | | S( sÁ Sends a PATCH request.
:param url: URL for the new :class:`Request` object.
:param data: (optional) Dictionary, list of tuples, bytes, or file-like
object to send in the body of the :class:`Request`.
:param json: (optional) json data to send in the body of the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
t patchR ( R ( R R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR † s c K s t d | | S( sç Sends a DELETE request.
:param url: URL for the new :class:`Request` object.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response ` object
:rtype: requests.Response
t delete( R ( R R ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyR • s N( t __doc__t R R t NoneR R R
R R R R ( ( ( s0 /usr/lib/python2.7/site-packages/requests/api.pyt s /