pip 25.1__tar.gz → 25.2__tar.gz

{pip-25.1 → pip-25.2}/AUTHORS.txt

@@ -220,11 +220,13 @@ Davidovich
 ddelange
 Deepak Sharma
 Deepyaman Datta
+Denis Roussel (ACSONE)
 Denise Yu
 dependabot[bot]
 derwolfe
 Desetude
 developer
+Devesh Kumar
 Devesh Kumar Singh
 devsagul
 Diego Caraballo
@@ -295,6 +297,7 @@ Gabriel de Perthuis
 Garry Polley
 gavin
 gdanielson
+Gene Wood
 Geoffrey Sneddon
 George Margaritis
 George Song
@@ -333,6 +336,7 @@ Hugo Lopes Tavares
 Hugo van Kemenade
 Hugues Bruant
 Hynek Schlawack
+iamsrp-deshaw
 Ian Bicking
 Ian Cordasco
 Ian Lee
@@ -640,6 +644,7 @@ Pulkit Goyal
 q0w
 Qiangning Hong
 Qiming Xu
+qraqras
 Quentin Lee
 Quentin Pradet
 R. David Murray
@@ -665,6 +670,7 @@ Robert McGibbon
 Robert Pollak
 Robert T. McGibbon
 robin elisha robinson
+Rodney, Tiara
 Roey Berman
 Rohan Jain
 Roman Bogorodskiy
@@ -680,6 +686,7 @@ Russell Keith-Magee
 Ryan Shepherd
 Ryan Wooden
 ryneeverett
+Ryuma Asai
 S. Guliaev
 Sachi King
 Salvatore Rinchiera
@@ -694,6 +701,8 @@ Sebastian Jordan
 Sebastian Schaetz
 Segev Finer
 SeongSoo Cho
+Sepehr Rasouli
+sepehrrasooli
 Sergey Vasilyev
 Seth Michael Larson
 Seth Woodworth
@@ -719,6 +728,7 @@ Stavros Korokithakis
 Stefan Scherfke
 Stefano Rivera
 Stephan Erb
+Stephen Payne
 Stephen Rosen
 stepshal
 Steve (Gadget) Barnes
@@ -811,7 +821,9 @@ Yeray Diaz Diaz
 Yoval P
 Yu Jian
 Yuan Jing Vincent Yan
+Yuki Kobayashi
 Yusuke Hayashi
+zackzack38
 Zearin
 Zhiping Deng
 ziebam

{pip-25.1 → pip-25.2}/MANIFEST.in

@@ -1,5 +1,3 @@
-include AUTHORS.txt
-include LICENSE.txt
 include NEWS.rst
 include README.rst
 include SECURITY.md
@@ -12,8 +10,6 @@ include build-project/.python-version
 
 include src/pip/_vendor/README.rst
 include src/pip/_vendor/vendor.txt
-recursive-include  src/pip/_vendor *LICENSE*
-recursive-include  src/pip/_vendor *COPYING*
 
 include docs/requirements.txt
 

{pip-25.1 → pip-25.2}/NEWS.rst

@@ -9,6 +9,85 @@
 
 .. towncrier release notes start
 
+25.2 (2025-07-30)
+=================
+
+Features
+--------
+
+- Declare support for Python 3.14 (`#13506 <https://github.com/pypa/pip/issues/13506>`_)
+- Automatic download resumption and retrying is enabled by default. (`#13464 <https://github.com/pypa/pip/issues/13464>`_)
+- Requires-Python error message displays version clauses in numerical order. (`#13367 <https://github.com/pypa/pip/issues/13367>`_)
+- Minor performance improvement getting the order to install a very large number of interdependent packages. (`#13424 <https://github.com/pypa/pip/issues/13424>`_)
+- Show time taken instead of ``eta 0:00:00`` at download completion. (`#13483 <https://github.com/pypa/pip/issues/13483>`_)
+- Speed up small CLI tools by removing ``import re`` from the console
+  script executable template. (`#13165 <https://github.com/pypa/pip/issues/13165>`_)
+- Remove warning when cloning from a Git reference that does not look like a commit hash. (`#12283 <https://github.com/pypa/pip/issues/12283>`_)
+
+Bug Fixes
+---------
+
+- ``pip config debug`` now correctly separates options as set by the different files
+  at the same level. (`#12099 <https://github.com/pypa/pip/issues/12099>`_)
+- Ensure truststore feature remains active even when a proxy is also in use. (`#13343 <https://github.com/pypa/pip/issues/13343>`_)
+- Include sub-commands in tab completion. (`#13140 <https://github.com/pypa/pip/issues/13140>`_)
+- ``pip list`` with the ``json`` or ``freeze`` format enabled will no longer
+  crash when encountering a package with an invalid version. (`#13345 <https://github.com/pypa/pip/issues/13345>`_)
+- Provide a hint if a system error is raised involving long filenames or path segments on Windows. (`#13346 <https://github.com/pypa/pip/issues/13346>`_)
+- Resumed downloads are saved to the HTTP cache like any other normal download. (`#13441 <https://github.com/pypa/pip/issues/13441>`_)
+- Configured verbosity is consistently forwarded while calling Git during
+  VCS operations. (`#13329 <https://github.com/pypa/pip/issues/13329>`_)
+- Suppress the progress bar, when running with ``--log`` and ``--quiet``.
+
+  Consequently, a new ``auto`` mode for ``--progress-bar`` has been added.
+  ``auto`` will enable progress bars unless suppressed by ``--quiet``,
+  while ``on`` will always enable progress bars. (`#10915 <https://github.com/pypa/pip/issues/10915>`_)
+- Fix normalization of local URLs with non-``file`` schemes. (`#13509 <https://github.com/pypa/pip/issues/13509>`_)
+- Fix normalization of local file URLs on Windows in newer Python versions. (`#13510 <https://github.com/pypa/pip/issues/13510>`_)
+- Fix remaining test failures in Python 3.14 by adjusting ``path_to_url`` and similar functions. (`#13423 <https://github.com/pypa/pip/issues/13423>`_)
+- Fix missing ``network`` test markings, making the suite pass in offline
+  environments again. (`#13378 <https://github.com/pypa/pip/issues/13378>`_)
+
+Vendored Libraries
+------------------
+
+- Upgrade CacheControl to 0.14.3
+- Upgrade certifi to 2025.7.14
+- Upgrade distlib to 0.4.0
+- Upgrade msgpack to 1.1.1
+- Upgrade platformdirs to 4.3.8
+- Upgrade pygments to 2.19.2
+- Upgrade requests to 2.32.4
+- Upgrade resolvelib to 1.2.0
+- Upgrade rich to 14.1.0
+- Remove vendored typing-extensions.
+
+Process
+-------
+
+- pip's own licensing metadata now follows :pep:`639`.
+  In addition, the licenses of pip's vendored dependencies are now included
+  in the ``License-File`` metadata field and in the wheel.
+
+25.1.1 (2025-05-02)
+===================
+
+Bug Fixes
+---------
+
+- Fix ``req.source_dir`` AssertionError when using the legacy resolver. (`#13353 <https://github.com/pypa/pip/issues/13353>`_)
+- Fix crash on Python 3.9.6 and lower when pip failed to compile a Python module
+  during installation. (`#13364 <https://github.com/pypa/pip/issues/13364>`_)
+- Names in dependency group includes are now normalized before lookup, which
+  fixes incorrect ``Dependency group '...' not found`` errors. (`#13372 <https://github.com/pypa/pip/issues/13372>`_)
+
+Vendored Libraries
+------------------
+
+- Fix issues with using tomllib from the stdlib if available, rather than tomli
+- Upgrade dependency-groups to 1.3.1
+
+
 25.1 (2025-04-26)
 =================
 

{pip-25.1 → pip-25.2}/PKG-INFO

@@ -1,16 +1,15 @@
 Metadata-Version: 2.4
 Name: pip
-Version: 25.1
+Version: 25.2
 Summary: The PyPA recommended tool for installing Python packages.
 Author-email: The pip developers <distutils-sig@python.org>
-License: MIT
+License-Expression: MIT
 Project-URL: Homepage, https://pip.pypa.io/
 Project-URL: Documentation, https://pip.pypa.io
 Project-URL: Source, https://github.com/pypa/pip
 Project-URL: Changelog, https://pip.pypa.io/en/stable/news/
 Classifier: Development Status :: 5 - Production/Stable
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Topic :: Software Development :: Build Tools
 Classifier: Programming Language :: Python
 Classifier: Programming Language :: Python :: 3
@@ -20,12 +19,35 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Programming Language :: Python :: Implementation :: CPython
 Classifier: Programming Language :: Python :: Implementation :: PyPy
 Requires-Python: >=3.9
 Description-Content-Type: text/x-rst
-License-File: LICENSE.txt
 License-File: AUTHORS.txt
+License-File: LICENSE.txt
+License-File: src/pip/_vendor/msgpack/COPYING
+License-File: src/pip/_vendor/cachecontrol/LICENSE.txt
+License-File: src/pip/_vendor/certifi/LICENSE
+License-File: src/pip/_vendor/dependency_groups/LICENSE.txt
+License-File: src/pip/_vendor/distlib/LICENSE.txt
+License-File: src/pip/_vendor/distro/LICENSE
+License-File: src/pip/_vendor/idna/LICENSE.md
+License-File: src/pip/_vendor/packaging/LICENSE
+License-File: src/pip/_vendor/packaging/LICENSE.APACHE
+License-File: src/pip/_vendor/packaging/LICENSE.BSD
+License-File: src/pip/_vendor/pkg_resources/LICENSE
+License-File: src/pip/_vendor/platformdirs/LICENSE
+License-File: src/pip/_vendor/pygments/LICENSE
+License-File: src/pip/_vendor/pyproject_hooks/LICENSE
+License-File: src/pip/_vendor/requests/LICENSE
+License-File: src/pip/_vendor/resolvelib/LICENSE
+License-File: src/pip/_vendor/rich/LICENSE
+License-File: src/pip/_vendor/tomli/LICENSE
+License-File: src/pip/_vendor/tomli/LICENSE-HEADER
+License-File: src/pip/_vendor/tomli_w/LICENSE
+License-File: src/pip/_vendor/truststore/LICENSE
+License-File: src/pip/_vendor/urllib3/LICENSE.txt
 Dynamic: license-file
 
 pip - The Python Package Installer

{pip-25.1 → pip-25.2}/build-project/build-requirements.txt

@@ -18,7 +18,7 @@ pyproject-hooks==1.2.0 \
     # via build
 
 # The following packages are considered to be unsafe in a requirements file:
-setuptools==79.0.0 \
-    --hash=sha256:9828422e7541213b0aacb6e10bbf9dd8febeaa45a48570e09b6d100e063fc9f9 \
-    --hash=sha256:b9ab3a104bedb292323f53797b00864e10e434a3ab3906813a7169e4745b912a
+setuptools==80.9.0 \
+    --hash=sha256:062d34222ad13e0cc312a4c02d73f059e86a4acbfbdea8f8f76b28c99f306922 \
+    --hash=sha256:f36b47402ecde768dbfafc46e8e4207b4360c654f1f3bb84475f0a28628fb19c
     # via -r build-requirements.in

{pip-25.1 → pip-25.2}/docs/html/cli/pip_download.rst

@@ -204,9 +204,9 @@ Examples
          pip-8.1.1-py2.py3-none-any.whl
 
 #. Download a package supporting one of several ABIs and platforms.
-    This is useful when fetching wheels for a well-defined interpreter, whose
-    supported ABIs and platforms are known and fixed, different than the one pip is
-    running under.
+   This is useful when fetching wheels for a well-defined interpreter, whose
+   supported ABIs and platforms are known and fixed, different than the one pip is
+   running under.
 
    .. tab:: Unix/macOS
 

{pip-25.1 → pip-25.2}/docs/html/cli/pip_install.rst

@@ -321,7 +321,7 @@ Examples
 
          py -m pip install --upgrade SomePackage
 
-    .. note::
+   .. note::
 
       This will guarantee an update to ``SomePackage`` as it is a direct
       requirement, and possibly upgrade dependencies if their installed

{pip-25.1 → pip-25.2}/docs/html/cli/pip_list.rst

@@ -142,10 +142,10 @@ Examples
 
 #. List packages installed in editable mode
 
-When some packages are installed in editable mode, ``pip list`` outputs an
-additional column that shows the directory where the editable project is
-located (i.e. the directory that contains the ``pyproject.toml`` or
-``setup.py`` file).
+   When some packages are installed in editable mode, ``pip list`` outputs an
+   additional column that shows the directory where the editable project is
+   located (i.e. the directory that contains the ``pyproject.toml`` or
+   ``setup.py`` file).
 
    .. tab:: Unix/macOS
 
@@ -172,7 +172,7 @@ located (i.e. the directory that contains the ``pyproject.toml`` or
          setuptools       57.4.0
          wheel            0.36.2
 
-The json format outputs an additional ``editable_project_location`` field.
+   The json format outputs an additional ``editable_project_location`` field.
 
    .. tab:: Unix/macOS
 

{pip-25.1 → pip-25.2}/docs/html/conf.py

@@ -5,7 +5,6 @@ import os
 import pathlib
 import re
 import sys
-from typing import List, Tuple
 
 # Add the docs/ directory to sys.path, because pip_sphinxext.py is there.
 docs_dir = os.path.dirname(os.path.dirname(__file__))
@@ -101,7 +100,7 @@ html_use_index = False
 
 
 # List of manual pages generated
-def determine_man_pages() -> List[Tuple[str, str, str, str, int]]:
+def determine_man_pages() -> list[tuple[str, str, str, str, int]]:
     """Determine which man pages need to be generated."""
 
     def to_document_name(path: str, base_dir: str) -> str:

{pip-25.1 → pip-25.2}/docs/html/development/architecture/overview.rst

@@ -42,13 +42,13 @@ In sequence, what does pip do?:
    user-given requirements, and where to get them from.
 
    a. this step is convoluted - also exploratory, involves dependency
-         resolution -- we need to get to the index, see what versions
-         are available
+      resolution -- we need to get to the index, see what versions
+      are available
 
    b. Sometimes you need to build the package itself in order to get
-         dependency information, which means fetching the package from
-         package index, which means knowing whether it exists. For a
-         single package,
+      dependency information, which means fetching the package from
+      package index, which means knowing whether it exists. For a
+      single package,
 
 4. Install the actual items to be installed.
 

{pip-25.1 → pip-25.2}/docs/html/development/ci.rst

@@ -23,6 +23,7 @@ pip support a variety of Python interpreters:
 - CPython 3.11
 - CPython 3.12
 - CPython 3.13
+- CPython 3.14
 - Latest PyPy3
 
 on different operating systems:
@@ -37,7 +38,7 @@ and on different architectures:
 - x86
 - arm64 (macOS only)
 
-so 49 hypothetical interpreters.
+so 56 hypothetical interpreters.
 
 
 Checks
@@ -100,6 +101,8 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|               |                 |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|               |                 |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 |  Windows  +----------+-------+---------------+-----------------+
 |           |   x64    | CP3.9 |   GitHub      |   GitHub        |
@@ -112,6 +115,8 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|   GitHub      |   GitHub        |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|   GitHub      |   GitHub        |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 +-----------+----------+-------+---------------+-----------------+
 |           |   x86    | CP3.9 |               |                 |
@@ -124,6 +129,8 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|               |                 |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|               |                 |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 |   Linux   +----------+-------+---------------+-----------------+
 |           |   x64    | CP3.9 |   GitHub      |   GitHub        |
@@ -136,6 +143,8 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|   GitHub      |   GitHub        |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|   GitHub      |   GitHub        |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 +-----------+----------+-------+---------------+-----------------+
 |           |  arm64   | CP3.9 |   GitHub      |   GitHub        |
@@ -148,6 +157,8 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|   GitHub      |   GitHub        |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|   GitHub      |   GitHub        |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 |   macOS   +----------+-------+---------------+-----------------+
 |           |   x64    | CP3.9 |   GitHub      |   GitHub        |
@@ -160,5 +171,7 @@ Actual testing
 |           |          +-------+---------------+-----------------+
 |           |          | CP3.13|   GitHub      |   GitHub        |
 |           |          +-------+---------------+-----------------+
+|           |          | CP3.14|   GitHub      |   GitHub        |
+|           |          +-------+---------------+-----------------+
 |           |          | PyPy3 |               |                 |
 +-----------+----------+-------+---------------+-----------------+

{pip-25.1 → pip-25.2}/docs/html/development/contributing.rst

@@ -35,6 +35,15 @@ Examples include re-flowing text in comments or documentation, or adding or
 removing blank lines or whitespace within lines. Such changes can be made
 separately, as a "formatting cleanup" PR, if needed.
 
+.. attention::
+
+   While contributors may use whatever tools they like when developing a pull
+   request, it is the contributor's responsibility to ensure that submitted
+   code meets the project requirements, and that they understand the submitted
+   code well enough to respond to review comments.
+
+   In particular, we will mark LLM-generated slop as spam without additional
+   discussion.
 
 Automated Testing
 =================

{pip-25.1 → pip-25.2}/docs/html/ux-research-design/guidance.md

@@ -344,6 +344,24 @@ Designing for pip includes:
 - Writing pip's _output_ - establishing how pip responds to commands and what information it provides the user. This includes writing success and error messages.
 - Providing supplemental materials - e.g. documentation that helps users understand pip's operation
 
+### Error Message Format
+
+A good error message should mention:
+
+* what the user has tried to do
+* possible next steps to try and solve the error
+  * possible steps need to go from "easiest" to "most complicated"
+* why the error has happened - include a way to see more information
+  about the situation
+
+A [sample `ResolutionImpossible` error that follows this guidance
+is available](resolution-impossible-example).
+
+**Further reading**
+
+- <https://uxplanet.org/how-to-write-good-error-messages-858e4551cd4>
+- <https://www.nngroup.com/articles/error-message-guidelines/>
+
 ### Design Principles / Usability Heuristics
 
 There are many interaction design principles that help designers design great experiences. Nielsen Norman's [10 Usability Heuristics for User Interface Design](https://www.nngroup.com/articles/ten-usability-heuristics) is a great place to start. Here are some of the ways these principles apply to pip:

pip-25.2/docs/html/ux-research-design/resolution-impossible-example.md

@@ -0,0 +1,92 @@
+---
+orphan:
+---
+
+# Example error: ResolutionImpossible
+
+## What if there are user-provided pinned packages?
+
+Where a user wants to install packages (with 1 or more pinned version)
+with default verbose level
+
+```
+$ pip install peach=1.0 apple=2.0
+
+Due to conflicting dependencies pip cannot install Peach1.0 and Apple2.0:
+
+* Peach 1.0 depends on Banana 3.0
+* Apple2.0 depends on Banana2.0
+
+There are a number of possible solutions. You can try:
+1. removing package versions from your requirements, and letting pip try to resolve the problem for you
+2. Trying  a version of Peach that depends on Banana2.0. Try `pip-search peach —dep banana2.0`
+3. replacing Apple or Peach with a different package altogether
+4. patching Apple2.0 to use Banana3.0
+5. force installing (Be aware!)
+
+For instructions on how to do these steps visit: https://pypa.io/SomeLink
+To debug this further you can run `pip-tree` to see all of your dependencies.
+```
+
+**with verbose level -vv**
+
+If a user ran the same pip command with more verbosity, what would they see?
+
+**with verbose level -vvv**
+
+If a user ran the same pip command with more verbosity, what would they see?
+
+## What if there are no user-provided version restrictions?
+
+NB: We are assuming this resolver behaviour gets implemented, based on [GH issues 8249](https://github.com/pypa/pip/issues/8249).
+
+**with default verbose level**
+
+```
+$ pip install apple peach
+
+Due to conflicting dependencies pip cannot install apple or peach. Both depend on banana, but pip can't find a version of either where they depend on the same banana version.
+
+There are a number of possible solutions. You can try:
+1. replacing apple or peach with a different package altogether
+2. patching apple or peach to use the same version of banana
+3. force installing (Be aware!)
+
+To debug this further you can run pip-tree to see all of your dependencies.
+```
+
+**with verbose level -vv**
+
+If a user ran the same pip command with more verbosity, what would they see?
+
+**with verbose level -vvv**
+
+If a user ran the same pip command with more verbosity, what would they see?
+
+**What should be in the "documentation" page?**
+
+* ways to swap a package for another
+* how to patch a package to support a version (various ways)
+
+## Recommendations
+
+* Write official documentation / guide "How to resolve dependency conflicts" explaining:
+  * Why conflicts can exist
+  * How you can avoid them (pinning)
+  * How you can resolve them
+    * Use alternative package
+    * Use older version
+    * Patch package
+* Introduce new commands to pip, inspired by poetry:
+  * Tree: Show full tree of dependencies
+  * Show `<package>` Show details of a package, including it's dependencies
+  * latest - shows latest vs installed versions
+  * outdated - shows only outdated versions
+* Expose commands / help link in output??
+  * when particular issue happens provide ways to move on (ala pipenv), e.g.
+    * run this command to see X
+    * is it your internet connection?
+    * is it the pypi website?
+* Aspirational commands
+  * `pip search PackageName —dep PackageNameVersion`
+    * a command that will search for a version of a package that has a dependency on another packageversion

{pip-25.1 → pip-25.2}/docs/pip_sphinxext.py

@@ -1,11 +1,13 @@
 """pip sphinx extensions"""
 
+from __future__ import annotations
+
 import optparse
 import pathlib
 import re
 import sys
+from collections.abc import Iterable, Iterator
 from textwrap import dedent
-from typing import Dict, Iterable, Iterator, List, Optional, Union
 
 from docutils import nodes, statemachine
 from docutils.parsers import rst
@@ -24,7 +26,7 @@ def convert_cli_option_to_envvar(opt_name: str) -> str:
     return f"PIP_{normalized_opt_name}"
 
 
-def convert_cli_opt_names_to_envvars(original_cli_opt_names: List[str]) -> List[str]:
+def convert_cli_opt_names_to_envvars(original_cli_opt_names: list[str]) -> list[str]:
     return [
         convert_cli_option_to_envvar(opt_name) for opt_name in original_cli_opt_names
     ]
@@ -33,9 +35,7 @@ def convert_cli_opt_names_to_envvars(original_cli_opt_names: List[str]) -> List[
 class PipNewsInclude(rst.Directive):
     required_arguments = 1
 
-    def _is_version_section_title_underline(
-        self, prev: Optional[str], curr: str
-    ) -> bool:
+    def _is_version_section_title_underline(self, prev: str | None, curr: str) -> bool:
         """Find a ==== line that marks the version section title."""
         if prev is None:
             return False
@@ -69,7 +69,7 @@ class PipNewsInclude(rst.Directive):
         if prev is not None:
             yield prev
 
-    def run(self) -> List[nodes.Node]:
+    def run(self) -> list[nodes.Node]:
         source = self.state_machine.input_lines.source(
             self.lineno - self.state_machine.input_offset - 1,
         )
@@ -90,7 +90,7 @@ class PipCommandUsage(rst.Directive):
     required_arguments = 1
     optional_arguments = 3
 
-    def run(self) -> List[nodes.Node]:
+    def run(self) -> list[nodes.Node]:
         cmd = create_command(self.arguments[0])
         cmd_prefix = "python -m pip"
         if len(self.arguments) > 1:
@@ -105,7 +105,7 @@ class PipCommandUsage(rst.Directive):
 class PipCommandDescription(rst.Directive):
     required_arguments = 1
 
-    def run(self) -> List[nodes.Node]:
+    def run(self) -> list[nodes.Node]:
         node = nodes.paragraph()
         node.document = self.state.document
         desc = ViewList()
@@ -120,8 +120,8 @@ class PipCommandDescription(rst.Directive):
 
 class PipOptions(rst.Directive):
     def _format_option(
-        self, option: optparse.Option, cmd_name: Optional[str] = None
-    ) -> List[str]:
+        self, option: optparse.Option, cmd_name: str | None = None
+    ) -> list[str]:
         bookmark_line = (
             f".. _`{cmd_name}_{option._long_opts[0]}`:"
             if cmd_name
@@ -157,7 +157,7 @@ class PipOptions(rst.Directive):
         ]
 
     def _format_options(
-        self, options: Iterable[optparse.Option], cmd_name: Optional[str] = None
+        self, options: Iterable[optparse.Option], cmd_name: str | None = None
     ) -> None:
         for option in options:
             if option.help == optparse.SUPPRESS_HELP:
@@ -165,7 +165,7 @@ class PipOptions(rst.Directive):
             for line in self._format_option(option, cmd_name):
                 self.view_list.append(line, "")
 
-    def run(self) -> List[nodes.Node]:
+    def run(self) -> list[nodes.Node]:
         node = nodes.paragraph()
         node.document = self.state.document
         self.view_list = ViewList()
@@ -242,7 +242,7 @@ class PipCLIDirective(rst.Directive):
     has_content = True
     optional_arguments = 1
 
-    def run(self) -> List[nodes.Node]:
+    def run(self) -> list[nodes.Node]:
         node = nodes.paragraph()
         node.document = self.state.document
 
@@ -310,7 +310,7 @@ class PipCLIDirective(rst.Directive):
         return [node]
 
 
-def setup(app: Sphinx) -> Dict[str, Union[bool, str]]:
+def setup(app: Sphinx) -> dict[str, bool | str]:
     app.add_directive("pip-command-usage", PipCommandUsage)
     app.add_directive("pip-command-description", PipCommandDescription)
     app.add_directive("pip-command-options", PipCommandOptions)