Current File : //usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyc
�
��abc @ 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 <Request>`.
:param method: method for the new :class:`Request` object.
:param url: URL for the new :class:`Request` object.
:param params: (optional) Dictionary or bytes to be sent in the query string for the :class:`Request`.
:param data: (optional) Dictionary or list of tuples ``[(key, value)]`` (will be form-encoded), 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 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) <timeouts>` 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 <Response>` object
:rtype: requests.Response
Usage::
>>> import requests
>>> req = requests.request('GET', 'http://httpbin.org/get')
<Response [200]>
t methodt urlN( R t Sessiont request( R R t kwargst session( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR s )c K s& | j d t � t d | d | | �S( sO Sends a GET request.
:param url: URL for the new :class:`Request` object.
:param params: (optional) Dictionary or bytes to be sent in the query string for the :class:`Request`.
:param \*\*kwargs: Optional arguments that ``request`` takes.
:return: :class:`Response <Response>` object
:rtype: requests.Response
t allow_redirectst gett params( t
setdefaultt TrueR ( R R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/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 <Response>` object
:rtype: requests.Response
R t options( R
R R ( R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR K 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 <Response>` object
:rtype: requests.Response
R t head( R
t FalseR ( R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR
X 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 (will be form-encoded), 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 <Response>` object
:rtype: requests.Response
t postt datat json( R ( R R R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR e 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 (will be form-encoded), 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 <Response>` object
:rtype: requests.Response
t putR ( R ( R R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR s 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 (will be form-encoded), 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 <Response>` object
:rtype: requests.Response
t patchR ( R ( R R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/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 <Response>` object
:rtype: requests.Response
t delete( R ( R R ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyR � s N( t __doc__t R R t NoneR R R
R R R R ( ( ( s< /usr/lib/python2.7/site-packages/pip/_vendor/requests/api.pyt <module> s -
Mini Shell