Gecko [ www.jobworksschool.com ]

Name	Size	Permission	Date
__pycache__	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
_distutils	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
_vendor	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
command	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
config	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
extern	[ DIR ]	drwxr-xr-x	2025-08-05 17:14
__init__.py	9.04 KB	-rw-r--r--	2025-08-05 17:14
_entry_points.py	2.18 KB	-rw-r--r--	2025-08-05 17:14
_imp.py	2.38 KB	-rw-r--r--	2025-08-05 17:14
_importlib.py	1.43 KB	-rw-r--r--	2025-08-05 17:14
_itertools.py	675 B	-rw-r--r--	2025-08-05 17:14
_normalization.py	3.62 KB	-rw-r--r--	2025-08-05 17:14
_path.py	1.03 KB	-rw-r--r--	2025-08-05 17:14
_reqs.py	882 B	-rw-r--r--	2025-08-05 17:14
archive_util.py	7.16 KB	-rw-r--r--	2025-08-05 17:14
build_meta.py	19.62 KB	-rw-r--r--	2025-08-05 17:14
dep_util.py	936 B	-rw-r--r--	2025-08-05 17:14
depends.py	5.4 KB	-rw-r--r--	2025-08-05 17:14
discovery.py	20.65 KB	-rw-r--r--	2025-08-05 17:14
dist.py	45.74 KB	-rw-r--r--	2025-08-05 17:14
errors.py	2.41 KB	-rw-r--r--	2025-08-05 17:14
extension.py	5.46 KB	-rw-r--r--	2025-08-05 17:14
glob.py	4.75 KB	-rw-r--r--	2025-08-05 17:14
installer.py	4.87 KB	-rw-r--r--	2025-08-05 17:14
launch.py	812 B	-rw-r--r--	2025-08-05 17:14
logging.py	1.21 KB	-rw-r--r--	2025-08-05 17:14
monkey.py	4.58 KB	-rw-r--r--	2025-08-05 17:14
msvc.py	46.38 KB	-rw-r--r--	2025-08-05 17:14
namespaces.py	2.97 KB	-rw-r--r--	2025-08-05 17:14
package_index.py	38.96 KB	-rw-r--r--	2025-08-05 17:14
py312compat.py	330 B	-rw-r--r--	2025-08-05 17:14
sandbox.py	14.01 KB	-rw-r--r--	2025-08-05 17:14
script (dev).tmpl	218 B	-rw-r--r--	2025-08-05 17:14
script.tmpl	138 B	-rw-r--r--	2025-08-05 17:14
unicode_utils.py	941 B	-rw-r--r--	2025-08-05 17:14
version.py	161 B	-rw-r--r--	2025-08-05 17:14
warnings.py	3.61 KB	-rw-r--r--	2025-08-05 17:14
wheel.py	8.43 KB	-rw-r--r--	2025-08-05 17:14
windows_support.py	719 B	-rw-r--r--	2025-08-05 17:14

Rename

"""
Helpers for normalization as expected in wheel/sdist/module file names
and core metadata
"""
import re
from pathlib import Path
from typing import Union

from .extern import packaging
from .warnings import SetuptoolsDeprecationWarning

_Path = Union[str, Path]

# https://packaging.python.org/en/latest/specifications/core-metadata/#name
_VALID_NAME = re.compile(r"^([A-Z0-9]|[A-Z0-9][A-Z0-9._-]*[A-Z0-9])$", re.I)
_UNSAFE_NAME_CHARS = re.compile(r"[^A-Z0-9.]+", re.I)

def safe_identifier(name: str) -> str:
    """Make a string safe to be used as Python identifier.
    >>> safe_identifier("12abc")
    '_12abc'
    >>> safe_identifier("__editable__.myns.pkg-78.9.3_local")
    '__editable___myns_pkg_78_9_3_local'
    """
    safe = re.sub(r'\W|^(?=\d)', '_', name)
    assert safe.isidentifier()
    return safe

def safe_name(component: str) -> str:
    """Escape a component used as a project name according to Core Metadata.
    >>> safe_name("hello world")
    'hello-world'
    >>> safe_name("hello?world")
    'hello-world'
    """
    # See pkg_resources.safe_name
    return _UNSAFE_NAME_CHARS.sub("-", component)

def safe_version(version: str) -> str:
    """Convert an arbitrary string into a valid version string.
    >>> safe_version("1988 12 25")
    '1988.12.25'
    >>> safe_version("v0.2.1")
    '0.2.1'
    >>> safe_version("v0.2?beta")
    '0.2b0'
    >>> safe_version("v0.2 beta")
    '0.2b0'
    >>> safe_version("ubuntu lts")
    Traceback (most recent call last):
    ...
    setuptools.extern.packaging.version.InvalidVersion: Invalid version: 'ubuntu.lts'
    """
    v = version.replace(' ', '.')
    try:
        return str(packaging.version.Version(v))
    except packaging.version.InvalidVersion:
        attempt = _UNSAFE_NAME_CHARS.sub("-", v)
        return str(packaging.version.Version(attempt))

def best_effort_version(version: str) -> str:
    """Convert an arbitrary string into a version-like string.
    >>> best_effort_version("v0.2 beta")
    '0.2b0'

>>> import warnings
    >>> warnings.simplefilter("ignore", category=SetuptoolsDeprecationWarning)
    >>> best_effort_version("ubuntu lts")
    'ubuntu.lts'
    """
    # See pkg_resources.safe_version
    try:
        return safe_version(version)
    except packaging.version.InvalidVersion:
        SetuptoolsDeprecationWarning.emit(
            f"Invalid version: {version!r}.",
            f"""
            Version {version!r} is not valid according to PEP 440.

Please make sure to specify a valid version for your package.
            Also note that future releases of setuptools may halt the build process
            if an invalid version is given.
            """,
            see_url="https://peps.python.org/pep-0440/",
            due_date=(2023, 9, 26),  # See setuptools/dist _validate_version
        )
        v = version.replace(' ', '.')
        return safe_name(v)

def filename_component(value: str) -> str:
    """Normalize each component of a filename (e.g. distribution/version part of wheel)
    Note: ``value`` needs to be already normalized.
    >>> filename_component("my-pkg")
    'my_pkg'
    """
    return value.replace("-", "_").strip("_")

def safer_name(value: str) -> str:
    """Like ``safe_name`` but can be used as filename component for wheel"""
    # See bdist_wheel.safer_name
    return filename_component(safe_name(value))

def safer_best_effort_version(value: str) -> str:
    """Like ``best_effort_version`` but can be used as filename component for wheel"""
    # See bdist_wheel.safer_verion
    # TODO: Replace with only safe_version in the future (no need for best effort)
    return filename_component(best_effort_version(value))