✨ Características

• 🎮 Navegación con flechas — arriba/abajo para moverte, Enter para ejecutar, q para salir
• 🎨 20 estilos de borde — desde ASCII clásico hasta caracteres Unicode y emoji-like
• 🌈 Colores personalizables — borde, opciones y foco por separado, con 8 colores en 2 tonos cada uno
• 📦 Cero dependencias externas — solo la librería estándar de Python (termios, tty, os)
• 🐍 Ligero — un único archivo, fácil de auditar y de vendorizar si hace falta
• 🐧 Linux / macOS — funciona en cualquier terminal POSIX

⚠️ Requiere una terminal real (TTY) en Linux o macOS. No funciona en Windows ni en streams no interactivos, porque usa los módulos termios/tty para leer teclas en modo crudo.

📦 Instalación

pip install grmenu

_{Requiere Python ≥ 3.9.}

🚀 Uso rápido

from GRmenu import GRmenu

def opcion_uno():
    print("elegiste uno")

def opcion_dos():
    print("elegiste dos")

menu = GRmenu([opcion_uno, opcion_dos], title="Mi menu", style=19)
menu.SetStyle.Border("yellow")
menu.SetStyle.Options("green")
menu.draw()

Cada elemento de la lista es una función; el nombre de la función se usa como texto de la opción, y al presionar Enter sobre ella, esa función se ejecuta.

🕹️ Controles

🎨 Personalización

Colores (SetStyle)

Cada zona del menú se personaliza por separado. level=1 es el tono normal y level=2 el brillante.

menu.SetStyle.Border("cyan")        # color del borde
menu.SetStyle.Options("white")      # color de las opciones no seleccionadas
menu.SetStyle.Focus("green", 2)     # color de la opción resaltada

Colores disponibles: black, red, green, yellow, blue, magenta, cyan, white.

Estilos de borde (style)

El parámetro style acepta un número que define cómo se dibuja el marco del menú:

menu = GRmenu([opcion_uno, opcion_dos], title="Mi menu", style=7)  # bordes redondeados

Ancho del menú

draw() acepta size_max, el ancho mínimo en caracteres del cuadro (se expande automáticamente si el título o las opciones son más largos):

menu.draw(size_max=30)

📖 Referencia de la API

GRmenu(functions, title="", style=19)

menu.draw(size_max=20)

Dibuja el menú y bloquea el hilo hasta que el usuario elige una opción (Enter) o sale (q).

menu.SetStyle

🧩 Ejemplo completo

from GRmenu import GRmenu

def saludar():
    print("¡Hola!")

def salir_app():
    print("Hasta luego 👋")

def acerca_de():
    print("GRmenu v0.1.0 — menú TTY para terminal")

menu = GRmenu(
    [saludar, acerca_de, salir_app],
    title="GRmenu Demo",
    style=7,
)
menu.SetStyle.Border("magenta")
menu.SetStyle.Options("white")
menu.SetStyle.Focus("cyan", 2)
menu.draw(size_max=28)

🤝 Contribuir

Las contribuciones son bienvenidas. Podés abrir un issue o enviar un pull request.

📄 Licencia

Distribuido bajo licencia MIT.