Skip to main content

ANSI color formatting for output in terminal

Project description

Colored Matrix

GitHub

A Python library for changing the colors in the terminal using ANSI escape codes.

Installation

To install Colored Matrix, use pip:

pip install coloredmatrix

Usage

To use Colored Matrix, import the Stylize class and the Color constants, and call the desired methods on a Stylize object:

from coloredmatrix import Stylize, Color

# Set the background color to green
print(Stylize("hello").bg_color(Color.Green))

# Set the background color to red
print(Stylize("hello").bg_color(Color.Red))

# Set the background color to green and the foreground color to red
print(Stylize("hello").bg_color(Color.Green).fg_color(Color.Red))

# Set the text to bold and underlined
print(Stylize("hello").bold().underline())

You can also pass an RGB color tuple to the bg_color and fg_color methods:

from coloredmatrix import Stylize

# Set the background color to red using an RGB color tuple
print(Stylize("hello").bg_color((255, 0, 0)))

# Set the background color to green using an RGB color tuple
print(Stylize("hello").bg_color((0, 255, 0)))

# Set the background color to red and the foreground color to green using RGB color tuples
print(Stylize("hello").bg_color((255, 0, 0)).fg_color((0, 255, 0)))

Text Styling

The Stylize class provides the following methods for styling text:

  • bold: Makes the text bold
  • italic: Makes the text italic
  • underline: Underlines the text
  • blink: Makes the text blink
  • strike: Strikes through the text

You can chain these methods to apply multiple styles to the same text. For example:

from coloredmatrix import Stylize

# Set the text to bold, italic, and underlined
print(Stylize("hello").bold().italic().underline())

# Set the text to blink and struck through
print(Stylize("hello").blink().strike())

Supported Colors

You can also use RGB color tuples to specify any other color.
The Color constants define the following colors:

Color Name Color Name Color Name Color Name Color Name
MediumVioletRed DeepPink PaleVioletRed HotPink LightPink
Pink DarkRed Red Firebrick Crimson
IndianRed LightCoral Salmon DarkSalmon LightSalmon
OrangeRed Tomato DarkOrange Coral Orange
DarkKhaki Gold Khaki PeachPuff Yellow
PaleGoldenrod Moccasin PapayaWhip LightGoldenrodYellow LemonChiffon
LightYellow Maroon Brown SaddleBrown Sienna
Chocolate DarkGoldenrod Peru RosyBrown Goldenrod
SandyBrown Tan Burlywood Wheat NavajoWhite
Bisque BlanchedAlmond Cornsilk Indigo Purple
DarkMagenta DarkViolet DarkSlateBlue BlueViolet DarkOrchid
Fuchsia Magenta SlateBlue MediumSlateBlue MediumOrchid
MediumPurple Orchid Violet Plum Thistle
Lavender MidnightBlue Navy DarkBlue MediumBlue
Blue RoyalBlue SteelBlue DodgerBlue DeepSkyBlue
CornflowerBlue SkyBlue LightSkyBlue LightSteelBlue LightBlue
PowderBlue Teal DarkCyan LightSeaGreen CadetBlue
DarkTurquoise MediumTurquoise Turquoise Aqua Cyan
Aquamarine PaleTurquoise LightCyan DarkGreen Green
DarkOliveGreen ForestGreen SeaGreen Olive OliveDrab
MediumSeaGreen LimeGreen Lime SpringGreen MediumSpringGreen
DarkSeaGreen MediumAquamarine YellowGreen LawnGreen Chartreuse
LightGreen GreenYellow PaleGreen MistyRose AntiqueWhite
Linen Beige WhiteSmoke LavenderBlush OldLace
AliceBlue Seashell GhostWhite Honeydew FloralWhite
Azure MintCream Snow Ivory White
Black DarkSlateGray DimGray SlateGray Gray
LightSlateGray DarkGray Silver LightGray Gainsboro

License

License Colored Matrix is released under the MIT License. See the LICENSE file for more information.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

coloredmatrix-0.0.2.tar.gz (5.8 kB view details)

Uploaded Source

Built Distribution

coloredmatrix-0.0.2-py3-none-any.whl (5.7 kB view details)

Uploaded Python 3

File details

Details for the file coloredmatrix-0.0.2.tar.gz.

File metadata

  • Download URL: coloredmatrix-0.0.2.tar.gz
  • Upload date:
  • Size: 5.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.11.0

File hashes

Hashes for coloredmatrix-0.0.2.tar.gz
Algorithm Hash digest
SHA256 f2a6007698fe0e0bb0b72fcf09ffc4c92948f3c7a5eca70a83b96231b4ef04d5
MD5 61d9a21f1bdff9a2044190b5c3f48e87
BLAKE2b-256 1fdd598b27924defe26f32afe5e796e9980753873102e53af39b6fcb00d6b319

See more details on using hashes here.

File details

Details for the file coloredmatrix-0.0.2-py3-none-any.whl.

File metadata

File hashes

Hashes for coloredmatrix-0.0.2-py3-none-any.whl
Algorithm Hash digest
SHA256 2f4f4a422c0143895888f68d124223f684a2ef3e81e030f1ddb29183a108d42d
MD5 7bd00daab9ce10f91a576b70f6095551
BLAKE2b-256 46a7ccec18dfc44146d4b3f95013e0cc27237384ee3838d44b303618d1496cab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page