157 lines
5.5 KiB
Python
157 lines
5.5 KiB
Python
# Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
|
|
"""menu_action.py"""
|
|
from typing import Any
|
|
|
|
from prompt_toolkit import PromptSession
|
|
from rich.console import Console
|
|
from rich.table import Table
|
|
from rich.tree import Tree
|
|
|
|
from falyx.action.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.menu import MenuOptionMap
|
|
from falyx.selection import prompt_for_selection, render_table_base
|
|
from falyx.signals import BackSignal, QuitSignal
|
|
from falyx.themes import OneColors
|
|
from falyx.utils import chunks
|
|
|
|
|
|
class MenuAction(BaseAction):
|
|
"""MenuAction class for creating single use menu actions."""
|
|
|
|
def __init__(
|
|
self,
|
|
name: str,
|
|
menu_options: MenuOptionMap,
|
|
*,
|
|
title: str = "Select an option",
|
|
columns: int = 2,
|
|
prompt_message: str = "Select > ",
|
|
default_selection: str = "",
|
|
inject_last_result: bool = False,
|
|
inject_into: str = "last_result",
|
|
console: Console | None = None,
|
|
prompt_session: PromptSession | None = None,
|
|
never_prompt: bool = False,
|
|
include_reserved: bool = True,
|
|
show_table: bool = True,
|
|
custom_table: Table | None = None,
|
|
):
|
|
super().__init__(
|
|
name,
|
|
inject_last_result=inject_last_result,
|
|
inject_into=inject_into,
|
|
never_prompt=never_prompt,
|
|
)
|
|
self.menu_options = menu_options
|
|
self.title = title
|
|
self.columns = columns
|
|
self.prompt_message = prompt_message
|
|
self.default_selection = default_selection
|
|
self.console = console or Console(color_system="auto")
|
|
self.prompt_session = prompt_session or PromptSession()
|
|
self.include_reserved = include_reserved
|
|
self.show_table = show_table
|
|
self.custom_table = custom_table
|
|
|
|
def _build_table(self) -> Table:
|
|
if self.custom_table:
|
|
return self.custom_table
|
|
table = render_table_base(
|
|
title=self.title,
|
|
columns=self.columns,
|
|
)
|
|
for chunk in chunks(
|
|
self.menu_options.items(include_reserved=self.include_reserved), self.columns
|
|
):
|
|
row = []
|
|
for key, option in chunk:
|
|
row.append(option.render(key))
|
|
table.add_row(*row)
|
|
return table
|
|
|
|
async def _run(self, *args, **kwargs) -> Any:
|
|
kwargs = self._maybe_inject_last_result(kwargs)
|
|
context = ExecutionContext(
|
|
name=self.name,
|
|
args=args,
|
|
kwargs=kwargs,
|
|
action=self,
|
|
)
|
|
|
|
effective_default = self.default_selection
|
|
maybe_result = str(self.last_result)
|
|
if maybe_result in self.menu_options:
|
|
effective_default = maybe_result
|
|
elif self.inject_last_result:
|
|
logger.warning(
|
|
"[%s] Injected last result '%s' not found in menu options",
|
|
self.name,
|
|
maybe_result,
|
|
)
|
|
|
|
if self.never_prompt and not effective_default:
|
|
raise ValueError(
|
|
f"[{self.name}] 'never_prompt' is True but no valid default_selection"
|
|
" was provided."
|
|
)
|
|
|
|
context.start_timer()
|
|
try:
|
|
await self.hooks.trigger(HookType.BEFORE, context)
|
|
key = effective_default
|
|
if not self.never_prompt:
|
|
table = self._build_table()
|
|
key = await prompt_for_selection(
|
|
self.menu_options.keys(),
|
|
table,
|
|
default_selection=self.default_selection,
|
|
console=self.console,
|
|
prompt_session=self.prompt_session,
|
|
prompt_message=self.prompt_message,
|
|
show_table=self.show_table,
|
|
)
|
|
option = self.menu_options[key]
|
|
result = await option.action(*args, **kwargs)
|
|
context.result = result
|
|
await self.hooks.trigger(HookType.ON_SUCCESS, context)
|
|
return result
|
|
|
|
except BackSignal:
|
|
logger.debug("[%s][BackSignal] ← Returning to previous menu", self.name)
|
|
return None
|
|
except QuitSignal:
|
|
logger.debug("[%s][QuitSignal] ← Exiting application", self.name)
|
|
raise
|
|
except Exception as error:
|
|
context.exception = error
|
|
await self.hooks.trigger(HookType.ON_ERROR, context)
|
|
raise
|
|
finally:
|
|
context.stop_timer()
|
|
await self.hooks.trigger(HookType.AFTER, context)
|
|
await self.hooks.trigger(HookType.ON_TEARDOWN, context)
|
|
er.record(context)
|
|
|
|
async def preview(self, parent: Tree | None = None):
|
|
label = f"[{OneColors.DARK_YELLOW_b}]📋 MenuAction[/] '{self.name}'"
|
|
tree = parent.add(label) if parent else Tree(label)
|
|
for key, option in self.menu_options.items():
|
|
tree.add(
|
|
f"[dim]{key}[/]: {option.description} → [italic]{option.action.name}[/]"
|
|
)
|
|
await option.action.preview(parent=tree)
|
|
if not parent:
|
|
self.console.print(tree)
|
|
|
|
def __str__(self) -> str:
|
|
return (
|
|
f"MenuAction(name={self.name!r}, options={list(self.menu_options.keys())!r}, "
|
|
f"default_selection={self.default_selection!r}, "
|
|
f"include_reserved={self.include_reserved}, "
|
|
f"prompt={'off' if self.never_prompt else 'on'})"
|
|
)
|