__ __ __ __ _____ _ _ _____ _ _ _ | \/ | \ \ / / | __ \ (_) | | / ____| | | | | | \ / |_ __\ V / | |__) | __ ___ ____ _| |_ ___ | (___ | |__ ___| | | | |\/| | '__|> < | ___/ '__| \ \ / / _` | __/ _ \ \___ \| '_ \ / _ \ | | | | | | |_ / . \ | | | | | |\ V / (_| | || __/ ____) | | | | __/ | | |_| |_|_(_)_/ \_\ |_| |_| |_| \_/ \__,_|\__\___| |_____/|_| |_|\___V 2.1 if you need WebShell for Seo everyday contact me on Telegram Telegram Address : @jackleetFor_More_Tools:
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.
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.
"""
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 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:")
| Name | Type | Size | Permission | Actions |
|---|---|---|---|---|
| __pycache__ | Folder | 0755 |
|
|
| __init__.py | File | 5.92 KB | 0644 |
|
| __main__.py | File | 8.14 KB | 0644 |
|
| _cell_widths.py | File | 9.97 KB | 0644 |
|
| _emoji_codes.py | File | 136.95 KB | 0644 |
|
| _emoji_replace.py | File | 1.04 KB | 0644 |
|
| _export_format.py | File | 2.08 KB | 0644 |
|
| _extension.py | File | 241 B | 0644 |
|
| _fileno.py | File | 799 B | 0644 |
|
| _inspect.py | File | 9.47 KB | 0644 |
|
| _log_render.py | File | 3.14 KB | 0644 |
|
| _loop.py | File | 1.21 KB | 0644 |
|
| _null_file.py | File | 1.35 KB | 0644 |
|
| _palettes.py | File | 6.9 KB | 0644 |
|
| _pick.py | File | 423 B | 0644 |
|
| _ratio.py | File | 5.33 KB | 0644 |
|
| _spinners.py | File | 19.45 KB | 0644 |
|
| _stack.py | File | 351 B | 0644 |
|
| _timer.py | File | 417 B | 0644 |
|
| _win32_console.py | File | 22.25 KB | 0644 |
|
| _windows.py | File | 1.86 KB | 0644 |
|
| _windows_renderer.py | File | 2.69 KB | 0644 |
|
| _wrap.py | File | 3.32 KB | 0644 |
|
| abc.py | File | 878 B | 0644 |
|
| align.py | File | 10.08 KB | 0644 |
|
| ansi.py | File | 6.74 KB | 0644 |
|
| bar.py | File | 3.19 KB | 0644 |
|
| box.py | File | 10.53 KB | 0644 |
|
| cells.py | File | 4.67 KB | 0644 |
|
| color.py | File | 17.8 KB | 0644 |
|
| color_triplet.py | File | 1.03 KB | 0644 |
|
| columns.py | File | 6.96 KB | 0644 |
|
| console.py | File | 96.78 KB | 0644 |
|
| constrain.py | File | 1.26 KB | 0644 |
|
| containers.py | File | 5.37 KB | 0644 |
|
| control.py | File | 6.45 KB | 0644 |
|
| default_styles.py | File | 7.86 KB | 0644 |
|
| diagnose.py | File | 924 B | 0644 |
|
| emoji.py | File | 2.41 KB | 0644 |
|
| errors.py | File | 642 B | 0644 |
|
| file_proxy.py | File | 1.64 KB | 0644 |
|
| filesize.py | File | 2.45 KB | 0644 |
|
| highlighter.py | File | 9.36 KB | 0644 |
|
| json.py | File | 4.9 KB | 0644 |
|
| jupyter.py | File | 3.15 KB | 0644 |
|
| layout.py | File | 13.62 KB | 0644 |
|
| live.py | File | 13.94 KB | 0644 |
|
| live_render.py | File | 3.57 KB | 0644 |
|
| logging.py | File | 11.61 KB | 0644 |
|
| markdown.py | File | 25.55 KB | 0644 |
|
| markup.py | File | 8.23 KB | 0644 |
|
| measure.py | File | 5.18 KB | 0644 |
|
| padding.py | File | 4.84 KB | 0644 |
|
| pager.py | File | 828 B | 0644 |
|
| palette.py | File | 3.21 KB | 0644 |
|
| panel.py | File | 10.45 KB | 0644 |
|
| pretty.py | File | 34.97 KB | 0644 |
|
| progress.py | File | 58.3 KB | 0644 |
|
| progress_bar.py | File | 7.97 KB | 0644 |
|
| prompt.py | File | 11.03 KB | 0644 |
|
| protocol.py | File | 1.33 KB | 0644 |
|
| py.typed | File | 0 B | 0644 |
|
| region.py | File | 166 B | 0644 |
|
| repr.py | File | 4.32 KB | 0644 |
|
| rule.py | File | 4.48 KB | 0644 |
|
| scope.py | File | 2.76 KB | 0644 |
|
| screen.py | File | 1.54 KB | 0644 |
|
| segment.py | File | 23.64 KB | 0644 |
|
| spinner.py | File | 4.24 KB | 0644 |
|
| status.py | File | 4.32 KB | 0644 |
|
| style.py | File | 26.44 KB | 0644 |
|
| styled.py | File | 1.21 KB | 0644 |
|
| syntax.py | File | 34.54 KB | 0644 |
|
| table.py | File | 38.71 KB | 0644 |
|
| terminal_theme.py | File | 3.29 KB | 0644 |
|
| text.py | File | 46.19 KB | 0644 |
|
| theme.py | File | 3.69 KB | 0644 |
|
| themes.py | File | 102 B | 0644 |
|
| traceback.py | File | 28.84 KB | 0644 |
|
| tree.py | File | 8.89 KB | 0644 |
|