Skip to main content

Simple and lightweight shell color output function.

Project description

Simple and lightweight shell color output function.

It also checks if terminal supports color before vomitting ANSI codes.

Usage

from kolors import c

print c('Some <red>Red</end> and <blue>blue</end> text')
print c('<green bg>Some green background</end>')
print c('Some <cyan bold bg>{}</end>').format('interpolation')

Colors

  • grey (alias: gray)

  • red

  • green

  • yellow

  • blue

  • magenta (alias: purple)

  • cyan

  • white

Styles

  • bold

  • bg

Roadmap

Not sure where this project will go, but suggestions and pull requests are welcome.

The features bellow were suggested, I’m seriously considering them for the next iterations.

Use curses

import curses

curses.setupterm()

if curses.tigetstr('setf') is not None:
    # Red foreground, if supported.
    print (curses.tparm(curses.tigetstr('setf'), curses.COLOR_RED).decode('utf-8'))

>From man 5 terminfo:

To change the current foreground or background color on a Tek‐ tronix-type terminal, use setaf (set ANSI foreground) and setab (set ANSI background) or setf (set foreground) and setb (set back‐ ground). These take one parameter, the color number. The SVr4 documentation describes only setaf/setab; the XPG4 draft says that “If the terminal supports ANSI escape sequences to set background and foreground, they should be coded as setaf and setab, respec‐ tively.

Note: thanks u/awegge!

Cleaner, nestable syntax

<fg red>Red text<b>Red bold text <bg blue>Red bold tect on Blue background</bg>red bold again</b>Just red again </fg>

Wrapping around other libraries

Like colorama & click.style

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

kolors-0.0.4.tar.gz (3.6 kB view hashes)

Uploaded Source

Built Distribution

kolors-0.0.4-py2.py3-none-any.whl (5.0 kB view hashes)

Uploaded Python 2 Python 3

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