pas-tui 2026.1.20.2

A professional, hotkey-driven TUI system for Python CLIs

pas-tui

A professional, hotkey-driven TUI system for Python CLIs.

This is part of the PAS Toolkit which will be open-sourced in the future, but can be used independently.

Installation

pip install pas-tui

Features

• Numerical index padding (01, 02, etc.)
• Automatic hotkey mapping (1-9, q for Quit, b for Back)
• Rich-formatted output
• Cross-platform clipboard support

Usage

High-Level Menu Class (Recommended)

The Menu class provides a declarative way to build interactive loops with callback support, encapsulating headers and state.

from pas_tui import Menu

def run_setup():
    print("Running setup...")

def main():
    # 1. Initialize with title
    menu = Menu("Project Manager", style="bold green")
    
    # 2. Add items with direct callback support or return values
    menu.add_item("Setup Project", run_setup)
    menu.add_item("View Dashboard", "view_dash")
    
    # 3. Add standard navigation
    menu.add_back_item() 
    menu.add_quit_item()
    
    # 4. Start the interactive loop
    selection = menu.run()
    
    if selection == "view_dash":
        print("Opening dashboard...")

if __name__ == "__main__":
    main()

Low-Level Interactive Menus

Confirmation Prompts

from pas_tui import prompt_yes_no

if prompt_yes_no("Do you want to proceed with the deletion?", default=False):
    print("Deleting...")
else:
    print("Aborted.")

Clipboard Support

from pas_tui import copy_to_clipboard

if copy_to_clipboard("Hello from pas-tui!"):
    print("Copied to clipboard!")