Skip to main content

A simple command-line utility for changing your terminal colors

Project description

tsty

tsty short for "terminal style"

A simple command-line utility for quickly switching your terminal colors and styles

Example usage

# Change background to green
tsty bg green

## by default, the tsty command runs the `bg` subcommand, so this works too:
tsty green

## you can also pass in rgb values, in order of: r g b 
tsty 0 100

# Change text color — both bold and normal — to orange
tsty text orange

# change bold text color to red
tsty text red --bold

# change cursor to lavender
tsty cursor lavender

# list commands and colors
tsty list

Current status

  • Allows user to change macOS Terminal background, text, and cursor colors

TODOS

  • Add ability to switch themes
  • Make it compatible with Windows Powershell/WSL
  • Make it compatible with Linux terminals
  • Make separate color presets for background/cursor and text, as the former generally needs to be darker and the latter more brighter
  • make aliases, e.g. tsty t for tsty text
  • finish writing tests
    • throw error when user has more than 4 values for color argument
    • throw error when user has more than 1 non-numerical value for color argument
  • Replace verbose-by-default with --verbose opt-in flag (i.e. deprecate --quiet)

Installation and development notes

Install this tool using pip:

pip install tsty

Dev and Testing

# install locally
pip install -e .


# run all tests
pytest

# run just alpha tests
pytest -m 'alpha'


# skip alpha tests
pytest -m 'not alpha'

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

tsty-0.0.5.3.tar.gz (6.8 kB view details)

Uploaded Source

Built Distribution

tsty-0.0.5.3-py3-none-any.whl (5.6 kB view details)

Uploaded Python 3

File details

Details for the file tsty-0.0.5.3.tar.gz.

File metadata

  • Download URL: tsty-0.0.5.3.tar.gz
  • Upload date:
  • Size: 6.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.2

File hashes

Hashes for tsty-0.0.5.3.tar.gz
Algorithm Hash digest
SHA256 01f85515746d11184c33bdb7caa25a7b9a8943c9aa77acdb7ab52bef83f7ba1f
MD5 764da404eb453c611a7ab6bb6256960e
BLAKE2b-256 75092f03765b215ae59f6a6640a0d8b31815e88d8927b69d4d62a64c51d9d79e

See more details on using hashes here.

File details

Details for the file tsty-0.0.5.3-py3-none-any.whl.

File metadata

  • Download URL: tsty-0.0.5.3-py3-none-any.whl
  • Upload date:
  • Size: 5.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.10.2

File hashes

Hashes for tsty-0.0.5.3-py3-none-any.whl
Algorithm Hash digest
SHA256 a35f09bd5941443140d6533cc5a4408114ae85712b8a937c01d0a9529d7d0b5b
MD5 c68857e909e1c5643dd8bef57f01e914
BLAKE2b-256 2bf57a14ff14aa8eb0f6f75103761c9d50bc5f46fc29897bb1afd547454a4d94

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