Python module to style terminal output, moving and positioning the cursor.
Python 2 and 3 compatible
Install through pip.
$ pip install py-term
or get from source
$ git clone https://github.com/gravmatt/py-term.git $ cd py-term $ python setup.py install
Import the module into your python project.
import term
term.write('Hello, ') term.write('Python!') > Hello, Python! term.writeLine('Hello') term.writeLine('Python!') > Hello > Python!
The first argument is the text output and all following arguments are for styling.
term.writeLine(text, *style) Or text = term.format(text, *style) term.writeLine(text)
term.writeLine('Hello, Python!') term.writeLine('This text line will be green', term.green) term.writeLine('Reverse the green color', term.green, term.reverse)
Or
output = term.format('Hello, ', term.green) + term.format('Python!', term.blue, term.bold) term.writeLine(output) term.write(term.format('All in one line', term.reverse))
Center align
# term.textCenter(text) term.writeLine(term.textCenter('Super Python!'))
Right align
# term.textRight(text) term.writeLine(term.textRight('Rene Tanczos (@gravmatt)')) ( Function term.right() to align text is depricated because of naming conflicts! )
Code | Description |
---|---|
term.off | All attributes off |
term.bold | Bold |
term.dim | Dim |
term.underscore | Underscore (monochrome display only) |
term.blink | Blink |
term.reverse | Reverse |
term.hide | Hide |
Code | Color |
---|---|
term.black | Black |
term.red | Red |
term.green | Green |
term.yellow | Yellow |
term.blue | Blue |
term.magenta | Magenta |
term.cyan | Cyan |
term.white | White |
Code | Color |
---|---|
term.bgblack | Black |
term.bgred | Red |
term.bggreen | Green |
term.bgyellow | Yellow |
term.bgblue | Blue |
term.bgMagenta | Magenta |
term.bgcyan | Cyan |
term.bgwhite | White |
Removes style characters.
(Good to call before you count a string)
term.strip(formatted_text) hello = term.red + 'hello, world' + term.off print hello # '\x1b[31mhello, world\x1b[0m\x1b[27m' print term.strip(hello) # hello, world
Simple highlighting of unformatted text strings
def callback(matching_text): return term.blue + matching_text + term.off output, match_count, array_of_positions = term.highlight(regex_pattern, text, callback)
Return a tuple.
output (index 0) = formatted text output
match_count (index 1) = match count of the pattern
array_of_positions (index 2) = array of tuples with start and stop points of the matches [(4, 6), (9, 11), ..]
term.setTitle('Hello Terminal') # or clear it term.clearTitle()
term.setTab('Hello Tab') # or clear it term.clearTab()
Move the cursor to a specific position.
term.pos(line, column) term.pos(2, 15)
Get the size of the terminal (lines and columns)
(30, 100) = term.getSize() # (lines, colums) = term.getSize()
Move the cursor to the home position (1, 1).
term.homePos()
Moves the current cursor position up, down, left or right by the specified value.
term.up(value=1) term.down(value=1) term.left(value=1) term.right(value=1)
Saves the current cursor position.
term.saveCursor()
Restore the previously stored cursor position.
term.restoreCursor()
Clear the terminal screen.
term.clear()
Clear the entire line on the current cursor position.
term.clearLine()
Clear line from the current cursor position to the end.
term.clearLineFromPos()
Clear line from begin to current cursor position.
term.clearLineToPos()