2020-10-05 20:53:40 +00:00
|
|
|
# -*- coding: utf-8 -*-
|
|
|
|
|
|
|
|
# __
|
|
|
|
# /__) _ _ _ _ _/ _
|
|
|
|
# / ( (- (/ (/ (- _) / _)
|
|
|
|
# /
|
|
|
|
|
|
|
|
"""
|
2020-10-12 16:10:01 +00:00
|
|
|
Requests HTTP Library
|
2020-10-05 20:53:40 +00:00
|
|
|
~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
|
2020-10-12 16:10:01 +00:00
|
|
|
Requests is an HTTP library, written in Python, for human beings.
|
|
|
|
Basic GET usage:
|
2020-10-05 20:53:40 +00:00
|
|
|
|
|
|
|
>>> import requests
|
|
|
|
>>> r = requests.get('https://www.python.org')
|
|
|
|
>>> r.status_code
|
|
|
|
200
|
2020-10-12 16:10:01 +00:00
|
|
|
>>> b'Python is a programming language' in r.content
|
2020-10-05 20:53:40 +00:00
|
|
|
True
|
|
|
|
|
|
|
|
... or POST:
|
|
|
|
|
|
|
|
>>> payload = dict(key1='value1', key2='value2')
|
2020-10-12 16:10:01 +00:00
|
|
|
>>> r = requests.post('https://httpbin.org/post', data=payload)
|
2020-10-05 20:53:40 +00:00
|
|
|
>>> print(r.text)
|
|
|
|
{
|
|
|
|
...
|
|
|
|
"form": {
|
2020-10-12 16:10:01 +00:00
|
|
|
"key1": "value1",
|
|
|
|
"key2": "value2"
|
2020-10-05 20:53:40 +00:00
|
|
|
},
|
|
|
|
...
|
|
|
|
}
|
|
|
|
|
|
|
|
The other HTTP methods are supported - see `requests.api`. Full documentation
|
2020-10-12 16:10:01 +00:00
|
|
|
is at <https://requests.readthedocs.io>.
|
2020-10-05 20:53:40 +00:00
|
|
|
|
2020-10-12 16:10:01 +00:00
|
|
|
:copyright: (c) 2017 by Kenneth Reitz.
|
2020-10-05 20:53:40 +00:00
|
|
|
:license: Apache 2.0, see LICENSE for more details.
|
|
|
|
"""
|
|
|
|
|
2020-10-12 16:10:01 +00:00
|
|
|
import urllib3
|
|
|
|
import chardet
|
|
|
|
import warnings
|
|
|
|
from .exceptions import RequestsDependencyWarning
|
|
|
|
|
|
|
|
|
|
|
|
def check_compatibility(urllib3_version, chardet_version):
|
|
|
|
urllib3_version = urllib3_version.split('.')
|
|
|
|
assert urllib3_version != ['dev'] # Verify urllib3 isn't installed from git.
|
|
|
|
|
|
|
|
# Sometimes, urllib3 only reports its version as 16.1.
|
|
|
|
if len(urllib3_version) == 2:
|
|
|
|
urllib3_version.append('0')
|
|
|
|
|
|
|
|
# Check urllib3 for compatibility.
|
|
|
|
major, minor, patch = urllib3_version # noqa: F811
|
|
|
|
major, minor, patch = int(major), int(minor), int(patch)
|
|
|
|
# urllib3 >= 1.21.1, <= 1.25
|
|
|
|
assert major == 1
|
|
|
|
assert minor >= 21
|
|
|
|
assert minor <= 25
|
|
|
|
|
|
|
|
# Check chardet for compatibility.
|
|
|
|
major, minor, patch = chardet_version.split('.')[:3]
|
|
|
|
major, minor, patch = int(major), int(minor), int(patch)
|
|
|
|
# chardet >= 3.0.2, < 3.1.0
|
|
|
|
assert major == 3
|
|
|
|
assert minor < 1
|
|
|
|
assert patch >= 2
|
|
|
|
|
|
|
|
|
|
|
|
def _check_cryptography(cryptography_version):
|
|
|
|
# cryptography < 1.3.4
|
|
|
|
try:
|
|
|
|
cryptography_version = list(map(int, cryptography_version.split('.')))
|
|
|
|
except ValueError:
|
|
|
|
return
|
|
|
|
|
|
|
|
if cryptography_version < [1, 3, 4]:
|
|
|
|
warning = 'Old version of cryptography ({}) may cause slowdown.'.format(cryptography_version)
|
|
|
|
warnings.warn(warning, RequestsDependencyWarning)
|
|
|
|
|
|
|
|
# Check imported dependencies for compatibility.
|
2020-10-05 20:53:40 +00:00
|
|
|
try:
|
2020-10-12 16:10:01 +00:00
|
|
|
check_compatibility(urllib3.__version__, chardet.__version__)
|
|
|
|
except (AssertionError, ValueError):
|
|
|
|
warnings.warn("urllib3 ({}) or chardet ({}) doesn't match a supported "
|
|
|
|
"version!".format(urllib3.__version__, chardet.__version__),
|
|
|
|
RequestsDependencyWarning)
|
|
|
|
|
|
|
|
# Attempt to enable urllib3's fallback for SNI support
|
|
|
|
# if the standard library doesn't support SNI or the
|
|
|
|
# 'ssl' library isn't available.
|
|
|
|
try:
|
|
|
|
try:
|
|
|
|
import ssl
|
|
|
|
except ImportError:
|
|
|
|
ssl = None
|
|
|
|
|
|
|
|
if not getattr(ssl, "HAS_SNI", False):
|
|
|
|
from urllib3.contrib import pyopenssl
|
|
|
|
pyopenssl.inject_into_urllib3()
|
|
|
|
|
|
|
|
# Check cryptography version
|
|
|
|
from cryptography import __version__ as cryptography_version
|
|
|
|
_check_cryptography(cryptography_version)
|
2020-10-05 20:53:40 +00:00
|
|
|
except ImportError:
|
|
|
|
pass
|
|
|
|
|
|
|
|
# urllib3's DependencyWarnings should be silenced.
|
2020-10-12 16:10:01 +00:00
|
|
|
from urllib3.exceptions import DependencyWarning
|
2020-10-05 20:53:40 +00:00
|
|
|
warnings.simplefilter('ignore', DependencyWarning)
|
|
|
|
|
2020-10-12 16:10:01 +00:00
|
|
|
from .__version__ import __title__, __description__, __url__, __version__
|
|
|
|
from .__version__ import __build__, __author__, __author_email__, __license__
|
|
|
|
from .__version__ import __copyright__, __cake__
|
|
|
|
|
2020-10-05 20:53:40 +00:00
|
|
|
from . import utils
|
2020-10-12 16:10:01 +00:00
|
|
|
from . import packages
|
2020-10-05 20:53:40 +00:00
|
|
|
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
|
|
|
|
from .exceptions import (
|
|
|
|
RequestException, Timeout, URLRequired,
|
|
|
|
TooManyRedirects, HTTPError, ConnectionError,
|
|
|
|
FileModeWarning, ConnectTimeout, ReadTimeout
|
|
|
|
)
|
|
|
|
|
|
|
|
# Set default logging handler to avoid "No handler found" warnings.
|
|
|
|
import logging
|
2020-10-12 16:10:01 +00:00
|
|
|
from logging import NullHandler
|
2020-10-05 20:53:40 +00:00
|
|
|
|
|
|
|
logging.getLogger(__name__).addHandler(NullHandler())
|
|
|
|
|
|
|
|
# FileModeWarnings go off per the default.
|
|
|
|
warnings.simplefilter('default', FileModeWarning, append=True)
|