falyx 0.1.56__py3-none-any.whl → 0.1.58__py3-none-any.whl

falyx/action/select_file_action.py

@@ -11,7 +11,6 @@ from typing import Any
 import toml
 import yaml
 from prompt_toolkit import PromptSession
-from rich.console import Console
 from rich.tree import Tree
 
 from falyx.action.action_types import FileType
@@ -51,7 +50,6 @@ class SelectFileAction(BaseAction):
         style (str): Style for the selection options.
         suffix_filter (str | None): Restrict to certain file types.
         return_type (FileType): What to return (path, content, parsed).
-        console (Console | None): Console instance for output.
         prompt_session (PromptSession | None): Prompt session for user input.
     """
 
@@ -69,7 +67,6 @@ class SelectFileAction(BaseAction):
         number_selections: int | str = 1,
         separator: str = ",",
         allow_duplicates: bool = False,
-        console: Console | None = None,
         prompt_session: PromptSession | None = None,
     ):
         super().__init__(name)
@@ -82,10 +79,6 @@ class SelectFileAction(BaseAction):
         self.number_selections = number_selections
         self.separator = separator
         self.allow_duplicates = allow_duplicates
-        if isinstance(console, Console):
-            self.console = console
-        elif console:
-            raise ValueError("`console` must be an instance of `rich.console.Console`")
         self.prompt_session = prompt_session or PromptSession()
         self.return_type = self._coerce_return_type(return_type)
 
@@ -195,7 +188,6 @@ class SelectFileAction(BaseAction):
             keys = await prompt_for_selection(
                 (options | cancel_option).keys(),
                 table,
-                console=self.console,
                 prompt_session=self.prompt_session,
                 prompt_message=self.prompt_message,
                 number_selections=self.number_selections,

falyx/action/selection_action.py

@@ -3,7 +3,6 @@
 from typing import Any
 
 from prompt_toolkit import PromptSession
-from rich.console import Console
 from rich.tree import Tree
 
 from falyx.action.action_types import SelectionReturnType
@@ -54,7 +53,6 @@ class SelectionAction(BaseAction):
         inject_last_result: bool = False,
         inject_into: str = "last_result",
         return_type: SelectionReturnType | str = "value",
-        console: Console | None = None,
         prompt_session: PromptSession | None = None,
         never_prompt: bool = False,
         show_table: bool = True,
@@ -70,10 +68,6 @@ class SelectionAction(BaseAction):
         self.return_type: SelectionReturnType = self._coerce_return_type(return_type)
         self.title = title
         self.columns = columns
-        if isinstance(console, Console):
-            self.console = console
-        elif console:
-            raise ValueError("`console` must be an instance of `rich.console.Console`")
         self.prompt_session = prompt_session or PromptSession()
         self.default_selection = default_selection
         self.number_selections = number_selections
@@ -262,7 +256,6 @@ class SelectionAction(BaseAction):
                         len(self.selections),
                         table,
                         default_selection=effective_default,
-                        console=self.console,
                         prompt_session=self.prompt_session,
                         prompt_message=self.prompt_message,
                         show_table=self.show_table,
@@ -306,7 +299,6 @@ class SelectionAction(BaseAction):
                         (self.selections | cancel_option).keys(),
                         table,
                         default_selection=effective_default,
-                        console=self.console,
                         prompt_session=self.prompt_session,
                         prompt_message=self.prompt_message,
                         show_table=self.show_table,

falyx/action/user_input_action.py

@@ -2,7 +2,6 @@
 """user_input_action.py"""
 from prompt_toolkit import PromptSession
 from prompt_toolkit.validation import Validator
-from rich.console import Console
 from rich.tree import Tree
 
 from falyx.action.base_action import BaseAction
@@ -20,7 +19,6 @@ class UserInputAction(BaseAction):
         name (str): Action name.
         prompt_text (str): Prompt text (can include '{last_result}' for interpolation).
         validator (Validator, optional): Prompt Toolkit validator.
-        console (Console, optional): Rich console for rendering.
         prompt_session (PromptSession, optional): Reusable prompt session.
         inject_last_result (bool): Whether to inject last_result into prompt.
         inject_into (str): Key to use for injection (default: 'last_result').
@@ -33,7 +31,6 @@ class UserInputAction(BaseAction):
         prompt_text: str = "Input > ",
         default_text: str = "",
         validator: Validator | None = None,
-        console: Console | None = None,
         prompt_session: PromptSession | None = None,
         inject_last_result: bool = False,
     ):
@@ -43,10 +40,6 @@ class UserInputAction(BaseAction):
         )
         self.prompt_text = prompt_text
         self.validator = validator
-        if isinstance(console, Console):
-            self.console = console
-        elif console:
-            raise ValueError("`console` must be an instance of `rich.console.Console`")
         self.prompt_session = prompt_session or PromptSession()
         self.default_text = default_text
 

falyx/bottom_bar.py

@@ -5,8 +5,8 @@ from typing import Any, Callable
 
 from prompt_toolkit.formatted_text import HTML, merge_formatted_text
 from prompt_toolkit.key_binding import KeyBindings
-from rich.console import Console
 
+from falyx.console import console
 from falyx.options_manager import OptionsManager
 from falyx.themes import OneColors
 from falyx.utils import CaseInsensitiveDict, chunks
@@ -30,7 +30,7 @@ class BottomBar:
         key_validator: Callable[[str], bool] | None = None,
     ) -> None:
         self.columns = columns
-        self.console = Console(color_system="truecolor")
+        self.console: Console = console
         self._named_items: dict[str, Callable[[], HTML]] = {}
         self._value_getters: dict[str, Callable[[], Any]] = CaseInsensitiveDict()
         self.toggle_keys: list[str] = []

falyx/command.py

@@ -23,11 +23,11 @@ from typing import Any, Awaitable, Callable
 
 from prompt_toolkit.formatted_text import FormattedText
 from pydantic import BaseModel, ConfigDict, Field, PrivateAttr, field_validator
-from rich.console import Console
 from rich.tree import Tree
 
 from falyx.action.action import Action
 from falyx.action.base_action import BaseAction
+from falyx.console import console
 from falyx.context import ExecutionContext
 from falyx.debug import register_debug_hooks
 from falyx.execution_registry import ExecutionRegistry as er
@@ -44,8 +44,6 @@ from falyx.signals import CancelSignal
 from falyx.themes import OneColors
 from falyx.utils import ensure_async
 
-console = Console(color_system="truecolor")
-
 
 class Command(BaseModel):
     """

falyx/config.py

@@ -11,18 +11,16 @@ from typing import Any, Callable
 import toml
 import yaml
 from pydantic import BaseModel, Field, field_validator, model_validator
-from rich.console import Console
 
 from falyx.action.action import Action
 from falyx.action.base_action import BaseAction
 from falyx.command import Command
+from falyx.console import console
 from falyx.falyx import Falyx
 from falyx.logger import logger
 from falyx.retry import RetryPolicy
 from falyx.themes import OneColors
 
-console = Console(color_system="truecolor")
-
 
 def wrap_if_needed(obj: Any, name=None) -> BaseAction | Command:
     if isinstance(obj, (BaseAction, Command)):

falyx/console.py

@@ -0,0 +1,5 @@
+from rich.console import Console
+
+from falyx.themes import get_nord_theme
+
+console = Console(color_system="truecolor", theme=get_nord_theme())

falyx/context.py

@@ -24,6 +24,8 @@ from typing import Any
 from pydantic import BaseModel, ConfigDict, Field
 from rich.console import Console
 
+from falyx.console import console
+
 
 class ExecutionContext(BaseModel):
     """
@@ -83,7 +85,7 @@ class ExecutionContext(BaseModel):
     index: int | None = None
 
     extra: dict[str, Any] = Field(default_factory=dict)
-    console: Console = Field(default_factory=lambda: Console(color_system="truecolor"))
+    console: Console = console
 
     shared_context: SharedContext | None = None
 

falyx/execution_registry.py

@@ -36,6 +36,7 @@ from rich import box
 from rich.console import Console
 from rich.table import Table
 
+from falyx.console import console
 from falyx.context import ExecutionContext
 from falyx.logger import logger
 from falyx.themes import OneColors

falyx/falyx.py

@@ -46,6 +46,7 @@ from falyx.action.base_action import BaseAction
 from falyx.bottom_bar import BottomBar
 from falyx.command import Command
 from falyx.completer import FalyxCompleter
+from falyx.console import console
 from falyx.context import ExecutionContext
 from falyx.debug import log_after, log_before, log_error, log_success
 from falyx.exceptions import (
@@ -63,7 +64,7 @@ from falyx.parser import CommandArgumentParser, FalyxParsers, get_arg_parsers
 from falyx.protocols import ArgParserProtocol
 from falyx.retry import RetryPolicy
 from falyx.signals import BackSignal, CancelSignal, HelpSignal, QuitSignal
-from falyx.themes import OneColors, get_nord_theme
+from falyx.themes import OneColors
 from falyx.utils import CaseInsensitiveDict, _noop, chunks
 from falyx.version import __version__
 
@@ -201,7 +202,7 @@ class Falyx:
         self.help_command: Command | None = (
             self._get_help_command() if include_help_command else None
         )
-        self.console: Console = Console(color_system="truecolor", theme=get_nord_theme())
+        self.console: Console = console
         self.welcome_message: str | Markdown | dict[str, Any] = welcome_message
         self.exit_message: str | Markdown | dict[str, Any] = exit_message
         self.hooks: HookManager = HookManager()
@@ -513,6 +514,8 @@ class Falyx:
                 bottom_toolbar=self._get_bottom_bar_render(),
                 key_bindings=self.key_bindings,
                 validate_while_typing=True,
+                interrupt_exception=QuitSignal,
+                eof_exception=QuitSignal,
             )
         return self._prompt_session
 

falyx/init.py

@@ -2,7 +2,7 @@
 """init.py"""
 from pathlib import Path
 
-from rich.console import Console
+from falyx.console import console
 
 TEMPLATE_TASKS = """\
 # This file is used by falyx.yaml to define CLI actions.
@@ -98,8 +98,6 @@ commands:
     aliases: [clean, cleanup]
 """
 
-console = Console(color_system="truecolor")
-
 
 def init_project(name: str) -> None:
     target = Path(name).resolve()

falyx/parser/argument.py

@@ -9,21 +9,37 @@ from falyx.parser.argument_action import ArgumentAction
 
 @dataclass
 class Argument:
-    """Represents a command-line argument."""
+    """
+    Represents a command-line argument.
+
+    Attributes:
+        flags (tuple[str, ...]): Short and long flags for the argument.
+        dest (str): The destination name for the argument.
+        action (ArgumentAction): The action to be taken when the argument is encountered.
+        type (Any): The type of the argument (e.g., str, int, float) or a callable that converts the argument value.
+        default (Any): The default value if the argument is not provided.
+        choices (list[str] | None): A list of valid choices for the argument.
+        required (bool): True if the argument is required, False otherwise.
+        help (str): Help text for the argument.
+        nargs (int | str | None): Number of arguments expected. Can be an int, '?', '*', '+', or None.
+        positional (bool): True if the argument is positional (no leading - or -- in flags), False otherwise.
+        resolver (BaseAction | None):
+            An action object that resolves the argument, if applicable.
+        lazy_resolver (bool): True if the resolver should be called lazily, False otherwise
+    """
 
     flags: tuple[str, ...]
-    dest: str  # Destination name for the argument
-    action: ArgumentAction = (
-        ArgumentAction.STORE
-    )  # Action to be taken when the argument is encountered
-    type: Any = str  # Type of the argument (e.g., str, int, float) or callable
-    default: Any = None  # Default value if the argument is not provided
-    choices: list[str] | None = None  # List of valid choices for the argument
-    required: bool = False  # True if the argument is required
-    help: str = ""  # Help text for the argument
-    nargs: int | str | None = None  # int, '?', '*', '+', None
-    positional: bool = False  # True if no leading - or -- in flags
-    resolver: BaseAction | None = None  # Action object for the argument
+    dest: str
+    action: ArgumentAction = ArgumentAction.STORE
+    type: Any = str
+    default: Any = None
+    choices: list[str] | None = None
+    required: bool = False
+    help: str = ""
+    nargs: int | str | None = None
+    positional: bool = False
+    resolver: BaseAction | None = None
+    lazy_resolver: bool = False
 
     def get_positional_text(self) -> str:
         """Get the positional text for the argument."""

falyx/parser/command_argument_parser.py

@@ -9,6 +9,7 @@ from rich.console import Console
 from rich.markup import escape
 
 from falyx.action.base_action import BaseAction
+from falyx.console import console
 from falyx.exceptions import CommandArgumentError
 from falyx.parser.argument import Argument
 from falyx.parser.argument_action import ArgumentAction
@@ -46,7 +47,7 @@ class CommandArgumentParser:
         aliases: list[str] | None = None,
     ) -> None:
         """Initialize the CommandArgumentParser."""
-        self.console = Console(color_system="truecolor")
+        self.console: Console = console
         self.command_key: str = command_key
         self.command_description: str = command_description
         self.command_style: str = command_style
@@ -300,6 +301,7 @@ class CommandArgumentParser:
         help: str = "",
         dest: str | None = None,
         resolver: BaseAction | None = None,
+        lazy_resolver: bool = False,
     ) -> None:
         """Add an argument to the parser.
         For `ArgumentAction.ACTION`, `nargs` and `type` determine how many and what kind
@@ -348,6 +350,10 @@ class CommandArgumentParser:
                 f"Default value '{default}' not in allowed choices: {choices}"
             )
         required = self._determine_required(required, positional, nargs)
+        if not isinstance(lazy_resolver, bool):
+            raise CommandArgumentError(
+                f"lazy_resolver must be a boolean, got {type(lazy_resolver)}"
+            )
         argument = Argument(
             flags=flags,
             dest=dest,
@@ -360,6 +366,7 @@ class CommandArgumentParser:
             nargs=nargs,
             positional=positional,
             resolver=resolver,
+            lazy_resolver=lazy_resolver,
         )
         for flag in flags:
             if flag in self._flag_map:
@@ -445,6 +452,7 @@ class CommandArgumentParser:
         result: dict[str, Any],
         positional_args: list[Argument],
         consumed_positional_indicies: set[int],
+        from_validate: bool = False,
     ) -> int:
         remaining_positional_args = [
             (j, spec)
@@ -508,12 +516,13 @@ class CommandArgumentParser:
                 assert isinstance(
                     spec.resolver, BaseAction
                 ), "resolver should be an instance of BaseAction"
-                try:
-                    result[spec.dest] = await spec.resolver(*typed)
-                except Exception as error:
-                    raise CommandArgumentError(
-                        f"[{spec.dest}] Action failed: {error}"
-                    ) from error
+                if not spec.lazy_resolver or not from_validate:
+                    try:
+                        result[spec.dest] = await spec.resolver(*typed)
+                    except Exception as error:
+                        raise CommandArgumentError(
+                            f"[{spec.dest}] Action failed: {error}"
+                        ) from error
             elif not typed and spec.default:
                 result[spec.dest] = spec.default
             elif spec.action == ArgumentAction.APPEND:
@@ -657,21 +666,25 @@ class CommandArgumentParser:
                 if not typed_values and spec.nargs not in ("*", "?"):
                     choices = []
                     if spec.default:
-                        choices.append(f"default={spec.default!r}")
+                        choices.append(f"default={spec.default}")
                     if spec.choices:
-                        choices.append(f"choices={spec.choices!r}")
+                        choices.append(f"choices={spec.choices}")
                     if choices:
                         choices_text = ", ".join(choices)
                         raise CommandArgumentError(
                             f"Argument '{spec.dest}' requires a value. {choices_text}"
                         )
-                    if spec.nargs is None:
+                    elif spec.nargs is None:
+                        try:
+                            raise CommandArgumentError(
+                                f"Enter a {spec.type.__name__} value for '{spec.dest}'"
+                            )
+                        except AttributeError:
+                            raise CommandArgumentError(f"Enter a value for '{spec.dest}'")
+                    else:
                         raise CommandArgumentError(
-                            f"Enter a {spec.type.__name__} value for '{spec.dest}'"
+                            f"Argument '{spec.dest}' requires a value. Expected {spec.nargs} values."
                         )
-                    raise CommandArgumentError(
-                        f"Argument '{spec.dest}' requires a value. Expected {spec.nargs} values."
-                    )
                 if spec.nargs in (None, 1, "?") and spec.action != ArgumentAction.APPEND:
                     result[spec.dest] = (
                         typed_values[0] if len(typed_values) == 1 else typed_values
@@ -705,6 +718,7 @@ class CommandArgumentParser:
                 result,
                 positional_args,
                 consumed_positional_indices,
+                from_validate=from_validate,
             )
             i += args_consumed
         return i
@@ -746,13 +760,19 @@ class CommandArgumentParser:
                 continue
             if spec.required and not result.get(spec.dest):
                 help_text = f" help: {spec.help}" if spec.help else ""
+                if (
+                    spec.action == ArgumentAction.ACTION
+                    and spec.lazy_resolver
+                    and from_validate
+                ):
+                    continue  # Lazy resolvers are not validated here
                 raise CommandArgumentError(
-                    f"Missing required argument {spec.dest}: {spec.get_choice_text()}{help_text}"
+                    f"Missing required argument '{spec.dest}': {spec.get_choice_text()}{help_text}"
                 )
 
             if spec.choices and result.get(spec.dest) not in spec.choices:
                 raise CommandArgumentError(
-                    f"Invalid value for {spec.dest}: must be one of {spec.choices}"
+                    f"Invalid value for '{spec.dest}': must be one of {{{', '.join(spec.choices)}}}"
                 )
 
             if spec.action == ArgumentAction.ACTION:
@@ -761,23 +781,23 @@ class CommandArgumentParser:
             if isinstance(spec.nargs, int) and spec.nargs > 1:
                 assert isinstance(
                     result.get(spec.dest), list
-                ), f"Invalid value for {spec.dest}: expected a list"
+                ), f"Invalid value for '{spec.dest}': expected a list"
                 if not result[spec.dest] and not spec.required:
                     continue
                 if spec.action == ArgumentAction.APPEND:
                     for group in result[spec.dest]:
                         if len(group) % spec.nargs != 0:
                             raise CommandArgumentError(
-                                f"Invalid number of values for {spec.dest}: expected a multiple of {spec.nargs}"
+                                f"Invalid number of values for '{spec.dest}': expected a multiple of {spec.nargs}"
                             )
                 elif spec.action == ArgumentAction.EXTEND:
                     if len(result[spec.dest]) % spec.nargs != 0:
                         raise CommandArgumentError(
-                            f"Invalid number of values for {spec.dest}: expected a multiple of {spec.nargs}"
+                            f"Invalid number of values for '{spec.dest}': expected a multiple of {spec.nargs}"
                         )
                 elif len(result[spec.dest]) != spec.nargs:
                     raise CommandArgumentError(
-                        f"Invalid number of values for {spec.dest}: expected {spec.nargs}, got {len(result[spec.dest])}"
+                        f"Invalid number of values for '{spec.dest}': expected {spec.nargs}, got {len(result[spec.dest])}"
                     )
 
         result.pop("help", None)

falyx/parser/utils.py

@@ -37,7 +37,8 @@ def coerce_enum(value: Any, enum_type: EnumMeta) -> Any:
         coerced_value = base_type(value)
         return enum_type(coerced_value)
     except (ValueError, TypeError):
-        raise ValueError(f"Value '{value}' could not be coerced to enum type {enum_type}")
+        values = [str(enum.value) for enum in enum_type]
+        raise ValueError(f"'{value}' should be one of {{{', '.join(values)}}}") from None
 
 
 def coerce_value(value: str, target_type: type) -> Any:
@@ -57,7 +58,7 @@ def coerce_value(value: str, target_type: type) -> Any:
                 return coerce_value(value, arg)
             except Exception:
                 continue
-        raise ValueError(f"Value '{value}' could not be coerced to any of {args!r}")
+        raise ValueError(f"Value '{value}' could not be coerced to any of {args}")
 
     if isinstance(target_type, EnumMeta):
         return coerce_enum(value, target_type)

falyx/selection.py

@@ -5,10 +5,10 @@ from typing import Any, Callable, KeysView, Sequence
 
 from prompt_toolkit import PromptSession
 from rich import box
-from rich.console import Console
 from rich.markup import escape
 from rich.table import Table
 
+from falyx.console import console
 from falyx.themes import OneColors
 from falyx.utils import CaseInsensitiveDict, chunks
 from falyx.validators import MultiIndexValidator, MultiKeyValidator
@@ -267,7 +267,6 @@ async def prompt_for_index(
     *,
     min_index: int = 0,
     default_selection: str = "",
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     show_table: bool = True,
@@ -277,7 +276,6 @@ async def prompt_for_index(
     cancel_key: str = "",
 ) -> int | list[int]:
     prompt_session = prompt_session or PromptSession()
-    console = console or Console(color_system="truecolor")
 
     if show_table:
         console.print(table, justify="center")
@@ -307,7 +305,6 @@ async def prompt_for_selection(
     table: Table,
     *,
     default_selection: str = "",
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     show_table: bool = True,
@@ -318,7 +315,6 @@ async def prompt_for_selection(
 ) -> str | list[str]:
     """Prompt the user to select a key from a set of options. Return the selected key."""
     prompt_session = prompt_session or PromptSession()
-    console = console or Console(color_system="truecolor")
 
     if show_table:
         console.print(table, justify="center")
@@ -342,7 +338,6 @@ async def select_value_from_list(
     title: str,
     selections: Sequence[str],
     *,
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     default_selection: str = "",
@@ -381,13 +376,11 @@ async def select_value_from_list(
         highlight=highlight,
     )
     prompt_session = prompt_session or PromptSession()
-    console = console or Console(color_system="truecolor")
 
     selection_index = await prompt_for_index(
         len(selections) - 1,
         table,
         default_selection=default_selection,
-        console=console,
         prompt_session=prompt_session,
         prompt_message=prompt_message,
         number_selections=number_selections,
@@ -405,7 +398,6 @@ async def select_key_from_dict(
     selections: dict[str, SelectionOption],
     table: Table,
     *,
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     default_selection: str = "",
@@ -416,7 +408,6 @@ async def select_key_from_dict(
 ) -> str | list[str]:
     """Prompt for a key from a dict, returns the key."""
     prompt_session = prompt_session or PromptSession()
-    console = console or Console(color_system="truecolor")
 
     console.print(table, justify="center")
 
@@ -424,7 +415,6 @@ async def select_key_from_dict(
         selections.keys(),
         table,
         default_selection=default_selection,
-        console=console,
         prompt_session=prompt_session,
         prompt_message=prompt_message,
         number_selections=number_selections,
@@ -438,7 +428,6 @@ async def select_value_from_dict(
     selections: dict[str, SelectionOption],
     table: Table,
     *,
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     default_selection: str = "",
@@ -449,7 +438,6 @@ async def select_value_from_dict(
 ) -> Any | list[Any]:
     """Prompt for a key from a dict, but return the value."""
     prompt_session = prompt_session or PromptSession()
-    console = console or Console(color_system="truecolor")
 
     console.print(table, justify="center")
 
@@ -457,7 +445,6 @@ async def select_value_from_dict(
         selections.keys(),
         table,
         default_selection=default_selection,
-        console=console,
         prompt_session=prompt_session,
         prompt_message=prompt_message,
         number_selections=number_selections,
@@ -475,7 +462,6 @@ async def get_selection_from_dict_menu(
     title: str,
     selections: dict[str, SelectionOption],
     *,
-    console: Console | None = None,
     prompt_session: PromptSession | None = None,
     prompt_message: str = "Select an option > ",
     default_selection: str = "",
@@ -493,7 +479,6 @@ async def get_selection_from_dict_menu(
     return await select_value_from_dict(
         selections=selections,
         table=table,
-        console=console,
         prompt_session=prompt_session,
         prompt_message=prompt_message,
         default_selection=default_selection,

falyx/validators.py

@@ -47,6 +47,30 @@ def yes_no_validator() -> Validator:
     return Validator.from_callable(validate, error_message="Enter 'Y' or 'n'.")
 
 
+def words_validator(keys: Sequence[str] | KeysView[str]) -> Validator:
+    """Validator for specific word inputs."""
+
+    def validate(text: str) -> bool:
+        if text.upper() not in [key.upper() for key in keys]:
+            return False
+        return True
+
+    return Validator.from_callable(
+        validate, error_message=f"Invalid input. Choices: {{{', '.join(keys)}}}."
+    )
+
+
+def word_validator(word: str) -> Validator:
+    """Validator for specific word inputs."""
+
+    def validate(text: str) -> bool:
+        if text.upper().strip() == "N":
+            return True
+        return text.upper().strip() == word.upper()
+
+    return Validator.from_callable(validate, error_message=f"Enter '{word}' or 'N'.")
+
+
 class MultiIndexValidator(Validator):
     def __init__(
         self,

falyx/version.py

@@ -1 +1 @@
-__version__ = "0.1.56"
+__version__ = "0.1.58"