You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1095 lines
33 KiB
1095 lines
33 KiB
"""
|
|
requests.utils
|
|
~~~~~~~~~~~~~~
|
|
|
|
This module provides utility functions that are used within Requests
|
|
that are also useful for external consumption.
|
|
"""
|
|
|
|
import codecs
|
|
import contextlib
|
|
import io
|
|
import os
|
|
import re
|
|
import socket
|
|
import struct
|
|
import sys
|
|
import tempfile
|
|
import warnings
|
|
import zipfile
|
|
from collections import OrderedDict
|
|
|
|
from urllib3.util import make_headers, parse_url
|
|
|
|
from . import certs
|
|
from .__version__ import __version__
|
|
|
|
# to_native_string is unused here, but imported here for backwards compatibility
|
|
from ._internal_utils import ( # noqa: F401
|
|
_HEADER_VALIDATORS_BYTE,
|
|
_HEADER_VALIDATORS_STR,
|
|
HEADER_VALIDATORS,
|
|
to_native_string,
|
|
)
|
|
from .compat import (
|
|
Mapping,
|
|
basestring,
|
|
bytes,
|
|
getproxies,
|
|
getproxies_environment,
|
|
integer_types,
|
|
)
|
|
from .compat import parse_http_list as _parse_list_header
|
|
from .compat import (
|
|
proxy_bypass,
|
|
proxy_bypass_environment,
|
|
quote,
|
|
str,
|
|
unquote,
|
|
urlparse,
|
|
urlunparse,
|
|
)
|
|
from .cookies import cookiejar_from_dict
|
|
from .exceptions import (
|
|
FileModeWarning,
|
|
InvalidHeader,
|
|
InvalidURL,
|
|
UnrewindableBodyError,
|
|
)
|
|
from .structures import CaseInsensitiveDict
|
|
|
|
NETRC_FILES = (".netrc", "_netrc")
|
|
|
|
DEFAULT_CA_BUNDLE_PATH = certs.where()
|
|
|
|
DEFAULT_PORTS = {"http": 80, "https": 443}
|
|
|
|
# Ensure that ', ' is used to preserve previous delimiter behavior.
|
|
DEFAULT_ACCEPT_ENCODING = ", ".join(
|
|
re.split(r",\s*", make_headers(accept_encoding=True)["accept-encoding"])
|
|
)
|
|
|
|
|
|
if sys.platform == "win32":
|
|
# provide a proxy_bypass version on Windows without DNS lookups
|
|
|
|
def proxy_bypass_registry(host):
|
|
try:
|
|
import winreg
|
|
except ImportError:
|
|
return False
|
|
|
|
try:
|
|
internetSettings = winreg.OpenKey(
|
|
winreg.HKEY_CURRENT_USER,
|
|
r"Software\Microsoft\Windows\CurrentVersion\Internet Settings",
|
|
)
|
|
# ProxyEnable could be REG_SZ or REG_DWORD, normalizing it
|
|
proxyEnable = int(winreg.QueryValueEx(internetSettings, "ProxyEnable")[0])
|
|
# ProxyOverride is almost always a string
|
|
proxyOverride = winreg.QueryValueEx(internetSettings, "ProxyOverride")[0]
|
|
except (OSError, ValueError):
|
|
return False
|
|
if not proxyEnable or not proxyOverride:
|
|
return False
|
|
|
|
# make a check value list from the registry entry: replace the
|
|
# '<local>' string by the localhost entry and the corresponding
|
|
# canonical entry.
|
|
proxyOverride = proxyOverride.split(";")
|
|
# now check if we match one of the registry values.
|
|
for test in proxyOverride:
|
|
if test == "<local>":
|
|
if "." not in host:
|
|
return True
|
|
test = test.replace(".", r"\.") # mask dots
|
|
test = test.replace("*", r".*") # change glob sequence
|
|
test = test.replace("?", r".") # change glob char
|
|
if re.match(test, host, re.I):
|
|
return True
|
|
return False
|
|
|
|
def proxy_bypass(host): # noqa
|
|
"""Return True, if the host should be bypassed.
|
|
|
|
Checks proxy settings gathered from the environment, if specified,
|
|
or the registry.
|
|
"""
|
|
if getproxies_environment():
|
|
return proxy_bypass_environment(host)
|
|
else:
|
|
return proxy_bypass_registry(host)
|
|
|
|
|
|
def dict_to_sequence(d):
|
|
"""Returns an internal sequence dictionary update."""
|
|
|
|
if hasattr(d, "items"):
|
|
d = d.items()
|
|
|
|
return d
|
|
|
|
|
|
def super_len(o):
|
|
total_length = None
|
|
current_position = 0
|
|
|
|
if hasattr(o, "__len__"):
|
|
total_length = len(o)
|
|
|
|
elif hasattr(o, "len"):
|
|
total_length = o.len
|
|
|
|
elif hasattr(o, "fileno"):
|
|
try:
|
|
fileno = o.fileno()
|
|
except (io.UnsupportedOperation, AttributeError):
|
|
# AttributeError is a surprising exception, seeing as how we've just checked
|
|
# that `hasattr(o, 'fileno')`. It happens for objects obtained via
|
|
# `Tarfile.extractfile()`, per issue 5229.
|
|
pass
|
|
else:
|
|
total_length = os.fstat(fileno).st_size
|
|
|
|
# Having used fstat to determine the file length, we need to
|
|
# confirm that this file was opened up in binary mode.
|
|
if "b" not in o.mode:
|
|
warnings.warn(
|
|
(
|
|
"Requests has determined the content-length for this "
|
|
"request using the binary size of the file: however, the "
|
|
"file has been opened in text mode (i.e. without the 'b' "
|
|
"flag in the mode). This may lead to an incorrect "
|
|
"content-length. In Requests 3.0, support will be removed "
|
|
"for files in text mode."
|
|
),
|
|
FileModeWarning,
|
|
)
|
|
|
|
if hasattr(o, "tell"):
|
|
try:
|
|
current_position = o.tell()
|
|
except OSError:
|
|
# This can happen in some weird situations, such as when the file
|
|
# is actually a special file descriptor like stdin. In this
|
|
# instance, we don't know what the length is, so set it to zero and
|
|
# let requests chunk it instead.
|
|
if total_length is not None:
|
|
current_position = total_length
|
|
else:
|
|
if hasattr(o, "seek") and total_length is None:
|
|
# StringIO and BytesIO have seek but no usable fileno
|
|
try:
|
|
# seek to end of file
|
|
o.seek(0, 2)
|
|
total_length = o.tell()
|
|
|
|
# seek back to current position to support
|
|
# partially read file-like objects
|
|
o.seek(current_position or 0)
|
|
except OSError:
|
|
total_length = 0
|
|
|
|
if total_length is None:
|
|
total_length = 0
|
|
|
|
return max(0, total_length - current_position)
|
|
|
|
|
|
def get_netrc_auth(url, raise_errors=False):
|
|
"""Returns the Requests tuple auth for a given url from netrc."""
|
|
|
|
netrc_file = os.environ.get("NETRC")
|
|
if netrc_file is not None:
|
|
netrc_locations = (netrc_file,)
|
|
else:
|
|
netrc_locations = (f"~/{f}" for f in NETRC_FILES)
|
|
|
|
try:
|
|
from netrc import NetrcParseError, netrc
|
|
|
|
netrc_path = None
|
|
|
|
for f in netrc_locations:
|
|
try:
|
|
loc = os.path.expanduser(f)
|
|
except KeyError:
|
|
# os.path.expanduser can fail when $HOME is undefined and
|
|
# getpwuid fails. See https://bugs.python.org/issue20164 &
|
|
# https://github.com/psf/requests/issues/1846
|
|
return
|
|
|
|
if os.path.exists(loc):
|
|
netrc_path = loc
|
|
break
|
|
|
|
# Abort early if there isn't one.
|
|
if netrc_path is None:
|
|
return
|
|
|
|
ri = urlparse(url)
|
|
|
|
# Strip port numbers from netloc. This weird `if...encode`` dance is
|
|
# used for Python 3.2, which doesn't support unicode literals.
|
|
splitstr = b":"
|
|
if isinstance(url, str):
|
|
splitstr = splitstr.decode("ascii")
|
|
host = ri.netloc.split(splitstr)[0]
|
|
|
|
try:
|
|
_netrc = netrc(netrc_path).authenticators(host)
|
|
if _netrc:
|
|
# Return with login / password
|
|
login_i = 0 if _netrc[0] else 1
|
|
return (_netrc[login_i], _netrc[2])
|
|
except (NetrcParseError, OSError):
|
|
# If there was a parsing error or a permissions issue reading the file,
|
|
# we'll just skip netrc auth unless explicitly asked to raise errors.
|
|
if raise_errors:
|
|
raise
|
|
|
|
# App Engine hackiness.
|
|
except (ImportError, AttributeError):
|
|
pass
|
|
|
|
|
|
def guess_filename(obj):
|
|
"""Tries to guess the filename of the given object."""
|
|
name = getattr(obj, "name", None)
|
|
if name and isinstance(name, basestring) and name[0] != "<" and name[-1] != ">":
|
|
return os.path.basename(name)
|
|
|
|
|
|
def extract_zipped_paths(path):
|
|
"""Replace nonexistent paths that look like they refer to a member of a zip
|
|
archive with the location of an extracted copy of the target, or else
|
|
just return the provided path unchanged.
|
|
"""
|
|
if os.path.exists(path):
|
|
# this is already a valid path, no need to do anything further
|
|
return path
|
|
|
|
# find the first valid part of the provided path and treat that as a zip archive
|
|
# assume the rest of the path is the name of a member in the archive
|
|
archive, member = os.path.split(path)
|
|
while archive and not os.path.exists(archive):
|
|
archive, prefix = os.path.split(archive)
|
|
if not prefix:
|
|
# If we don't check for an empty prefix after the split (in other words, archive remains unchanged after the split),
|
|
# we _can_ end up in an infinite loop on a rare corner case affecting a small number of users
|
|
break
|
|
member = "/".join([prefix, member])
|
|
|
|
if not zipfile.is_zipfile(archive):
|
|
return path
|
|
|
|
zip_file = zipfile.ZipFile(archive)
|
|
if member not in zip_file.namelist():
|
|
return path
|
|
|
|
# we have a valid zip archive and a valid member of that archive
|
|
tmp = tempfile.gettempdir()
|
|
extracted_path = os.path.join(tmp, member.split("/")[-1])
|
|
if not os.path.exists(extracted_path):
|
|
# use read + write to avoid the creating nested folders, we only want the file, avoids mkdir racing condition
|
|
with atomic_open(extracted_path) as file_handler:
|
|
file_handler.write(zip_file.read(member))
|
|
return extracted_path
|
|
|
|
|
|
@contextlib.contextmanager
|
|
def atomic_open(filename):
|
|
"""Write a file to the disk in an atomic fashion"""
|
|
tmp_descriptor, tmp_name = tempfile.mkstemp(dir=os.path.dirname(filename))
|
|
try:
|
|
with os.fdopen(tmp_descriptor, "wb") as tmp_handler:
|
|
yield tmp_handler
|
|
os.replace(tmp_name, filename)
|
|
except BaseException:
|
|
os.remove(tmp_name)
|
|
raise
|
|
|
|
|
|
def from_key_val_list(value):
|
|
"""Take an object and test to see if it can be represented as a
|
|
dictionary. Unless it can not be represented as such, return an
|
|
OrderedDict, e.g.,
|
|
|
|
::
|
|
|
|
>>> from_key_val_list([('key', 'val')])
|
|
OrderedDict([('key', 'val')])
|
|
>>> from_key_val_list('string')
|
|
Traceback (most recent call last):
|
|
...
|
|
ValueError: cannot encode objects that are not 2-tuples
|
|
>>> from_key_val_list({'key': 'val'})
|
|
OrderedDict([('key', 'val')])
|
|
|
|
:rtype: OrderedDict
|
|
"""
|
|
if value is None:
|
|
return None
|
|
|
|
if isinstance(value, (str, bytes, bool, int)):
|
|
raise ValueError("cannot encode objects that are not 2-tuples")
|
|
|
|
return OrderedDict(value)
|
|
|
|
|
|
def to_key_val_list(value):
|
|
"""Take an object and test to see if it can be represented as a
|
|
dictionary. If it can be, return a list of tuples, e.g.,
|
|
|
|
::
|
|
|
|
>>> to_key_val_list([('key', 'val')])
|
|
[('key', 'val')]
|
|
>>> to_key_val_list({'key': 'val'})
|
|
[('key', 'val')]
|
|
>>> to_key_val_list('string')
|
|
Traceback (most recent call last):
|
|
...
|
|
ValueError: cannot encode objects that are not 2-tuples
|
|
|
|
:rtype: list
|
|
"""
|
|
if value is None:
|
|
return None
|
|
|
|
if isinstance(value, (str, bytes, bool, int)):
|
|
raise ValueError("cannot encode objects that are not 2-tuples")
|
|
|
|
if isinstance(value, Mapping):
|
|
value = value.items()
|
|
|
|
return list(value)
|
|
|
|
|
|
# From mitsuhiko/werkzeug (used with permission).
|
|
def parse_list_header(value):
|
|
"""Parse lists as described by RFC 2068 Section 2.
|
|
|
|
In particular, parse comma-separated lists where the elements of
|
|
the list may include quoted-strings. A quoted-string could
|
|
contain a comma. A non-quoted string could have quotes in the
|
|
middle. Quotes are removed automatically after parsing.
|
|
|
|
It basically works like :func:`parse_set_header` just that items
|
|
may appear multiple times and case sensitivity is preserved.
|
|
|
|
The return value is a standard :class:`list`:
|
|
|
|
>>> parse_list_header('token, "quoted value"')
|
|
['token', 'quoted value']
|
|
|
|
To create a header from the :class:`list` again, use the
|
|
:func:`dump_header` function.
|
|
|
|
:param value: a string with a list header.
|
|
:return: :class:`list`
|
|
:rtype: list
|
|
"""
|
|
result = []
|
|
for item in _parse_list_header(value):
|
|
if item[:1] == item[-1:] == '"':
|
|
item = unquote_header_value(item[1:-1])
|
|
result.append(item)
|
|
return result
|
|
|
|
|
|
# From mitsuhiko/werkzeug (used with permission).
|
|
def parse_dict_header(value):
|
|
"""Parse lists of key, value pairs as described by RFC 2068 Section 2 and
|
|
convert them into a python dict:
|
|
|
|
>>> d = parse_dict_header('foo="is a fish", bar="as well"')
|
|
>>> type(d) is dict
|
|
True
|
|
>>> sorted(d.items())
|
|
[('bar', 'as well'), ('foo', 'is a fish')]
|
|
|
|
If there is no value for a key it will be `None`:
|
|
|
|
>>> parse_dict_header('key_without_value')
|
|
{'key_without_value': None}
|
|
|
|
To create a header from the :class:`dict` again, use the
|
|
:func:`dump_header` function.
|
|
|
|
:param value: a string with a dict header.
|
|
:return: :class:`dict`
|
|
:rtype: dict
|
|
"""
|
|
result = {}
|
|
for item in _parse_list_header(value):
|
|
if "=" not in item:
|
|
result[item] = None
|
|
continue
|
|
name, value = item.split("=", 1)
|
|
if value[:1] == value[-1:] == '"':
|
|
value = unquote_header_value(value[1:-1])
|
|
result[name] = value
|
|
return result
|
|
|
|
|
|
# From mitsuhiko/werkzeug (used with permission).
|
|
def unquote_header_value(value, is_filename=False):
|
|
r"""Unquotes a header value. (Reversal of :func:`quote_header_value`).
|
|
This does not use the real unquoting but what browsers are actually
|
|
using for quoting.
|
|
|
|
:param value: the header value to unquote.
|
|
:rtype: str
|
|
"""
|
|
if value and value[0] == value[-1] == '"':
|
|
# this is not the real unquoting, but fixing this so that the
|
|
# RFC is met will result in bugs with internet explorer and
|
|
# probably some other browsers as well. IE for example is
|
|
# uploading files with "C:\foo\bar.txt" as filename
|
|
value = value[1:-1]
|
|
|
|
# if this is a filename and the starting characters look like
|
|
# a UNC path, then just return the value without quotes. Using the
|
|
# replace sequence below on a UNC path has the effect of turning
|
|
# the leading double slash into a single slash and then
|
|
# _fix_ie_filename() doesn't work correctly. See #458.
|
|
if not is_filename or value[:2] != "\\\\":
|
|
return value.replace("\\\\", "\\").replace('\\"', '"')
|
|
return value
|
|
|
|
|
|
def dict_from_cookiejar(cj):
|
|
"""Returns a key/value dictionary from a CookieJar.
|
|
|
|
:param cj: CookieJar object to extract cookies from.
|
|
:rtype: dict
|
|
"""
|
|
|
|
cookie_dict = {}
|
|
|
|
for cookie in cj:
|
|
cookie_dict[cookie.name] = cookie.value
|
|
|
|
return cookie_dict
|
|
|
|
|
|
def add_dict_to_cookiejar(cj, cookie_dict):
|
|
"""Returns a CookieJar from a key/value dictionary.
|
|
|
|
:param cj: CookieJar to insert cookies into.
|
|
:param cookie_dict: Dict of key/values to insert into CookieJar.
|
|
:rtype: CookieJar
|
|
"""
|
|
|
|
return cookiejar_from_dict(cookie_dict, cj)
|
|
|
|
|
|
def get_encodings_from_content(content):
|
|
"""Returns encodings from given content string.
|
|
|
|
:param content: bytestring to extract encodings from.
|
|
"""
|
|
warnings.warn(
|
|
(
|
|
"In requests 3.0, get_encodings_from_content will be removed. For "
|
|
"more information, please see the discussion on issue #2266. (This"
|
|
" warning should only appear once.)"
|
|
),
|
|
DeprecationWarning,
|
|
)
|
|
|
|
charset_re = re.compile(r'<meta.*?charset=["\']*(.+?)["\'>]', flags=re.I)
|
|
pragma_re = re.compile(r'<meta.*?content=["\']*;?charset=(.+?)["\'>]', flags=re.I)
|
|
xml_re = re.compile(r'^<\?xml.*?encoding=["\']*(.+?)["\'>]')
|
|
|
|
return (
|
|
charset_re.findall(content)
|
|
+ pragma_re.findall(content)
|
|
+ xml_re.findall(content)
|
|
)
|
|
|
|
|
|
def _parse_content_type_header(header):
|
|
"""Returns content type and parameters from given header
|
|
|
|
:param header: string
|
|
:return: tuple containing content type and dictionary of
|
|
parameters
|
|
"""
|
|
|
|
tokens = header.split(";")
|
|
content_type, params = tokens[0].strip(), tokens[1:]
|
|
params_dict = {}
|
|
items_to_strip = "\"' "
|
|
|
|
for param in params:
|
|
param = param.strip()
|
|
if param:
|
|
key, value = param, True
|
|
index_of_equals = param.find("=")
|
|
if index_of_equals != -1:
|
|
key = param[:index_of_equals].strip(items_to_strip)
|
|
value = param[index_of_equals + 1 :].strip(items_to_strip)
|
|
params_dict[key.lower()] = value
|
|
return content_type, params_dict
|
|
|
|
|
|
def get_encoding_from_headers(headers):
|
|
"""Returns encodings from given HTTP Header Dict.
|
|
|
|
:param headers: dictionary to extract encoding from.
|
|
:rtype: str
|
|
"""
|
|
|
|
content_type = headers.get("content-type")
|
|
|
|
if not content_type:
|
|
return None
|
|
|
|
content_type, params = _parse_content_type_header(content_type)
|
|
|
|
if "charset" in params:
|
|
return params["charset"].strip("'\"")
|
|
|
|
if "text" in content_type:
|
|
return "ISO-8859-1"
|
|
|
|
if "application/json" in content_type:
|
|
# Assume UTF-8 based on RFC 4627: https://www.ietf.org/rfc/rfc4627.txt since the charset was unset
|
|
return "utf-8"
|
|
|
|
|
|
def stream_decode_response_unicode(iterator, r):
|
|
"""Stream decodes an iterator."""
|
|
|
|
if r.encoding is None:
|
|
yield from iterator
|
|
return
|
|
|
|
decoder = codecs.getincrementaldecoder(r.encoding)(errors="replace")
|
|
for chunk in iterator:
|
|
rv = decoder.decode(chunk)
|
|
if rv:
|
|
yield rv
|
|
rv = decoder.decode(b"", final=True)
|
|
if rv:
|
|
yield rv
|
|
|
|
|
|
def iter_slices(string, slice_length):
|
|
"""Iterate over slices of a string."""
|
|
pos = 0
|
|
if slice_length is None or slice_length <= 0:
|
|
slice_length = len(string)
|
|
while pos < len(string):
|
|
yield string[pos : pos + slice_length]
|
|
pos += slice_length
|
|
|
|
|
|
def get_unicode_from_response(r):
|
|
"""Returns the requested content back in unicode.
|
|
|
|
:param r: Response object to get unicode content from.
|
|
|
|
Tried:
|
|
|
|
1. charset from content-type
|
|
2. fall back and replace all unicode characters
|
|
|
|
:rtype: str
|
|
"""
|
|
warnings.warn(
|
|
(
|
|
"In requests 3.0, get_unicode_from_response will be removed. For "
|
|
"more information, please see the discussion on issue #2266. (This"
|
|
" warning should only appear once.)"
|
|
),
|
|
DeprecationWarning,
|
|
)
|
|
|
|
tried_encodings = []
|
|
|
|
# Try charset from content-type
|
|
encoding = get_encoding_from_headers(r.headers)
|
|
|
|
if encoding:
|
|
try:
|
|
return str(r.content, encoding)
|
|
except UnicodeError:
|
|
tried_encodings.append(encoding)
|
|
|
|
# Fall back:
|
|
try:
|
|
return str(r.content, encoding, errors="replace")
|
|
except TypeError:
|
|
return r.content
|
|
|
|
|
|
# The unreserved URI characters (RFC 3986)
|
|
UNRESERVED_SET = frozenset(
|
|
"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz" + "0123456789-._~"
|
|
)
|
|
|
|
|
|
def unquote_unreserved(uri):
|
|
"""Un-escape any percent-escape sequences in a URI that are unreserved
|
|
characters. This leaves all reserved, illegal and non-ASCII bytes encoded.
|
|
|
|
:rtype: str
|
|
"""
|
|
parts = uri.split("%")
|
|
for i in range(1, len(parts)):
|
|
h = parts[i][0:2]
|
|
if len(h) == 2 and h.isalnum():
|
|
try:
|
|
c = chr(int(h, 16))
|
|
except ValueError:
|
|
raise InvalidURL(f"Invalid percent-escape sequence: '{h}'")
|
|
|
|
if c in UNRESERVED_SET:
|
|
parts[i] = c + parts[i][2:]
|
|
else:
|
|
parts[i] = f"%{parts[i]}"
|
|
else:
|
|
parts[i] = f"%{parts[i]}"
|
|
return "".join(parts)
|
|
|
|
|
|
def requote_uri(uri):
|
|
"""Re-quote the given URI.
|
|
|
|
This function passes the given URI through an unquote/quote cycle to
|
|
ensure that it is fully and consistently quoted.
|
|
|
|
:rtype: str
|
|
"""
|
|
safe_with_percent = "!#$%&'()*+,/:;=?@[]~"
|
|
safe_without_percent = "!#$&'()*+,/:;=?@[]~"
|
|
try:
|
|
# Unquote only the unreserved characters
|
|
# Then quote only illegal characters (do not quote reserved,
|
|
# unreserved, or '%')
|
|
return quote(unquote_unreserved(uri), safe=safe_with_percent)
|
|
except InvalidURL:
|
|
# We couldn't unquote the given URI, so let's try quoting it, but
|
|
# there may be unquoted '%'s in the URI. We need to make sure they're
|
|
# properly quoted so they do not cause issues elsewhere.
|
|
return quote(uri, safe=safe_without_percent)
|
|
|
|
|
|
def address_in_network(ip, net):
|
|
"""This function allows you to check if an IP belongs to a network subnet
|
|
|
|
Example: returns True if ip = 192.168.1.1 and net = 192.168.1.0/24
|
|
returns False if ip = 192.168.1.1 and net = 192.168.100.0/24
|
|
|
|
:rtype: bool
|
|
"""
|
|
ipaddr = struct.unpack("=L", socket.inet_aton(ip))[0]
|
|
netaddr, bits = net.split("/")
|
|
netmask = struct.unpack("=L", socket.inet_aton(dotted_netmask(int(bits))))[0]
|
|
network = struct.unpack("=L", socket.inet_aton(netaddr))[0] & netmask
|
|
return (ipaddr & netmask) == (network & netmask)
|
|
|
|
|
|
def dotted_netmask(mask):
|
|
"""Converts mask from /xx format to xxx.xxx.xxx.xxx
|
|
|
|
Example: if mask is 24 function returns 255.255.255.0
|
|
|
|
:rtype: str
|
|
"""
|
|
bits = 0xFFFFFFFF ^ (1 << 32 - mask) - 1
|
|
return socket.inet_ntoa(struct.pack(">I", bits))
|
|
|
|
|
|
def is_ipv4_address(string_ip):
|
|
"""
|
|
:rtype: bool
|
|
"""
|
|
try:
|
|
socket.inet_aton(string_ip)
|
|
except OSError:
|
|
return False
|
|
return True
|
|
|
|
|
|
def is_valid_cidr(string_network):
|
|
"""
|
|
Very simple check of the cidr format in no_proxy variable.
|
|
|
|
:rtype: bool
|
|
"""
|
|
if string_network.count("/") == 1:
|
|
try:
|
|
mask = int(string_network.split("/")[1])
|
|
except ValueError:
|
|
return False
|
|
|
|
if mask < 1 or mask > 32:
|
|
return False
|
|
|
|
try:
|
|
socket.inet_aton(string_network.split("/")[0])
|
|
except OSError:
|
|
return False
|
|
else:
|
|
return False
|
|
return True
|
|
|
|
|
|
@contextlib.contextmanager
|
|
def set_environ(env_name, value):
|
|
"""Set the environment variable 'env_name' to 'value'
|
|
|
|
Save previous value, yield, and then restore the previous value stored in
|
|
the environment variable 'env_name'.
|
|
|
|
If 'value' is None, do nothing"""
|
|
value_changed = value is not None
|
|
if value_changed:
|
|
old_value = os.environ.get(env_name)
|
|
os.environ[env_name] = value
|
|
try:
|
|
yield
|
|
finally:
|
|
if value_changed:
|
|
if old_value is None:
|
|
del os.environ[env_name]
|
|
else:
|
|
os.environ[env_name] = old_value
|
|
|
|
|
|
def should_bypass_proxies(url, no_proxy):
|
|
"""
|
|
Returns whether we should bypass proxies or not.
|
|
|
|
:rtype: bool
|
|
"""
|
|
# Prioritize lowercase environment variables over uppercase
|
|
# to keep a consistent behaviour with other http projects (curl, wget).
|
|
def get_proxy(key):
|
|
return os.environ.get(key) or os.environ.get(key.upper())
|
|
|
|
# First check whether no_proxy is defined. If it is, check that the URL
|
|
# we're getting isn't in the no_proxy list.
|
|
no_proxy_arg = no_proxy
|
|
if no_proxy is None:
|
|
no_proxy = get_proxy("no_proxy")
|
|
parsed = urlparse(url)
|
|
|
|
if parsed.hostname is None:
|
|
# URLs don't always have hostnames, e.g. file:/// urls.
|
|
return True
|
|
|
|
if no_proxy:
|
|
# We need to check whether we match here. We need to see if we match
|
|
# the end of the hostname, both with and without the port.
|
|
no_proxy = (host for host in no_proxy.replace(" ", "").split(",") if host)
|
|
|
|
if is_ipv4_address(parsed.hostname):
|
|
for proxy_ip in no_proxy:
|
|
if is_valid_cidr(proxy_ip):
|
|
if address_in_network(parsed.hostname, proxy_ip):
|
|
return True
|
|
elif parsed.hostname == proxy_ip:
|
|
# If no_proxy ip was defined in plain IP notation instead of cidr notation &
|
|
# matches the IP of the index
|
|
return True
|
|
else:
|
|
host_with_port = parsed.hostname
|
|
if parsed.port:
|
|
host_with_port += f":{parsed.port}"
|
|
|
|
for host in no_proxy:
|
|
if parsed.hostname.endswith(host) or host_with_port.endswith(host):
|
|
# The URL does match something in no_proxy, so we don't want
|
|
# to apply the proxies on this URL.
|
|
return True
|
|
|
|
with set_environ("no_proxy", no_proxy_arg):
|
|
# parsed.hostname can be `None` in cases such as a file URI.
|
|
try:
|
|
bypass = proxy_bypass(parsed.hostname)
|
|
except (TypeError, socket.gaierror):
|
|
bypass = False
|
|
|
|
if bypass:
|
|
return True
|
|
|
|
return False
|
|
|
|
|
|
def get_environ_proxies(url, no_proxy=None):
|
|
"""
|
|
Return a dict of environment proxies.
|
|
|
|
:rtype: dict
|
|
"""
|
|
if should_bypass_proxies(url, no_proxy=no_proxy):
|
|
return {}
|
|
else:
|
|
return getproxies()
|
|
|
|
|
|
def select_proxy(url, proxies):
|
|
"""Select a proxy for the url, if applicable.
|
|
|
|
:param url: The url being for the request
|
|
:param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
|
|
"""
|
|
proxies = proxies or {}
|
|
urlparts = urlparse(url)
|
|
if urlparts.hostname is None:
|
|
return proxies.get(urlparts.scheme, proxies.get("all"))
|
|
|
|
proxy_keys = [
|
|
urlparts.scheme + "://" + urlparts.hostname,
|
|
urlparts.scheme,
|
|
"all://" + urlparts.hostname,
|
|
"all",
|
|
]
|
|
proxy = None
|
|
for proxy_key in proxy_keys:
|
|
if proxy_key in proxies:
|
|
proxy = proxies[proxy_key]
|
|
break
|
|
|
|
return proxy
|
|
|
|
|
|
def resolve_proxies(request, proxies, trust_env=True):
|
|
"""This method takes proxy information from a request and configuration
|
|
input to resolve a mapping of target proxies. This will consider settings
|
|
such a NO_PROXY to strip proxy configurations.
|
|
|
|
:param request: Request or PreparedRequest
|
|
:param proxies: A dictionary of schemes or schemes and hosts to proxy URLs
|
|
:param trust_env: Boolean declaring whether to trust environment configs
|
|
|
|
:rtype: dict
|
|
"""
|
|
proxies = proxies if proxies is not None else {}
|
|
url = request.url
|
|
scheme = urlparse(url).scheme
|
|
no_proxy = proxies.get("no_proxy")
|
|
new_proxies = proxies.copy()
|
|
|
|
if trust_env and not should_bypass_proxies(url, no_proxy=no_proxy):
|
|
environ_proxies = get_environ_proxies(url, no_proxy=no_proxy)
|
|
|
|
proxy = environ_proxies.get(scheme, environ_proxies.get("all"))
|
|
|
|
if proxy:
|
|
new_proxies.setdefault(scheme, proxy)
|
|
return new_proxies
|
|
|
|
|
|
def default_user_agent(name="python-requests"):
|
|
"""
|
|
Return a string representing the default user agent.
|
|
|
|
:rtype: str
|
|
"""
|
|
return f"{name}/{__version__}"
|
|
|
|
|
|
def default_headers():
|
|
"""
|
|
:rtype: requests.structures.CaseInsensitiveDict
|
|
"""
|
|
return CaseInsensitiveDict(
|
|
{
|
|
"User-Agent": default_user_agent(),
|
|
"Accept-Encoding": DEFAULT_ACCEPT_ENCODING,
|
|
"Accept": "*/*",
|
|
"Connection": "keep-alive",
|
|
}
|
|
)
|
|
|
|
|
|
def parse_header_links(value):
|
|
"""Return a list of parsed link headers proxies.
|
|
|
|
i.e. Link: <http:/.../front.jpeg>; rel=front; type="image/jpeg",<http://.../back.jpeg>; rel=back;type="image/jpeg"
|
|
|
|
:rtype: list
|
|
"""
|
|
|
|
links = []
|
|
|
|
replace_chars = " '\""
|
|
|
|
value = value.strip(replace_chars)
|
|
if not value:
|
|
return links
|
|
|
|
for val in re.split(", *<", value):
|
|
try:
|
|
url, params = val.split(";", 1)
|
|
except ValueError:
|
|
url, params = val, ""
|
|
|
|
link = {"url": url.strip("<> '\"")}
|
|
|
|
for param in params.split(";"):
|
|
try:
|
|
key, value = param.split("=")
|
|
except ValueError:
|
|
break
|
|
|
|
link[key.strip(replace_chars)] = value.strip(replace_chars)
|
|
|
|
links.append(link)
|
|
|
|
return links
|
|
|
|
|
|
# Null bytes; no need to recreate these on each call to guess_json_utf
|
|
_null = "\x00".encode("ascii") # encoding to ASCII for Python 3
|
|
_null2 = _null * 2
|
|
_null3 = _null * 3
|
|
|
|
|
|
def guess_json_utf(data):
|
|
"""
|
|
:rtype: str
|
|
"""
|
|
# JSON always starts with two ASCII characters, so detection is as
|
|
# easy as counting the nulls and from their location and count
|
|
# determine the encoding. Also detect a BOM, if present.
|
|
sample = data[:4]
|
|
if sample in (codecs.BOM_UTF32_LE, codecs.BOM_UTF32_BE):
|
|
return "utf-32" # BOM included
|
|
if sample[:3] == codecs.BOM_UTF8:
|
|
return "utf-8-sig" # BOM included, MS style (discouraged)
|
|
if sample[:2] in (codecs.BOM_UTF16_LE, codecs.BOM_UTF16_BE):
|
|
return "utf-16" # BOM included
|
|
nullcount = sample.count(_null)
|
|
if nullcount == 0:
|
|
return "utf-8"
|
|
if nullcount == 2:
|
|
if sample[::2] == _null2: # 1st and 3rd are null
|
|
return "utf-16-be"
|
|
if sample[1::2] == _null2: # 2nd and 4th are null
|
|
return "utf-16-le"
|
|
# Did not detect 2 valid UTF-16 ascii-range characters
|
|
if nullcount == 3:
|
|
if sample[:3] == _null3:
|
|
return "utf-32-be"
|
|
if sample[1:] == _null3:
|
|
return "utf-32-le"
|
|
# Did not detect a valid UTF-32 ascii-range character
|
|
return None
|
|
|
|
|
|
def prepend_scheme_if_needed(url, new_scheme):
|
|
"""Given a URL that may or may not have a scheme, prepend the given scheme.
|
|
Does not replace a present scheme with the one provided as an argument.
|
|
|
|
:rtype: str
|
|
"""
|
|
parsed = parse_url(url)
|
|
scheme, auth, host, port, path, query, fragment = parsed
|
|
|
|
# A defect in urlparse determines that there isn't a netloc present in some
|
|
# urls. We previously assumed parsing was overly cautious, and swapped the
|
|
# netloc and path. Due to a lack of tests on the original defect, this is
|
|
# maintained with parse_url for backwards compatibility.
|
|
netloc = parsed.netloc
|
|
if not netloc:
|
|
netloc, path = path, netloc
|
|
|
|
if auth:
|
|
# parse_url doesn't provide the netloc with auth
|
|
# so we'll add it ourselves.
|
|
netloc = "@".join([auth, netloc])
|
|
if scheme is None:
|
|
scheme = new_scheme
|
|
if path is None:
|
|
path = ""
|
|
|
|
return urlunparse((scheme, netloc, path, "", query, fragment))
|
|
|
|
|
|
def get_auth_from_url(url):
|
|
"""Given a url with authentication components, extract them into a tuple of
|
|
username,password.
|
|
|
|
:rtype: (str,str)
|
|
"""
|
|
parsed = urlparse(url)
|
|
|
|
try:
|
|
auth = (unquote(parsed.username), unquote(parsed.password))
|
|
except (AttributeError, TypeError):
|
|
auth = ("", "")
|
|
|
|
return auth
|
|
|
|
|
|
def check_header_validity(header):
|
|
"""Verifies that header parts don't contain leading whitespace
|
|
reserved characters, or return characters.
|
|
|
|
:param header: tuple, in the format (name, value).
|
|
"""
|
|
name, value = header
|
|
_validate_header_part(header, name, 0)
|
|
_validate_header_part(header, value, 1)
|
|
|
|
|
|
def _validate_header_part(header, header_part, header_validator_index):
|
|
if isinstance(header_part, str):
|
|
validator = _HEADER_VALIDATORS_STR[header_validator_index]
|
|
elif isinstance(header_part, bytes):
|
|
validator = _HEADER_VALIDATORS_BYTE[header_validator_index]
|
|
else:
|
|
raise InvalidHeader(
|
|
f"Header part ({header_part!r}) from {header} "
|
|
f"must be of type str or bytes, not {type(header_part)}"
|
|
)
|
|
|
|
if not validator.match(header_part):
|
|
header_kind = "name" if header_validator_index == 0 else "value"
|
|
raise InvalidHeader(
|
|
f"Invalid leading whitespace, reserved character(s), or return"
|
|
f"character(s) in header {header_kind}: {header_part!r}"
|
|
)
|
|
|
|
|
|
def urldefragauth(url):
|
|
"""
|
|
Given a url remove the fragment and the authentication part.
|
|
|
|
:rtype: str
|
|
"""
|
|
scheme, netloc, path, params, query, fragment = urlparse(url)
|
|
|
|
# see func:`prepend_scheme_if_needed`
|
|
if not netloc:
|
|
netloc, path = path, netloc
|
|
|
|
netloc = netloc.rsplit("@", 1)[-1]
|
|
|
|
return urlunparse((scheme, netloc, path, params, query, ""))
|
|
|
|
|
|
def rewind_body(prepared_request):
|
|
"""Move file pointer back to its recorded starting position
|
|
so it can be read again on redirect.
|
|
"""
|
|
body_seek = getattr(prepared_request.body, "seek", None)
|
|
if body_seek is not None and isinstance(
|
|
prepared_request._body_position, integer_types
|
|
):
|
|
try:
|
|
body_seek(prepared_request._body_position)
|
|
except OSError:
|
|
raise UnrewindableBodyError(
|
|
"An error occurred when rewinding request body for redirect."
|
|
)
|
|
else:
|
|
raise UnrewindableBodyError("Unable to rewind request body for redirect.")
|