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

venv/Lib/site-packages/pip/_internal/resolution/resolvelib/found_candidates.py

@@ -1,166 +0,0 @@
-"""Utilities to lazily create and visit candidates found.
-
-Creating and visiting a candidate is a *very* costly operation. It involves
-fetching, extracting, potentially building modules from source, and verifying
-distribution metadata. It is therefore crucial for performance to keep
-everything here lazy all the way down, so we only touch candidates that we
-absolutely need, and not "download the world" when we only need one version of
-something.
-"""
-
-from __future__ import annotations
-
-import logging
-from collections.abc import Iterator, Sequence
-from typing import Any, Callable, Optional
-
-from pip._vendor.packaging.version import _BaseVersion
-
-from pip._internal.exceptions import MetadataInvalid
-
-from .base import Candidate
-
-logger = logging.getLogger(__name__)
-
-IndexCandidateInfo = tuple[_BaseVersion, Callable[[], Optional[Candidate]]]
-
-
-def _iter_built(infos: Iterator[IndexCandidateInfo]) -> Iterator[Candidate]:
-    """Iterator for ``FoundCandidates``.
-
-    This iterator is used when the package is not already installed. Candidates
-    from index come later in their normal ordering.
-    """
-    versions_found: set[_BaseVersion] = set()
-    for version, func in infos:
-        if version in versions_found:
-            continue
-        try:
-            candidate = func()
-        except MetadataInvalid as e:
-            logger.warning(
-                "Ignoring version %s of %s since it has invalid metadata:\n"
-                "%s\n"
-                "Please use pip<24.1 if you need to use this version.",
-                version,
-                e.ireq.name,
-                e,
-            )
-            # Mark version as found to avoid trying other candidates with the same
-            # version, since they most likely have invalid metadata as well.
-            versions_found.add(version)
-        else:
-            if candidate is None:
-                continue
-            yield candidate
-            versions_found.add(version)
-
-
-def _iter_built_with_prepended(
-    installed: Candidate, infos: Iterator[IndexCandidateInfo]
-) -> Iterator[Candidate]:
-    """Iterator for ``FoundCandidates``.
-
-    This iterator is used when the resolver prefers the already-installed
-    candidate and NOT to upgrade. The installed candidate is therefore
-    always yielded first, and candidates from index come later in their
-    normal ordering, except skipped when the version is already installed.
-    """
-    yield installed
-    versions_found: set[_BaseVersion] = {installed.version}
-    for version, func in infos:
-        if version in versions_found:
-            continue
-        candidate = func()
-        if candidate is None:
-            continue
-        yield candidate
-        versions_found.add(version)
-
-
-def _iter_built_with_inserted(
-    installed: Candidate, infos: Iterator[IndexCandidateInfo]
-) -> Iterator[Candidate]:
-    """Iterator for ``FoundCandidates``.
-
-    This iterator is used when the resolver prefers to upgrade an
-    already-installed package. Candidates from index are returned in their
-    normal ordering, except replaced when the version is already installed.
-
-    The implementation iterates through and yields other candidates, inserting
-    the installed candidate exactly once before we start yielding older or
-    equivalent candidates, or after all other candidates if they are all newer.
-    """
-    versions_found: set[_BaseVersion] = set()
-    for version, func in infos:
-        if version in versions_found:
-            continue
-        # If the installed candidate is better, yield it first.
-        if installed.version >= version:
-            yield installed
-            versions_found.add(installed.version)
-        candidate = func()
-        if candidate is None:
-            continue
-        yield candidate
-        versions_found.add(version)
-
-    # If the installed candidate is older than all other candidates.
-    if installed.version not in versions_found:
-        yield installed
-
-
-class FoundCandidates(Sequence[Candidate]):
-    """A lazy sequence to provide candidates to the resolver.
-
-    The intended usage is to return this from `find_matches()` so the resolver
-    can iterate through the sequence multiple times, but only access the index
-    page when remote packages are actually needed. This improve performances
-    when suitable candidates are already installed on disk.
-    """
-
-    def __init__(
-        self,
-        get_infos: Callable[[], Iterator[IndexCandidateInfo]],
-        installed: Candidate | None,
-        prefers_installed: bool,
-        incompatible_ids: set[int],
-    ):
-        self._get_infos = get_infos
-        self._installed = installed
-        self._prefers_installed = prefers_installed
-        self._incompatible_ids = incompatible_ids
-        self._bool: bool | None = None
-
-    def __getitem__(self, index: Any) -> Any:
-        # Implemented to satisfy the ABC check. This is not needed by the
-        # resolver, and should not be used by the provider either (for
-        # performance reasons).
-        raise NotImplementedError("don't do this")
-
-    def __iter__(self) -> Iterator[Candidate]:
-        infos = self._get_infos()
-        if not self._installed:
-            iterator = _iter_built(infos)
-        elif self._prefers_installed:
-            iterator = _iter_built_with_prepended(self._installed, infos)
-        else:
-            iterator = _iter_built_with_inserted(self._installed, infos)
-        return (c for c in iterator if id(c) not in self._incompatible_ids)
-
-    def __len__(self) -> int:
-        # Implemented to satisfy the ABC check. This is not needed by the
-        # resolver, and should not be used by the provider either (for
-        # performance reasons).
-        raise NotImplementedError("don't do this")
-
-    def __bool__(self) -> bool:
-        if self._bool is not None:
-            return self._bool
-
-        if self._prefers_installed and self._installed:
-            self._bool = True
-            return True
-
-        self._bool = any(self)
-        return self._bool

venv/Lib/site-packages/pip/_internal/resolution/resolvelib/provider.py

@@ -1,276 +0,0 @@
-from __future__ import annotations
-
-import math
-from collections.abc import Iterable, Iterator, Mapping, Sequence
-from functools import cache
-from typing import (
-    TYPE_CHECKING,
-    TypeVar,
-)
-
-from pip._vendor.resolvelib.providers import AbstractProvider
-
-from pip._internal.req.req_install import InstallRequirement
-
-from .base import Candidate, Constraint, Requirement
-from .candidates import REQUIRES_PYTHON_IDENTIFIER
-from .factory import Factory
-from .requirements import ExplicitRequirement
-
-if TYPE_CHECKING:
-    from pip._vendor.resolvelib.providers import Preference
-    from pip._vendor.resolvelib.resolvers import RequirementInformation
-
-    PreferenceInformation = RequirementInformation[Requirement, Candidate]
-
-    _ProviderBase = AbstractProvider[Requirement, Candidate, str]
-else:
-    _ProviderBase = AbstractProvider
-
-# Notes on the relationship between the provider, the factory, and the
-# candidate and requirement classes.
-#
-# The provider is a direct implementation of the resolvelib class. Its role
-# is to deliver the API that resolvelib expects.
-#
-# Rather than work with completely abstract "requirement" and "candidate"
-# concepts as resolvelib does, pip has concrete classes implementing these two
-# ideas. The API of Requirement and Candidate objects are defined in the base
-# classes, but essentially map fairly directly to the equivalent provider
-# methods. In particular, `find_matches` and `is_satisfied_by` are
-# requirement methods, and `get_dependencies` is a candidate method.
-#
-# The factory is the interface to pip's internal mechanisms. It is stateless,
-# and is created by the resolver and held as a property of the provider. It is
-# responsible for creating Requirement and Candidate objects, and provides
-# services to those objects (access to pip's finder and preparer).
-
-
-D = TypeVar("D")
-V = TypeVar("V")
-
-
-def _get_with_identifier(
-    mapping: Mapping[str, V],
-    identifier: str,
-    default: D,
-) -> D | V:
-    """Get item from a package name lookup mapping with a resolver identifier.
-
-    This extra logic is needed when the target mapping is keyed by package
-    name, which cannot be directly looked up with an identifier (which may
-    contain requested extras). Additional logic is added to also look up a value
-    by "cleaning up" the extras from the identifier.
-    """
-    if identifier in mapping:
-        return mapping[identifier]
-    # HACK: Theoretically we should check whether this identifier is a valid
-    # "NAME[EXTRAS]" format, and parse out the name part with packaging or
-    # some regular expression. But since pip's resolver only spits out three
-    # kinds of identifiers: normalized PEP 503 names, normalized names plus
-    # extras, and Requires-Python, we can cheat a bit here.
-    name, open_bracket, _ = identifier.partition("[")
-    if open_bracket and name in mapping:
-        return mapping[name]
-    return default
-
-
-class PipProvider(_ProviderBase):
-    """Pip's provider implementation for resolvelib.
-
-    :params constraints: A mapping of constraints specified by the user. Keys
-        are canonicalized project names.
-    :params ignore_dependencies: Whether the user specified ``--no-deps``.
-    :params upgrade_strategy: The user-specified upgrade strategy.
-    :params user_requested: A set of canonicalized package names that the user
-        supplied for pip to install/upgrade.
-    """
-
-    def __init__(
-        self,
-        factory: Factory,
-        constraints: dict[str, Constraint],
-        ignore_dependencies: bool,
-        upgrade_strategy: str,
-        user_requested: dict[str, int],
-    ) -> None:
-        self._factory = factory
-        self._constraints = constraints
-        self._ignore_dependencies = ignore_dependencies
-        self._upgrade_strategy = upgrade_strategy
-        self._user_requested = user_requested
-
-    def identify(self, requirement_or_candidate: Requirement | Candidate) -> str:
-        return requirement_or_candidate.name
-
-    def narrow_requirement_selection(
-        self,
-        identifiers: Iterable[str],
-        resolutions: Mapping[str, Candidate],
-        candidates: Mapping[str, Iterator[Candidate]],
-        information: Mapping[str, Iterator[PreferenceInformation]],
-        backtrack_causes: Sequence[PreferenceInformation],
-    ) -> Iterable[str]:
-        """Produce a subset of identifiers that should be considered before others.
-
-        Currently pip narrows the following selection:
-            * Requires-Python, if present is always returned by itself
-            * Backtrack causes are considered next because they can be identified
-              in linear time here, whereas because get_preference() is called
-              for each identifier, it would be quadratic to check for them there.
-              Further, the current backtrack causes likely need to be resolved
-              before other requirements as a resolution can't be found while
-              there is a conflict.
-        """
-        backtrack_identifiers = set()
-        for info in backtrack_causes:
-            backtrack_identifiers.add(info.requirement.name)
-            if info.parent is not None:
-                backtrack_identifiers.add(info.parent.name)
-
-        current_backtrack_causes = []
-        for identifier in identifiers:
-            # Requires-Python has only one candidate and the check is basically
-            # free, so we always do it first to avoid needless work if it fails.
-            # This skips calling get_preference() for all other identifiers.
-            if identifier == REQUIRES_PYTHON_IDENTIFIER:
-                return [identifier]
-
-            # Check if this identifier is a backtrack cause
-            if identifier in backtrack_identifiers:
-                current_backtrack_causes.append(identifier)
-                continue
-
-        if current_backtrack_causes:
-            return current_backtrack_causes
-
-        return identifiers
-
-    def get_preference(
-        self,
-        identifier: str,
-        resolutions: Mapping[str, Candidate],
-        candidates: Mapping[str, Iterator[Candidate]],
-        information: Mapping[str, Iterable[PreferenceInformation]],
-        backtrack_causes: Sequence[PreferenceInformation],
-    ) -> Preference:
-        """Produce a sort key for given requirement based on preference.
-
-        The lower the return value is, the more preferred this group of
-        arguments is.
-
-        Currently pip considers the following in order:
-
-        * Any requirement that is "direct", e.g., points to an explicit URL.
-        * Any requirement that is "pinned", i.e., contains the operator ``===``
-          or ``==`` without a wildcard.
-        * Any requirement that imposes an upper version limit, i.e., contains the
-          operator ``<``, ``<=``, ``~=``, or ``==`` with a wildcard. Because
-          pip prioritizes the latest version, preferring explicit upper bounds
-          can rule out infeasible candidates sooner. This does not imply that
-          upper bounds are good practice; they can make dependency management
-          and resolution harder.
-        * Order user-specified requirements as they are specified, placing
-          other requirements afterward.
-        * Any "non-free" requirement, i.e., one that contains at least one
-          operator, such as ``>=`` or ``!=``.
-        * Alphabetical order for consistency (aids debuggability).
-        """
-        try:
-            next(iter(information[identifier]))
-        except StopIteration:
-            # There is no information for this identifier, so there's no known
-            # candidates.
-            has_information = False
-        else:
-            has_information = True
-
-        if not has_information:
-            direct = False
-            ireqs: tuple[InstallRequirement | None, ...] = ()
-        else:
-            # Go through the information and for each requirement,
-            # check if it's explicit (e.g., a direct link) and get the
-            # InstallRequirement (the second element) from get_candidate_lookup()
-            directs, ireqs = zip(
-                *(
-                    (isinstance(r, ExplicitRequirement), r.get_candidate_lookup()[1])
-                    for r, _ in information[identifier]
-                )
-            )
-            direct = any(directs)
-
-        operators: list[tuple[str, str]] = [
-            (specifier.operator, specifier.version)
-            for specifier_set in (ireq.specifier for ireq in ireqs if ireq)
-            for specifier in specifier_set
-        ]
-
-        pinned = any(((op[:2] == "==") and ("*" not in ver)) for op, ver in operators)
-        upper_bounded = any(
-            ((op in ("<", "<=", "~=")) or (op == "==" and "*" in ver))
-            for op, ver in operators
-        )
-        unfree = bool(operators)
-        requested_order = self._user_requested.get(identifier, math.inf)
-
-        return (
-            not direct,
-            not pinned,
-            not upper_bounded,
-            requested_order,
-            not unfree,
-            identifier,
-        )
-
-    def find_matches(
-        self,
-        identifier: str,
-        requirements: Mapping[str, Iterator[Requirement]],
-        incompatibilities: Mapping[str, Iterator[Candidate]],
-    ) -> Iterable[Candidate]:
-        def _eligible_for_upgrade(identifier: str) -> bool:
-            """Are upgrades allowed for this project?
-
-            This checks the upgrade strategy, and whether the project was one
-            that the user specified in the command line, in order to decide
-            whether we should upgrade if there's a newer version available.
-
-            (Note that we don't need access to the `--upgrade` flag, because
-            an upgrade strategy of "to-satisfy-only" means that `--upgrade`
-            was not specified).
-            """
-            if self._upgrade_strategy == "eager":
-                return True
-            elif self._upgrade_strategy == "only-if-needed":
-                user_order = _get_with_identifier(
-                    self._user_requested,
-                    identifier,
-                    default=None,
-                )
-                return user_order is not None
-            return False
-
-        constraint = _get_with_identifier(
-            self._constraints,
-            identifier,
-            default=Constraint.empty(),
-        )
-        return self._factory.find_candidates(
-            identifier=identifier,
-            requirements=requirements,
-            constraint=constraint,
-            prefers_installed=(not _eligible_for_upgrade(identifier)),
-            incompatibilities=incompatibilities,
-            is_satisfied_by=self.is_satisfied_by,
-        )
-
-    @staticmethod
-    @cache
-    def is_satisfied_by(requirement: Requirement, candidate: Candidate) -> bool:
-        return requirement.is_satisfied_by(candidate)
-
-    def get_dependencies(self, candidate: Candidate) -> Iterable[Requirement]:
-        with_requires = not self._ignore_dependencies
-        # iter_dependencies() can perform nontrivial work so delay until needed.
-        return (r for r in candidate.iter_dependencies(with_requires) if r is not None)

venv/Lib/site-packages/pip/_internal/resolution/resolvelib/reporter.py

@@ -1,85 +0,0 @@
-from __future__ import annotations
-
-from collections import defaultdict
-from logging import getLogger
-from typing import Any
-
-from pip._vendor.resolvelib.reporters import BaseReporter
-
-from .base import Candidate, Requirement
-
-logger = getLogger(__name__)
-
-
-class PipReporter(BaseReporter[Requirement, Candidate, str]):
-    def __init__(self) -> None:
-        self.reject_count_by_package: defaultdict[str, int] = defaultdict(int)
-
-        self._messages_at_reject_count = {
-            1: (
-                "pip is looking at multiple versions of {package_name} to "
-                "determine which version is compatible with other "
-                "requirements. This could take a while."
-            ),
-            8: (
-                "pip is still looking at multiple versions of {package_name} to "
-                "determine which version is compatible with other "
-                "requirements. This could take a while."
-            ),
-            13: (
-                "This is taking longer than usual. You might need to provide "
-                "the dependency resolver with stricter constraints to reduce "
-                "runtime. See https://pip.pypa.io/warnings/backtracking for "
-                "guidance. If you want to abort this run, press Ctrl + C."
-            ),
-        }
-
-    def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None:
-        self.reject_count_by_package[candidate.name] += 1
-
-        count = self.reject_count_by_package[candidate.name]
-        if count not in self._messages_at_reject_count:
-            return
-
-        message = self._messages_at_reject_count[count]
-        logger.info("INFO: %s", message.format(package_name=candidate.name))
-
-        msg = "Will try a different candidate, due to conflict:"
-        for req_info in criterion.information:
-            req, parent = req_info.requirement, req_info.parent
-            # Inspired by Factory.get_installation_error
-            msg += "\n    "
-            if parent:
-                msg += f"{parent.name} {parent.version} depends on "
-            else:
-                msg += "The user requested "
-            msg += req.format_for_error()
-        logger.debug(msg)
-
-
-class PipDebuggingReporter(BaseReporter[Requirement, Candidate, str]):
-    """A reporter that does an info log for every event it sees."""
-
-    def starting(self) -> None:
-        logger.info("Reporter.starting()")
-
-    def starting_round(self, index: int) -> None:
-        logger.info("Reporter.starting_round(%r)", index)
-
-    def ending_round(self, index: int, state: Any) -> None:
-        logger.info("Reporter.ending_round(%r, state)", index)
-        logger.debug("Reporter.ending_round(%r, %r)", index, state)
-
-    def ending(self, state: Any) -> None:
-        logger.info("Reporter.ending(%r)", state)
-
-    def adding_requirement(
-        self, requirement: Requirement, parent: Candidate | None
-    ) -> None:
-        logger.info("Reporter.adding_requirement(%r, %r)", requirement, parent)
-
-    def rejecting_candidate(self, criterion: Any, candidate: Candidate) -> None:
-        logger.info("Reporter.rejecting_candidate(%r, %r)", criterion, candidate)
-
-    def pinning(self, candidate: Candidate) -> None:
-        logger.info("Reporter.pinning(%r)", candidate)