HOME

�
bUc@sndZd
dl
mZ
d�Zd�Zd�Zd�Zddd�Zdd�
Z	dd	�
Z
d
�ZdS(s�
requests.api
~~~~~~~~~~~~

This module implements the Requests API.

:copyright: (c) 2012 by Kenneth Reitz.
:license: Apache2, see LICENSE for more details.

i
(
tsessionscKs5tj
�}|jd
|d|
|�}|j�
|S(sPConstructs 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, 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': ('filename', fileobj)}``) for multipart encoding upload.
    :param auth: (optional) Auth tuple to enable Basic/Digest/Custom HTTP Auth.
    :param timeout: (optional) How long to wait for the server to send data
        before giving up, as a float, or a (`connect timeout, read timeout
        <user/advanced.html#timeouts>`_) tuple.
    :type timeout: float or tuple
    :param allow_redirects: (optional) Boolean. Set to True if POST/PUT/DELETE redirect following is allowed.
    :type allow_redirects: bool
    :param proxies: (optional) Dictionary mapping protocol to the URL of the proxy.
    :param verify: (optional) if ``True``, the SSL cert will be verified. A CA_BUNDLE path can also be provided.
    :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]>
    tmethodturl(RtSessiontrequesttclose(R
Rtkwargstsessiontresponse((s0/usr/lib/python2.7/site-packages/requests/api.pyRs 


c
Ks |
jd
t
�
td||
�S(s�Sends a GET 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
    tallow_redirectstget(t
setdefaulttTrueR(RR((s0/usr/lib/python2.7/site-packages/requests/api.pyR
:s	
c
Ks |
jd
t
�
td||
�S(s�Sends a 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	toptions(RRR(RR((s0/usr/lib/python2.7/site-packages/requests/api.pyR
Gs	
c
Ks |
jd
t
�
td||
�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	thead(RtFalseR(RR((s0/usr/lib/python2.7/site-packages/requests/api.pyRTs	
cKstd
|d|
d||�S(s�
Sends a POST request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, 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
    tposttdatatjson(
R(RRRR((s0/usr/lib/python2.7/site-packages/requests/api.pyRascKstd
|d|
|�
S(sT
Sends a PUT request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    tputR(
R(RRR((s0/usr/lib/python2.7/site-packages/requests/api.pyRos
cKstd
|d|
|�
S(sV
Sends a PATCH request.

    :param url: URL for the new :class:`Request` object.
    :param data: (optional) Dictionary, bytes, or file-like object to send in the body of the :class:`Request`.
    :param \*\*kwargs: Optional arguments that ``request`` takes.
    :return: :class:`Response <Response>` object
    :rtype: requests.Response
    tpatchR(
R(RRR((s0/usr/lib/python2.7/site-packages/requests/api.pyR|s
c
Kstd
||
�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
    tdelete(
R(RR((s0/usr/lib/python2.7/site-packages/requests/api.pyR�s	N(t__doc__tRRR
R
RtNoneRRRR(((s0/usr/lib/python2.7/site-packages/requests/api.pyt<module>s	)