ColorFlow 1.0.1

A Python library for creating and applying full-color, linear, and circular gradients to text with easy color management.

ColorFlow

ColorFlow is a Python library for creating stunning color gradients and applying them to text with ease. It supports both linear and circular gradients and offers comprehensive utilities for managing colors.

---

Features

• Comprehensive color presets
• Create colors using RGB, HSL, or HTML hex codes
• Generate linear and circular gradients
• Apply gradients to multi-line text
• Support for color interpolation
• Works seamlessly with ANSI-supported terminals

---

Installation

ColorFlow can be installed using pip:

pip install colorflow

Quick Start

Creating Colors

With ColorFlow, colors can be defined in multiple formats:

from colorflow import FromRGB, FromHTML, FromHSL

# From RGB values
blue = FromRGB(0, 0, 255)

# From HTML Hex codes
red = FromHTML("#FF0000")
short_red = FromHTML("#F00")  # Short form is supported

# From HSL (Hue, Saturation, Lightness)
green = FromHSL(120, 1.0, 0.5)

Using Presets

ColorFlow includes a rich set of predefined colors through the Presets class:

from colorflow import Presets

blue = Presets.Blue
red = Presets.Red
white = Presets.White

---

Applying Colors to Text

from colorflow import Presets
color = Presets.Red # Red

# Apply the color to text
colored_text = color("Hello, World!")
print(colored_text)  # Displays "Hello, World!" in red

---

Gradients

Linear Gradients

Linear gradients allow you to transition between multiple colors across the text.

from colorflow import ColorSequence, Presets

# Create a gradient from blue to red
gradient = ColorSequence({
    0: Presets.Blue,  # Blue
    1: Presets.Red    # Red
})

# Apply the gradient to text
gradient_text = gradient("""
This text will gradually
change from blue
to red
""")

print(gradient_text)

Directional Control

The gradient's direction can be customized using start and end points.

# Top to bottom gradient
gradient = ColorSequence({
    0: Presets.Blue,  # Blue
    1: Presets.Red    # Red
}, start=(0, 0), end=(0, 1))

# Left to right gradient
gradient = ColorSequence({
    0: Presets.Blue,  # Blue
    1: Presets.Red    # Red
}, start=(0, 0), end=(1, 0))

# Diagonal gradient
gradient = ColorSequence({
    0: Presets.Blue,  # Blue
    1: Presets.Red    # Red
}, start=(0, 0), end=(1, 1))

Circular Gradients

Circular gradients radiate color patterns outward from a center point.

# Create a circular gradient
circular_gradient = ColorSequence({
    0: Presets.Blue,
    0.5: Presets.White,
    1: Presets.Red
}, start=(0.5, 0.5), end=(0.5, 0.5), gradient_type="CIRCULAR")

# Apply the gradient to text
circular_text = circular_gradient("""
This text will have
a circular gradient
emanating from the center
""")

print(circular_text)

Example with Input

from colorflow import Presets, ColorSequence

sequence = ColorSequence({
    0: Presets.Blue,    # Blue
    0.5: Presets.White, # White
    1: Presets.Red      # Red
}, start=(0.5, 0), end=(0.5, 1), gradient_type="CIRCULAR")

input(sequence("""
██████╗  ██████╗ ██████╗ ██╗ █████╗ ██╗  ██╗
██╔══██╗██╔════╝██╔═══██╗██║██╔══██╗██║  ██║
██████╔╝██║     ██║   ██║██║╚██████║███████║
██╔═══╝ ██║     ██║   ██║██║ ╚═══██║╚════██║
██║     ╚██████╗╚██████╔╝██║ █████╔╝     ██║
╚═╝      ╚═════╝ ╚═════╝ ╚═╝ ╚════╝      ╚═╝
"""))

Coordinate System

For both linear and circular gradients:

• start and end are normalized between (0, 0) and (1, 1):
  • (0, 0) is the top-left corner
  • (1, 1) is the bottom-right corner
  • (0.5, 0.5) is the center

License

This project is licensed under the MIT License. See the LICENSE file for details.# #\x00 \x00C\x00o\x00l\x00o\x00r\x00F\x00l\x00o\x00w\x00 \x00 \x00