FM / rich

/opt/imh/python3.13/lib/python3.13/site-packages/pip/_vendor/rich/

/opt/imh/python3.13/lib/python3.13/site-packages/pip/_vendor/rich

Name	Size	Mode	Actions
__pycache__/	-	0755	rm
abc.py	890	0644	edit dl rm
align.py	10368	0644	edit dl rm
ansi.py	6906	0644	edit dl rm
bar.py	3263	0644	edit dl rm
box.py	10831	0644	edit dl rm
cells.py	4780	0644	edit dl rm
color.py	18223	0644	edit dl rm
color_triplet.py	1054	0644	edit dl rm
columns.py	7131	0644	edit dl rm
console.py	99173	0644	edit dl rm
constrain.py	1288	0644	edit dl rm
containers.py	5502	0644	edit dl rm
control.py	6630	0644	edit dl rm
default_styles.py	8082	0644	edit dl rm
diagnose.py	972	0644	edit dl rm
emoji.py	2501	0644	edit dl rm
errors.py	642	0644	edit dl rm
filesize.py	2508	0644	edit dl rm
file_proxy.py	1683	0644	edit dl rm
highlighter.py	9585	0644	edit dl rm
json.py	5031	0644	edit dl rm
jupyter.py	3252	0644	edit dl rm
layout.py	14004	0644	edit dl rm
live.py	14271	0644	edit dl rm
live_render.py	3666	0644	edit dl rm
logging.py	11903	0644	edit dl rm
markup.py	8451	0644	edit dl rm
measure.py	5305	0644	edit dl rm
padding.py	4970	0644	edit dl rm
pager.py	828	0644	edit dl rm
palette.py	3396	0644	edit dl rm
panel.py	10705	0644	edit dl rm
pretty.py	35848	0644	edit dl rm
progress.py	59715	0644	edit dl rm
progress_bar.py	8164	0644	edit dl rm
prompt.py	11304	0644	edit dl rm
protocol.py	1391	0644	edit dl rm
py.typed	0	0644	edit dl rm
region.py	166	0644	edit dl rm
repr.py	4431	0644	edit dl rm
rule.py	4602	0644	edit dl rm
scope.py	2843	0644	edit dl rm
screen.py	1591	0644	edit dl rm
segment.py	24246	0644	edit dl rm
spinner.py	4339	0644	edit dl rm
status.py	4424	0644	edit dl rm
style.py	27073	0644	edit dl rm
styled.py	1258	0644	edit dl rm
syntax.py	35475	0644	edit dl rm
table.py	39680	0644	edit dl rm
terminal_theme.py	3370	0644	edit dl rm
text.py	47312	0644	edit dl rm
theme.py	3777	0644	edit dl rm
themes.py	102	0644	edit dl rm
traceback.py	29601	0644	edit dl rm
tree.py	9167	0644	edit dl rm
_cell_widths.py	10209	0644	edit dl rm
_emoji_codes.py	140235	0644	edit dl rm
_emoji_replace.py	1064	0644	edit dl rm
_export_format.py	2128	0644	edit dl rm
_extension.py	265	0644	edit dl rm
_fileno.py	799	0644	edit dl rm
_inspect.py	9695	0644	edit dl rm
_log_render.py	3225	0644	edit dl rm
_loop.py	1236	0644	edit dl rm
_null_file.py	1387	0644	edit dl rm
_palettes.py	7063	0644	edit dl rm
_pick.py	423	0644	edit dl rm
_ratio.py	5471	0644	edit dl rm
_spinners.py	19919	0644	edit dl rm
_stack.py	351	0644	edit dl rm
_timer.py	417	0644	edit dl rm
_win32_console.py	22820	0644	edit dl rm
_windows.py	1925	0644	edit dl rm
_windows_renderer.py	2783	0644	edit dl rm
_wrap.py	3404	0644	edit dl rm
__init__.py	6090	0644	edit dl rm
__main__.py	8477	0644	edit dl rm

Edit: /opt/imh/python3.13/lib/python3.13/site-packages/pip/_vendor/rich/prompt.py (11304B)

from typing import Any, Generic, List, Optional, TextIO, TypeVar, Union, overload

from . import get_console
from .console import Console
from .text import Text, TextType

PromptType = TypeVar("PromptType")
DefaultType = TypeVar("DefaultType")

class PromptError(Exception):
    """Exception base class for prompt related errors."""

class InvalidResponse(PromptError):
    """Exception to indicate a response was invalid. Raise this within process_response() to indicate an error
    and provide an error message.

Args:
        message (Union[str, Text]): Error message.
    """

def __init__(self, message: TextType) -> None:
        self.message = message

def __rich__(self) -> TextType:
        return self.message

class PromptBase(Generic[PromptType]):
    """Ask the user for input until a valid response is received. This is the base class, see one of
    the concrete classes for examples.

response_type: type = str

validate_error_message = "[prompt.invalid]Please enter a valid value"
    illegal_choice_message = (
        "[prompt.invalid.choice]Please select one of the available options"
    )
    prompt_suffix = ": "

choices: Optional[List[str]] = None

def __init__(
        self,
        prompt: TextType = "",
        *,
        console: Optional[Console] = None,
        password: bool = False,
        choices: Optional[List[str]] = None,
        show_default: bool = True,
        show_choices: bool = True,
    ) -> None:
        self.console = console or get_console()
        self.prompt = (
            Text.from_markup(prompt, style="prompt")
            if isinstance(prompt, str)
            else prompt
        )
        self.password = password
        if choices is not None:
            self.choices = choices
        self.show_default = show_default
        self.show_choices = show_choices

@classmethod
    @overload
    def ask(
        cls,
        prompt: TextType = "",
        *,
        console: Optional[Console] = None,
        password: bool = False,
        choices: Optional[List[str]] = None,
        show_default: bool = True,
        show_choices: bool = True,
        default: DefaultType,
        stream: Optional[TextIO] = None,
    ) -> Union[DefaultType, PromptType]:
        ...

@classmethod
    @overload
    def ask(
        cls,
        prompt: TextType = "",
        *,
        console: Optional[Console] = None,
        password: bool = False,
        choices: Optional[List[str]] = None,
        show_default: bool = True,
        show_choices: bool = True,
        stream: Optional[TextIO] = None,
    ) -> PromptType:
        ...

@classmethod
    def ask(
        cls,
        prompt: TextType = "",
        *,
        console: Optional[Console] = None,
        password: bool = False,
        choices: Optional[List[str]] = None,
        show_default: bool = True,
        show_choices: bool = True,
        default: Any = ...,
        stream: Optional[TextIO] = None,
    ) -> Any:
        """Shortcut to construct and run a prompt loop and return the result.

Example:
            >>> filename = Prompt.ask("Enter a filename")

Args:
            prompt (TextType, optional): Prompt text. Defaults to "".
            console (Console, optional): A Console instance or None to use global console. Defaults to None.
            password (bool, optional): Enable password input. Defaults to False.
            choices (List[str], optional): A list of valid choices. Defaults to None.
            show_default (bool, optional): Show default in prompt. Defaults to True.
            show_choices (bool, optional): Show choices in prompt. Defaults to True.
            stream (TextIO, optional): Optional text file open for reading to get input. Defaults to None.
        """
        _prompt = cls(
            prompt,
            console=console,
            password=password,
            choices=choices,
            show_default=show_default,
            show_choices=show_choices,
        )
        return _prompt(default=default, stream=stream)

def render_default(self, default: DefaultType) -> Text:
        """Turn the supplied default in to a Text instance.

Args:
            default (DefaultType): Default value.

Returns:
            Text: Text containing rendering of default value.
        """
        return Text(f"({default})", "prompt.default")

def make_prompt(self, default: DefaultType) -> Text:
        """Make prompt text.

Args:
            default (DefaultType): Default value.

Returns:
            Text: Text to display in prompt.
        """
        prompt = self.prompt.copy()
        prompt.end = ""

if self.show_choices and self.choices:
            _choices = "/".join(self.choices)
            choices = f"[{_choices}]"
            prompt.append(" ")
            prompt.append(choices, "prompt.choices")

if (
            default != ...
            and self.show_default
            and isinstance(default, (str, self.response_type))
        ):
            prompt.append(" ")
            _default = self.render_default(default)
            prompt.append(_default)

prompt.append(self.prompt_suffix)

return prompt

@classmethod
    def get_input(
        cls,
        console: Console,
        prompt: TextType,
        password: bool,
        stream: Optional[TextIO] = None,
    ) -> str:
        """Get input from user.

Args:
            console (Console): Console instance.
            prompt (TextType): Prompt text.
            password (bool): Enable password entry.

Returns:
            str: String from user.
        """
        return console.input(prompt, password=password, stream=stream)

def check_choice(self, value: str) -> bool:
        """Check value is in the list of valid choices.

Args:
            value (str): Value entered by user.

Returns:
            bool: True if choice was valid, otherwise False.
        """
        assert self.choices is not None
        return value.strip() in self.choices

def process_response(self, value: str) -> PromptType:
        """Process response from user, convert to prompt type.

Args:
            value (str): String typed by user.

Raises:
            InvalidResponse: If ``value`` is invalid.

Returns:
            PromptType: The value to be returned from ask method.
        """
        value = value.strip()
        try:
            return_value: PromptType = self.response_type(value)
        except ValueError:
            raise InvalidResponse(self.validate_error_message)

if self.choices is not None and not self.check_choice(value):
            raise InvalidResponse(self.illegal_choice_message)

return return_value

def on_validate_error(self, value: str, error: InvalidResponse) -> None:
        """Called to handle validation error.

Args:
            value (str): String entered by user.
            error (InvalidResponse): Exception instance the initiated the error.
        """
        self.console.print(error)

def pre_prompt(self) -> None:
        """Hook to display something before the prompt."""

@overload
    def __call__(self, *, stream: Optional[TextIO] = None) -> PromptType:
        ...

@overload
    def __call__(
        self, *, default: DefaultType, stream: Optional[TextIO] = None
    ) -> Union[PromptType, DefaultType]:
        ...

def __call__(self, *, default: Any = ..., stream: Optional[TextIO] = None) -> Any:
        """Run the prompt loop.

Args:
            default (Any, optional): Optional default value.

Returns:
            PromptType: Processed value.
        """
        while True:
            self.pre_prompt()
            prompt = self.make_prompt(default)
            value = self.get_input(self.console, prompt, self.password, stream=stream)
            if value == "" and default != ...:
                return default
            try:
                return_value = self.process_response(value)
            except InvalidResponse as error:
                self.on_validate_error(value, error)
                continue
            else:
                return return_value

class Prompt(PromptBase[str]):
    """A prompt that returns a str.

Example:
        >>> name = Prompt.ask("Enter your name")

"""

response_type = str

class IntPrompt(PromptBase[int]):
    """A prompt that returns an integer.

Example:
        >>> burrito_count = IntPrompt.ask("How many burritos do you want to order")

"""

response_type = int
    validate_error_message = "[prompt.invalid]Please enter a valid integer number"

class FloatPrompt(PromptBase[float]):
    """A prompt that returns a float.

Example:
        >>> temperature = FloatPrompt.ask("Enter desired temperature")

"""

response_type = float
    validate_error_message = "[prompt.invalid]Please enter a number"

class Confirm(PromptBase[bool]):
    """A yes / no confirmation prompt.

Example:
        >>> if Confirm.ask("Continue"):
                run_job()

"""

response_type = bool
    validate_error_message = "[prompt.invalid]Please enter Y or N"
    choices: List[str] = ["y", "n"]

def render_default(self, default: DefaultType) -> Text:
        """Render the default as (y) or (n) rather than True/False."""
        yes, no = self.choices
        return Text(f"({yes})" if default else f"({no})", style="prompt.default")

def process_response(self, value: str) -> bool:
        """Convert choices to a bool."""
        value = value.strip().lower()
        if value not in self.choices:
            raise InvalidResponse(self.validate_error_message)
        return value == self.choices[0]

if __name__ == "__main__":  # pragma: no cover
    from pip._vendor.rich import print

if Confirm.ask("Run [i]prompt[/i] tests?", default=True):
        while True:
            result = IntPrompt.ask(
                ":rocket: Enter a number between [b]1[/b] and [b]10[/b]", default=5
            )
            if result >= 1 and result <= 10:
                break
            print(":pile_of_poo: [prompt.invalid]Number must be between 1 and 10")
        print(f"number={result}")

while True:
            password = Prompt.ask(
                "Please enter a password [cyan](must be at least 5 characters)",
                password=True,
            )
            if len(password) >= 5:
                break
            print("[prompt.invalid]password too short")
        print(f"password={password!r}")

fruit = Prompt.ask("Enter a fruit", choices=["apple", "orange", "pear"])
        print(f"fruit={fruit!r}")

else:
        print("[b]OK :loudly_crying_face:")

cmd: