tiny-tui 0.0.1024

Tiny package for fast implementing the simpliest tui on Python

Tiny TUI

A very small library with no dependencies, written in pure Python to create simple text interfaces (TUI) in Python.

Русская версия

---

What is Tiny TUI?

Tiny TUI is a small Python library for building simple menus and text interfaces without third-party dependencies. It allows you to quickly and easily build menus and submenus, linking actions to them (if required).

---

What is implemented at the moment

• Simple menu model and menu items
• Nested menus
• Navigation using arrows (color selection of the selected menu item)
• Use of parameters and settings (if any actions require input from the user)

---

Installation

pip install tiny-tui

---

Basic Example

At the moment, the library fills in keywords (such as "exit", "settings" and "back") in Russian. This will be fixed in the future.

from tiny_tui import Menu, App


def hello(ctx):
    print("Hello, World!")

submenu: Menu = Menu(
	title="Submenu",
	items={
		"Do nothing": None
		}
)
head_menu: Menu = Menu(
	title="Main menu",
	items={
		"Call function": hello,
		"Go to submenu": submenu}
	)
app: App = App(head_menu=head_menu)
app.run()

Project Status

Early stage

• API may change
• Feedback is welcome
• The project is intentionally kept small

---

Contributing

Issues, ideas, and pull requests are welcome.

If you find a bug or have a suggestion:

• open an issue
• describe the use case
• keep it simple

---

License

MIT License

---

Tiny TUI(Русский)

Очень маленькая библиотека без зависимостей, написанная на чистом Python для создания простых текстовых интерфейсов (TUI) на Python.

English version

---

Что такое Tiny TUI?

Tiny TUI — это маленькая Python-библиотека для построения простых меню и текстовых интерфейсов без сторонних зависимостей. Она позволяет достаточно быстрым и простым образом строить меню и подменю, привязывая к ним действия(если требуется).

---

Что реализовано на данный момент

• Простая модель меню и пунктов меню
• Вложенные меню
• Навигация с помощью стрелок(цветовое выделение выбранного пункта меню)
• Использование параметров и настроек(если какие-то действия требуют ввода от пользователя)

---

Установка

pip install tiny-tui

---

Пример использования

from tiny_tui import Menu, App


def hello(ctx):
    print("Привет, мир!")

submenu: Menu = Menu(
	title="Подменю",
	items={
		"Ничего не делать": None
		}
)
head_menu: Menu = Menu(
	title="Главное меню",
	items={
		"Выполнить функцию": hello,
		"Перейти в подменю": submenu}
	)
app: App = App(head_menu=head_menu)
app.run()

---

Статус проекта

Ранняя стадия разработки

• API может меняться
• Обратная связь приветствуется
• Проект намеренно остаётся небольшим

---

Участие в разработке

Идеи, баг-репорты и pull request'ы приветствуются.

---

Лицензия

MIT License