|
| 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('http://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) 2013 by Kenneth Reitz. |
| 40 | +:license: Apache 2.0, see LICENSE for more details. |
| 41 | +
|
| 42 | +""" |
| 43 | + |
| 44 | +__title__ = 'requests' |
| 45 | +__version__ = '2.0.0' |
| 46 | +__build__ = 0x020000 |
| 47 | +__author__ = 'Kenneth Reitz' |
| 48 | +__license__ = 'Apache 2.0' |
| 49 | +__copyright__ = 'Copyright 2013 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 | +from . import utils |
| 59 | +from .models import Request, Response, PreparedRequest |
| 60 | +from .api import request, get, head, post, patch, put, delete, options |
| 61 | +from .sessions import session, Session |
| 62 | +from .status_codes import codes |
| 63 | +from .exceptions import ( |
| 64 | + RequestException, Timeout, URLRequired, |
| 65 | + TooManyRedirects, HTTPError, ConnectionError |
| 66 | +) |
| 67 | + |
| 68 | +# Set default logging handler to avoid "No handler found" warnings. |
| 69 | +import logging |
| 70 | +try: # Python 2.7+ |
| 71 | + from logging import NullHandler |
| 72 | +except ImportError: |
| 73 | + class NullHandler(logging.Handler): |
| 74 | + def emit(self, record): |
| 75 | + pass |
| 76 | + |
| 77 | +logging.getLogger(__name__).addHandler(NullHandler()) |
0 commit comments