falyx 0.1.22__py3-none-any.whl → 0.1.24__py3-none-any.whl

falyx/selection_action.py

@@ -10,6 +10,7 @@ from falyx.action import BaseAction
 from falyx.context import ExecutionContext
 from falyx.execution_registry import ExecutionRegistry as er
 from falyx.hook_manager import HookType
+from falyx.logger import logger
 from falyx.selection import (
     SelectionOption,
     prompt_for_index,
@@ -18,17 +19,25 @@ from falyx.selection import (
     render_selection_indexed_table,
 )
 from falyx.themes.colors import OneColors
-from falyx.utils import CaseInsensitiveDict, logger
+from falyx.utils import CaseInsensitiveDict
 
 
 class SelectionAction(BaseAction):
+    """
+    A selection action that prompts the user to select an option from a list or
+    dictionary. The selected option is then returned as the result of the action.
+
+    If return_key is True, the key of the selected option is returned instead of
+    the value.
+    """
+
     def __init__(
         self,
         name: str,
         selections: list[str] | set[str] | tuple[str, ...] | dict[str, SelectionOption],
         *,
         title: str = "Select an option",
-        columns: int = 2,
+        columns: int = 5,
         prompt_message: str = "Select > ",
         default_selection: str = "",
         inject_last_result: bool = False,
@@ -45,7 +54,8 @@ class SelectionAction(BaseAction):
             inject_into=inject_into,
             never_prompt=never_prompt,
         )
-        self.selections: list[str] | CaseInsensitiveDict = selections
+        # Setter normalizes to correct type, mypy can't infer that
+        self.selections: list[str] | CaseInsensitiveDict = selections  # type: ignore[assignment]
         self.return_key = return_key
         self.title = title
         self.columns = columns
@@ -71,7 +81,8 @@ class SelectionAction(BaseAction):
             self._selections = cid
         else:
             raise TypeError(
-                f"'selections' must be a list[str] or dict[str, SelectionOption], got {type(value).__name__}"
+                "'selections' must be a list[str] or dict[str, SelectionOption], "
+                f"got {type(value).__name__}"
             )
 
     async def _run(self, *args, **kwargs) -> Any:
@@ -108,7 +119,8 @@ class SelectionAction(BaseAction):
 
         if self.never_prompt and not effective_default:
             raise ValueError(
-                f"[{self.name}] 'never_prompt' is True but no valid default_selection was provided."
+                f"[{self.name}] 'never_prompt' is True but no valid default_selection "
+                "was provided."
             )
 
         context.start_timer()
@@ -152,7 +164,8 @@ class SelectionAction(BaseAction):
                 result = key if self.return_key else self.selections[key].value
             else:
                 raise TypeError(
-                    f"'selections' must be a list[str] or dict[str, tuple[str, Any]], got {type(self.selections).__name__}"
+                    "'selections' must be a list[str] or dict[str, tuple[str, Any]], "
+                    f"got {type(self.selections).__name__}"
                 )
             context.result = result
             await self.hooks.trigger(HookType.ON_SUCCESS, context)
@@ -186,7 +199,7 @@ class SelectionAction(BaseAction):
             if len(self.selections) > 10:
                 sub.add(f"[dim]... ({len(self.selections) - 10} more)[/]")
         else:
-            tree.add("[bold red]Invalid selections type[/]")
+            tree.add(f"[{OneColors.DARK_RED_b}]Invalid selections type[/]")
             return
 
         tree.add(f"[dim]Default:[/] '{self.default_selection or self.last_result}'")
@@ -205,5 +218,6 @@ class SelectionAction(BaseAction):
         return (
             f"SelectionAction(name={self.name!r}, type={selection_type}, "
             f"default_selection={self.default_selection!r}, "
-            f"return_key={self.return_key}, prompt={'off' if self.never_prompt else 'on'})"
+            f"return_key={self.return_key}, "
+            f"prompt={'off' if self.never_prompt else 'on'})"
         )

falyx/signal_action.py

@@ -1,3 +1,5 @@
+# Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
+"""signal_action.py"""
 from falyx.action import Action
 from falyx.signals import FlowSignal
 

falyx/signals.py

@@ -1,4 +1,7 @@
 # Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
+"""signals.py"""
+
+
 class FlowSignal(BaseException):
     """Base class for all flow control signals in Falyx.
 

falyx/tagged_table.py

@@ -1,4 +1,5 @@
 # Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
+"""tagged_table.py"""
 from collections import defaultdict
 
 from rich import box
@@ -10,7 +11,7 @@ from falyx.falyx import Falyx
 
 def build_tagged_table(flx: Falyx) -> Table:
     """Custom table builder that groups commands by tags."""
-    table = Table(title=flx.title, show_header=False, box=box.SIMPLE)
+    table = Table(title=flx.title, show_header=False, box=box.SIMPLE)  # type: ignore[arg-type]
 
     # Group commands by first tag
     grouped: dict[str, list[Command]] = defaultdict(list)

falyx/utils.py

@@ -1,5 +1,7 @@
 # Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
 """utils.py"""
+from __future__ import annotations
+
 import functools
 import inspect
 import logging
@@ -10,23 +12,12 @@ from itertools import islice
 from typing import Any, Awaitable, Callable, TypeVar
 
 import pythonjsonlogger.json
-from prompt_toolkit import PromptSession
-from prompt_toolkit.formatted_text import (
-    AnyFormattedText,
-    FormattedText,
-    merge_formatted_text,
-)
 from rich.logging import RichHandler
 
-from falyx.themes.colors import OneColors
-from falyx.validators import yes_no_validator
-
-logger = logging.getLogger("falyx")
-
 T = TypeVar("T")
 
 
-async def _noop(*args, **kwargs):
+async def _noop(*_, **__):
     pass
 
 
@@ -70,22 +61,6 @@ def chunks(iterator, size):
         yield chunk
 
 
-async def confirm_async(
-    message: AnyFormattedText = "Are you sure?",
-    prefix: AnyFormattedText = FormattedText([(OneColors.CYAN, "❓ ")]),
-    suffix: AnyFormattedText = FormattedText([(OneColors.LIGHT_YELLOW_b, " [Y/n] > ")]),
-    session: PromptSession | None = None,
-) -> bool:
-    """Prompt the user with a yes/no async confirmation and return True for 'Y'."""
-    session = session or PromptSession()
-    merged_message: AnyFormattedText = merge_formatted_text([prefix, message, suffix])
-    answer = await session.prompt_async(
-        merged_message,
-        validator=yes_no_validator(),
-    )
-    return True if answer.upper() == "Y" else False
-
-
 class CaseInsensitiveDict(dict):
     """A case-insensitive dictionary that treats all keys as uppercase."""
 
@@ -114,12 +89,6 @@ class CaseInsensitiveDict(dict):
         items.update({self._normalize_key(k): v for k, v in kwargs.items()})
         super().update(items)
 
-    def __iter__(self):
-        return super().__iter__()
-
-    def keys(self):
-        return super().keys()
-
 
 def running_in_container() -> bool:
     try:
@@ -143,11 +112,13 @@ def setup_logging(
     console_log_level: int = logging.WARNING,
 ):
     """
-    Configure logging for Falyx with support for both CLI-friendly and structured JSON output.
+    Configure logging for Falyx with support for both CLI-friendly and structured
+    JSON output.
 
-    This function sets up separate logging handlers for console and file output, with optional
-    support for JSON formatting. It also auto-detects whether the application is running inside
-    a container to default to machine-readable logs when appropriate.
+    This function sets up separate logging handlers for console and file output,
+    with optional support for JSON formatting. It also auto-detects whether the
+    application is running inside a container to default to machine-readable logs
+    when appropriate.
 
     Args:
         mode (str | None):
@@ -170,7 +141,8 @@ def setup_logging(
         - Clears existing root handlers before setup.
         - Configures console logging using either Rich (for CLI) or JSON formatting.
         - Configures file logging in plain text or JSON based on `json_log_to_file`.
-        - Automatically sets logging levels for noisy third-party modules (`urllib3`, `asyncio`).
+        - Automatically sets logging levels for noisy third-party modules
+          (`urllib3`, `asyncio`, `markdown_it`).
         - Propagates logs from the "falyx" logger to ensure centralized output.
 
     Raises:

falyx/validators.py

@@ -1,4 +1,5 @@
 # Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
+"""validators.py"""
 from typing import KeysView, Sequence
 
 from prompt_toolkit.validation import Validator
@@ -7,10 +8,10 @@ from prompt_toolkit.validation import Validator
 def int_range_validator(minimum: int, maximum: int) -> Validator:
     """Validator for integer ranges."""
 
-    def validate(input: str) -> bool:
+    def validate(text: str) -> bool:
         try:
-            value = int(input)
-            if not (minimum <= value <= maximum):
+            value = int(text)
+            if not minimum <= value <= maximum:
                 return False
             return True
         except ValueError:
@@ -25,8 +26,8 @@ def int_range_validator(minimum: int, maximum: int) -> Validator:
 def key_validator(keys: Sequence[str] | KeysView[str]) -> Validator:
     """Validator for key inputs."""
 
-    def validate(input: str) -> bool:
-        if input.upper() not in [key.upper() for key in keys]:
+    def validate(text: str) -> bool:
+        if text.upper() not in [key.upper() for key in keys]:
             return False
         return True
 
@@ -38,8 +39,8 @@ def key_validator(keys: Sequence[str] | KeysView[str]) -> Validator:
 def yes_no_validator() -> Validator:
     """Validator for yes/no inputs."""
 
-    def validate(input: str) -> bool:
-        if input.upper() not in ["Y", "N"]:
+    def validate(text: str) -> bool:
+        if text.upper() not in ["Y", "N"]:
             return False
         return True
 

falyx/version.py

@@ -1 +1 @@
-__version__ = "0.1.22"
+__version__ = "0.1.24"

{falyx-0.1.22.dist-info → falyx-0.1.24.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.3
 Name: falyx
-Version: 0.1.22
+Version: 0.1.24
 Summary: Reliable and introspectable async CLI action framework.
 License: MIT
 Author: Roland Thomas Jr

falyx-0.1.24.dist-info/RECORD

@@ -0,0 +1,42 @@
+falyx/.pytyped,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+falyx/__init__.py,sha256=dYRamQJlT1Zoy5Uu1uG4NCV05Xk98nN1LAQrSR1CT2A,643
+falyx/__main__.py,sha256=g_LwJieofK3DJzCYtpkAMEeOXhzSLQenb7pRVUqcf-Y,2152
+falyx/action.py,sha256=9iOsqi-7tiNdBcGFrAQHGBCsTKZoBYXkClZE0DM9qhQ,32495
+falyx/action_factory.py,sha256=RKKb9C49xYNnMBgNvaDYTspVF3jmpBtNibrxlzLGiQQ,4228
+falyx/bottom_bar.py,sha256=GdyM-IY-E08c2GSaeAGVv1h1suOQuohFTRwbqtawbW0,7390
+falyx/command.py,sha256=PCnGDbx8E-168FcuUvz87YqR94FvYCQX8dj6tVXnMtw,12231
+falyx/config.py,sha256=nbAEea1-3zNhycrQ9aKuMqqa_EaQGBK0HcCAGsj_rZ0,7204
+falyx/config_schema.py,sha256=j5GQuHVlaU-VLxLF9t8idZRjqOP9MIKp1hyd9NhpAGU,3124
+falyx/context.py,sha256=FNF-IS7RMDxel2l3kskEqQImZ0mLO6zvGw_xC9cIzgI,10338
+falyx/debug.py,sha256=oWWTLOF8elrx_RGZ1G4pbzfFr46FjB0woFXpVU2wmjU,1567
+falyx/exceptions.py,sha256=Qxp6UScZWEyno-6Lgksrv3s9iwjbr2U-d6hun-_xpc0,798
+falyx/execution_registry.py,sha256=io2hX9VkWJBRch-G7thla1eH_PgyVjjWf9qU5foOOEA,4719
+falyx/falyx.py,sha256=KuIAaZj4RgiFdiAzOMswZ8n6lUKN00L5k4zWoJA1PBk,40545
+falyx/hook_manager.py,sha256=GuGxVVz9FXrU39Tk220QcsLsMXeut7ZDkGW3hU9GcwQ,2952
+falyx/hooks.py,sha256=KOmUGP6xWU-eTW8QOl-qEflNRxZRf_OHA0N7gph13UM,2947
+falyx/http_action.py,sha256=sGADtRhSRuNu4UiEo1oeTHeC2rgAlALZm08-X4Pne34,5806
+falyx/init.py,sha256=abcSlPmxVeByLIHdUkNjqtO_tEkO3ApC6f9WbxsSEWg,3393
+falyx/io_action.py,sha256=5TIWeRUIffvkbdMbureLMiNk6mcy-tCaMMBRCeFFfgM,9718
+falyx/logger.py,sha256=1Mfb_vJFJ1tQwziuyU2p-cSMi2Js8N2byniFEnI6vOQ,132
+falyx/menu_action.py,sha256=jLYUR6-6F5NIDb9kP0Ysovmy3mtfO8xTXRRZMRaTtY0,8183
+falyx/options_manager.py,sha256=dFAnQw543tQ6Xupvh1PwBrhiSWlSACHw8K-sHP_lUh4,2842
+falyx/parsers.py,sha256=hxrBouQEqdgk6aWzNa7UwTg7u55vJffSEUUTiiQoI0U,5602
+falyx/prompt_utils.py,sha256=6qt65HESo79-rZhIWpgndrYG6yJwk8tMSJCKXar0dP0,1549
+falyx/protocols.py,sha256=Sk2a1rz5Tk7iDUVTeitItNX-Kg3kwXOSwIjojEOE1mI,299
+falyx/retry.py,sha256=UUzY6FlKobr84Afw7yJO9rj3AIQepDk2fcWs6_1gi6Q,3788
+falyx/retry_utils.py,sha256=1xPSr-1ZJsUXnXFyGNZZJ9h9eE4ExHjJMkyjHIm5cd8,687
+falyx/select_file_action.py,sha256=698t0Mc5_6dPXjxuKBC_O7u35o08nLqkgpQH82dZafc,8678
+falyx/selection.py,sha256=r__wrXaLz4oJobeqniKvHrEhe9vYVsZo1SoB3Cn6qRM,10738
+falyx/selection_action.py,sha256=PdY-3ewMhgC8F3DKS6TCWcAoOD3va9Hp8bPkdZSMWBE,8811
+falyx/signal_action.py,sha256=DSwVkL81PLWAHRHZbpiYlPH1ew97KL6TPs3XlU--RJY,916
+falyx/signals.py,sha256=4PTuVRB_P_aWfnU8pANqhMxGTLq7TJDEyk9jCp0Bx2c,713
+falyx/tagged_table.py,sha256=4SV-SdXFrAhy1JNToeBCvyxT-iWVf6cWY7XETTys4n8,1067
+falyx/themes/colors.py,sha256=4aaeAHJetmeNInI0Zytg4E3YqKfPFelpf04vtjSvsS8,19776
+falyx/utils.py,sha256=uss-FV8p164pmhoqYtQt8gNp5z8fGbuMAk4dRJ6RopI,6717
+falyx/validators.py,sha256=t5iyzVpY8tdC4rfhr4isEfWpD5gNTzjeX_Hbi_Uq6sA,1328
+falyx/version.py,sha256=Jq7e1LcKcQSNVg4EOJ-acPyPgs8Os5cYEZWXrQsI7Pg,23
+falyx-0.1.24.dist-info/LICENSE,sha256=B0yqgaHuSdhN7T3OBmgQSiDTy8HqT5Oe_dLypRe4Ra4,1073
+falyx-0.1.24.dist-info/METADATA,sha256=b7Ca1bcIlHrVsb3YLlSUQCgzoh0Jvd7qfUeD6ms5mWo,5484
+falyx-0.1.24.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
+falyx-0.1.24.dist-info/entry_points.txt,sha256=j8owOSl2j1Ss8DtGMnKfgehKaolqnIPhVFHaUBLUnMs,45
+falyx-0.1.24.dist-info/RECORD,,

falyx-0.1.22.dist-info/RECORD

@@ -1,40 +0,0 @@
-falyx/.pytyped,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-falyx/__init__.py,sha256=dYRamQJlT1Zoy5Uu1uG4NCV05Xk98nN1LAQrSR1CT2A,643
-falyx/__main__.py,sha256=559pd3P1iScvC-V__gfXUbEQTxeV7PXlRcQI9kpMQcg,2286
-falyx/action.py,sha256=J-SG5zltYbqtdvTwBBUeEj4jp44DOKBR6G5rvmdkkTs,32147
-falyx/action_factory.py,sha256=SMucCBuigKk3rlKXCEN69Sew4dVaBUxQqxyUUAHMZeo,3629
-falyx/bottom_bar.py,sha256=NTen52Nfz32eWSBmJtEUuJO33u5sGQj-33IeudPVsqQ,7403
-falyx/command.py,sha256=8J3xeHw3fYiqf05EUbXd--aEIJso5bzxb5JECGuISQk,12199
-falyx/config.py,sha256=MnZeyti2TpeuOKrvXVaslIxYPHFyE4liREJsmUKlySg,5455
-falyx/context.py,sha256=Dm7HV-eigU-aTv5ERah6Ow9fIRdrOsB1G6ETPIu42Gw,10070
-falyx/debug.py,sha256=-jbTti29UC5zP9qQlWs3TbkOQR2f3zKSuNluh-r56wY,1551
-falyx/exceptions.py,sha256=YVbhPp2BNvZoO_xqeGSRKHVQ2rdLOLf1HCjH4JTj9w8,776
-falyx/execution_registry.py,sha256=IZvZr2hElzsYcMX3bAXg7sc7V2zi4RURn0OR7de2iCo,2864
-falyx/falyx.py,sha256=Yj7dYpEiqnswVRWSJyqS45wlRTUKvABIQR8Bh2axA9I,40453
-falyx/hook_manager.py,sha256=E9Vk4bdoUTeXPQ_BQEvY2Jt-jUAusc40LI8JDy3NLUw,2381
-falyx/hooks.py,sha256=9zXk62DsJLJrmwTdyeNy5s-rVRvl8feuYRrfMmz6cVQ,2802
-falyx/http_action.py,sha256=JfopEleXJ0goVHi0VCn983c22GrmJhobnPIP7sTRqzU,5796
-falyx/init.py,sha256=jP4ZNw7ycDMKw4n1HDifxWSa0NYHaGLq7_LiFt85NpA,1832
-falyx/io_action.py,sha256=mBRX8rqQ11gkcUnJluZ87XT4QBA1oFkof6PaCtuK5o8,8997
-falyx/menu_action.py,sha256=kagtnn3djDxUm_Cyynp0lj-sZ9D_FZn4IEBYnFYqB74,7986
-falyx/options_manager.py,sha256=yYpn-moYN-bRYgMLccmi_de4mUzhTT7cv_bR2FFWZ8c,2798
-falyx/parsers.py,sha256=r2FZTN26PqrnEQG4hVPorzzTPQZihsb4ca23fQY4Lgo,5574
-falyx/prompt_utils.py,sha256=JOg3p8Juv6ZdY1srfy_HlMNYfE-ajggDWLqNsjZq87I,560
-falyx/protocols.py,sha256=yNtQEugq9poN-SbOJf5LL_j6HBWdglbTNghpyopLpTs,216
-falyx/retry.py,sha256=GncBUiDDfDHUvLsWsWQw2Nq2XYL0TR0Fne3iXPzvQ48,3551
-falyx/retry_utils.py,sha256=SN5apcsg71IG2-KylysqdJd-PkPBLoCVwsgrSTF9wrQ,666
-falyx/select_file_action.py,sha256=5Pt9ThIfwqd8ZJLEVDapevV6SF_AQEQFkk-i9Y1to_Q,7315
-falyx/selection.py,sha256=aeJZPDwb5LR9e9iTjCYx4D5bh1mWyn3uBPA-M1AXdAw,10553
-falyx/selection_action.py,sha256=MAKZeDwfCEE3hOoL1hpiMVlFUEDYV6X0oNCVGEcT_ZU,8324
-falyx/signal_action.py,sha256=wfhW9miSUj9MUoc1WOyk4tU9CtYKAXusHxQdBPYLoyQ,829
-falyx/signals.py,sha256=tlUbz3x6z3rYlUggan_Ntoy4bU5RbOd8UfR4cNcV6kQ,694
-falyx/tagged_table.py,sha256=sn2kosRRpcpeMB8vKk47c9yjpffSz_9FXH_e6kw15mA,1019
-falyx/themes/colors.py,sha256=4aaeAHJetmeNInI0Zytg4E3YqKfPFelpf04vtjSvsS8,19776
-falyx/utils.py,sha256=b1GQ3ooz4Io3zPE7MsoDm7j42AioTG-ZcWH-N2TRpbI,7710
-falyx/validators.py,sha256=NMxqCk8Fr8HQGVDYpg8B_JRk5SKR41E_G9gj1YfQnxg,1316
-falyx/version.py,sha256=zmP2TRnzKPjZJ1eiBcT-cRInsji6FW-OVD3FafQFCc4,23
-falyx-0.1.22.dist-info/LICENSE,sha256=B0yqgaHuSdhN7T3OBmgQSiDTy8HqT5Oe_dLypRe4Ra4,1073
-falyx-0.1.22.dist-info/METADATA,sha256=jXADXacZ3y4WPCwGkMSg5aGsseu-G98twHd2YIK5Hzg,5484
-falyx-0.1.22.dist-info/WHEEL,sha256=fGIA9gx4Qxk2KDKeNJCbOEwSrmLtjWCwzBz351GyrPQ,88
-falyx-0.1.22.dist-info/entry_points.txt,sha256=j8owOSl2j1Ss8DtGMnKfgehKaolqnIPhVFHaUBLUnMs,45
-falyx-0.1.22.dist-info/RECORD,,