golden hour

/opt/alt/python37/lib/python3.7/site-packages/pip/_internal/utils

File/Folder	Size	Actions
__init__.py	0 B
__init__.pyc	164 B
__init__.pyo	164 B
__pycache__	-
appdirs.py	1.32 KB
appdirs.pyc	1.78 KB
appdirs.pyo	1.78 KB
compat.py	9.27 KB
compat.pyc	8.62 KB
compat.pyo	8.62 KB
compatibility_tags.py	5.31 KB
compatibility_tags.pyc	4.45 KB
compatibility_tags.pyo	4.45 KB
datetime.py	295 B
datetime.pyc	625 B
datetime.pyo	625 B
deprecation.py	3.24 KB
deprecation.pyc	3.44 KB
deprecation.pyo	3.44 KB
direct_url_helpers.py	4.26 KB
direct_url_helpers.pyc	3.37 KB
direct_url_helpers.pyo	3.24 KB
distutils_args.py	1.32 KB
distutils_args.pyc	1.6 KB
distutils_args.pyo	1.6 KB
encoding.py	1.25 KB
encoding.pyc	1.61 KB
encoding.pyo	1.56 KB
entrypoints.py	1.19 KB
entrypoints.pyc	1.47 KB
entrypoints.pyo	1.47 KB
filesystem.py	6.78 KB
filesystem.pyc	7.4 KB
filesystem.pyo	7.35 KB
filetypes.py	571 B
filetypes.pyc	792 B
filetypes.pyo	792 B
glibc.py	3.22 KB
glibc.pyc	2.19 KB
glibc.pyo	2.19 KB
hashes.py	4.57 KB
hashes.pyc	5.68 KB
hashes.pyo	5.68 KB
inject_securetransport.py	810 B
inject_securetransport.pyc	1.07 KB
inject_securetransport.pyo	1.07 KB
logging.py	12.79 KB
logging.pyc	11.6 KB
logging.pyo	11.6 KB
misc.py	27.67 KB
misc.pyc	32.2 KB
misc.pyo	32.2 KB
models.py	1.17 KB
models.pyc	2.55 KB
models.pyo	2.55 KB
packaging.py	2.96 KB
packaging.pyc	3.27 KB
packaging.pyo	3.27 KB
parallel.py	3.32 KB
parallel.pyc	3.62 KB
parallel.pyo	3.62 KB
pkg_resources.py	1.22 KB
pkg_resources.pyc	2.39 KB
pkg_resources.pyo	2.39 KB
setuptools_build.py	4.94 KB
setuptools_build.pyc	3.83 KB
setuptools_build.pyo	3.75 KB
subprocess.py	9.69 KB
subprocess.pyc	6.77 KB
subprocess.pyo	6.69 KB
temp_dir.py	8.18 KB
temp_dir.pyc	8.75 KB
temp_dir.pyo	8.62 KB
typing.py	1.37 KB
typing.pyc	1.52 KB
typing.pyo	1.52 KB
unpacking.py	9.27 KB
unpacking.pyc	7.83 KB
unpacking.pyo	7.79 KB
urls.py	1.49 KB
urls.pyc	1.94 KB
urls.pyo	1.8 KB
virtualenv.py	3.62 KB
virtualenv.pyc	4.11 KB
virtualenv.pyo	4.11 KB
wheel.py	7.13 KB
wheel.pyc	7.27 KB
wheel.pyo	7.27 KB

Edit: deprecation.py

"""
A module that implements tooling to enable easy warnings about deprecations.
"""

# The following comment should be removed at some point in the future.
# mypy: disallow-untyped-defs=False

from __future__ import absolute_import

import logging
import warnings

from pip._vendor.packaging.version import parse

from pip import __version__ as current_version
from pip._internal.utils.typing import MYPY_CHECK_RUNNING

if MYPY_CHECK_RUNNING:
    from typing import Any, Optional

DEPRECATION_MSG_PREFIX = "DEPRECATION: "

class PipDeprecationWarning(Warning):
    pass

_original_showwarning = None  # type: Any

# Warnings <-> Logging Integration
def _showwarning(message, category, filename, lineno, file=None, line=None):
    if file is not None:
        if _original_showwarning is not None:
            _original_showwarning(
                message, category, filename, lineno, file, line,
            )
    elif issubclass(category, PipDeprecationWarning):
        # We use a specially named logger which will handle all of the
        # deprecation messages for pip.
        logger = logging.getLogger("pip._internal.deprecations")
        logger.warning(message)
    else:
        _original_showwarning(
            message, category, filename, lineno, file, line,
        )

def install_warning_logger():
    # type: () -> None
    # Enable our Deprecation Warnings
    warnings.simplefilter("default", PipDeprecationWarning, append=True)

global _original_showwarning

if _original_showwarning is None:
        _original_showwarning = warnings.showwarning
        warnings.showwarning = _showwarning

def deprecated(reason, replacement, gone_in, issue=None):
    # type: (str, Optional[str], Optional[str], Optional[int]) -> None
    """Helper to deprecate existing functionality.

reason:
        Textual reason shown to the user about why this functionality has
        been deprecated.
    replacement:
        Textual suggestion shown to the user about what alternative
        functionality they can use.
    gone_in:
        The version of pip does this functionality should get removed in.
        Raises errors if pip's current version is greater than or equal to
        this.
    issue:
        Issue number on the tracker that would serve as a useful place for
        users to find related discussion and provide feedback.

Always pass replacement, gone_in and issue as keyword arguments for clarity
    at the call site.
    """

# Construct a nice message.
    #   This is eagerly formatted as we want it to get logged as if someone
    #   typed this entire message out.
    sentences = [
        (reason, DEPRECATION_MSG_PREFIX + "{}"),
        (gone_in, "pip {} will remove support for this functionality."),
        (replacement, "A possible replacement is {}."),
        (issue, (
            "You can find discussion regarding this at "
            "https://github.com/pypa/pip/issues/{}."
        )),
    ]
    message = " ".join(
        template.format(val) for val, template in sentences if val is not None
    )

# Raise as an error if it has to be removed.
    if gone_in is not None and parse(current_version) >= parse(gone_in):
        raise PipDeprecationWarning(message)

warnings.warn(message, category=PipDeprecationWarning, stacklevel=2)