OXIESEC PANEL

Name	Size	Modified	Perms
📁 ..	-	02/16/2024 09:01:52 PM	rwxr-xr-x
📄 __init__.py	0 bytes	11/13/2023 09:31:06 PM	rw-r--r--
📁 __pycache__	-	02/16/2024 09:01:52 PM	rwxr-xr-x
📄 _log.py	1015 bytes	03/16/2023 12:55:40 PM	rw-r--r--
📄 appdirs.py	1.32 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 compat.py	9.27 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 compatibility_tags.py	5.31 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 datetime.py	295 bytes	11/13/2023 09:31:06 PM	rw-r--r--
📄 deprecation.py	3.24 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 direct_url_helpers.py	4.26 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 distutils_args.py	1.32 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 egg_link.py	2.07 KB	03/16/2023 12:55:40 PM	rw-r--r--
📄 encoding.py	1.25 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 entrypoints.py	1.19 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 filesystem.py	6.78 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 filetypes.py	571 bytes	11/13/2023 09:31:06 PM	rw-r--r--
📄 glibc.py	3.22 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 hashes.py	4.57 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 inject_securetransport.py	810 bytes	11/13/2023 09:31:06 PM	rw-r--r--
📄 logging.py	12.79 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 misc.py	27.67 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 models.py	1.17 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 packaging.py	2.96 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 parallel.py	3.32 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 pkg_resources.py	1.22 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 setuptools_build.py	4.94 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 subprocess.py	9.69 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 temp_dir.py	8.18 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 typing.py	1.37 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 unpacking.py	9.27 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 urls.py	1.49 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 virtualenv.py	3.62 KB	11/13/2023 09:31:06 PM	rw-r--r--
📄 wheel.py	7.13 KB	11/13/2023 09:31:06 PM	rw-r--r--

Editing: 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)