cli-ih 0.6.3.1__py3-none-any.whl → 0.7.1__py3-none-any.whl

venv/Lib/site-packages/pip/_internal/operations/build/build_tracker.py

@@ -1,140 +0,0 @@
-from __future__ import annotations
-
-import contextlib
-import hashlib
-import logging
-import os
-from collections.abc import Generator
-from types import TracebackType
-
-from pip._internal.req.req_install import InstallRequirement
-from pip._internal.utils.temp_dir import TempDirectory
-
-logger = logging.getLogger(__name__)
-
-
-@contextlib.contextmanager
-def update_env_context_manager(**changes: str) -> Generator[None, None, None]:
-    target = os.environ
-
-    # Save values from the target and change them.
-    non_existent_marker = object()
-    saved_values: dict[str, object | str] = {}
-    for name, new_value in changes.items():
-        try:
-            saved_values[name] = target[name]
-        except KeyError:
-            saved_values[name] = non_existent_marker
-        target[name] = new_value
-
-    try:
-        yield
-    finally:
-        # Restore original values in the target.
-        for name, original_value in saved_values.items():
-            if original_value is non_existent_marker:
-                del target[name]
-            else:
-                assert isinstance(original_value, str)  # for mypy
-                target[name] = original_value
-
-
-@contextlib.contextmanager
-def get_build_tracker() -> Generator[BuildTracker, None, None]:
-    root = os.environ.get("PIP_BUILD_TRACKER")
-    with contextlib.ExitStack() as ctx:
-        if root is None:
-            root = ctx.enter_context(TempDirectory(kind="build-tracker")).path
-            ctx.enter_context(update_env_context_manager(PIP_BUILD_TRACKER=root))
-            logger.debug("Initialized build tracking at %s", root)
-
-        with BuildTracker(root) as tracker:
-            yield tracker
-
-
-class TrackerId(str):
-    """Uniquely identifying string provided to the build tracker."""
-
-
-class BuildTracker:
-    """Ensure that an sdist cannot request itself as a setup requirement.
-
-    When an sdist is prepared, it identifies its setup requirements in the
-    context of ``BuildTracker.track()``. If a requirement shows up recursively, this
-    raises an exception.
-
-    This stops fork bombs embedded in malicious packages."""
-
-    def __init__(self, root: str) -> None:
-        self._root = root
-        self._entries: dict[TrackerId, InstallRequirement] = {}
-        logger.debug("Created build tracker: %s", self._root)
-
-    def __enter__(self) -> BuildTracker:
-        logger.debug("Entered build tracker: %s", self._root)
-        return self
-
-    def __exit__(
-        self,
-        exc_type: type[BaseException] | None,
-        exc_val: BaseException | None,
-        exc_tb: TracebackType | None,
-    ) -> None:
-        self.cleanup()
-
-    def _entry_path(self, key: TrackerId) -> str:
-        hashed = hashlib.sha224(key.encode()).hexdigest()
-        return os.path.join(self._root, hashed)
-
-    def add(self, req: InstallRequirement, key: TrackerId) -> None:
-        """Add an InstallRequirement to build tracking."""
-
-        # Get the file to write information about this requirement.
-        entry_path = self._entry_path(key)
-
-        # Try reading from the file. If it exists and can be read from, a build
-        # is already in progress, so a LookupError is raised.
-        try:
-            with open(entry_path) as fp:
-                contents = fp.read()
-        except FileNotFoundError:
-            pass
-        else:
-            message = f"{req.link} is already being built: {contents}"
-            raise LookupError(message)
-
-        # If we're here, req should really not be building already.
-        assert key not in self._entries
-
-        # Start tracking this requirement.
-        with open(entry_path, "w", encoding="utf-8") as fp:
-            fp.write(str(req))
-        self._entries[key] = req
-
-        logger.debug("Added %s to build tracker %r", req, self._root)
-
-    def remove(self, req: InstallRequirement, key: TrackerId) -> None:
-        """Remove an InstallRequirement from build tracking."""
-
-        # Delete the created file and the corresponding entry.
-        os.unlink(self._entry_path(key))
-        del self._entries[key]
-
-        logger.debug("Removed %s from build tracker %r", req, self._root)
-
-    def cleanup(self) -> None:
-        for key, req in list(self._entries.items()):
-            self.remove(req, key)
-
-        logger.debug("Removed build tracker: %r", self._root)
-
-    @contextlib.contextmanager
-    def track(self, req: InstallRequirement, key: str) -> Generator[None, None, None]:
-        """Ensure that `key` cannot install itself as a setup requirement.
-
-        :raises LookupError: If `key` was already provided in a parent invocation of
-                             the context introduced by this method."""
-        tracker_id = TrackerId(key)
-        self.add(req, tracker_id)
-        yield
-        self.remove(req, tracker_id)

venv/Lib/site-packages/pip/_internal/operations/build/metadata.py

@@ -1,38 +0,0 @@
-"""Metadata generation logic for source distributions."""
-
-import os
-
-from pip._vendor.pyproject_hooks import BuildBackendHookCaller
-
-from pip._internal.build_env import BuildEnvironment
-from pip._internal.exceptions import (
-    InstallationSubprocessError,
-    MetadataGenerationFailed,
-)
-from pip._internal.utils.subprocess import runner_with_spinner_message
-from pip._internal.utils.temp_dir import TempDirectory
-
-
-def generate_metadata(
-    build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str
-) -> str:
-    """Generate metadata using mechanisms described in PEP 517.
-
-    Returns the generated metadata directory.
-    """
-    metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True)
-
-    metadata_dir = metadata_tmpdir.path
-
-    with build_env:
-        # Note that BuildBackendHookCaller implements a fallback for
-        # prepare_metadata_for_build_wheel, so we don't have to
-        # consider the possibility that this hook doesn't exist.
-        runner = runner_with_spinner_message("Preparing metadata (pyproject.toml)")
-        with backend.subprocess_runner(runner):
-            try:
-                distinfo_dir = backend.prepare_metadata_for_build_wheel(metadata_dir)
-            except InstallationSubprocessError as error:
-                raise MetadataGenerationFailed(package_details=details) from error
-
-    return os.path.join(metadata_dir, distinfo_dir)

venv/Lib/site-packages/pip/_internal/operations/build/metadata_editable.py

@@ -1,41 +0,0 @@
-"""Metadata generation logic for source distributions."""
-
-import os
-
-from pip._vendor.pyproject_hooks import BuildBackendHookCaller
-
-from pip._internal.build_env import BuildEnvironment
-from pip._internal.exceptions import (
-    InstallationSubprocessError,
-    MetadataGenerationFailed,
-)
-from pip._internal.utils.subprocess import runner_with_spinner_message
-from pip._internal.utils.temp_dir import TempDirectory
-
-
-def generate_editable_metadata(
-    build_env: BuildEnvironment, backend: BuildBackendHookCaller, details: str
-) -> str:
-    """Generate metadata using mechanisms described in PEP 660.
-
-    Returns the generated metadata directory.
-    """
-    metadata_tmpdir = TempDirectory(kind="modern-metadata", globally_managed=True)
-
-    metadata_dir = metadata_tmpdir.path
-
-    with build_env:
-        # Note that BuildBackendHookCaller implements a fallback for
-        # prepare_metadata_for_build_wheel/editable, so we don't have to
-        # consider the possibility that this hook doesn't exist.
-        runner = runner_with_spinner_message(
-            "Preparing editable metadata (pyproject.toml)"
-        )
-        with backend.subprocess_runner(runner):
-            try:
-                distinfo_dir = backend.prepare_metadata_for_build_editable(metadata_dir)
-            except InstallationSubprocessError as error:
-                raise MetadataGenerationFailed(package_details=details) from error
-
-    assert distinfo_dir is not None
-    return os.path.join(metadata_dir, distinfo_dir)

venv/Lib/site-packages/pip/_internal/operations/build/metadata_legacy.py

@@ -1,73 +0,0 @@
-"""Metadata generation logic for legacy source distributions."""
-
-import logging
-import os
-
-from pip._internal.build_env import BuildEnvironment
-from pip._internal.cli.spinners import open_spinner
-from pip._internal.exceptions import (
-    InstallationError,
-    InstallationSubprocessError,
-    MetadataGenerationFailed,
-)
-from pip._internal.utils.setuptools_build import make_setuptools_egg_info_args
-from pip._internal.utils.subprocess import call_subprocess
-from pip._internal.utils.temp_dir import TempDirectory
-
-logger = logging.getLogger(__name__)
-
-
-def _find_egg_info(directory: str) -> str:
-    """Find an .egg-info subdirectory in `directory`."""
-    filenames = [f for f in os.listdir(directory) if f.endswith(".egg-info")]
-
-    if not filenames:
-        raise InstallationError(f"No .egg-info directory found in {directory}")
-
-    if len(filenames) > 1:
-        raise InstallationError(
-            f"More than one .egg-info directory found in {directory}"
-        )
-
-    return os.path.join(directory, filenames[0])
-
-
-def generate_metadata(
-    build_env: BuildEnvironment,
-    setup_py_path: str,
-    source_dir: str,
-    isolated: bool,
-    details: str,
-) -> str:
-    """Generate metadata using setup.py-based defacto mechanisms.
-
-    Returns the generated metadata directory.
-    """
-    logger.debug(
-        "Running setup.py (path:%s) egg_info for package %s",
-        setup_py_path,
-        details,
-    )
-
-    egg_info_dir = TempDirectory(kind="pip-egg-info", globally_managed=True).path
-
-    args = make_setuptools_egg_info_args(
-        setup_py_path,
-        egg_info_dir=egg_info_dir,
-        no_user_config=isolated,
-    )
-
-    with build_env:
-        with open_spinner("Preparing metadata (setup.py)") as spinner:
-            try:
-                call_subprocess(
-                    args,
-                    cwd=source_dir,
-                    command_desc="python setup.py egg_info",
-                    spinner=spinner,
-                )
-            except InstallationSubprocessError as error:
-                raise MetadataGenerationFailed(package_details=details) from error
-
-    # Return the .egg-info directory.
-    return _find_egg_info(egg_info_dir)

venv/Lib/site-packages/pip/_internal/operations/build/wheel.py

@@ -1,38 +0,0 @@
-from __future__ import annotations
-
-import logging
-import os
-
-from pip._vendor.pyproject_hooks import BuildBackendHookCaller
-
-from pip._internal.utils.subprocess import runner_with_spinner_message
-
-logger = logging.getLogger(__name__)
-
-
-def build_wheel_pep517(
-    name: str,
-    backend: BuildBackendHookCaller,
-    metadata_directory: str,
-    tempd: str,
-) -> str | None:
-    """Build one InstallRequirement using the PEP 517 build process.
-
-    Returns path to wheel if successfully built. Otherwise, returns None.
-    """
-    assert metadata_directory is not None
-    try:
-        logger.debug("Destination directory: %s", tempd)
-
-        runner = runner_with_spinner_message(
-            f"Building wheel for {name} (pyproject.toml)"
-        )
-        with backend.subprocess_runner(runner):
-            wheel_name = backend.build_wheel(
-                tempd,
-                metadata_directory=metadata_directory,
-            )
-    except Exception:
-        logger.error("Failed building wheel for %s", name)
-        return None
-    return os.path.join(tempd, wheel_name)

venv/Lib/site-packages/pip/_internal/operations/build/wheel_editable.py

@@ -1,47 +0,0 @@
-from __future__ import annotations
-
-import logging
-import os
-
-from pip._vendor.pyproject_hooks import BuildBackendHookCaller, HookMissing
-
-from pip._internal.utils.subprocess import runner_with_spinner_message
-
-logger = logging.getLogger(__name__)
-
-
-def build_wheel_editable(
-    name: str,
-    backend: BuildBackendHookCaller,
-    metadata_directory: str,
-    tempd: str,
-) -> str | None:
-    """Build one InstallRequirement using the PEP 660 build process.
-
-    Returns path to wheel if successfully built. Otherwise, returns None.
-    """
-    assert metadata_directory is not None
-    try:
-        logger.debug("Destination directory: %s", tempd)
-
-        runner = runner_with_spinner_message(
-            f"Building editable for {name} (pyproject.toml)"
-        )
-        with backend.subprocess_runner(runner):
-            try:
-                wheel_name = backend.build_editable(
-                    tempd,
-                    metadata_directory=metadata_directory,
-                )
-            except HookMissing as e:
-                logger.error(
-                    "Cannot build editable %s because the build "
-                    "backend does not have the %s hook",
-                    name,
-                    e,
-                )
-                return None
-    except Exception:
-        logger.error("Failed building editable for %s", name)
-        return None
-    return os.path.join(tempd, wheel_name)

venv/Lib/site-packages/pip/_internal/operations/build/wheel_legacy.py

@@ -1,119 +0,0 @@
-from __future__ import annotations
-
-import logging
-import os.path
-
-from pip._internal.cli.spinners import open_spinner
-from pip._internal.utils.deprecation import deprecated
-from pip._internal.utils.setuptools_build import make_setuptools_bdist_wheel_args
-from pip._internal.utils.subprocess import call_subprocess, format_command_args
-
-logger = logging.getLogger(__name__)
-
-
-def format_command_result(
-    command_args: list[str],
-    command_output: str,
-) -> str:
-    """Format command information for logging."""
-    command_desc = format_command_args(command_args)
-    text = f"Command arguments: {command_desc}\n"
-
-    if not command_output:
-        text += "Command output: None"
-    elif logger.getEffectiveLevel() > logging.DEBUG:
-        text += "Command output: [use --verbose to show]"
-    else:
-        if not command_output.endswith("\n"):
-            command_output += "\n"
-        text += f"Command output:\n{command_output}"
-
-    return text
-
-
-def get_legacy_build_wheel_path(
-    names: list[str],
-    temp_dir: str,
-    name: str,
-    command_args: list[str],
-    command_output: str,
-) -> str | None:
-    """Return the path to the wheel in the temporary build directory."""
-    # Sort for determinism.
-    names = sorted(names)
-    if not names:
-        msg = f"Legacy build of wheel for {name!r} created no files.\n"
-        msg += format_command_result(command_args, command_output)
-        logger.warning(msg)
-        return None
-
-    if len(names) > 1:
-        msg = (
-            f"Legacy build of wheel for {name!r} created more than one file.\n"
-            f"Filenames (choosing first): {names}\n"
-        )
-        msg += format_command_result(command_args, command_output)
-        logger.warning(msg)
-
-    return os.path.join(temp_dir, names[0])
-
-
-def build_wheel_legacy(
-    name: str,
-    setup_py_path: str,
-    source_dir: str,
-    global_options: list[str],
-    build_options: list[str],
-    tempd: str,
-) -> str | None:
-    """Build one unpacked package using the "legacy" build process.
-
-    Returns path to wheel if successfully built. Otherwise, returns None.
-    """
-    deprecated(
-        reason=(
-            f"Building {name!r} using the legacy setup.py bdist_wheel mechanism, "
-            "which will be removed in a future version."
-        ),
-        replacement=(
-            "to use the standardized build interface by "
-            "setting the `--use-pep517` option, "
-            "(possibly combined with `--no-build-isolation`), "
-            f"or adding a `pyproject.toml` file to the source tree of {name!r}"
-        ),
-        gone_in="25.3",
-        issue=6334,
-    )
-
-    wheel_args = make_setuptools_bdist_wheel_args(
-        setup_py_path,
-        global_options=global_options,
-        build_options=build_options,
-        destination_dir=tempd,
-    )
-
-    spin_message = f"Building wheel for {name} (setup.py)"
-    with open_spinner(spin_message) as spinner:
-        logger.debug("Destination directory: %s", tempd)
-
-        try:
-            output = call_subprocess(
-                wheel_args,
-                command_desc="python setup.py bdist_wheel",
-                cwd=source_dir,
-                spinner=spinner,
-            )
-        except Exception:
-            spinner.finish("error")
-            logger.error("Failed building wheel for %s", name)
-            return None
-
-        names = os.listdir(tempd)
-        wheel_path = get_legacy_build_wheel_path(
-            names=names,
-            temp_dir=tempd,
-            name=name,
-            command_args=wheel_args,
-            command_output=output,
-        )
-        return wheel_path

venv/Lib/site-packages/pip/_internal/operations/check.py

@@ -1,175 +0,0 @@
-"""Validation of dependencies of packages"""
-
-from __future__ import annotations
-
-import logging
-from collections.abc import Generator, Iterable
-from contextlib import suppress
-from email.parser import Parser
-from functools import reduce
-from typing import (
-    Callable,
-    NamedTuple,
-)
-
-from pip._vendor.packaging.requirements import Requirement
-from pip._vendor.packaging.tags import Tag, parse_tag
-from pip._vendor.packaging.utils import NormalizedName, canonicalize_name
-from pip._vendor.packaging.version import Version
-
-from pip._internal.distributions import make_distribution_for_install_requirement
-from pip._internal.metadata import get_default_environment
-from pip._internal.metadata.base import BaseDistribution
-from pip._internal.req.req_install import InstallRequirement
-
-logger = logging.getLogger(__name__)
-
-
-class PackageDetails(NamedTuple):
-    version: Version
-    dependencies: list[Requirement]
-
-
-# Shorthands
-PackageSet = dict[NormalizedName, PackageDetails]
-Missing = tuple[NormalizedName, Requirement]
-Conflicting = tuple[NormalizedName, Version, Requirement]
-
-MissingDict = dict[NormalizedName, list[Missing]]
-ConflictingDict = dict[NormalizedName, list[Conflicting]]
-CheckResult = tuple[MissingDict, ConflictingDict]
-ConflictDetails = tuple[PackageSet, CheckResult]
-
-
-def create_package_set_from_installed() -> tuple[PackageSet, bool]:
-    """Converts a list of distributions into a PackageSet."""
-    package_set = {}
-    problems = False
-    env = get_default_environment()
-    for dist in env.iter_installed_distributions(local_only=False, skip=()):
-        name = dist.canonical_name
-        try:
-            dependencies = list(dist.iter_dependencies())
-            package_set[name] = PackageDetails(dist.version, dependencies)
-        except (OSError, ValueError) as e:
-            # Don't crash on unreadable or broken metadata.
-            logger.warning("Error parsing dependencies of %s: %s", name, e)
-            problems = True
-    return package_set, problems
-
-
-def check_package_set(
-    package_set: PackageSet, should_ignore: Callable[[str], bool] | None = None
-) -> CheckResult:
-    """Check if a package set is consistent
-
-    If should_ignore is passed, it should be a callable that takes a
-    package name and returns a boolean.
-    """
-
-    missing = {}
-    conflicting = {}
-
-    for package_name, package_detail in package_set.items():
-        # Info about dependencies of package_name
-        missing_deps: set[Missing] = set()
-        conflicting_deps: set[Conflicting] = set()
-
-        if should_ignore and should_ignore(package_name):
-            continue
-
-        for req in package_detail.dependencies:
-            name = canonicalize_name(req.name)
-
-            # Check if it's missing
-            if name not in package_set:
-                missed = True
-                if req.marker is not None:
-                    missed = req.marker.evaluate({"extra": ""})
-                if missed:
-                    missing_deps.add((name, req))
-                continue
-
-            # Check if there's a conflict
-            version = package_set[name].version
-            if not req.specifier.contains(version, prereleases=True):
-                conflicting_deps.add((name, version, req))
-
-        if missing_deps:
-            missing[package_name] = sorted(missing_deps, key=str)
-        if conflicting_deps:
-            conflicting[package_name] = sorted(conflicting_deps, key=str)
-
-    return missing, conflicting
-
-
-def check_install_conflicts(to_install: list[InstallRequirement]) -> ConflictDetails:
-    """For checking if the dependency graph would be consistent after \
-    installing given requirements
-    """
-    # Start from the current state
-    package_set, _ = create_package_set_from_installed()
-    # Install packages
-    would_be_installed = _simulate_installation_of(to_install, package_set)
-
-    # Only warn about directly-dependent packages; create a whitelist of them
-    whitelist = _create_whitelist(would_be_installed, package_set)
-
-    return (
-        package_set,
-        check_package_set(
-            package_set, should_ignore=lambda name: name not in whitelist
-        ),
-    )
-
-
-def check_unsupported(
-    packages: Iterable[BaseDistribution],
-    supported_tags: Iterable[Tag],
-) -> Generator[BaseDistribution, None, None]:
-    for p in packages:
-        with suppress(FileNotFoundError):
-            wheel_file = p.read_text("WHEEL")
-            wheel_tags: frozenset[Tag] = reduce(
-                frozenset.union,
-                map(parse_tag, Parser().parsestr(wheel_file).get_all("Tag", [])),
-                frozenset(),
-            )
-            if wheel_tags.isdisjoint(supported_tags):
-                yield p
-
-
-def _simulate_installation_of(
-    to_install: list[InstallRequirement], package_set: PackageSet
-) -> set[NormalizedName]:
-    """Computes the version of packages after installing to_install."""
-    # Keep track of packages that were installed
-    installed = set()
-
-    # Modify it as installing requirement_set would (assuming no errors)
-    for inst_req in to_install:
-        abstract_dist = make_distribution_for_install_requirement(inst_req)
-        dist = abstract_dist.get_metadata_distribution()
-        name = dist.canonical_name
-        package_set[name] = PackageDetails(dist.version, list(dist.iter_dependencies()))
-
-        installed.add(name)
-
-    return installed
-
-
-def _create_whitelist(
-    would_be_installed: set[NormalizedName], package_set: PackageSet
-) -> set[NormalizedName]:
-    packages_affected = set(would_be_installed)
-
-    for package_name in package_set:
-        if package_name in packages_affected:
-            continue
-
-        for req in package_set[package_name].dependencies:
-            if canonicalize_name(req.name) in packages_affected:
-                packages_affected.add(package_name)
-                break
-
-    return packages_affected