Voice et bot modif

venv/lib/python3.12/site-packages/pip/_internal/utils/subprocess.py

@@ -1,11 +1,17 @@
-from __future__ import annotations
-
 import logging
 import os
 import shlex
 import subprocess
-from collections.abc import Iterable, Mapping
-from typing import Any, Callable, Literal, Union
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Iterable,
+    List,
+    Mapping,
+    Optional,
+    Union,
+)
 
 from pip._vendor.rich.markup import escape
 
@@ -14,10 +20,16 @@ from pip._internal.exceptions import InstallationSubprocessError
 from pip._internal.utils.logging import VERBOSE, subprocess_logger
 from pip._internal.utils.misc import HiddenText
 
-CommandArgs = list[Union[str, HiddenText]]
+if TYPE_CHECKING:
+    # Literal was introduced in Python 3.8.
+    #
+    # TODO: Remove `if TYPE_CHECKING` when dropping support for Python 3.7.
+    from typing import Literal
+
+CommandArgs = List[Union[str, HiddenText]]
 
 
-def make_command(*args: str | HiddenText | CommandArgs) -> CommandArgs:
+def make_command(*args: Union[str, HiddenText, CommandArgs]) -> CommandArgs:
     """
     Create a CommandArgs object.
     """
@@ -34,7 +46,7 @@ def make_command(*args: str | HiddenText | CommandArgs) -> CommandArgs:
     return command_args
 
 
-def format_command_args(args: list[str] | CommandArgs) -> str:
+def format_command_args(args: Union[List[str], CommandArgs]) -> str:
     """
     Format command arguments for display.
     """
@@ -49,7 +61,7 @@ def format_command_args(args: list[str] | CommandArgs) -> str:
     )
 
 
-def reveal_command_args(args: list[str] | CommandArgs) -> list[str]:
+def reveal_command_args(args: Union[List[str], CommandArgs]) -> List[str]:
     """
     Return the arguments in their raw, unredacted form.
     """
@@ -57,16 +69,16 @@ def reveal_command_args(args: list[str] | CommandArgs) -> list[str]:
 
 
 def call_subprocess(
-    cmd: list[str] | CommandArgs,
+    cmd: Union[List[str], CommandArgs],
     show_stdout: bool = False,
-    cwd: str | None = None,
-    on_returncode: Literal["raise", "warn", "ignore"] = "raise",
-    extra_ok_returncodes: Iterable[int] | None = None,
-    extra_environ: Mapping[str, Any] | None = None,
-    unset_environ: Iterable[str] | None = None,
-    spinner: SpinnerInterface | None = None,
-    log_failed_cmd: bool | None = True,
-    stdout_only: bool | None = False,
+    cwd: Optional[str] = None,
+    on_returncode: 'Literal["raise", "warn", "ignore"]' = "raise",
+    extra_ok_returncodes: Optional[Iterable[int]] = None,
+    extra_environ: Optional[Mapping[str, Any]] = None,
+    unset_environ: Optional[Iterable[str]] = None,
+    spinner: Optional[SpinnerInterface] = None,
+    log_failed_cmd: Optional[bool] = True,
+    stdout_only: Optional[bool] = False,
     *,
     command_desc: str,
 ) -> str:
@@ -232,9 +244,9 @@ def runner_with_spinner_message(message: str) -> Callable[..., None]:
     """
 
     def runner(
-        cmd: list[str],
-        cwd: str | None = None,
-        extra_environ: Mapping[str, Any] | None = None,
+        cmd: List[str],
+        cwd: Optional[str] = None,
+        extra_environ: Optional[Mapping[str, Any]] = None,
     ) -> None:
         with open_spinner(message) as spinner:
             call_subprocess(