diff options
author | Dimitris Zlatanidis <d.zlatanidis@gmail.com> | 2014-01-07 13:33:44 +0700 |
---|---|---|
committer | Erik Hanson <erik@slackbuilds.org> | 2014-01-07 11:14:02 -0600 |
commit | 96c2163657c6dac7351392c779520af1dd17bb33 (patch) | |
tree | af7cfe171c53c8b80f384750b3bd9a25f9935496 /python/colorama/README | |
parent | 1668891aa1912726b3cb028d2d868f0dde3bc3d0 (diff) | |
download | slackbuilds-96c2163657c6dac7351392c779520af1dd17bb33.tar.gz slackbuilds-96c2163657c6dac7351392c779520af1dd17bb33.tar.xz |
python/colorama: Added (Cross-platform colored terminal text).
Signed-off-by: Willy Sudiarto Raharjo <willysr@slackbuilds.org>
Diffstat (limited to 'python/colorama/README')
-rw-r--r-- | python/colorama/README | 29 |
1 files changed, 29 insertions, 0 deletions
diff --git a/python/colorama/README b/python/colorama/README new file mode 100644 index 0000000000..3b8b8fc503 --- /dev/null +++ b/python/colorama/README @@ -0,0 +1,29 @@ +Makes ANSI escape character sequences for producing colored terminal +text and cursor positioning work under MS Windows. +ANSI escape character sequences have long been used to produce colored +terminal text and cursor positioning on Unix and Macs. Colorama makes this +work on Windows, too, by wrapping stdout, stripping ANSI sequences it finds +(which otherwise show up as gobbledygook in your output), and converting +them into the appropriate win32 calls to modify the state of the terminal. +On other platforms, Colorama does nothing. + +Colorama also provides some shortcuts to help generate ANSI sequences but +works fine in conjunction with any other ANSI sequence generation library, +such as Termcolor (http://pypi.python.org/pypi/termcolor.) + +This has the upshot of providing a simple cross-platform API for printing +colored terminal text from Python, and has the happy side-effect that +existing applications or libraries which use ANSI sequences to produce +colored output on Linux or Macs can now also work on Windows, simply by +calling colorama.init(). + +An alternative approach is to install 'ansi.sys' on Windows machines, +which provides the same behaviour for all applications running in +terminals. Colorama is intended for situations where that isn't easy +(e.g. maybe your app doesn't have an installer.) + +Demo scripts in the source code repository prints some colored text +using ANSI sequences. Compare their output under Gnome-terminal's +built in ANSI handling, versus on Windows Command-Prompt using +Colorama. +See demos files '$ /usr/doc/colorama-0.2.7/' |