معرفی شرکت ها
cursedui-0.0.1
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشتر
تبلیغات ما
مشتریان به طور فزاینده ای آنلاین هستند. تبلیغات می تواند به آنها کمک کند تا کسب و کار شما را پیدا کنند.
مشاهده بیشترتوضیحات
Graphic library based on curses
| ویژگی | مقدار |
|---|---|
| سیستم عامل | - |
| نام فایل | cursedui-0.0.1 |
| نام | cursedui |
| نسخه کتابخانه | 0.0.1 |
| نگهدارنده | [] |
| ایمیل نگهدارنده | [] |
| نویسنده | Giacomo Furlan |
| ایمیل نویسنده | opensource@giacomofurlan.name |
| آدرس صفحه اصلی | https://github.com/elegos/python-cursedui |
| آدرس اینترنتی | https://pypi.org/project/cursedui/ |
| مجوز | LGPLv3 |
# CursedUI
[](https://www.gnu.org/licenses/lgpl-3.0)
[](https://www.python.org/dev/peps/pep-0008/)
[](https://realpython.com/lessons/pros-and-cons-type-hints/)
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
- [CursedUI](#cursedui)
- [Index](#index)
- [Examples](#examples)
- [Available tiles](#available-tiles)
- [Split](#split)
- [Text](#text)
- [Log](#log)
- [Extending (creating new tiles)](#extending-creating-new-tiles)
- [Tile decorators](#tile-decorators)
- [fixed_height](#fixed_height)
- [fixed_width](#fixed_width)
## Examples
- Basic: [example.py](example.py)
- Layout example: [playground.py](playground.py)
You can run the example files simply by running `python [filename].py`
## Available tiles
### [Split](cursedui/tiles/split.py)
Equally vertically splits the available space between its child tiles.
```python
from cursedui import Split
splitTile = Split(tile1, tile2, ...)
```
### [Text](cursedui/tiles/text.py)
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).
```python
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](cursedui/tiles/log.py)
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).
```python
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](cursedui/tile.py) file to see the rest of the overrideable methods.
See [tiles](cursedui/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](cursedui/tiles/split.py) 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](cursedui/tiles/text.py) for an example.
```python
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](cursedui/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](cursedui/cursedui.py)) supports this decorator.
```python
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:
- [CursedUI](cursedui/cursedui.py)
- [Split](cursedui/tiles/split.py)
زبان مورد نیاز
| مقدار | نام |
|---|---|
| >=3.6 | Python |
نحوه نصب
نصب پکیج whl cursedui-0.0.1:
pip install cursedui-0.0.1.whl
نصب پکیج tar.gz cursedui-0.0.1:
pip install cursedui-0.0.1.tar.gz