82c0f78074aceb90293a45e0d0b872aaf23163f9
[sdc/sdc-distribution-client.git] /
1 # -*- coding: utf-8 -*-
2
3 #   __
4 #  /__)  _  _     _   _ _/   _
5 # / (   (- (/ (/ (- _)  /  _)
6 #          /
7
8 """
9 Requests HTTP library
10 ~~~~~~~~~~~~~~~~~~~~~
11
12 Requests is an HTTP library, written in Python, for human beings. Basic GET
13 usage:
14
15    >>> import requests
16    >>> r = requests.get('https://www.python.org')
17    >>> r.status_code
18    200
19    >>> 'Python is a programming language' in r.content
20    True
21
22 ... or POST:
23
24    >>> payload = dict(key1='value1', key2='value2')
25    >>> r = requests.post('http://httpbin.org/post', data=payload)
26    >>> print(r.text)
27    {
28      ...
29      "form": {
30        "key2": "value2",
31        "key1": "value1"
32      },
33      ...
34    }
35
36 The other HTTP methods are supported - see `requests.api`. Full documentation
37 is at <http://python-requests.org>.
38
39 :copyright: (c) 2016 by Kenneth Reitz.
40 :license: Apache 2.0, see LICENSE for more details.
41
42 """
43
44 __title__ = 'requests'
45 __version__ = '2.10.0'
46 __build__ = 0x021000
47 __author__ = 'Kenneth Reitz'
48 __license__ = 'Apache 2.0'
49 __copyright__ = 'Copyright 2016 Kenneth Reitz'
50
51 # Attempt to enable urllib3's SNI support, if possible
52 try:
53     from .packages.urllib3.contrib import pyopenssl
54     pyopenssl.inject_into_urllib3()
55 except ImportError:
56     pass
57
58 import warnings
59
60 # urllib3's DependencyWarnings should be silenced.
61 from .packages.urllib3.exceptions import DependencyWarning
62 warnings.simplefilter('ignore', DependencyWarning)
63
64 from . import utils
65 from .models import Request, Response, PreparedRequest
66 from .api import request, get, head, post, patch, put, delete, options
67 from .sessions import session, Session
68 from .status_codes import codes
69 from .exceptions import (
70     RequestException, Timeout, URLRequired,
71     TooManyRedirects, HTTPError, ConnectionError,
72     FileModeWarning, ConnectTimeout, ReadTimeout
73 )
74
75 # Set default logging handler to avoid "No handler found" warnings.
76 import logging
77 try:  # Python 2.7+
78     from logging import NullHandler
79 except ImportError:
80     class NullHandler(logging.Handler):
81         def emit(self, record):
82             pass
83
84 logging.getLogger(__name__).addHandler(NullHandler())
85
86 import warnings
87
88 # FileModeWarnings go off per the default.
89 warnings.simplefilter('default', FileModeWarning, append=True)