Fork of termcolor library
Project description
modern ANSII Color formatting for output in terminal
What is neotermcolor
neotermcolor library is a fork of old good termcolor, which is widely used. I like it very much, but unfortunately last release was long time ago.
Everything is fully backward compatible with original termcolor:
import sys
from neotermcolor import colored, cprint
text = colored('Hello, World!', 'red', attrs=['reverse', 'blink'])
print(text)
cprint('Hello, World!', 'green', 'on_red')
print_red_on_cyan = lambda x: cprint(x, 'red', 'on_cyan')
print_red_on_cyan('Hello, World!')
print_red_on_cyan('Hello, Universe!')
for i in range(10):
cprint(i, 'magenta', end=' ')
cprint("Attention!", 'red', attrs=['bold'], file=sys.stderr)
Installation
pip3 install neotermcolor
New features
It works in Windows terminal
Yep, right out-of-the-box (tested on Windows 10)
It is readline-safe
When you mix ANSI color codes with readline input, it may cause a problem. neotermcolor has a workaround:
- new param for cprint and colored: readline_safe=True
- you may also turn on readline-safe colorizing by default, setting
import neotermcolor
neotermcolor.readline_always_safe = True
It has 256-color palette
If color code is specified as an integer (0..255), ANSI 256-color palette is used. You may specify color codes both for foreground and background and mix them with other attributes:
from neotermcolor import cprint
cprint('Underline light-green (119) on grey (237)', 119, 237, ['underline'])
It is TTY-aware
neotermcolor will not colorize text if process stdout or stderr is not a TTY.
This feature is on by default, but you may turn it off:
import neotermcolor
neotermcolor.tty_aware = False
It has palette overriding
You may define own color names or override existing ones: e.g. you may use standard palette for 16-color terminals, but override it when your program detect terminal with 256-color support or when it's forced by user:
import neotermcolor
neotermcolor.set_color('red', 197)
neotermcolor.cprint('Red color is now purple', 'red')
It has styles
Styles are alternative to classical defining a "style" for certain type of messages with functools.partial or lambda. A style may contain color, on_color and attributes:
import neotermcolor
neotermcolor.set_style('error', color='red', attrs='bold')
neotermcolor.cprint('ERROR MESSAGE', style='error')
# or
neotermcolor.cprint('ERROR MESSAGE 2', '@error')
Note: if you specify both style and e.g. attrs, the style attrs will be overriden.
Single attribute can now be specified as a string
# as list or tuple
cprint('test', attrs=['bold'])
# as a string
cprint('test', attrs='bold')
How to use it instead of old termcolor in the existing projects
import neotermcolor as termcolor
I'll do my best to keep it backward compatible with original termcolor.
Enjoy!
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
File details
Details for the file neotermcolor-2.0.10.tar.gz
.
File metadata
- Download URL: neotermcolor-2.0.10.tar.gz
- Upload date:
- Size: 5.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.21.0 setuptools/45.2.0 requests-toolbelt/0.9.1 tqdm/4.45.0 CPython/3.8.5
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | ac1026df5578fd38d8a876d80127d40ad36107f47b014e212c842b794f9ec71d |
|
MD5 | 41aae2b74116cf6a4f3f01538ddf42c0 |
|
BLAKE2b-256 | c7e6a82017c6d26439b174880b5c8a7e4d548c5362310099c87229579b41501c |