Skip to main content

change color and style (bold, reverse) of text on display

Project description

ansiterm Package

ansiterm - change color and style (bold, reverse) of text on display

DESCRIPTION

This manual page documents ansiterm module, a Python module providing functions for generating ANSI escape sequences to change the color and the style (i.e., bold and reverse) of text displayed on the screen.

A majority of terminal emulators support ANSI escape sequences. ansiterm module provides handy functions for changing the color and the style.

Please refer to https://en.wikipedia.org/wiki/ANSI_escape_code for the introduction of ANSI escape sequences.

EXAMPLE

from ansiterm import color

for bold in (False, True):
    for reverse in (False, True):
        for name in [
                'reset', 'bold', 'underline', 'reverse', 'gray', 'red',
                'green', 'yellow', 'blue', 'magenta', 'cyan', 'white'
        ]:
            astr = color('text in {} with bold={}, reverse={}'.format(
                name, bold, reverse),
                         name,
                         bold=bold,
                         reverse=reverse)
            print(astr)

FUNCTIONS

ansiterm module provides the following functions.

  • color(astr, name='bold', bold=False, reverse=False)

    Embed ANSI escape sequences around string ASTR to change the text style to NAME. Make the text boldface and reversed video if BOLD or REVERSE is True, respectively.

The following functions are provided as short-cuts. For instance, blue(astr) and reest(astr) are equivalent to color(astr, 'blue') and color(astr, 'reset), respectively.

  • reset(astr, bold=False, reverse=False)

  • bold(astr, bold=True, reverse=False)

  • gray(astr, bold=False, reverse=False)

  • red(astr, bold=False, reverse=False)

  • green(astr, bold=False, reverse=False)

  • yellow(astr, bold=False, reverse=False)

  • blue(astr, bold=False, reverse=False)

  • magenta(astr, bold=False, reverse=False)

  • cyan(astr, bold=False, reverse=False)

  • white(astr, bold=False, reverse=False)

INSTALLATION

pip3 install ansiterm

AVAILABILITY

The latest version of ansiterm module is available at PyPI (https://pypi.org/project/ansiterm/) .

SEE ALSO

perl(1), perlfunc(1), getopt(3), Getopt::Std(3perl)

AUTHOR

Hiroyuki Ohsaki <ohsaki[atmark]lsnl.jp>

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ansiterm, version 1.1
Filename, size File type Python version Upload date Hashes
Filename, size ansiterm-1.1-py3-none-any.whl (15.7 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ansiterm-1.1.tar.gz (3.0 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page