public
Description: a dirt-simple terminal-colour library for python
Homepage:
Clone URL: git://github.com/gfxmonk/termstyle.git
name age message
file .gitignore Thu Mar 19 03:46:47 -0700 2009 got setuptools working [gfxmonk]
file Makefile Thu Mar 19 03:46:47 -0700 2009 got setuptools working [gfxmonk]
file README Wed Jun 24 03:26:41 -0700 2009 0.1.3: source dist instead of egg [gfxmonk]
file readme.rst Sun May 24 02:24:36 -0700 2009 Added bg_default style, which enables transpare... [JNRowe]
file setup.py Wed Jun 24 04:26:57 -0700 2009 setuptools issues [gfxmonk]
directory termstyle/ Sun May 24 02:24:36 -0700 2009 Added bg_default style, which enables transpare... [JNRowe]
file test.py Thu Mar 19 03:20:29 -0700 2009 initial cut [gfxmonk]
readme.rst

termstyle

termstyle is a simple python library for adding coloured output to terminal (console) programs. The definitions come from ECMA-048, the "Control Functions for Coded Character Sets" standard.

Installation:

easy_install termstyle

or from source:

./setup.py bdist_egg
cp dist/termstyle-*.egg <path-to-your-python-libraries>

Example Usage:

from termstyle import *
print "%s:%s" % (red('Hey'), green('how are you?'))
print blue('How ', bold('you'), ' doin?')

or, you can use a colour just as a string:

print "%sBlue!%s" % (blue, reset)

Styles:

reset or default (no colour / style)

colour:

black
red
green
yellow
blue
magenta
cyan
white

background colour:

bg_black
bg_red
bg_green
bg_yellow
bg_blue
bg_magenta
bg_cyan
bg_white
bg_default

In terminals supporting transparency bg_default is often used to set the background to transparent [1].

weight:

bold
inverted

style:

italic
underscore

Controls:

auto() - sets colouring on only if sys.stdout is a terminal
disabe() - disable colours
enable() - enable colours
[1]Supporting terminals include rxvt-unicode, and Eterm.