pip 25.1__py3-none-any.whl → 25.2__py3-none-any.whl

pip/_internal/locations/base.py

@@ -1,9 +1,10 @@
+from __future__ import annotations
+
 import functools
 import os
 import site
 import sys
 import sysconfig
-import typing
 
 from pip._internal.exceptions import InstallationError
 from pip._internal.utils import appdirs
@@ -71,11 +72,11 @@ def get_src_prefix() -> str:
 try:
     # Use getusersitepackages if this is present, as it ensures that the
     # value is initialised properly.
-    user_site: typing.Optional[str] = site.getusersitepackages()
+    user_site: str | None = site.getusersitepackages()
 except AttributeError:
     user_site = site.USER_SITE
 
 
-@functools.lru_cache(maxsize=None)
+@functools.cache
 def is_osx_framework() -> bool:
     return bool(sysconfig.get_config_var("PYTHONFRAMEWORK"))

pip/_internal/main.py

@@ -1,7 +1,7 @@
-from typing import List, Optional
+from __future__ import annotations
 
 
-def main(args: Optional[List[str]] = None) -> int:
+def main(args: list[str] | None = None) -> int:
     """This is preserved for old console scripts that may still be referencing
     it.
 

pip/_internal/metadata/__init__.py

@@ -1,8 +1,10 @@
+from __future__ import annotations
+
 import contextlib
 import functools
 import os
 import sys
-from typing import List, Literal, Optional, Protocol, Type, cast
+from typing import Literal, Protocol, cast
 
 from pip._internal.utils.deprecation import deprecated
 from pip._internal.utils.misc import strtobool
@@ -81,12 +83,12 @@ def _emit_pkg_resources_deprecation_if_needed() -> None:
 
 
 class Backend(Protocol):
-    NAME: 'Literal["importlib", "pkg_resources"]'
-    Distribution: Type[BaseDistribution]
-    Environment: Type[BaseEnvironment]
+    NAME: Literal["importlib", "pkg_resources"]
+    Distribution: type[BaseDistribution]
+    Environment: type[BaseEnvironment]
 
 
-@functools.lru_cache(maxsize=None)
+@functools.cache
 def select_backend() -> Backend:
     if _should_use_importlib_metadata():
         from . import importlib
@@ -110,7 +112,7 @@ def get_default_environment() -> BaseEnvironment:
     return select_backend().Environment.default()
 
 
-def get_environment(paths: Optional[List[str]]) -> BaseEnvironment:
+def get_environment(paths: list[str] | None) -> BaseEnvironment:
     """Get a representation of the environment specified by ``paths``.
 
     This returns an Environment instance from the chosen backend based on the

pip/_internal/metadata/_json.py

@@ -1,8 +1,9 @@
 # Extracted from https://github.com/pfmoore/pkg_metadata
+from __future__ import annotations
 
 from email.header import Header, decode_header, make_header
 from email.message import Message
-from typing import Any, Dict, List, Union, cast
+from typing import Any, cast
 
 METADATA_FIELDS = [
     # Name, Multiple-Use
@@ -40,10 +41,10 @@ def json_name(field: str) -> str:
     return field.lower().replace("-", "_")
 
 
-def msg_to_json(msg: Message) -> Dict[str, Any]:
+def msg_to_json(msg: Message) -> dict[str, Any]:
     """Convert a Message object into a JSON-compatible dictionary."""
 
-    def sanitise_header(h: Union[Header, str]) -> str:
+    def sanitise_header(h: Header | str) -> str:
         if isinstance(h, Header):
             chunks = []
             for bytes, encoding in decode_header(h):
@@ -65,7 +66,7 @@ def msg_to_json(msg: Message) -> Dict[str, Any]:
             continue
         key = json_name(field)
         if multi:
-            value: Union[str, List[str]] = [
+            value: str | list[str] = [
                 sanitise_header(v) for v in msg.get_all(field)  # type: ignore
             ]
         else:

pip/_internal/metadata/base.py

@@ -1,3 +1,5 @@
+from __future__ import annotations
+
 import csv
 import email.message
 import functools
@@ -6,19 +8,12 @@ import logging
 import pathlib
 import re
 import zipfile
+from collections.abc import Collection, Container, Iterable, Iterator
 from typing import (
     IO,
     Any,
-    Collection,
-    Container,
-    Dict,
-    Iterable,
-    Iterator,
-    List,
     NamedTuple,
-    Optional,
     Protocol,
-    Tuple,
     Union,
 )
 
@@ -61,8 +56,8 @@ class BaseEntryPoint(Protocol):
 
 
 def _convert_installed_files_path(
-    entry: Tuple[str, ...],
-    info: Tuple[str, ...],
+    entry: tuple[str, ...],
+    info: tuple[str, ...],
 ) -> str:
     """Convert a legacy installed-files.txt path into modern RECORD path.
 
@@ -98,7 +93,7 @@ class RequiresEntry(NamedTuple):
 
 class BaseDistribution(Protocol):
     @classmethod
-    def from_directory(cls, directory: str) -> "BaseDistribution":
+    def from_directory(cls, directory: str) -> BaseDistribution:
         """Load the distribution from a metadata directory.
 
         :param directory: Path to a metadata directory, e.g. ``.dist-info``.
@@ -111,7 +106,7 @@ class BaseDistribution(Protocol):
         metadata_contents: bytes,
         filename: str,
         project_name: str,
-    ) -> "BaseDistribution":
+    ) -> BaseDistribution:
         """Load the distribution from the contents of a METADATA file.
 
         This is used to implement PEP 658 by generating a "shallow" dist object that can
@@ -124,7 +119,7 @@ class BaseDistribution(Protocol):
         raise NotImplementedError()
 
     @classmethod
-    def from_wheel(cls, wheel: "Wheel", name: str) -> "BaseDistribution":
+    def from_wheel(cls, wheel: Wheel, name: str) -> BaseDistribution:
         """Load the distribution from a given wheel.
 
         :param wheel: A concrete wheel definition.
@@ -144,7 +139,7 @@ class BaseDistribution(Protocol):
         return f"{self.raw_name} {self.raw_version}"
 
     @property
-    def location(self) -> Optional[str]:
+    def location(self) -> str | None:
         """Where the distribution is loaded from.
 
         A string value is not necessarily a filesystem path, since distributions
@@ -158,7 +153,7 @@ class BaseDistribution(Protocol):
         raise NotImplementedError()
 
     @property
-    def editable_project_location(self) -> Optional[str]:
+    def editable_project_location(self) -> str | None:
         """The project location for editable distributions.
 
         This is the directory where pyproject.toml or setup.py is located.
@@ -180,7 +175,7 @@ class BaseDistribution(Protocol):
         return None
 
     @property
-    def installed_location(self) -> Optional[str]:
+    def installed_location(self) -> str | None:
         """The distribution's "installed" location.
 
         This should generally be a ``site-packages`` directory. This is
@@ -193,7 +188,7 @@ class BaseDistribution(Protocol):
         raise NotImplementedError()
 
     @property
-    def info_location(self) -> Optional[str]:
+    def info_location(self) -> str | None:
         """Location of the .[egg|dist]-info directory or file.
 
         Similarly to ``location``, a string value is not necessarily a
@@ -290,7 +285,7 @@ class BaseDistribution(Protocol):
         return self.raw_name.replace("-", "_")
 
     @property
-    def direct_url(self) -> Optional[DirectUrl]:
+    def direct_url(self) -> DirectUrl | None:
         """Obtain a DirectUrl from this distribution.
 
         Returns None if the distribution has no `direct_url.json` metadata,
@@ -398,7 +393,7 @@ class BaseDistribution(Protocol):
         return metadata
 
     @property
-    def metadata_dict(self) -> Dict[str, Any]:
+    def metadata_dict(self) -> dict[str, Any]:
         """PEP 566 compliant JSON-serializable representation of METADATA or PKG-INFO.
 
         This should return an empty dict if the metadata file is unavailable.
@@ -409,7 +404,7 @@ class BaseDistribution(Protocol):
         return msg_to_json(self.metadata)
 
     @property
-    def metadata_version(self) -> Optional[str]:
+    def metadata_version(self) -> str | None:
         """Value of "Metadata-Version:" in distribution metadata, if available."""
         return self.metadata.get("Metadata-Version")
 
@@ -463,7 +458,7 @@ class BaseDistribution(Protocol):
         """
         raise NotImplementedError()
 
-    def _iter_declared_entries_from_record(self) -> Optional[Iterator[str]]:
+    def _iter_declared_entries_from_record(self) -> Iterator[str] | None:
         try:
             text = self.read_text("RECORD")
         except FileNotFoundError:
@@ -471,7 +466,7 @@ class BaseDistribution(Protocol):
         # This extra Path-str cast normalizes entries.
         return (str(pathlib.Path(row[0])) for row in csv.reader(text.splitlines()))
 
-    def _iter_declared_entries_from_legacy(self) -> Optional[Iterator[str]]:
+    def _iter_declared_entries_from_legacy(self) -> Iterator[str] | None:
         try:
             text = self.read_text("installed-files.txt")
         except FileNotFoundError:
@@ -492,7 +487,7 @@ class BaseDistribution(Protocol):
             for p in paths
         )
 
-    def iter_declared_entries(self) -> Optional[Iterator[str]]:
+    def iter_declared_entries(self) -> Iterator[str] | None:
         """Iterate through file entries declared in this distribution.
 
         For modern .dist-info distributions, this is the files listed in the
@@ -585,14 +580,14 @@ class BaseEnvironment:
     """An environment containing distributions to introspect."""
 
     @classmethod
-    def default(cls) -> "BaseEnvironment":
+    def default(cls) -> BaseEnvironment:
         raise NotImplementedError()
 
     @classmethod
-    def from_paths(cls, paths: Optional[List[str]]) -> "BaseEnvironment":
+    def from_paths(cls, paths: list[str] | None) -> BaseEnvironment:
         raise NotImplementedError()
 
-    def get_distribution(self, name: str) -> Optional["BaseDistribution"]:
+    def get_distribution(self, name: str) -> BaseDistribution | None:
         """Given a requirement name, return the installed distributions.
 
         The name may not be normalized. The implementation must canonicalize
@@ -600,7 +595,7 @@ class BaseEnvironment:
         """
         raise NotImplementedError()
 
-    def _iter_distributions(self) -> Iterator["BaseDistribution"]:
+    def _iter_distributions(self) -> Iterator[BaseDistribution]:
         """Iterate through installed distributions.
 
         This function should be implemented by subclass, but never called

pip/_internal/metadata/importlib/_compat.py

@@ -1,6 +1,8 @@
+from __future__ import annotations
+
 import importlib.metadata
 import os
-from typing import Any, Optional, Protocol, Tuple, cast
+from typing import Any, Protocol, cast
 
 from pip._vendor.packaging.utils import NormalizedName, canonicalize_name
 
@@ -30,11 +32,11 @@ class BasePath(Protocol):
         raise NotImplementedError()
 
     @property
-    def parent(self) -> "BasePath":
+    def parent(self) -> BasePath:
         raise NotImplementedError()
 
 
-def get_info_location(d: importlib.metadata.Distribution) -> Optional[BasePath]:
+def get_info_location(d: importlib.metadata.Distribution) -> BasePath | None:
     """Find the path to the distribution's metadata directory.
 
     HACK: This relies on importlib.metadata's private ``_path`` attribute. Not
@@ -48,7 +50,7 @@ def get_info_location(d: importlib.metadata.Distribution) -> Optional[BasePath]:
 
 def parse_name_and_version_from_info_directory(
     dist: importlib.metadata.Distribution,
-) -> Tuple[Optional[str], Optional[str]]:
+) -> tuple[str | None, str | None]:
     """Get a name and version from the metadata directory name.
 
     This is much faster than reading distribution metadata.

pip/_internal/metadata/importlib/_dists.py

@@ -1,17 +1,12 @@
+from __future__ import annotations
+
 import email.message
 import importlib.metadata
 import pathlib
 import zipfile
+from collections.abc import Collection, Iterable, Iterator, Mapping, Sequence
 from os import PathLike
 from typing import (
-    Collection,
-    Dict,
-    Iterable,
-    Iterator,
-    Mapping,
-    Optional,
-    Sequence,
-    Union,
     cast,
 )
 
@@ -64,7 +59,7 @@ class WheelDistribution(importlib.metadata.Distribution):
         zf: zipfile.ZipFile,
         name: str,
         location: str,
-    ) -> "WheelDistribution":
+    ) -> WheelDistribution:
         info_dir, _ = parse_wheel(zf, name)
         paths = (
             (name, pathlib.PurePosixPath(name.split("/", 1)[-1]))
@@ -84,7 +79,7 @@ class WheelDistribution(importlib.metadata.Distribution):
             return iter(self._files)
         raise FileNotFoundError(path)
 
-    def read_text(self, filename: str) -> Optional[str]:
+    def read_text(self, filename: str) -> str | None:
         try:
             data = self._files[pathlib.PurePosixPath(filename)]
         except KeyError:
@@ -97,7 +92,7 @@ class WheelDistribution(importlib.metadata.Distribution):
             raise UnsupportedWheel(error)
         return text
 
-    def locate_file(self, path: Union[str, "PathLike[str]"]) -> pathlib.Path:
+    def locate_file(self, path: str | PathLike[str]) -> pathlib.Path:
         # This method doesn't make sense for our in-memory wheel, but the API
         # requires us to define it.
         raise NotImplementedError
@@ -107,8 +102,8 @@ class Distribution(BaseDistribution):
     def __init__(
         self,
         dist: importlib.metadata.Distribution,
-        info_location: Optional[BasePath],
-        installed_location: Optional[BasePath],
+        info_location: BasePath | None,
+        installed_location: BasePath | None,
     ) -> None:
         self._dist = dist
         self._info_location = info_location
@@ -147,19 +142,19 @@ class Distribution(BaseDistribution):
         return cls(dist, dist.info_location, pathlib.PurePosixPath(wheel.location))
 
     @property
-    def location(self) -> Optional[str]:
+    def location(self) -> str | None:
         if self._info_location is None:
             return None
         return str(self._info_location.parent)
 
     @property
-    def info_location(self) -> Optional[str]:
+    def info_location(self) -> str | None:
         if self._info_location is None:
             return None
         return str(self._info_location)
 
     @property
-    def installed_location(self) -> Optional[str]:
+    def installed_location(self) -> str | None:
         if self._installed_location is None:
             return None
         return normalize_path(str(self._installed_location))
@@ -215,7 +210,7 @@ class Distribution(BaseDistribution):
         ]
 
     def iter_dependencies(self, extras: Collection[str] = ()) -> Iterable[Requirement]:
-        contexts: Sequence[Dict[str, str]] = [{"extra": e} for e in extras]
+        contexts: Sequence[dict[str, str]] = [{"extra": e} for e in extras]
         for req_string in self.metadata.get_all("Requires-Dist", []):
             # strip() because email.message.Message.get_all() may return a leading \n
             # in case a long header was wrapped.

pip/_internal/metadata/importlib/_envs.py

@@ -1,10 +1,13 @@
+from __future__ import annotations
+
 import importlib.metadata
 import logging
 import os
 import pathlib
 import sys
 import zipfile
-from typing import Iterator, List, Optional, Sequence, Set, Tuple
+from collections.abc import Iterator, Sequence
+from typing import Optional
 
 from pip._vendor.packaging.utils import (
     InvalidWheelFilename,
@@ -47,10 +50,10 @@ class _DistributionFinder:
     installations as well. It's useful feature, after all.
     """
 
-    FoundResult = Tuple[importlib.metadata.Distribution, Optional[BasePath]]
+    FoundResult = tuple[importlib.metadata.Distribution, Optional[BasePath]]
 
     def __init__(self) -> None:
-        self._found_names: Set[NormalizedName] = set()
+        self._found_names: set[NormalizedName] = set()
 
     def _find_impl(self, location: str) -> Iterator[FoundResult]:
         """Find distributions in a location."""
@@ -80,7 +83,7 @@ class _DistributionFinder:
         """
         for dist, info_location in self._find_impl(location):
             if info_location is None:
-                installed_location: Optional[BasePath] = None
+                installed_location: BasePath | None = None
             else:
                 installed_location = info_location.parent
             yield Distribution(dist, info_location, installed_location)
@@ -119,7 +122,7 @@ class Environment(BaseEnvironment):
         return cls(sys.path)
 
     @classmethod
-    def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment:
+    def from_paths(cls, paths: list[str] | None) -> BaseEnvironment:
         if paths is None:
             return cls(sys.path)
         return cls(paths)
@@ -130,7 +133,7 @@ class Environment(BaseEnvironment):
             yield from finder.find(location)
             yield from finder.find_legacy_editables(location)
 
-    def get_distribution(self, name: str) -> Optional[BaseDistribution]:
+    def get_distribution(self, name: str) -> BaseDistribution | None:
         canonical_name = canonicalize_name(name)
         matches = (
             distribution

pip/_internal/metadata/pkg_resources.py

@@ -1,16 +1,13 @@
+from __future__ import annotations
+
 import email.message
 import email.parser
 import logging
 import os
 import zipfile
+from collections.abc import Collection, Iterable, Iterator, Mapping
 from typing import (
-    Collection,
-    Iterable,
-    Iterator,
-    List,
-    Mapping,
     NamedTuple,
-    Optional,
 )
 
 from pip._vendor import pkg_resources
@@ -73,7 +70,7 @@ class InMemoryMetadata:
     def metadata_isdir(self, name: str) -> bool:
         return False
 
-    def metadata_listdir(self, name: str) -> List[str]:
+    def metadata_listdir(self, name: str) -> list[str]:
         return []
 
     def run_script(self, script_name: str, namespace: str) -> None:
@@ -85,7 +82,7 @@ class Distribution(BaseDistribution):
         self._dist = dist
         # This is populated lazily, to avoid loading metadata for all possible
         # distributions eagerly.
-        self.__extra_mapping: Optional[Mapping[NormalizedName, str]] = None
+        self.__extra_mapping: Mapping[NormalizedName, str] | None = None
 
     @property
     def _extra_mapping(self) -> Mapping[NormalizedName, str]:
@@ -155,11 +152,11 @@ class Distribution(BaseDistribution):
         return cls(dist)
 
     @property
-    def location(self) -> Optional[str]:
+    def location(self) -> str | None:
         return self._dist.location
 
     @property
-    def installed_location(self) -> Optional[str]:
+    def installed_location(self) -> str | None:
         egg_link = egg_link_path_from_location(self.raw_name)
         if egg_link:
             location = egg_link
@@ -170,7 +167,7 @@ class Distribution(BaseDistribution):
         return normalize_path(location)
 
     @property
-    def info_location(self) -> Optional[str]:
+    def info_location(self) -> str | None:
         return self._dist.egg_info
 
     @property
@@ -259,14 +256,14 @@ class Environment(BaseEnvironment):
         return cls(pkg_resources.working_set)
 
     @classmethod
-    def from_paths(cls, paths: Optional[List[str]]) -> BaseEnvironment:
+    def from_paths(cls, paths: list[str] | None) -> BaseEnvironment:
         return cls(pkg_resources.WorkingSet(paths))
 
     def _iter_distributions(self) -> Iterator[BaseDistribution]:
         for dist in self._ws:
             yield Distribution(dist)
 
-    def _search_distribution(self, name: str) -> Optional[BaseDistribution]:
+    def _search_distribution(self, name: str) -> BaseDistribution | None:
         """Find a distribution matching the ``name`` in the environment.
 
         This searches from *all* distributions available in the environment, to
@@ -278,7 +275,7 @@ class Environment(BaseEnvironment):
                 return dist
         return None
 
-    def get_distribution(self, name: str) -> Optional[BaseDistribution]:
+    def get_distribution(self, name: str) -> BaseDistribution | None:
         # Search the distribution by looking through the working set.
         dist = self._search_distribution(name)
         if dist: