Declarative Terminal User Interface Library
Project description
About
Declarative TUI (Terminal User Interface) library, with layout features modelled after modern web components.
The syntax will be familiar with anyone who's used Django models before. Widget objects can be created declaratively by creating a class that inherits from the desired widget class.
A CSS flexbox-style widget that contains a text box and a button can be created declaratively, like so:
class NiceFlexBox(widgets.FlexBox):
text_box = widgets.TextBox(text="Hello World!")
button = widgets.Button(label="Button 2", callback=None)
class Meta:
border_label = "Nice FlexBox"
nice_flex_box = NiceFlexBox()
or imperatively, like so:
children = {
'text_box': widgets.TextBox(text="Hello World!"),
'button': widgets.Button(label="Button 2", callback=None)
}
nice_flex_box = widgets.FlexBox(children=children, border_label="Nice FlexBox")
Example
which is given by the code:
from tanmatsu import Tanmatsu, widgets
class ButtonList(widgets.List):
class Meta:
border_label = "List"
children = [
widgets.Button(label="Button 1", callback=None),
widgets.Button(label="Button 2", callback=None),
widgets.Button(label="Button 3", callback=None),
]
item_height = 5
class VertSplit(widgets.FlexBox):
text_box = widgets.TextBox(border_label="Text Box", text="Hello World!")
text_log = widgets.TextLog(border_label="Text Log")
button_list = ButtonList()
class Meta:
flex_direction = widgets.FlexBox.HORIZONTAL
with Tanmatsu(title="Tanmatsu!") as t:
rw = VertSplit()
t.set_root_widget(rw)
for (i, v) in enumerate(rw.button_list.children):
v.callback = lambda i=i: rw.text_log.append_line(f"Button {i + 1} pressed")
t.loop()
Installation
pip install tanmatsu
Documentation
https://tanmatsu.readthedocs.io/en/latest/
Requirements
- Python >=3.11
- GNU/Linux
- Full-featured terminal emulator (e.g., Gnome VTE)
- A font with unicode symbols (e.g., Noto)
Dependencies
- tri.declarative
- parsy
- wcwidth
Development dependancies:
- sphinx
Development
Installing
- If not running python 3.11, install pyenv.
- Install poetry.
- Run
poetry install
from the repository directory to set up a virtual environment with the necessary python version and packages
Running
poetry run python3 main.py
Testing
poetry run python3 -m unittest
License
MIT. For more information, see LICENSE.md
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for tanmatsu-0.0.1.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 75bc0f1dd0091428f761b3d0ef1398b4ddb5a083f38c30edb35907c9e9a76e11 |
|
MD5 | 510ec585d1b72843c9f25f903c3af8d1 |
|
BLAKE2b-256 | 411bdb1575dad60f6fcb977542351a5a7f2234749e1329095b8dbad46aaff9c1 |