py-menu-tui 0.2.0

This project implements a keyboard-controlled text user interface (TUI) for the terminal that allows users to navigate menus and nested subsections using simple key inputs (w, s, Enter, Esc). It provides a lightweight framework for building interactive CLI applications with features like menu navigation, dynamic subsections, progress bars, and confirmation prompts.

py_menu_tui

py_menu_tui is a lightweight terminal user interface (TUI) navigation framework for Python.
It allows developers to quickly build interactive command-line menus with keyboard navigation and nested subsections.

The interface is controlled using simple keys and is designed for Windows terminals using msvcrt.

---

Features

• Keyboard navigation (w / s)
• Nested menu sections
• Simple function binding to menu entries
• Scrollable menus
• Progress bar utility
• Confirmation prompts
• No external dependencies

---

Installation

Currently the package can be installed with:

pip install py_menu_tui

Controls
Key	Action
w	Move up
s	Move down
Enter	Select option
Esc	Go back
Ctrl+C	Exit program

Example
from win_nav_tui import UserInterface

def hello():
    print("Hello World")

ui = UserInterface(10)

ui.setup(
    ["Say Hello"],
    [hello]
)

ui.begin()
Creating Subsections
ui.add_sub_section(
    ["Option 1", "Option 2"],
    [func1, func2],
    section="Settings"
)
Utilities
Progress Bar
from win_nav_tui import progressbar

progressbar(50)
Clear Terminal
from win_nav_tui import clear
Confirmation Prompt
from win_nav_tui import confirm

if confirm("Continue?"):
    print("Confirmed")

Requirements

• Python 3+
• Windows terminal (uses msvcrt)
• No external dependencies

License

This project is licensed under the MIT License.