cobra-color 0.2.0

A Python library for enhanced terminal display.

cobra-color

About

A lightweight Python library for enhanced terminal display: simple text color/style conventions and image-to-terminal rendering.

• Python: 3.9+
• Runtime deps: Pillow (>=9,<11), NumPy (>=1.21,<2)

Features

• :rocket: Concise color/style names for terminal text.
• :rocket: Image rendering in multiple modes: ASCII, color, half-color, gray, half-gray.
• :rocket: Minimal dependencies and easy integration.

Installation

Stable (once published):

pip install cobra-color

Quick Start

• Render a text in the terminal:

  from cobra_color import ctext
  
  print(ctext("Hello World!", fg="r", styles=["bold"]))
  

• Render an image in the terminal:

  from cobra_color.draw import fmt_image
  
  # ASCII art
  print(fmt_image("example.jpg", width=80, mode="ascii"))
  
  # Half-block color (recommended for truecolor terminals)
  print(fmt_image("example.jpg", width=80, mode="half-color"))
  

• Render some text with fonts in the terminal:

  from cobra_color.draw import fmt_font, FontName
  
  # Borderless grayscale font
  print(fmt_font("Hello World!", font=FontName.LLDISCO,, mode="half-gray", trim_border=True))
  

Image Modes

• ascii: monochrome ASCII using a density charset.
• color: colorized character fill.
• half-color: half-block characters with color (higher density, good visual quality).
• gray: grayscale characters.
• half-gray: half-block grayscale.

Tip: For best results, use a TrueColor-capable terminal and a monospaced font.

Requirements

• Python >= 3.9
• Pillow >= 9.0, < 11
• NumPy >= 1.21, < 2.0

License

See LICENSE in the repository.

Links

• Homepage/Repo: https://github.com/tinchen777/cobra-color.git
• Issues: https://github.com/tinchen777/cobra-color.git/issues