terminal_layout - GitLite

KO | EN

gitlite — search

#javascript #python #react #ai #typescript #golang #go #deep-learning #linux #java #cli #kubernetes #vue #security

terminal_layout

(★ 151)

The project help you to quickly build layouts in terminal，cross-platform(一个跨平台的命令行ui布局工具)

File Explorer

Download Latest Version (.zip)

- - __init__.py
  - color.py
  - ex_color.py
  - ex_style.py
  - gravity.py
  - style.py
  - visibility.py
  - weight.py
  - width.py
- __init__.py
- choice.py
- demo6(get_width).py
- demo_v2_1.py
- input_ex.py
- key_listener.py
- progress.py
- record_demo.py
- scroll.py
- - choice.gif
  - color.jpeg
  - demo.gif
  - demo_v2_1.gif
  - ex_color.jpeg
  - ex_style.jpeg
  - gravity.jpeg
  - hello.png
  - input.gif
  - progress.gif
  - py2.png
  - scroll.gif
  - style.jpeg
  - table.png
  - visibility.jpeg
  - weight.jpeg
  - width.jpeg
- - index.rst
- changelog.rst
- conf.py
- draw.rst
- FAQ.rst
- getStarted.rst
- index.rst
- installation.rst
- keyListener.rst
- make.bat
- Makefile
- Properties.rst
- requirements.txt
- View.rst
- .DS_Store
- cal_scroll.png
- choice.gif
- color.jpeg
- demo.gif
- demo_v2_1.gif
- ex_color.jpeg
- ex_style.jpeg
- gravity.jpeg
- hello.png
- input.gif
- loading.jpg
- progress.gif
- progress.jpg
- py2.png
- scroll.gif
- style.jpeg
- visibility.jpeg
- weight.jpeg
- width.jpeg
- - __init__.py
  - back.py
  - font.py
  - fore.py
  - style.py
- - __init__.py
- - __init__.py
  - class_helper.py
  - helper.py
- - __init__.py
  - event.py
  - key.py
  - linux.py
  - listener.py
  - windows.py
- - __init__.py
  - base.py
  - layout.py
  - params.py
  - text_view.py
  - util.py
- __init__.py
- ctl.py
- log.py
- types.py
- __init__.py
- test_1.py
.gitignore
LICENSE
pyproject.toml
README.md
README.rst
README.ZH.md
requirements.txt
setup.py

# Installation Guide

1. Get the code

git clone https://github.com/gojuukaze/terminal_layout

Downloads the entire project code from GitHub to your computer.

cd terminal_layout

Moves into the project folder you just downloaded.

2. Python

Easy Recommended

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install -r requirements.txt

Installs the Python libraries listed in requirements.txt (or similar).

python <실행할 파일명>.py # README에서 정확한 실행 파일명을 확인하세요

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# terminal_layout

The project help you to quickly build layouts in terminal  
(这个一个命令行ui布局工具)

![demo_v2_1.gif](https://raw.githubusercontent.com/gojuukaze/terminal_layout/master/pic/demo_v2_1.gif)

<img src="pic/demo.gif"  alt="demo.gif" width="450"/>

----------------

**Some extensions base on terminal_layout**

* [progress](terminal_layout/extensions/progress/README.md)

![progress.gif](https://raw.githubusercontent.com/gojuukaze/terminal_layout/master/pic/progress.gif)

* [choice](terminal_layout/extensions/choice/README.md)

![choice.gif](https://raw.githubusercontent.com/gojuukaze/terminal_layout/master/pic/choice.gif)

-------------------

** video demo **

<a href="https://asciinema.org/a/226120">
<img src="https://asciinema.org/a/226120.svg"  alt="asciicast" width="550"/>
</a>

# link

* [Github](https://github.com/gojuukaze/terminal_layout) 
* [中文README](README.ZH.md) 
* [Documentation 中文文档](https://doc.ikaze.cn/terminal_layout/)

# install 
```bash
pip install terminal-layout
```

# Dependencies
* Python 3.5+ (maybe 3.4)
* Linux, OS X, and Windows systems.

## Python Support

| Python | terminal_layout |
| ------ | --------------- |
| 2.7    | 2.1.x           |
| 3.5+   | 3.x             |

# Usage

* easy demo:

```python
import time
from terminal_layout import *

ctl = LayoutCtl.quick(TableLayout,
                      # table id: root
                      [
                          [TextView('t1', 'Hello World!', width=Width.fill, back=Back.blue)],  # <- row id: root_row_0,
                          [TextView('t2', '', fore=Fore.magenta)],  # <- row id: root_row_1,
                      ],
                      )

# or layout=ctl.get_layout()
layout = ctl.find_view_by_id('root')
layout.set_width(20)

# default: auto_re_draw=True
ctl.draw()

# call delay_set_text() must be set auto_re_draw=True,
# otherwise you must start a thread to call re_draw() by yourself
ctl.find_view_by_id('t2').delay_set_text('你好,世界!', delay=0.2)

time.sleep(0.5)
row3 = TableRow.quick_init('', [TextView('t3', 'こんにちは、世界!')])
layout.add_view(row3)

# If you call draw() with auto_re_draw=True, you must stop()
ctl.stop()

```
![](https://raw.githubusercontent.com/gojuukaze/terminal_layout/master/pic/hello.png)

* disable auto_re_draw

```python
import time
from terminal_layout import *

ctl = LayoutCtl.quick(TableLayout,
                      # table id: root
                      [
                          [TextView('t1', 'Hello World!', width=Width.fill, back=Back.blue)],  # <- row id: root_row_1,
                          [TextView('t2', '', fore=Fore.magenta)],  # <- row id: root_row_2,
                      ],
                      )

layout = ctl.find_view_by_id('root')
layout.set_width(20)

ctl.draw(auto_re_draw=False)

ctl.find_view_by_id('t2').set_text('你好,世界!')
ctl.re_draw()

time.sleep(0.5)
row3 = TableRow.quick_init('', [TextView('t3', 'こんにちは、世界!')])
layout.add_view(row3)
ctl.re_draw()

# don't need call stop()
# ctl.stop()
```

* use python2 unicode

```python
# -*- coding: utf-8 -*-
from terminal_layout import *
import sys
reload(sys)
sys.setdefaultencoding('utf-8')

ctl = LayoutCtl.quick(TableLayout,
                      [
                          [TextView('', u'中文，你好', back=Back.cyan, width=Width.wrap)],
                          [TextView('', u'中文，你好', back=Back.cyan, width=6)],
                          [TextView('', u'日本語，こんにちは', back=Back.cyan, width=Width.wrap)],
                      ]

)

ctl.draw()

```

![](https://raw.githubusercontent.com/gojuukaze/terminal_layout/master/pic/py2.png)

## Properties

* fore & back
 
```python
TextView('','fore',fore=Fore.red)
TextView('','back',back=Back.red)
```

<img width="560" src="pic/color.jpeg"/>

* style

```python
TextView('','style',style=Style.dim)
```

<img width="560" src="pic/style.jpeg"/>

* width
 
```python
TextView('','width',width=10)
```

<img width="560" src="pic/width.jpeg"/>

* weight
 
```python
TextView('','weight',weight=1)
```

<img width="560" src="pic/weight.jpeg"/>

* gravity
 
```python
TextView('','gravity',gravity=Gravity.left)
```

<img width="560" src="pic/gravity.jpeg"/>

* visibility
 
```python
TextView('','',visibility=Visibility.visible)
```

<img width="560" src="pic/visibility.jpeg"/>

* ex_style (not support windows)

```python
TextView('','ex_style',style=Style.ex_blink)
```

<img width="560" src="pic/ex_style.jpeg"/>

* ex_fore & ex_back (not support windows)

```python
TextView('','ex_fore',fore=Fore.ex_red_1)
TextView('','ex_back',back=Back.ex_red_1)

```

<img width="560" src="pic/ex_color.jpeg"/>

# LICENSE

[GPLv3](https://github.com/gojuukaze/terminal_layout/blob/master/LICENSE)

# Thanks

* [colorama](https://github.com/tartley/colorama) : Simple cross-platform colored terminal text in Python
 * [colored](https://gitlab.com/dslackw/colored) : Very simple Python library for color and formatting in terminal

# 捐赠 / Sponsor

开源不易，如果你觉得对你有帮助，求打赏个一块两块的

![](https://gitee.com/gojuukaze/liteAuth/raw/master/shang.jpg)