🌈 Colorist for Python 🌈

Lightweight Python package that makes it easy and fast to print colored text in the terminal.

Ready to try? See how to install.

Getting Started

Print Line of Colored Text

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:

Print Mixed Text Colors

How to customize colors inside a paragraph and print it in the terminal:

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:

Other Styling Options

Print Bright Colors

Most terminals support bright colors that stand more out:

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.

Print Background Colors

from colorist import bg_green, bg_yellow, bg_red

bg_green("This is GREEN background!")
bg_yellow("This is YELLOW background!")
bg_red("This is RED background!")

How it appears in the terminal:

Background colors can also be mixed inside a paragraph:

from colorist import BgColor

print(f"I want {BgColor.RED}red{BgColor.OFF} background color inside this paragraph")

print(f"Both {BgColor.GREEN}green{BgColor.OFF} and {BgColor.YELLOW}yellow{BgColor.OFF} are nice background colors")

How it appears in the terminal:

from colorist import BgBrightColor

print(f"I want {BgBrightColor.CYAN}cyan{BgBrightColor.OFF} background color inside this paragraph")

How it appears in the terminal:

As with text colors, remember to use BgColor.OFF or BgBrightColor.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.

Foreground Text

Color	Full Text Function	Color Code	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.DEFAULT	-
-	-	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.DEFAULT	-
-	-	BrightColor.OFF	-

Background

Color	Full Text Function	Color Code	Example
	bg_green("text")	BgColor.GREEN
	bg_yellow("text")	BgColor.YELLOW
	bg_red("text")	BgColor.RED
	bg_magenta("text")	BgColor.MAGENTA
	bg_blue("text")	BgColor.BLUE
	bg_cyan("text")	BgColor.CYAN
	bg_white("text")	BgColor.WHITE
	bg_black("text")	BgColor.BLACK
-	-	BgColor.DEFAULT	-
-	-	BgColor.OFF	-
	bg_bright_green("text")	BgBrightColor.GREEN
	bg_bright_yellow("text")	BgBrightColor.YELLOW
	bg_bright_red("text")	BgBrightColor.RED
	bg_bright_magenta("text")	BgBrightColor.MAGENTA
	bg_bright_blue("text")	BgBrightColor.BLUE
	bg_bright_cyan("text")	BgBrightColor.CYAN
	bg_bright_white("text")	BgBrightColor.WHITE
	bg_bright_black("text")	BgBrightColor.BLACK
-	-	BgBrightColor.DEFAULT	-
-	-	BgBrightColor.OFF	-

Become a Sponsor 🏅

If you find this project helpful, please consider supporting its development. Your donations will help keep it alive and growing. Every contribution makes a difference, whether you buy a coffee or support with a monthly donation. Find your tier here:

Donate on GitHub Sponsors

Thank you for your support! 🙌

Contribute

If you have suggestions or changes to the module, feel free to add to the code and create a pull request.

Report Bugs

If you encounter any issues, you can report them as bugs or raise issues.