Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/s0md3v/huepy
Print awesomely in terminals.
https://github.com/s0md3v/huepy
colorama print-color terminal-colors
Last synced: 4 days ago
JSON representation
Print awesomely in terminals.
- Host: GitHub
- URL: https://github.com/s0md3v/huepy
- Owner: s0md3v
- License: gpl-3.0
- Created: 2018-03-05T19:40:46.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-09T12:55:43.000Z (12 days ago)
- Last Synced: 2024-12-17T12:52:59.921Z (4 days ago)
- Topics: colorama, print-color, terminal-colors
- Language: Python
- Homepage:
- Size: 54.7 KB
- Stars: 1,472
- Watchers: 15
- Forks: 80
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-starred-test - s0md3v/huepy - Print awesomely in terminals. (Python)
README
# Hue
Hue provides a minimal and powerful interface to print colored text and labels
in the terminal.\ It works with Python 2 as well as Python 3.
What makes hue better than other coloring libraries? [Here's a
comparison.](#why-hue)
## Supported Stuff
Following styles are supported
Following colors are supported
Following labels are supported
### Installation
You can install `hue` with **pip** as follows:
```
pip install huepy
```
or with **easy_install**:
```
easy_install huepy
```
### Usage
First of all, import everything that Hue has to offer as follows:
```python
from huepy import *
```
Printing colored text is as simple as doing
```python
print(red('This string is red'))
```
Easy right?
But what if you want to print italic text?
You can simply do this
```python
print(italic('This string is in italic'))
```
You can also combine styles and colors
```python
print(bold(red('This string is bold and red')))
```
Output:
And what is the use of those labels?\
I have been using these labels in projects as a minimal output schema.\
If some error occured in your program or something else bad happened you don't need to print the whole line in red. With hue, you can simply do this
```python
print(bad('An error occured.'))
```
Take a look at the output of all the labels
#### List of all colors
```python
white, grey, black, green, lightgreen, cyan, lightcyan, red, lightred,
blue, lightblue, purple, light purple, orange, yellow
```
#### List of all styles
```python
bold, bg, under, strike, italic
```
#### List of all labels
```python
info, que, run, bad, good
```
**Note:** Windows versions below windows 10 do not support ANSI escape sequences so the colors will not be printed in command prompt.
### Why hue
Because its awesome!
Lets print a red colored string in popular coloring libraries:
- Colorama
```python
from colorama import Fore
print(Fore.RED + 'This string is red')
```
- Termcolor
```python
import sys
from termcolor import colored, cprint
print(colored('This string is red', 'red'))
```
- Hue
```python
from hue import *
print(red('This string is red'))
```
Here's comparison table:
| |Hue |Colorama |Termcolor|
|-------------|-----------------|--------------|---------|
|Compatibility|Unix & Windows 10|Unix & Windows|Unix |
|Ease of use |10/10 |4/10 |5/10 |
|Bright Colors|Yes |No |No |
**Note:** Colorama and Termcolor print bold styled strings when asked for
bright colored strings. On the other hand, Hue supports both bright and bold
strings. Also the *Ease to use* ratings are a result of my own experience and
may differ for others.
### Contribution
The only thing I think **Hue** needs is better windows compatibility. So if
you can start a pull request for windows support that would be great.
Additional colors and labels will be appreciated too.