Skip to main content

Very simple Python library for color and formatting in terminal.

Project description

https://badge.fury.io/py/colored.png https://pypip.in/d/colored/badge.png https://pypip.in/license/colored/badge.png

colored

Very simple Python library for color and formatting in terminal.

Video Demo

https://raw.githubusercontent.com/dslackw/images/master/colored/video.png

The following colors works with most terminals and terminals emulators. ANSI/VT100 escape sequences can be used in every programming languages.

Set:

+-----+-------------+
|Code | Description |
+-----+-------------+
|  1  | bold        |
|  2  | dim         |
|  4  | underlined  |
|  5  | blink       |
|  7  | reverse     |
|  8  | hidden      |
+-------------------+

Reset:

+-----+-------------+
|Code | Description |
+-----+-------------+
|  0  | all         |
| 21  | bold        |
| 22  | dim         |
| 24  | underlined  |
| 25  | blink       |
| 27  | reverse     |
| 28  | hidden      |
+-----+-------------+

Foreground (text):

+-----+---------------+
|Code | Description   |
+-----+---------------+
| 39  | default       |
| 30  | black         |
| 31  | red           |
| 32  | green         |
| 33  | yellow        |
| 34  | blue          |
| 35  | magenta       |
| 36  | cyan          |
| 37  | light_gray    |
| 90  | dark_gray     |
| 91  | light_red     |
| 92  | light_green   |
| 93  | light_yellow  |
| 94  | light_blue    |
| 95  | light_magenta |
| 96  | light_cyan    |
| 97  | white         |
+-----+---------------+

Background:

+-----+---------------+
|Code | Description   |
+-----+---------------+
| 49  | default       |
| 40  | black         |
| 41  | red           |
| 42  | green         |
| 43  | yellow        |
| 44  | blue          |
| 45  | magenta       |
| 46  | cyan          |
| 47  | light_gray    |
| 100 | dark_gray     |
| 101 | light_red     |
| 102 | light_green   |
| 103 | light_yellow  |
| 104 | light_blue    |
| 105 | light_magenta |
| 106 | light_cyan    |
| 107 | white         |
+-----+---------------+

256 Colors Foreground (text):

256 fg colors

256 Colors Background:

256 bg colors

Installation

$ pip install colored

uninstall

$ pip uninstall colored

Dependencies

None, only Python progmamming language.

Usage Examples

How to use the module in your own python code:

Functions

colored.fg() Change foreground color,
colored.fg256() Change foreground color using 256 colors,
colored.bg() Change background color,
colored.bg256() Change background color using 256 colors,
colored.set() Set attribute combinations,
colored.reset() Reset attributes

Initialisation

>>> import colored
>>>
>>> red = colored.fg(31)
>>> default = colored.fg(39)
>>> print ('%s Hello World !!! %s') % (red, default)
 Hello World !!!

Use description:

>>> green = colored.fg('green')
>>> default = colored.fg('default')
>>> print ('%s Hello World !!! %s') % (green, default)
 Hello World !!!

Using format method:

>>> bold = colored.set('bold')
>>> print ('{0}{1} Hello World !!! {2}'.format(green, bold, default))
 Hello World !!!

Print 256 colors:

>>> color = colored.fg256(165)
>>> color
'\x1b[38;5;165m'
>>> print color + 'Hello World !!!' + colored.reset(0)
Hello World !!!
>>> bg_color = colored.bg256(115)
>>> print color + bg_color + 'Hello World !!!' + colored.reset(0)
Hello World !!!

Screenshot:

example

Project details


Download files

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

Source Distribution

colored-1.0.4.tar.gz (15.4 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page