README.ZH.md

terminal_layout

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

---

基于terminal_layout的扩展

• progress

• choice

---

** video demo **

link

• Github
• 文档
• https://asciinema.org/a/226120

安装

pip install terminal-layout

依赖

• Python 2.7, 3.5+ (maybe 3.4)
• Linux, OS X, and Windows systems.

Usage

• easy demo:

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_00,
                          [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()

# 如果使用delay_set_text(), 必须把auto_re_draw设为True，否则你需要自己在线程中执行re_draw()
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)

# 如果执行draw()时auto_re_draw=True，你必须执行stop()
ctl.stop()

• 禁用 auto_re_draw

import time
from terminal_layout import *

ctl = LayoutCtl.quick(TableLayout,
                      [
                          [TextView('t1', 'Hello World!', width=Width.fill, back=Back.blue)],
                          [TextView('t2', '', fore=Fore.magenta)],
                      ],
                      )


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()

# 不需执行stop()
# ctl.stop()

• use python2 unicode

# -*- 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()

View的属性

• fore & back

TextView('','fore',fore=Fore.red)
TextView('','back',back=Back.red)

• style

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

• width

TextView('','width',width=10)

• weight

TextView('','weight',weight=1)

• gravity

TextView('','gravity',gravity=Gravity.left)

• visibility

TextView('','',visibility=Visibility.visible)

• ex_style (not support windows)

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

• ex_fore & ex_back (not support windows)

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

LICENSE

GPLv3

Thanks

• colorama : Simple cross-platform colored terminal text in Python
• colored : Very simple Python library for color and formatting in terminal