rich-style

rich-style

A Python library for creating and applying full-color, linear, and circular gradients to text with easy color management. Includes utilities for ANSI styling, colored prints, and more.

Features

• Text Styling: Bold, italic, underline, strikethrough, bullet lists, and more.
• Color Management: Use named presets, custom RGB, gradients, and HSL/HTML color parsing.
• Gradients: Linear and circular gradients for text.
• ANSI Support: Automatically detects terminal support for ANSI escape codes.
• Utility Prints: Info, warning, error, success, timed, and mutable prints with color.
• Composable: Combine styles and colors easily.

Installation

pip install richstyle

Usage

Basic Styling

from richstyle import bold, italic, underline, strikethrough

print(bold("Bold text"))
print(italic("Italic text"))
print(underline("Underlined text"))
print(strikethrough("Strikethrough text"))

Bullet Lists

from richstyle import bullet_list, bold

tasks = [
    "Complete report",
    "Send email to client",
    "Buy groceries"
]

print(bold("Task List:"))
print(bullet_list(*tasks))

Colors and Gradients

from richstyle import presets, foreground, background

print(foreground(presets.red, "Red text"))
print(background(presets.blue, "Text with blue background"))

Colors and Gradients

from richstyle import presets, foreground, background

print(foreground(presets.red, "Red text"))
print(background(presets.blue, "Text with blue background"))

Rainbow Text

from richstyle import rainbow_text
print(rainbow_text("This is a rainbow text message."))

Utility Prints

from richstyle import info, success, warn, error, timed_print

info("This is an informational message.")
success("This is a success message.")
warn("This is a warning message.")
error("This is an error message.")
timed_print("This is a timed print message.")

Mutable Print

from richstyle import mutable_print
from time import sleep

mutable = mutable_print("Loading")
sleep(1)
mutable("Still loading...")
sleep(1)
mutable("Done!\n")

[!WARNING]
You can only use a mutable print when it's the last print.

Examples

See the examples/ directory for more usage examples.

Credits

• Author: PcoiDev
• Inspiration: colorama, rich and stylepy.

License

This project is licensed under the MIT License.