FM / setuptools

/usr/lib/imh-ultrastack-common/venv/lib/python3.13/site-packages/setuptools/

/usr/lib/imh-ultrastack-common/venv/lib/python3.13/site-packages/setuptools

Name	Size	Mode	Actions
command/	-	0755	rm
compat/	-	0755	rm
config/	-	0755	rm
tests/	-	0755	rm
_distutils/	-	0755	rm
_vendor/	-	0755	rm
__pycache__/	-	0755	rm
archive_util.py	7356	0644	edit dl rm
build_meta.py	20234	0644	edit dl rm
cli-32.exe	11776	0644	edit dl rm
cli-64.exe	14336	0644	edit dl rm
cli-arm64.exe	13824	0644	edit dl rm
cli.exe	11776	0644	edit dl rm
depends.py	5965	0644	edit dl rm
discovery.py	21286	0644	edit dl rm
dist.py	45184	0644	edit dl rm
errors.py	3024	0644	edit dl rm
extension.py	6818	0644	edit dl rm
glob.py	6062	0644	edit dl rm
gui-32.exe	11776	0644	edit dl rm
gui-64.exe	14336	0644	edit dl rm
gui-arm64.exe	13824	0644	edit dl rm
gui.exe	11776	0644	edit dl rm
installer.py	5184	0644	edit dl rm
launch.py	820	0644	edit dl rm
launcher manifest.xml	628	0644	edit dl rm
logging.py	1261	0644	edit dl rm
modified.py	568	0644	edit dl rm
monkey.py	3733	0644	edit dl rm
msvc.py	42909	0644	edit dl rm
namespaces.py	3045	0644	edit dl rm
script (dev).tmpl	218	0644	edit dl rm
script.tmpl	138	0644	edit dl rm
unicode_utils.py	3189	0644	edit dl rm
version.py	161	0644	edit dl rm
warnings.py	3796	0644	edit dl rm
wheel.py	9532	0644	edit dl rm
windows_support.py	726	0644	edit dl rm
_core_metadata.py	11978	0644	edit dl rm
_discovery.py	836	0644	edit dl rm
_entry_points.py	2468	0644	edit dl rm
_imp.py	2435	0644	edit dl rm
_importlib.py	223	0644	edit dl rm
_itertools.py	657	0644	edit dl rm
_normalization.py	5798	0644	edit dl rm
_path.py	2976	0644	edit dl rm
_reqs.py	1380	0644	edit dl rm
_scripts.py	11247	0644	edit dl rm
_shutil.py	1578	0644	edit dl rm
_static.py	4855	0644	edit dl rm
__init__.py	9521	0644	edit dl rm

Edit: /usr/lib/imh-ultrastack-common/venv/lib/python3.13/site-packages/setuptools/_normalization.py (5798B)

"""
Helpers for normalization as expected in wheel/sdist/module file names
and core metadata
"""

import re
from typing import TYPE_CHECKING

import packaging

# 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.IGNORECASE)
_UNSAFE_NAME_CHARS = re.compile(r"[^A-Z0-9._-]+", re.IGNORECASE)
_NON_ALPHANUMERIC = re.compile(r"[^A-Z0-9]+", re.IGNORECASE)
_PEP440_FALLBACK = re.compile(
    r"^v?(?P<safe>(?:[0-9]+!)?[0-9]+(?:\.[0-9]+)*)", re.IGNORECASE
)

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'
    >>> safe_name("hello_world")
    'hello_world'
    """
    return _UNSAFE_NAME_CHARS.sub("-", component)

def safe_version(version: str) -> str:
    """Convert an arbitrary string into a valid version string.
    Can still raise an ``InvalidVersion`` exception.
    To avoid exceptions use ``best_effort_version``.
    >>> 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):
    ...
    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.
    Fallback when ``safe_version`` is not safe enough.
    >>> best_effort_version("v0.2 beta")
    '0.2b0'
    >>> best_effort_version("ubuntu lts")
    '0.dev0+sanitized.ubuntu.lts'
    >>> best_effort_version("0.23ubuntu1")
    '0.23.dev0+sanitized.ubuntu1'
    >>> best_effort_version("0.23-")
    '0.23.dev0+sanitized'
    >>> best_effort_version("0.-_")
    '0.dev0+sanitized'
    >>> best_effort_version("42.+?1")
    '42.dev0+sanitized.1'
    """
    try:
        return safe_version(version)
    except packaging.version.InvalidVersion:
        v = version.replace(' ', '.')
        match = _PEP440_FALLBACK.search(v)
        if match:
            safe = match["safe"]
            rest = v[len(safe) :]
        else:
            safe = "0"
            rest = version
        safe_rest = _NON_ALPHANUMERIC.sub(".", rest).strip(".")
        local = f"sanitized.{safe_rest}".strip(".")
        return safe_version(f"{safe}.dev0+{local}")

def safe_extra(extra: str) -> str:
    """Normalize extra name according to PEP 685
    >>> safe_extra("_FrIeNdLy-._.-bArD")
    'friendly-bard'
    >>> safe_extra("FrIeNdLy-._.-bArD__._-")
    'friendly-bard'
    """
    return _NON_ALPHANUMERIC.sub("-", extra).strip("-").lower()

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 filename_component_broken(value: str) -> str:
    """
    Produce the incorrect filename component for compatibility.

See pypa/setuptools#4167 for detailed analysis.

TODO: replace this with filename_component after pip 24 is
    nearly-ubiquitous.

>>> filename_component_broken('foo_bar-baz')
    'foo-bar-baz'
    """
    return value.replace('_', '-')

def safer_name(value: str) -> str:
    """Like ``safe_name`` but can be used as filename component for wheel"""
    # See bdist_wheel.safer_name
    return (
        # Per https://packaging.python.org/en/latest/specifications/name-normalization/#name-normalization
        re
        .sub(r"[-_.]+", "-", safe_name(value))
        .lower()
        # Per https://packaging.python.org/en/latest/specifications/binary-distribution-format/#escaping-and-unicode
        .replace("-", "_")
    )

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

def _missing_canonicalize_license_expression(expression: str) -> str:
    """
    Defer import error to affect only users that actually use it
    https://github.com/pypa/setuptools/issues/4894
    >>> _missing_canonicalize_license_expression("a OR b")
    Traceback (most recent call last):
    ...
    ImportError: ...Cannot import `packaging.licenses`...
    """
    raise ImportError(
        "Cannot import `packaging.licenses`."
        """
        Setuptools>=77.0.0 requires "packaging>=24.2" to work properly.
        Please make sure you have a suitable version installed.
        """
    )

try:
    from packaging.licenses import (
        canonicalize_license_expression as _canonicalize_license_expression,
    )
except ImportError:  # pragma: nocover
    if not TYPE_CHECKING:
        # XXX: pyright is still upset even with # pyright: ignore[reportAssignmentType]
        _canonicalize_license_expression = _missing_canonicalize_license_expression

cmd: