Colorize your output using RegEx
Project description
ChromaTerm
ChromaTerm (ct
) reads from standard input and colors it according to user-configurable rules.
Think of ChromaTerm like grep
; just pipe data into it. However, unlike most programs which line-buffer, ct
works with interactive applications, like ssh
.
Here's an example using the rules in the default configuration file:
Installation
pip3 install chromaterm
Usage
By default, ChromaTerm reads .chromaterm.yml
in your home directory. As an example, run the following:
echo "Jul 14 12:28:19 Message from 1.2.3.4: Completed successfully" | ct
The default config file is copied to your home directory if it's not there.
Tip: set up functions, like ssh() { /usr/bin/ssh "$@" | ct; }
, in your .bash_profile
to always color the output of a program (ssh
in this example).
Highlight Rules
All of the highlight rules are placed under the rules
list in the configuration file. Here's an example config file:
rules:
- description: My first rule colors the foreground
regex: hello.+world
color: f#ff0000
- description: Color the foreground and background for "there" and make it bold. Paint "buddy" red.
regex: Hey (there), (buddy)
color:
1: b#abcabc f#123123 bold
2: b#ff0000
Description
Optional. It's purely for your sake.
RegEx
The RegEx engine used is Python's re.
Color
Background and Foreground
The color is a hex string prefixed by b
for background (e.g. b#123456
) and f
for foreground (e.g. f#abcdef
).
Style
In addition to the foreground and background, the following styles are supported, though some terminals ignore them:
- Blink
- Bold
- Italic
- Strike
- Underline
Group-Specific
A color can be applied per RegEx group (see the 2nd example rule). Any group can be referenced as long as it's in the RegEx.
Help
If you've got any questions or suggestions, please open up an issue (always appreciated).
There is no planned support for Windows due to the lack of standards.
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
Built Distribution
Hashes for chromaterm-0.5.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d18c179a55988a9213b95ecbbca9792a86bccf2d62949dae6b23e54bded46b15 |
|
MD5 | 1ab64b0e3a83e5d9838d7d1946b8dc2d |
|
BLAKE2b-256 | 6addbce43e76f578f3b4dda8d696985d9aa321d6c2838bbb7bcac091a148e270 |