Metadata-Version: 2.1
Name: colored
Version: 2.2.0
Summary: Simple python library for color and formatting to terminal
Keywords: xterm,color,vt100,ansi,terminal,python
Author-email: Dimitris Zlatanidis <dslackw@gmail.com>
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Other
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: Microsoft :: Windows :: Windows 10
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Terminals
Project-URL: homepage, https://dslackw.gitlab.io/colored/

<a href="https://dslackw.gitlab.io/colored"> 
<img src="https://gitlab.com/dslackw/colored/-/raw/site/docs/images/colored.png" title="colored"></a>

## About

Colored, it's a simple Python library for color and formatting in terminal.
Collection of color codes and names for 256 color terminal setups.

A list of [256 colors](https://dslackw.gitlab.io/colored/formatting/colors/#full-chart-256-foreground-and-background-colors)
for <a href="https://en.wikipedia.org/wiki/Xterm" target="_blank">Xterm</a>, containing an example of the displayed color, Xterm Name, Xterm Number and HEX.

The colors work with most terminals and terminals emulators.
<a href="https://en.wikipedia.org/wiki/ANSI_escape_code" target="_blank">ANSI/VT100 escape sequences</a> can be used in every programming languages.

Colored is powerful and easy to use:

```python title="Python 3.9.17"
>>> from colored import Fore, Back, Style
>>>
>>> Fore.red
'\x1b[38;5;1m'
>>>
>>> Back.red
'\x1b[48;5;1m'
>>>
>>> Style.reset
'\x1b[0m'
>>> 
>>> print(f'{Fore.white}{Back.green}Colored is Awesome!!!{Style.reset}')
```
<p> >>> <span style="background-color: green">
  <span style="color: white">Colored is Awesome!!!</span></span>
</p>

## Installing

Open up a terminal and install colored with <a href="https://pip.pypa.io/en/stable/" target="_blank">pip</a> command:

```bash
$ pip install colored
```

Alternatively, you can grab the latest source code from <a href="https://gitlab.com/dslackw/colored" target="_blank">GitLab</a>:
```bash
$ git clone https://gitlab.com/dslackw/colored.git
$ cd colored
$ pip install .
```

## Usage

The [User Guide](https://dslackw.gitlab.io/colored/user_guide/user_guide/#user-guide) is the place to go to learn how to use the library. 

The [API Reference](https://dslackw.gitlab.io/colored/api/attributes/) documentation provides API-level documentation.

## License

colored is made available under the MIT License. For more details, see [here](https://dslackw.gitlab.io/colored/license/#mit-license).

## Contributing


We happily welcome [contributions](https://dslackw.gitlab.io/colored/contributors/)!

## Donate

Did you know that we developers love coffee? 

Donate me a coffee ☕ ⬇

[<img src="https://gitlab.com/dslackw/colored/-/raw/site/docs/images/paypaldonate.png" alt="paypal" title="donate">](https://www.paypal.me/dslackw)
