FM / util

/usr/lib/python3/dist-packages/urllib3/util/

/usr/lib/python3/dist-packages/urllib3/util

Name	Size	Mode	Actions
__pycache__/	-	0755	rm
connection.py	4892	0644	edit dl rm
proxy.py	1604	0644	edit dl rm
queue.py	471	0644	edit dl rm
request.py	4112	0644	edit dl rm
response.py	3499	0644	edit dl rm
retry.py	21422	0644	edit dl rm
ssltransport.py	6907	0644	edit dl rm
ssl_.py	17094	0644	edit dl rm
timeout.py	10003	0644	edit dl rm
url.py	14014	0644	edit dl rm
wait.py	5404	0644	edit dl rm
__init__.py	1155	0644	edit dl rm

Edit: /usr/lib/python3/dist-packages/urllib3/util/retry.py (21422B)

from __future__ import absolute_import

import email
import logging
import re
import time
import warnings
from collections import namedtuple
from itertools import takewhile

from ..exceptions import (
    ConnectTimeoutError,
    InvalidHeader,
    MaxRetryError,
    ProtocolError,
    ProxyError,
    ReadTimeoutError,
    ResponseError,
)
import six

log = logging.getLogger(__name__)

# Data structure for representing the metadata of requests that result in a retry.
RequestHistory = namedtuple(
    "RequestHistory", ["method", "url", "error", "status", "redirect_location"]
)

# TODO: In v2 we can remove this sentinel and metaclass with deprecated options.
_Default = object()

class _RetryMeta(type):
    @property
    def DEFAULT_METHOD_WHITELIST(cls):
        warnings.warn(
            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
            "will be removed in v2.0. Use 'Retry.DEFAULT_METHODS_ALLOWED' instead",
            DeprecationWarning,
        )
        return cls.DEFAULT_ALLOWED_METHODS

@DEFAULT_METHOD_WHITELIST.setter
    def DEFAULT_METHOD_WHITELIST(cls, value):
        warnings.warn(
            "Using 'Retry.DEFAULT_METHOD_WHITELIST' is deprecated and "
            "will be removed in v2.0. Use 'Retry.DEFAULT_ALLOWED_METHODS' instead",
            DeprecationWarning,
        )
        cls.DEFAULT_ALLOWED_METHODS = value

@property
    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls):
        warnings.warn(
            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
            DeprecationWarning,
        )
        return cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT

@DEFAULT_REDIRECT_HEADERS_BLACKLIST.setter
    def DEFAULT_REDIRECT_HEADERS_BLACKLIST(cls, value):
        warnings.warn(
            "Using 'Retry.DEFAULT_REDIRECT_HEADERS_BLACKLIST' is deprecated and "
            "will be removed in v2.0. Use 'Retry.DEFAULT_REMOVE_HEADERS_ON_REDIRECT' instead",
            DeprecationWarning,
        )
        cls.DEFAULT_REMOVE_HEADERS_ON_REDIRECT = value

@six.add_metaclass(_RetryMeta)
class Retry(object):
    """Retry configuration.

Each retry attempt will create a new Retry object with updated values, so
    they can be safely reused.

Retries can be defined as a default for a pool::

retries = Retry(connect=5, read=2, redirect=5)
        http = PoolManager(retries=retries)
        response = http.request('GET', 'http://example.com/')

Or per-request (which overrides the default for the pool)::

response = http.request('GET', 'http://example.com/', retries=Retry(10))

Retries can be disabled by passing ``False``::

response = http.request('GET', 'http://example.com/', retries=False)

Errors will be wrapped in :class:`~urllib3.exceptions.MaxRetryError` unless
    retries are disabled, in which case the causing exception will be raised.

:param int total:
        Total number of retries to allow. Takes precedence over other counts.

Set to ``None`` to remove this constraint and fall back on other
        counts.

Set to ``0`` to fail on the first retry.

Set to ``False`` to disable and imply ``raise_on_redirect=False``.

:param int connect:
        How many connection-related errors to retry on.

These are errors raised before the request is sent to the remote server,
        which we assume has not triggered the server to process the request.