🌈
Colorist for Python
🌈
Lightweight Python package that makes it easy and fast to print terminal messages in colors.
Prerequisites
- Python 3.9 or higher
- macOS
- It may work on Windows or Linux, but hasn't been tested
Installation
PyPI
pip3 install colorist
Homebrew
If you already have installed the Homebrew package manager for Mac and Linux, use this terminal command to tap Colorist for Python:
brew tap jakob-bagterp/colorist
And then install:
brew install colorist
Colors
Getting Started
Full Terminal Output
How to print a full line of colored text in the terminal:
from colorist import green, yellow, red
green("This is GREEN!")
yellow("This is YELLOW!")
red("This is RED!")
How it appears in the terminal:
Custom Terminal Output
How to customize terminal messages and change color inside a paragraph:
from colorist import Color
print(f"I want {Color.RED}red{Color.OFF} color inside this paragraph")
print(f"Both {Color.GREEN}green{Color.OFF} and {Color.YELLOW}yellow{Color.OFF} are nice colors")
How it appears in the terminal:
from colorist import BrightColor
print(f"I want {BrightColor.CYAN}cyan{BrightColor.OFF} color inside this paragraph")
How it appears in the terminal:
Remember to use Color.OFF or BrightColor.OFF every time you want to revert back to the default terminal text style. Otherwise the color may spill over and into other terminal messages.
Other String Formats
It's easier and more readable to use f-strings as in the examples above, but you can also use string format:
from colorist import Color
print("I want {0}red{1} color inside this paragraph".format(Color.RED, Color.OFF))
How it appears in the terminal:
Supported Text Colors
| Color | Full Text Function | Custom | Example |
|---|---|---|---|
 |
green("text") | Color.GREEN |  |
 |
yellow("text") | Color.YELLOW |  |
 |
red("text") | Color.RED |  |
 |
magenta("text") | Color.MAGENTA |  |
 |
blue("text") | Color.BLUE |  |
 |
cyan("text") | Color.CYAN |  |
 |
white("text") | Color.WHITE |  |
 |
black("text") | Color.BLACK |  |
| - | - | Color.OFF | - |
 |
bright_green("text") | BrightColor.GREEN |  |
 |
bright_yellow("text") | BrightColor.YELLOW |  |
 |
bright_red("text") | BrightColor.RED |  |
 |
bright_magenta("text") | BrightColor.MAGENTA |  |
 |
bright_blue("text") | BrightColor.BLUE |  |
 |
bright_cyan("text") | BrightColor.CYAN |  |
 |
bright_white("text") | BrightColor.WHITE |  |
 |
bright_black("text") | BrightColor.BLACK |  |
| - | - | BrightColor.OFF | - |
Effects
Getting Started
In addition to colors, Colorist for Python can also add effects to text messages in the terminal.
Full Terminal Output
How to print a full line of text effect in the terminal:
from colorist import effect_blink
effect_blink("This is BLINKING!")
How it appears in the terminal:
And this can also be combined with an optional color:
from colorist import Color, effect_blink
effect_blink("This is BLINKING!", Color.CYAN)
How it appears in the terminal:
Custom Terminal Output
How to customize terminal messages and change effect inside a paragraph:
from colorist import Effect
print(f"I want {Effect.UNDERLINE}underlined text{Effect.UNDERLINE_OFF} inside this paragraph")
print(f"I want {Effect.BOLD}emphasized text{Effect.BOLD_OFF} inside this paragraph")
How it appears in the terminal:
Effects can also be mixed with colors:
from colorist import Color, Effect
print(f"I want both {Color.RED}colored and {Effect.BLINK}blinking{Effect.BLINK_OFF} text{Color.OFF} inside this paragraph")
Similar to Color.OFF and BrightColor.OFF, remember to turn off an effect with the relevant reset option (e.g Effect.BOLD_OFF, Effect.BOLD_OFF, etc. or even just Effect.OFF) every time you want to revert back to the default terminal text style. Otherwise the effect may spill over and into other terminal messages.
Supported Effects
| Effect | Full Text Function | Custom | Reset | Example |
|---|---|---|---|---|
| Bold | effect_bold("text") | Effect.BOLD | Effect.BOLD_OFF |  |
| Dim | effect_dim("text") | Effect.DIM | Effect.DIM_OFF |  |
| Underline | effect_underline("text") | Effect.UNDERLINE | Effect.UNDERLINE_OFF |  |
| Blink | effect_blink("text") | Effect.BLINK | Effect.BLINK_OFF |  |
| Reverse | effect_reverse("text") | Effect.REVERSE | Effect.REVERSE_OFF |  |
| Hide | effect_hide("text") | Effect.HIDE | Effect.HIDE_OFF |  |
| - | - | - | Effect.OFF | - |
Donate
This module is free to use. And if you like it, feel free to buy me a coffee.
Contribute
If you have suggestions or changes to the module, feel free to add to the code and create a pull request.
Report Bugs
Report bugs and issues here.
![[pre-commit.ci] pre-commit autoupdate](https://avatars.githubusercontent.com/in/68672?v=4)
5.9k Dec 30, 2022
1 Mar 07, 2022
333 Jan 02, 2023
1 Dec 27, 2021
4 Dec 14, 2022
16 Nov 08, 2022
32 Dec 10, 2022
2 Jul 22, 2022
21 Jan 03, 2023
305 Dec 30, 2022
798 Nov 21, 2022
10 Sep 20, 2022
2k Jan 07, 2023
61 Dec 14, 2022
1 May 25, 2022
4 Sep 04, 2021
1 Jan 03, 2022
2 Oct 20, 2021
2 Apr 07, 2022
0 Dec 15, 2021