colorfulstring 0.0.0

Make colorful strings.

colorfulstring

colorfulstring is a lightweight Python utility for building ANSI-colored terminal strings with a fluent, chainable API.

Installation

pip install colorfulstring

Quick Start

from colorfulstring import c

print(c.r << "Error:" << " something went wrong")
print(c.g("OK"))

Usage

1) Color Shortcuts

Available color properties are d/r/g/y/b/p/c/w, which map to dark, red, green, yellow, blue, purple, cyan, and white.

print(c.y << "Warning")

2) Pipe-Style Chaining

Use << (or @) to append fragments in sequence:

print(c.b << "[INFO]" << " service started")

3) Conditional Output

• iftrue(condition): include the next fragment only when condition is True.
• ifnot(condition): include the next fragment only when condition is False.
• ifelse(condition): choose between the next two fragments.

ok = True
line = c << "status: " << c.ifelse(ok) << c.g("success") << c.r("failed")
print(line)

4) Immediate Printing

c.print outputs each generated fragment immediately (without an automatic newline). It can be combined with c.endl.

line = c.print << "hello" << c.endl

See Also

Github repository

• https://github.com/Chitaoji/colorfulstring/

PyPI project

• https://pypi.org/project/colorfulstring/

License

This project falls under the BSD 3-Clause License.

History

v0.0.0

• Initial release.