TINGE ✨

Output colored terminal text from Python

Independence Day Special

Setup and Installation ⚙️

Using pip

pip install tinge

Or upgrade current version:

pip install --upgrade tinge

For developers / Contributors

1. Clone this repository

git clone https://github.com/g-paras/tinge.git
cd tinge

2. Install the module

python setup.py install

Installation Complete 🎉

Example

Foreground

from tinge import colored

print(colored("This is red text", color="red"))

Or

from tinge import cprint

cprint("Hello there", color="green")

Foreground and Background

from tinge import colored

print(colored("Green on white", color="green", on_color="white"))

Or

from tinge import cprint

cprint("Red on black", color="red", on_color="black")

Styling

underline & italic are not supported on windows

from tinge import italic, underline, bold

print(italic("This is italic"))
print(underline("This is underlined"))
print(bold("This is bold"))

Styling with Foreground and Background

from tinge import colored, italic, underline, bold

print(
    underline("This is red on white",
    color="red",
    on_color="white")
)

print(
    italic("This is italic",
    color="green")
)

Specific Use Cases

These method prints by default & return None

from tinge import warn, error, info, success

warn("This is warning") # yellow bold text
info("This is to inform") # blue bold text
success("Success", strong=False) # green normal text
error("Error: File Missing") # red bold text

Horizontal Line (width equal to terminal width)

from tinge import line

line()  # a horizontal line
line(text="Hello")  # horizontal line with text in middle
line(text="Hello", color="red") # red color line with text in middle
help(line)  # for more info

Available Colors and Styles

Foreground(color)	Background(on_color)
Black	Grey
Red	Red
Green	Green
Yellow	Yellow
Blue	Blue
Magenta	Magenta
Cyan	Cyan
White	White

Style	Bold	Italic	Underline

Function	Parameters	Use for
colored	text, color, on_color	Colored text
italic	text, color, on_color	Italic colored text
underline	text, color, on_color	Underlined colored text
bold	text, color, on_color	Bold colored text
warn	text	Yellow Bold Warning text
error	text	Red Bold Error text
info	text	Blue Bold Information text
success	text	Green Bold Success text

__version__ = 0.0.5, What's new?

• colorama is no longer a requirement
• line method for horizontal lines
• cprint method to directly print colored text