@uns-kit/cli 0.0.51 → 0.0.53

package/templates/python/venv/lib/python3.12/site-packages/setuptools/__init__.py

@@ -1,248 +0,0 @@
-"""Extensions to the 'distutils' for large or complex distributions"""
-# mypy: disable_error_code=override
-# Command.reinitialize_command has an extra **kw param that distutils doesn't have
-# Can't disable on the exact line because distutils doesn't exists on Python 3.12
-# and mypy isn't aware of distutils_hack, causing distutils.core.Command to be Any,
-# and a [unused-ignore] to be raised on 3.12+
-
-from __future__ import annotations
-
-import functools
-import os
-import sys
-from abc import abstractmethod
-from collections.abc import Mapping
-from typing import TYPE_CHECKING, TypeVar, overload
-
-sys.path.extend(((vendor_path := os.path.join(os.path.dirname(os.path.dirname(__file__)), 'setuptools', '_vendor')) not in sys.path) * [vendor_path])  # fmt: skip
-# workaround for #4476
-sys.modules.pop('backports', None)
-
-import _distutils_hack.override  # noqa: F401
-
-from . import logging, monkey
-from .depends import Require
-from .discovery import PackageFinder, PEP420PackageFinder
-from .dist import Distribution
-from .extension import Extension
-from .version import __version__ as __version__
-from .warnings import SetuptoolsDeprecationWarning
-
-import distutils.core
-
-__all__ = [
-    'setup',
-    'Distribution',
-    'Command',
-    'Extension',
-    'Require',
-    'SetuptoolsDeprecationWarning',
-    'find_packages',
-    'find_namespace_packages',
-]
-
-_CommandT = TypeVar("_CommandT", bound="_Command")
-
-bootstrap_install_from = None
-
-find_packages = PackageFinder.find
-find_namespace_packages = PEP420PackageFinder.find
-
-
-def _install_setup_requires(attrs):
-    # Note: do not use `setuptools.Distribution` directly, as
-    # our PEP 517 backend patch `distutils.core.Distribution`.
-    class MinimalDistribution(distutils.core.Distribution):
-        """
-        A minimal version of a distribution for supporting the
-        fetch_build_eggs interface.
-        """
-
-        def __init__(self, attrs: Mapping[str, object]) -> None:
-            _incl = 'dependency_links', 'setup_requires'
-            filtered = {k: attrs[k] for k in set(_incl) & set(attrs)}
-            super().__init__(filtered)
-            # Prevent accidentally triggering discovery with incomplete set of attrs
-            self.set_defaults._disable()
-
-        def _get_project_config_files(self, filenames=None):
-            """Ignore ``pyproject.toml``, they are not related to setup_requires"""
-            try:
-                cfg, _toml = super()._split_standard_project_metadata(filenames)
-            except Exception:
-                return filenames, ()
-            return cfg, ()
-
-        def finalize_options(self):
-            """
-            Disable finalize_options to avoid building the working set.
-            Ref #2158.
-            """
-
-    dist = MinimalDistribution(attrs)
-
-    # Honor setup.cfg's options.
-    dist.parse_config_files(ignore_option_errors=True)
-    if dist.setup_requires:
-        _fetch_build_eggs(dist)
-
-
-def _fetch_build_eggs(dist: Distribution):
-    try:
-        dist.fetch_build_eggs(dist.setup_requires)
-    except Exception as ex:
-        msg = """
-        It is possible a package already installed in your system
-        contains an version that is invalid according to PEP 440.
-        You can try `pip install --use-pep517` as a workaround for this problem,
-        or rely on a new virtual environment.
-
-        If the problem refers to a package that is not installed yet,
-        please contact that package's maintainers or distributors.
-        """
-        if "InvalidVersion" in ex.__class__.__name__:
-            if hasattr(ex, "add_note"):
-                ex.add_note(msg)  # PEP 678
-            else:
-                dist.announce(f"\n{msg}\n")
-        raise
-
-
-def setup(**attrs):
-    logging.configure()
-    # Make sure we have any requirements needed to interpret 'attrs'.
-    _install_setup_requires(attrs)
-    return distutils.core.setup(**attrs)
-
-
-setup.__doc__ = distutils.core.setup.__doc__
-
-if TYPE_CHECKING:
-    # Work around a mypy issue where type[T] can't be used as a base: https://github.com/python/mypy/issues/10962
-    from distutils.core import Command as _Command
-else:
-    _Command = monkey.get_unpatched(distutils.core.Command)
-
-
-class Command(_Command):
-    """
-    Setuptools internal actions are organized using a *command design pattern*.
-    This means that each action (or group of closely related actions) executed during
-    the build should be implemented as a ``Command`` subclass.
-
-    These commands are abstractions and do not necessarily correspond to a command that
-    can (or should) be executed via a terminal, in a CLI fashion (although historically
-    they would).
-
-    When creating a new command from scratch, custom defined classes **SHOULD** inherit
-    from ``setuptools.Command`` and implement a few mandatory methods.
-    Between these mandatory methods, are listed:
-    :meth:`initialize_options`, :meth:`finalize_options` and :meth:`run`.
-
-    A useful analogy for command classes is to think of them as subroutines with local
-    variables called "options".  The options are "declared" in :meth:`initialize_options`
-    and "defined" (given their final values, aka "finalized") in :meth:`finalize_options`,
-    both of which must be defined by every command class. The "body" of the subroutine,
-    (where it does all the work) is the :meth:`run` method.
-    Between :meth:`initialize_options` and :meth:`finalize_options`, ``setuptools`` may set
-    the values for options/attributes based on user's input (or circumstance),
-    which means that the implementation should be careful to not overwrite values in
-    :meth:`finalize_options` unless necessary.
-
-    Please note that other commands (or other parts of setuptools) may also overwrite
-    the values of the command's options/attributes multiple times during the build
-    process.
-    Therefore it is important to consistently implement :meth:`initialize_options` and
-    :meth:`finalize_options`. For example, all derived attributes (or attributes that
-    depend on the value of other attributes) **SHOULD** be recomputed in
-    :meth:`finalize_options`.
-
-    When overwriting existing commands, custom defined classes **MUST** abide by the
-    same APIs implemented by the original class. They also **SHOULD** inherit from the
-    original class.
-    """
-
-    command_consumes_arguments = False
-    distribution: Distribution  # override distutils.dist.Distribution with setuptools.dist.Distribution
-
-    def __init__(self, dist: Distribution, **kw) -> None:
-        """
-        Construct the command for dist, updating
-        vars(self) with any keyword parameters.
-        """
-        super().__init__(dist)
-        vars(self).update(kw)
-
-    @overload
-    def reinitialize_command(
-        self, command: str, reinit_subcommands: bool = False, **kw
-    ) -> _Command: ...
-    @overload
-    def reinitialize_command(
-        self, command: _CommandT, reinit_subcommands: bool = False, **kw
-    ) -> _CommandT: ...
-    def reinitialize_command(
-        self, command: str | _Command, reinit_subcommands: bool = False, **kw
-    ) -> _Command:
-        cmd = _Command.reinitialize_command(self, command, reinit_subcommands)
-        vars(cmd).update(kw)
-        return cmd  # pyright: ignore[reportReturnType] # pypa/distutils#307
-
-    @abstractmethod
-    def initialize_options(self) -> None:
-        """
-        Set or (reset) all options/attributes/caches used by the command
-        to their default values. Note that these values may be overwritten during
-        the build.
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def finalize_options(self) -> None:
-        """
-        Set final values for all options/attributes used by the command.
-        Most of the time, each option/attribute/cache should only be set if it does not
-        have any value yet (e.g. ``if self.attr is None: self.attr = val``).
-        """
-        raise NotImplementedError
-
-    @abstractmethod
-    def run(self) -> None:
-        """
-        Execute the actions intended by the command.
-        (Side effects **SHOULD** only take place when :meth:`run` is executed,
-        for example, creating new files or writing to the terminal output).
-        """
-        raise NotImplementedError
-
-
-def _find_all_simple(path):
-    """
-    Find all files under 'path'
-    """
-    results = (
-        os.path.join(base, file)
-        for base, dirs, files in os.walk(path, followlinks=True)
-        for file in files
-    )
-    return filter(os.path.isfile, results)
-
-
-def findall(dir=os.curdir):
-    """
-    Find all files under 'dir' and return the list of full filenames.
-    Unless dir is '.', return full filenames with dir prepended.
-    """
-    files = _find_all_simple(dir)
-    if dir == os.curdir:
-        make_rel = functools.partial(os.path.relpath, start=dir)
-        files = map(make_rel, files)
-    return list(files)
-
-
-class sic(str):
-    """Treat this string as-is (https://en.wikipedia.org/wiki/Sic)"""
-
-
-# Apply monkey patches
-monkey.patch_all()

package/templates/python/venv/lib/python3.12/site-packages/setuptools/_core_metadata.py

@@ -1,337 +0,0 @@
-"""
-Handling of Core Metadata for Python packages (including reading and writing).
-
-See: https://packaging.python.org/en/latest/specifications/core-metadata/
-"""
-
-from __future__ import annotations
-
-import os
-import stat
-import textwrap
-from email import message_from_file
-from email.message import Message
-from tempfile import NamedTemporaryFile
-
-from packaging.markers import Marker
-from packaging.requirements import Requirement
-from packaging.utils import canonicalize_name, canonicalize_version
-from packaging.version import Version
-
-from . import _normalization, _reqs
-from ._static import is_static
-from .warnings import SetuptoolsDeprecationWarning
-
-from distutils.util import rfc822_escape
-
-
-def get_metadata_version(self):
-    mv = getattr(self, 'metadata_version', None)
-    if mv is None:
-        mv = Version('2.4')
-        self.metadata_version = mv
-    return mv
-
-
-def rfc822_unescape(content: str) -> str:
-    """Reverse RFC-822 escaping by removing leading whitespaces from content."""
-    lines = content.splitlines()
-    if len(lines) == 1:
-        return lines[0].lstrip()
-    return '\n'.join((lines[0].lstrip(), textwrap.dedent('\n'.join(lines[1:]))))
-
-
-def _read_field_from_msg(msg: Message, field: str) -> str | None:
-    """Read Message header field."""
-    value = msg[field]
-    if value == 'UNKNOWN':
-        return None
-    return value
-
-
-def _read_field_unescaped_from_msg(msg: Message, field: str) -> str | None:
-    """Read Message header field and apply rfc822_unescape."""
-    value = _read_field_from_msg(msg, field)
-    if value is None:
-        return value
-    return rfc822_unescape(value)
-
-
-def _read_list_from_msg(msg: Message, field: str) -> list[str] | None:
-    """Read Message header field and return all results as list."""
-    values = msg.get_all(field, None)
-    if values == []:
-        return None
-    return values
-
-
-def _read_payload_from_msg(msg: Message) -> str | None:
-    value = str(msg.get_payload()).strip()
-    if value == 'UNKNOWN' or not value:
-        return None
-    return value
-
-
-def read_pkg_file(self, file):
-    """Reads the metadata values from a file object."""
-    msg = message_from_file(file)
-
-    self.metadata_version = Version(msg['metadata-version'])
-    self.name = _read_field_from_msg(msg, 'name')
-    self.version = _read_field_from_msg(msg, 'version')
-    self.description = _read_field_from_msg(msg, 'summary')
-    # we are filling author only.
-    self.author = _read_field_from_msg(msg, 'author')
-    self.maintainer = None
-    self.author_email = _read_field_from_msg(msg, 'author-email')
-    self.maintainer_email = None
-    self.url = _read_field_from_msg(msg, 'home-page')
-    self.download_url = _read_field_from_msg(msg, 'download-url')
-    self.license = _read_field_unescaped_from_msg(msg, 'license')
-    self.license_expression = _read_field_unescaped_from_msg(msg, 'license-expression')
-
-    self.long_description = _read_field_unescaped_from_msg(msg, 'description')
-    if self.long_description is None and self.metadata_version >= Version('2.1'):
-        self.long_description = _read_payload_from_msg(msg)
-    self.description = _read_field_from_msg(msg, 'summary')
-
-    if 'keywords' in msg:
-        self.keywords = _read_field_from_msg(msg, 'keywords').split(',')
-
-    self.platforms = _read_list_from_msg(msg, 'platform')
-    self.classifiers = _read_list_from_msg(msg, 'classifier')
-
-    # PEP 314 - these fields only exist in 1.1
-    if self.metadata_version == Version('1.1'):
-        self.requires = _read_list_from_msg(msg, 'requires')
-        self.provides = _read_list_from_msg(msg, 'provides')
-        self.obsoletes = _read_list_from_msg(msg, 'obsoletes')
-    else:
-        self.requires = None
-        self.provides = None
-        self.obsoletes = None
-
-    self.license_files = _read_list_from_msg(msg, 'license-file')
-
-
-def single_line(val):
-    """
-    Quick and dirty validation for Summary pypa/setuptools#1390.
-    """
-    if '\n' in val:
-        # TODO: Replace with `raise ValueError("newlines not allowed")`
-        # after reviewing #2893.
-        msg = "newlines are not allowed in `summary` and will break in the future"
-        SetuptoolsDeprecationWarning.emit("Invalid config.", msg)
-        # due_date is undefined. Controversial change, there was a lot of push back.
-        val = val.strip().split('\n')[0]
-    return val
-
-
-def write_pkg_info(self, base_dir):
-    """Write the PKG-INFO file into the release tree."""
-    temp = ""
-    final = os.path.join(base_dir, 'PKG-INFO')
-    try:
-        # Use a temporary file while writing to avoid race conditions
-        # (e.g. `importlib.metadata` reading `.egg-info/PKG-INFO`):
-        with NamedTemporaryFile("w", encoding="utf-8", dir=base_dir, delete=False) as f:
-            temp = f.name
-            self.write_pkg_file(f)
-        permissions = stat.S_IMODE(os.lstat(temp).st_mode)
-        os.chmod(temp, permissions | stat.S_IRGRP | stat.S_IROTH)
-        os.replace(temp, final)  # atomic operation.
-    finally:
-        if temp and os.path.exists(temp):
-            os.remove(temp)
-
-
-# Based on Python 3.5 version
-def write_pkg_file(self, file):  # noqa: C901  # is too complex (14)  # FIXME
-    """Write the PKG-INFO format data to a file object."""
-    version = self.get_metadata_version()
-
-    def write_field(key, value):
-        file.write(f"{key}: {value}\n")
-
-    write_field('Metadata-Version', str(version))
-    write_field('Name', self.get_name())
-    write_field('Version', self.get_version())
-
-    summary = self.get_description()
-    if summary:
-        write_field('Summary', single_line(summary))
-
-    optional_fields = (
-        ('Home-page', 'url'),
-        ('Download-URL', 'download_url'),
-        ('Author', 'author'),
-        ('Author-email', 'author_email'),
-        ('Maintainer', 'maintainer'),
-        ('Maintainer-email', 'maintainer_email'),
-    )
-
-    for field, attr in optional_fields:
-        attr_val = getattr(self, attr, None)
-        if attr_val is not None:
-            write_field(field, attr_val)
-
-    if license_expression := self.license_expression:
-        write_field('License-Expression', license_expression)
-    elif license := self.get_license():
-        write_field('License', rfc822_escape(license))
-
-    for label, url in self.project_urls.items():
-        write_field('Project-URL', f'{label}, {url}')
-
-    keywords = ','.join(self.get_keywords())
-    if keywords:
-        write_field('Keywords', keywords)
-
-    platforms = self.get_platforms() or []
-    for platform in platforms:
-        write_field('Platform', platform)
-
-    self._write_list(file, 'Classifier', self.get_classifiers())
-
-    # PEP 314
-    self._write_list(file, 'Requires', self.get_requires())
-    self._write_list(file, 'Provides', self.get_provides())
-    self._write_list(file, 'Obsoletes', self.get_obsoletes())
-
-    # Setuptools specific for PEP 345
-    if hasattr(self, 'python_requires'):
-        write_field('Requires-Python', self.python_requires)
-
-    # PEP 566
-    if self.long_description_content_type:
-        write_field('Description-Content-Type', self.long_description_content_type)
-
-    safe_license_files = map(_safe_license_file, self.license_files or [])
-    self._write_list(file, 'License-File', safe_license_files)
-    _write_requirements(self, file)
-
-    for field, attr in _POSSIBLE_DYNAMIC_FIELDS.items():
-        if (val := getattr(self, attr, None)) and not is_static(val):
-            write_field('Dynamic', field)
-
-    long_description = self.get_long_description()
-    if long_description:
-        file.write(f"\n{long_description}")
-        if not long_description.endswith("\n"):
-            file.write("\n")
-
-
-def _write_requirements(self, file):
-    for req in _reqs.parse(self.install_requires):
-        file.write(f"Requires-Dist: {req}\n")
-
-    processed_extras = {}
-    for augmented_extra, reqs in self.extras_require.items():
-        # Historically, setuptools allows "augmented extras": `<extra>:<condition>`
-        unsafe_extra, _, condition = augmented_extra.partition(":")
-        unsafe_extra = unsafe_extra.strip()
-        extra = _normalization.safe_extra(unsafe_extra)
-
-        if extra:
-            _write_provides_extra(file, processed_extras, extra, unsafe_extra)
-        for req in _reqs.parse_strings(reqs):
-            r = _include_extra(req, extra, condition.strip())
-            file.write(f"Requires-Dist: {r}\n")
-
-    return processed_extras
-
-
-def _include_extra(req: str, extra: str, condition: str) -> Requirement:
-    r = Requirement(req)  # create a fresh object that can be modified
-    parts = (
-        f"({r.marker})" if r.marker else None,
-        f"({condition})" if condition else None,
-        f"extra == {extra!r}" if extra else None,
-    )
-    r.marker = Marker(" and ".join(x for x in parts if x))
-    return r
-
-
-def _write_provides_extra(file, processed_extras, safe, unsafe):
-    previous = processed_extras.get(safe)
-    if previous == unsafe:
-        SetuptoolsDeprecationWarning.emit(
-            'Ambiguity during "extra" normalization for dependencies.',
-            f"""
-            {previous!r} and {unsafe!r} normalize to the same value:\n
-                {safe!r}\n
-            In future versions, setuptools might halt the build process.
-            """,
-            see_url="https://peps.python.org/pep-0685/",
-        )
-    else:
-        processed_extras[safe] = unsafe
-        file.write(f"Provides-Extra: {safe}\n")
-
-
-# from pypa/distutils#244; needed only until that logic is always available
-def get_fullname(self):
-    return _distribution_fullname(self.get_name(), self.get_version())
-
-
-def _distribution_fullname(name: str, version: str) -> str:
-    """
-    >>> _distribution_fullname('setup.tools', '1.0-2')
-    'setup_tools-1.0.post2'
-    >>> _distribution_fullname('setup-tools', '1.2post2')
-    'setup_tools-1.2.post2'
-    >>> _distribution_fullname('setup-tools', '1.0-r2')
-    'setup_tools-1.0.post2'
-    >>> _distribution_fullname('setup.tools', '1.0.post')
-    'setup_tools-1.0.post0'
-    >>> _distribution_fullname('setup.tools', '1.0+ubuntu-1')
-    'setup_tools-1.0+ubuntu.1'
-    """
-    return "{}-{}".format(
-        canonicalize_name(name).replace('-', '_'),
-        canonicalize_version(version, strip_trailing_zero=False),
-    )
-
-
-def _safe_license_file(file):
-    # XXX: Do we need this after the deprecation discussed in #4892, #4896??
-    normalized = os.path.normpath(file).replace(os.sep, "/")
-    if "../" in normalized:
-        return os.path.basename(normalized)  # Temporarily restore pre PEP639 behaviour
-    return normalized
-
-
-_POSSIBLE_DYNAMIC_FIELDS = {
-    # Core Metadata Field x related Distribution attribute
-    "author": "author",
-    "author-email": "author_email",
-    "classifier": "classifiers",
-    "description": "long_description",
-    "description-content-type": "long_description_content_type",
-    "download-url": "download_url",
-    "home-page": "url",
-    "keywords": "keywords",
-    "license": "license",
-    # XXX: License-File is complicated because the user gives globs that are expanded
-    #      during the build. Without special handling it is likely always
-    #      marked as Dynamic, which is an acceptable outcome according to:
-    #      https://github.com/pypa/setuptools/issues/4629#issuecomment-2331233677
-    "license-file": "license_files",
-    "license-expression": "license_expression",  # PEP 639
-    "maintainer": "maintainer",
-    "maintainer-email": "maintainer_email",
-    "obsoletes": "obsoletes",
-    # "obsoletes-dist": "obsoletes_dist",  # NOT USED
-    "platform": "platforms",
-    "project-url": "project_urls",
-    "provides": "provides",
-    # "provides-dist": "provides_dist",  # NOT USED
-    "provides-extra": "extras_require",
-    "requires": "requires",
-    "requires-dist": "install_requires",
-    # "requires-external": "requires_external",  # NOT USED
-    "requires-python": "python_requires",
-    "summary": "description",
-    # "supported-platform": "supported_platforms",  # NOT USED
-}