Initial commit: Tamigo CLI with Gitea Actions and global installation support

venv/lib/python3.12/site-packages/questionary/prompts/text.py

@@ -0,0 +1,101 @@
+from typing import Any
+from typing import List
+from typing import Optional
+from typing import Tuple
+
+from prompt_toolkit.document import Document
+from prompt_toolkit.lexers import Lexer
+from prompt_toolkit.lexers import SimpleLexer
+from prompt_toolkit.shortcuts.prompt import PromptSession
+from prompt_toolkit.styles import Style
+
+from questionary.constants import DEFAULT_QUESTION_PREFIX
+from questionary.constants import INSTRUCTION_MULTILINE
+from questionary.prompts.common import build_validator
+from questionary.question import Question
+from questionary.styles import merge_styles_default
+
+
+def text(
+    message: str,
+    default: str = "",
+    validate: Any = None,
+    qmark: str = DEFAULT_QUESTION_PREFIX,
+    style: Optional[Style] = None,
+    multiline: bool = False,
+    instruction: Optional[str] = None,
+    lexer: Optional[Lexer] = None,
+    **kwargs: Any,
+) -> Question:
+    """Prompt the user to enter a free text message.
+
+    This question type can be used to prompt the user for some text input.
+
+    Example:
+        >>> import questionary
+        >>> questionary.text("What's your first name?").ask()
+        ? What's your first name? Tom
+        'Tom'
+
+    .. image:: ../images/text.gif
+
+    This is just a really basic example, the prompt can be customised using the
+    parameters.
+
+    Args:
+        message: Question text.
+
+        default: Default value will be returned if the user just hits
+                 enter.
+
+        validate: Require the entered value to pass a validation. The
+                  value can not be submitted until the validator accepts
+                  it (e.g. to check minimum password length).
+
+                  This can either be a function accepting the input and
+                  returning a boolean, or an class reference to a
+                  subclass of the prompt toolkit Validator class.
+
+        qmark: Question prefix displayed in front of the question.
+               By default this is a ``?``.
+
+        style: A custom color and style for the question parts. You can
+               configure colors as well as font types for different elements.
+
+        multiline: If ``True``, multiline input will be enabled.
+
+        instruction: Write instructions for the user if needed. If ``None``
+                     and ``multiline=True``, some instructions will appear.
+
+        lexer: Supply a valid lexer to style the answer. Leave empty to
+               use a simple one by default.
+
+        kwargs: Additional arguments, they will be passed to prompt toolkit.
+
+    Returns:
+        :class:`Question`: Question instance, ready to be prompted (using ``.ask()``).
+    """
+    merged_style = merge_styles_default([style])
+    lexer = lexer or SimpleLexer("class:answer")
+    validator = build_validator(validate)
+
+    if instruction is None and multiline:
+        instruction = INSTRUCTION_MULTILINE
+
+    def get_prompt_tokens() -> List[Tuple[str, str]]:
+        result = [("class:qmark", qmark), ("class:question", " {} ".format(message))]
+        if instruction:
+            result.append(("class:instruction", " {} ".format(instruction)))
+        return result
+
+    p: PromptSession = PromptSession(
+        get_prompt_tokens,
+        style=merged_style,
+        validator=validator,
+        lexer=lexer,
+        multiline=multiline,
+        **kwargs,
+    )
+    p.default_buffer.reset(Document(default))
+
+    return Question(p.app)