🌈
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)
1.7k Jan 08, 2023
1 Apr 09, 2022
2 Mar 11, 2022
351 Dec 26, 2022
41 Jul 27, 2022
3.2k Jan 09, 2023
30 Dec 05, 2022
8 Dec 13, 2022
9 Oct 17, 2022
11 Nov 15, 2022
7.4k Jan 07, 2023
8 Jan 09, 2023
12 Mar 25, 2022
2 Dec 08, 2021
14 Dec 17, 2022
11 Feb 11, 2022
13 Oct 14, 2022
781 Jan 01, 2023
10 Dec 29, 2022
834 Dec 27, 2022