mirror
/
pyTermTk
mirror of https://github.com/ceccopierangiolieugenio/pyTermTk.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
235 Commits
8 Branches
107 Tags
36 MiB
 
 
 
 
 
Tree: 4a6cfa7f89
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from '4a6cfa7f89'
${ noResults }
Eugenio Parodi 4a6cfa7f89
Added split function to TTkString 		4 years ago
.github/workflows Removed python 3.7 test 5 years ago
TermTk Added split function to TTkString 4 years ago
demo Added split function to TTkString 4 years ago
docs Added Calculator Tutorial 4 years ago
tests Added split function to TTkString 4 years ago
tools Improved the Paint demo with double lines 4 years ago
tutorial Minor fix in the calculator tutorial 4 years ago
.gitignore Added Checkbox and RadioButton Label 4 years ago
LICENSE Formalizing the structure 5 years ago
Makefile Doc: Improved Button,Colors,Themes Documentation 4 years ago
README.md Added split function to TTkString 4 years ago
setup.py removed the apache licese from setup 4 years ago

README.md

Linux Usage Python pyTermTk_version Test Status pypi_version pypi_version

screenshot

python Terminal Toolkit

Text-based user interface library (TUI) Evolved from the discontinued project pyCuT and inspired by a mix of Qt5,GTK, and tkinter api definition with a touch of personal interpretation

screenshot

Features

  • Basic widgets for TUI development (Button, Label, checkbox, ...)
  • Specialized widgets to improve the usability (Windows, Frames, Tables, ...)
  • QT Like Layout system to help arrange the widgets in the terminal
  • True color support
  • [TBD] Fullsize/Halfsize UTF-8 characters

Limitations

  • Only the key combinations forwarded by the terminal emulator used are detected (ALT,CTRL may not be handled)

Try

screenshot

Tutorial

Be inspired by the tutorial examples

Api Definitions

Don't get bored by the Api Definitions

Install/Upgrade

pyTermTk is available on PyPI

pip3 install --upgrade pyTermTk

Quick Test/Try - no install required

Clone

clone git@github.com:ceccopierangiolieugenio/pyTermTk.git
cd pyTermTk

Run Basic (non ui) input test

python3 tests/test.input.py

Run demo

# Press CTRL-C to exit
# the logs are written to "session.log"
make runDemo
  # or
python3 demo/demo.py -f

# Try gittk
make runGittk

Profiling

cProfile, cProfilev
python3 -m cProfile -o profiler.txt tests/test.ui.004.py

# install cprofilev:
#     pip3 install cprofilev
cprofilev -f profiler.txt
# open http://127.0.0.1:4000
pyroscope

pyroscope can be used as well for profiling

Related Projects

  • honourable mention

    • bpytop - Linux/OSX/FreeBSD resource monitor
      This was the base inspiration for my core library

  • Python

    • urwid - Console user interface library for Python
    • pyTermGUI - A simple yet powerful TUI framework for your Python (3.7+) applications
    • Textual - TUI (Text User Interface) framework for Python inspired by modern web development
    • Rich - Python library for rich text and beautiful formatting in the terminal
    • PyCuT - terminal graphic library loosely based on QT api (my previous failed attempt)

  • Non Python