Graphic library based on curses
Project description
CursedUI
This is a python graphic library based on the curses library.
It hides the complexity of the basic library and offers a class-first approach to UI.
Index
Examples
- Basic: example.py
- Layout example: playground.py
You can run the example files simply by running python [filename].py
Available tiles
Split
Equally vertically splits the available space between its child tiles.
from cursedui import Split
splitTile = Split(tile1, tile2, ...)
Text
Shows the string subject in the available canvas. offsetX
and offsetY
attributes allow to move the pane of the visible text.
Invalid offset values will be reset either to 0 (if offset < 0) or to the calculated maximum offset (if offset > maximum offset).
from cursedui import Text
textSubject = Subject('myText')
splitTile = Text(title='My title', bordered=True, subject=textSubject)
splitTile.offsetY = 27 # might default to the maximum possible offset
splitTile.offsetX = -1 # defaults to 0
Log
Derived from Text
. The key difference is the auto-scroll feature, which disables itself whenever the vertical offset (offsetY
) is not aligned with the last line of the subject (i.e. when manual offset control is used).
from cursedui import Log
logSubject = Subject('Log line 0')
splitTile = Log(title='My scrolling log', bordered=True, subject=logSubject)
for i in range(100):
logSubject(f'{logSubject.value}\nLog line {i}')
Extending (creating new tiles)
The library is made to be easily enhanced with new tiles.
To create a new tile, you need to extend the cursedui.Tile
class and implement its abstract render
method.
See the tile.py file to see the rest of the overrideable methods.
See tiles folder for a list of tiles available out-of-the-box.
Other than the render
method, you might want to override the following methods:
Tile.onBeforeWindowRefresh
- used to access the curses' window (it should be used for particular cases only). See the Split tile for an example.Tile.shouldRender
- which should be overwritten returning the super's result and the new tile's particular logic. See the Text tile for an example.
from typing import List
from cursedui import Tile, Subject
class Dumb(Tile[str]):
def render(self, canvas: Canvas) -> None:
lines = [self.subject * canvas.width for _ in range(canvas.height)]
canvas.lines = lines
return canvas
Tile decorators
Tile decorators allow to extend their graphical representation without adding complexity to the normal usage. All the available decorators are written in the tile_decorators.py file.
fixed_height
Allows to define a fixed height tile, rather than following the mainstram logic to split the view equally between tiles.
It will attempt to get the required vertical space, but it will be limited to the main UI's available space. Also notice that this might preclude other views to show (for example if the remaining available space is not sufficient to show the remaining tiles).
Currently only the main UI class (CursedUI) supports this decorator.
from cursedui import Text
from cursedui.tile_decorators import fixed_height
myTile = fixed_height(maxHeight=20)(Text(...))
fixed_width
Allows to define a fixed width tile (absolute, percentage), rather than following the mainstream logic (CursedUI: full width; Split: equally divided).
It wil lattempt to get the required horizontal space, but it will be limited to the available width. Also notice that if misused, this might prevent other tiles to be shown.
Allowable parents:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.