Merge branch 'main' into release/25.0.1

Author: sbidoul

.git-blame-ignore-revs

@@ -34,3 +34,4 @@ c7ee560e00b85f7486b452c14ff49e4737996eda  # Blacken tools/
 94999255d5ede440c37137d210666fdf64302e75  # Reformat the codebase, with black
 585037a80a1177f1fa92e159a7079855782e543e  # Cleanup implicit string concatenation
 8a6f6ac19b80a6dc35900a47016c851d9fcd2ee2  # Blacken src/pip/_internal/resolution directory
+acfcae8941bb12ecfc372a05c875a7b414992604  # Reformat with Black's 2025 code style

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ repos:
     exclude: .patch
 
 - repo: https://github.com/psf/black-pre-commit-mirror
-  rev: 24.10.0
+  rev: 25.1.0
   hooks:
   - id: black
 

build-project.py

@@ -7,13 +7,14 @@
 from os import PathLike
 from pathlib import Path
 from types import SimpleNamespace
+from typing import Union
 
 
 class EnvBuilder(venv.EnvBuilder):
     """A subclass of venv.EnvBuilder that exposes the python executable command."""
 
     def ensure_directories(
-        self, env_dir: str | bytes | PathLike[str] | PathLike[bytes]
+        self, env_dir: Union[str, bytes, "PathLike[str]", "PathLike[bytes]"]
     ) -> SimpleNamespace:
         context = super().ensure_directories(env_dir)
         self.env_exec_cmd = context.env_exec_cmd

news/13156.bugfix.rst

@@ -1,5 +1,4 @@
-"""Automation using nox.
-"""
+"""Automation using nox."""
 
 import argparse
 import glob

news/13182.trivial.rst

@@ -184,6 +184,7 @@ select = [
     "W",
     "RUF100",
     "UP",
+    "FA102",  # future-required-type-annotation
 ]
 
 [tool.ruff.lint.isort]

noxfile.py

@@ -1,5 +1,4 @@
-"""Build Environment used for isolation during sdist building
-"""
+"""Build Environment used for isolation during sdist building"""
 
 import logging
 import os

pyproject.toml

@@ -1,5 +1,4 @@
-"""Cache Management
-"""
+"""Cache Management"""
 
 import hashlib
 import json

src/pip/_internal/build_env.py

@@ -1,4 +1,3 @@
-"""Subpackage containing all of pip's command line interface related code
-"""
+"""Subpackage containing all of pip's command line interface related code"""
 
 # This file intentionally does not import submodules

src/pip/_internal/cache.py

@@ -1,5 +1,4 @@
-"""Logic that powers autocompletion installed by ``pip completion``.
-"""
+"""Logic that powers autocompletion installed by ``pip completion``."""
 
 import optparse
 import os

src/pip/_internal/cli/__init__.py

@@ -1,5 +1,4 @@
-"""Primary application entrypoint.
-"""
+"""Primary application entrypoint."""
 
 import locale
 import logging

src/pip/_internal/cli/autocompletion.py

@@ -1,5 +1,4 @@
-"""A single place for constructing and exposing the main parser
-"""
+"""A single place for constructing and exposing the main parser"""
 
 import os
 import subprocess

src/pip/_internal/cli/main.py

@@ -1,2 +1 @@
-"""Index interaction code
-"""
+"""Index interaction code"""

src/pip/_internal/cli/main_parser.py

@@ -1,2 +1 @@
-"""A package that contains models that represent entities.
-"""
+"""A package that contains models that represent entities."""

src/pip/_internal/index/__init__.py

@@ -1,4 +1,4 @@
-""" PEP 610 """
+"""PEP 610"""
 
 import json
 import re

src/pip/_internal/models/__init__.py

@@ -1,2 +1 @@
-"""Contains purely network-related utilities.
-"""
+"""Contains purely network-related utilities."""

src/pip/_internal/models/direct_url.py

@@ -1,5 +1,4 @@
-"""HTTP cache implementation.
-"""
+"""HTTP cache implementation."""
 
 import os
 from contextlib import contextmanager

src/pip/_internal/network/__init__.py

@@ -1,5 +1,4 @@
-"""Download files with progress indicators.
-"""
+"""Download files with progress indicators."""
 
 import email.message
 import logging

src/pip/_internal/network/cache.py

@@ -1,5 +1,4 @@
-"""xmlrpclib.Transport implementation
-"""
+"""xmlrpclib.Transport implementation"""
 
 import logging
 import urllib.parse

src/pip/_internal/network/download.py

@@ -1,5 +1,4 @@
-"""Metadata generation logic for source distributions.
-"""
+"""Metadata generation logic for source distributions."""
 
 import os
 

src/pip/_internal/network/xmlrpc.py

@@ -1,5 +1,4 @@
-"""Metadata generation logic for source distributions.
-"""
+"""Metadata generation logic for source distributions."""
 
 import os
 

src/pip/_internal/operations/build/metadata.py

@@ -1,5 +1,4 @@
-"""Metadata generation logic for legacy source distributions.
-"""
+"""Metadata generation logic for legacy source distributions."""
 
 import logging
 import os

src/pip/_internal/operations/build/metadata_editable.py

@@ -1,5 +1,4 @@
-"""Validation of dependencies of packages
-"""
+"""Validation of dependencies of packages"""
 
 import logging
 from contextlib import suppress

src/pip/_internal/operations/build/metadata_legacy.py

@@ -1,2 +1 @@
-"""For modules related to installing packages.
-"""
+"""For modules related to installing packages."""

src/pip/_internal/operations/check.py

@@ -1,5 +1,4 @@
-"""Legacy editable installation process, i.e. `setup.py develop`.
-"""
+"""Legacy editable installation process, i.e. `setup.py develop`."""
 
 import logging
 from typing import Optional, Sequence

src/pip/_internal/operations/install/__init__.py

@@ -1,5 +1,4 @@
-"""Support for installing and building the "wheel" binary package format.
-"""
+"""Support for installing and building the "wheel" binary package format."""
 
 import collections
 import compileall

src/pip/_internal/operations/install/editable_legacy.py

@@ -1,5 +1,4 @@
-"""Prepares a distribution for installation
-"""
+"""Prepares a distribution for installation"""
 
 # The following comment should be removed at some point in the future.
 # mypy: strict-optional=False

src/pip/_internal/operations/install/wheel.py

@@ -38,7 +38,7 @@ def _script_names(
 
 
 def _unique(
-    fn: Callable[..., Generator[Any, None, None]]
+    fn: Callable[..., Generator[Any, None, None]],
 ) -> Callable[..., Generator[Any, None, None]]:
     @functools.wraps(fn)
     def unique(*args: Any, **kw: Any) -> Generator[Any, None, None]:

src/pip/_internal/operations/prepare.py

@@ -1,5 +1,4 @@
-"""Generate and work with PEP 425 Compatibility Tags.
-"""
+"""Generate and work with PEP 425 Compatibility Tags."""
 
 import re
 from typing import List, Optional, Tuple

src/pip/_internal/req/req_uninstall.py

@@ -1,5 +1,4 @@
-"""For when pip wants to check the date or time.
-"""
+"""For when pip wants to check the date or time."""
 
 import datetime
 

src/pip/_internal/utils/compatibility_tags.py

@@ -77,7 +77,10 @@ def get_best_invocation_for_this_python() -> str:
 
     # Try to use the basename, if it's the first executable.
     found_executable = shutil.which(exe_name)
-    if found_executable and os.path.samefile(found_executable, exe):
+    # Virtual environments often symlink to their parent Python binaries, but we don't
+    # want to treat the Python binaries as equivalent when the environment's Python is
+    # not on PATH (not activated). Thus, we don't follow symlinks.
+    if found_executable and os.path.samestat(os.lstat(found_executable), os.lstat(exe)):
         return exe_name
 
     # Use the full executable name, because we couldn't find something simpler.

src/pip/_internal/utils/datetime.py

@@ -1,5 +1,4 @@
-"""Filetype information.
-"""
+"""Filetype information."""
 
 from typing import Tuple
 

src/pip/_internal/utils/entrypoints.py

@@ -1,5 +1,4 @@
-"""Utilities related archives.
-"""
+"""Utilities related archives."""
 
 import logging
 import os

src/pip/_internal/utils/filetypes.py

@@ -1,5 +1,4 @@
-"""Support functions for working with wheel files.
-"""
+"""Support functions for working with wheel files."""
 
 import logging
 from email.message import Message

src/pip/_internal/utils/unpacking.py

@@ -1,5 +1,4 @@
-"""Orchestrator for building wheels from InstallRequirements.
-"""
+"""Orchestrator for building wheels from InstallRequirements."""
 
 import logging
 import os.path

src/pip/_internal/utils/wheel.py

@@ -1,5 +1,4 @@
-"""Basic CLI functionality checks.
-"""
+"""Basic CLI functionality checks."""
 
 import subprocess
 import sys

src/pip/_internal/wheel_builder.py

@@ -1,5 +1,4 @@
-"""Tests for the config command
-"""
+"""Tests for the config command"""
 
 import re
 import textwrap

tests/functional/test_cli.py

@@ -1,5 +1,4 @@
-"""Helpers for tests that check configuration
-"""
+"""Helpers for tests that check configuration"""
 
 import contextlib
 import functools

tests/functional/test_configuration.py

@@ -1,5 +1,4 @@
-"""Helpers for filesystem-dependent tests.
-"""
+"""Helpers for filesystem-dependent tests."""
 
 import os
 from contextlib import contextmanager

tests/lib/configuration_helpers.py

@@ -1,5 +1,4 @@
-"""Provides helper classes for testing option handling in pip
-"""
+"""Provides helper classes for testing option handling in pip"""
 
 from optparse import Values
 from typing import List, Tuple

tests/lib/filesystem.py

@@ -1,5 +1,4 @@
-"""Helper classes as mocks for requests objects.
-"""
+"""Helper classes as mocks for requests objects."""
 
 from io import BytesIO
 from typing import Any, Callable, Dict, Iterator, List, Optional

tests/lib/options_helpers.py

@@ -48,7 +48,7 @@ def make_environ(self) -> Dict[str, Any]:
 
 
 def _mock_wsgi_adapter(
-    mock: Callable[["WSGIEnvironment", "StartResponse"], "WSGIApplication"]
+    mock: Callable[["WSGIEnvironment", "StartResponse"], "WSGIApplication"],
 ) -> "WSGIApplication":
     """Uses a mock to record function arguments and provide
     the actual function that should respond.

tests/lib/requests_mocks.py

@@ -1,5 +1,4 @@
-"""Tests for wheel helper.
-"""
+"""Tests for wheel helper."""
 
 import csv
 from email import message_from_string

tests/lib/server.py

@@ -1,5 +1,4 @@
-"""Helper for building wheels as would be in test cases.
-"""
+"""Helper for building wheels as would be in test cases."""
 
 import csv
 import itertools

tests/lib/test_wheel.py

@@ -35,7 +35,7 @@ def resolver(preparer: RequirementPreparer, finder: PackageFinder) -> Resolver:
 
 
 def _make_graph(
-    edges: List[Tuple[Optional[str], Optional[str]]]
+    edges: List[Tuple[Optional[str], Optional[str]]],
 ) -> "DirectedGraph[Optional[str]]":
     """Build graph from edge declarations."""
 

tests/lib/wheel.py

@@ -66,7 +66,7 @@ def test_user_cache_dir_unicode(self, monkeypatch: pytest.MonkeyPatch) -> None:
             return
 
         def my_get_win_folder(csidl_name: str) -> str:
-            return "\u00DF\u00E4\u03B1\u20AC"
+            return "\u00df\u00e4\u03b1\u20ac"
 
         monkeypatch.setattr(
             platformdirs.windows,  # type: ignore

tests/unit/resolution_resolvelib/test_resolver.py

@@ -56,8 +56,8 @@ class FakeCommandWithUnicode(FakeCommand):
     _name = "fake_unicode"
 
     def run(self, options: Values, args: List[str]) -> int:
-        logging.getLogger("pip.tests").info(b"bytes here \xE9")
-        logging.getLogger("pip.tests").info(b"unicode here \xC3\xA9".decode("utf-8"))
+        logging.getLogger("pip.tests").info(b"bytes here \xe9")
+        logging.getLogger("pip.tests").info(b"unicode here \xc3\xa9".decode("utf-8"))
         return SUCCESS
 
 

tests/unit/test_appdirs.py

@@ -1,5 +1,4 @@
-"""Tests for all things related to the configuration
-"""
+"""Tests for all things related to the configuration"""
 
 import re
 from unittest.mock import MagicMock

tests/unit/test_base_command.py

@@ -1,5 +1,4 @@
-"""Tests for various classes in pip._internal.models
-"""
+"""Tests for various classes in pip._internal.models"""
 
 from pip._vendor.packaging.version import parse as parse_version
 

tests/unit/test_configuration.py

@@ -1,5 +1,4 @@
-"""Checks if the version is acceptable, as per this project's release process.
-"""
+"""Checks if the version is acceptable, as per this project's release process."""
 
 import sys
 from datetime import datetime