summaryrefslogtreecommitdiffstats
path: root/requests/__init__.py
diff options
context:
space:
mode:
Diffstat (limited to 'requests/__init__.py')
-rw-r--r--requests/__init__.py63
1 files changed, 53 insertions, 10 deletions
diff --git a/requests/__init__.py b/requests/__init__.py
index e3300cf..837f0df 100644
--- a/requests/__init__.py
+++ b/requests/__init__.py
@@ -6,25 +6,57 @@
# /
"""
-requests
-~~~~~~~~
+requests HTTP library
+~~~~~~~~~~~~~~~~~~~~~
-:copyright: (c) 2012 by Kenneth Reitz.
-:license: ISC, see LICENSE for more details.
+Requests is an HTTP library, written in Python, for human beings. Basic GET
+usage:
+
+ >>> import requests
+ >>> r = requests.get('http://python.org')
+ >>> r.status_code
+ 200
+ >>> 'Python is a programming language' in r.content
+ True
+
+... or POST:
+
+ >>> payload = dict(key1='value1', key2='value2')
+ >>> r = requests.post("http://httpbin.org/post", data=payload)
+ >>> print r.text
+ {
+ ...
+ "form": {
+ "key2": "value2",
+ "key1": "value1"
+ },
+ ...
+ }
+
+The other HTTP methods are supported - see `requests.api`. Full documentation
+is at <http://python-requests.org>.
+
+:copyright: (c) 2013 by Kenneth Reitz.
+:license: Apache 2.0, see LICENSE for more details.
"""
__title__ = 'requests'
-__version__ = '0.10.0'
-__build__ = 0x001000
+__version__ = '2.0.0'
+__build__ = 0x020000
__author__ = 'Kenneth Reitz'
-__license__ = 'ISC'
-__copyright__ = 'Copyright 2012 Kenneth Reitz'
-
+__license__ = 'Apache 2.0'
+__copyright__ = 'Copyright 2013 Kenneth Reitz'
+# Attempt to enable urllib3's SNI support, if possible
+try:
+ from .packages.urllib3.contrib import pyopenssl
+ pyopenssl.inject_into_urllib3()
+except ImportError:
+ pass
from . import utils
-from .models import Request, Response
+from .models import Request, Response, PreparedRequest
from .api import request, get, head, post, patch, put, delete, options
from .sessions import session, Session
from .status_codes import codes
@@ -32,3 +64,14 @@ from .exceptions import (
RequestException, Timeout, URLRequired,
TooManyRedirects, HTTPError, ConnectionError
)
+
+# Set default logging handler to avoid "No handler found" warnings.
+import logging
+try: # Python 2.7+
+ from logging import NullHandler
+except ImportError:
+ class NullHandler(logging.Handler):
+ def emit(self, record):
+ pass
+
+logging.getLogger(__name__).addHandler(NullHandler())