Roland Thomas
7f63e16097
- Add comprehensive module docstrings across the codebase for better clarity and documentation. - Refactor Enum classes (e.g., FileType, ConfirmType) to use `_missing_` for built-in coercion from strings. - Add `encoding` attribute to `LoadFileAction`, `SaveFileAction`, and `SelectFileAction` for more flexible file handling. - Enable lazy file loading by default in `SelectFileAction` to improve performance. - Simplify bottom bar toggle behavior: all toggles now use `ctrl+<key>`, eliminating the need for key conflict checks with Falyx commands. - Add `ignore_in_history` attribute to `Command` to refine how `ExecutionRegistry` identifies the last valid result. - Improve History command output: now includes tracebacks when displaying exceptions.
44 lines
1.4 KiB
Python
44 lines
1.4 KiB
Python
# Falyx CLI Framework — (c) 2025 rtj.dev LLC — MIT Licensed
|
|
"""
|
|
Generates a Rich table view of Falyx commands grouped by their tags.
|
|
|
|
This module defines a utility function for rendering a custom CLI command
|
|
table that organizes commands into groups based on their first tag. It is
|
|
used to visually separate commands in interactive menus for better clarity
|
|
and discoverability.
|
|
|
|
Functions:
|
|
- build_tagged_table(flx): Returns a `rich.Table` of commands grouped by tag.
|
|
"""
|
|
from collections import defaultdict
|
|
|
|
from rich import box
|
|
from rich.table import Table
|
|
|
|
from falyx.command import Command
|
|
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) # type: ignore[arg-type]
|
|
|
|
# Group commands by first tag
|
|
grouped: dict[str, list[Command]] = defaultdict(list)
|
|
for cmd in flx.commands.values():
|
|
first_tag = cmd.tags[0] if cmd.tags else "Other"
|
|
grouped[first_tag.capitalize()].append(cmd)
|
|
|
|
# Add grouped commands to table
|
|
for group_name, commands in grouped.items():
|
|
table.add_row(f"[bold underline]{group_name} Commands[/]")
|
|
for cmd in commands:
|
|
table.add_row(f"[{cmd.key}] [{cmd.style}]{cmd.description}")
|
|
table.add_row("")
|
|
|
|
# Add bottom row
|
|
for row in flx.get_bottom_row():
|
|
table.add_row(row)
|
|
|
|
return table
|