Colorful

Warnings

• breaking Python 2 support was officially dropped in `colorful` version 0.5.5. Attempts to use versions 0.5.5 or newer with Python 2 will result in `ImportError` or other compatibility issues.
  Fix: Ensure your project runs on Python 3.5 or newer. Upgrade your Python environment if necessary.
• gotcha Versions prior to 0.5.7 might encounter an `AttributeError: 'DualOutput' object has no attribute 'isatty'` when interacting with specific terminal output streams, particularly in certain environments or configurations.
  Fix: Upgrade to `colorful` version 0.5.7 or later to resolve this `isatty` attribute issue.
• gotcha In versions older than 0.5.5, there were known issues with `setup(colormode=NO_COLORS)` not behaving as expected and the `__str__` representation of `ColorfulString` objects not always correctly returning a plain string.
  Fix: Upgrade to `colorful` version 0.5.5 or later to ensure correct `NO_COLORS` setup and reliable string representation.
• gotcha Older versions (prior to 0.5.4) had an incorrect implementation of the `__getattr__` protocol, which could lead to unexpected behavior when dynamically accessing color and style attributes (e.g., `cf.some_color_name`).
  Fix: Upgrade to `colorful` version 0.5.4 or later to ensure correct dynamic attribute access for colors and styles.
• gotcha Although `colorful` generally manages color resets, explicitly using `cf.reset` or context managers (`with cf.with_...`) is good practice. Without proper resets, especially if a script terminates unexpectedly, terminal color settings might 'bleed' into subsequent shell output, affecting the console's appearance after your program exits.
  Fix: Always use `cf.reset` at the end of a block of colored output, or prefer context managers (e.g., `with cf.with_true_colors() as c:`) which automatically handle scope, to ensure color settings are restored.

Install

• pip install colorful Install latest version

Imports

• colorful

  import colorful as cf

  The official documentation and common practice recommend importing colorful with the alias `cf` for concise usage.

Quickstart

This quickstart demonstrates basic text coloring, combining styles, using f-strings for dynamic content, extending the color palette, and employing context managers for specific color modes. The recommended import is `import colorful as cf`.

import colorful as cf
import os

# Basic text styling
print(cf.red('Hello, red World!'))
print(cf.bold_green('This is bold and green.'))

# Combining styles using bitwise operators
print(cf.italic & cf.coral_on_beige | 'Styled with italic, coral text on beige background.')

# Using f-strings (Python >= 3.6)
user_name = os.environ.get('USER', 'Guest')
print(f'{cf.blue_on_white}Hello, {user_name}! Enjoy Colorful!{cf.reset}')

# Extending the default color palette
cf.update_palette({'companyOrange': '#f4b942', 'companyBlue': '#4287f5'})
print(cf.companyOrange_on_companyBlue('Custom company colors!'))

# Using a context manager for temporary color mode
with cf.with_8_ansi_colors() as c:
    print(c.bold_magenta('This text uses 8 ANSI colors only.'))

# Printing with format-string like syntax
cf.print('{c.cyan}Formatted {c.underline}output{c.reset} with {c.yellow}placeholders{c.reset}',
         name=cf.bold_white('Colorful'))