Metadata-Version: 2.4
Name: print-color
Version: 0.4.6
Summary: A simple package to print in color to the terminal
License: MIT
License-File: LICENSE
Author: xy3
Author-email: a@xsq.pw
Requires-Python: >=3.7,<4.0
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Project-URL: Homepage, https://github.com/xy3/print-color
Project-URL: Repository, https://github.com/xy3/print-color
Description-Content-Type: text/markdown

# print-color

[![test](https://github.com/xy3/print-color/actions/workflows/ci.yml/badge.svg)](https://github.com/xy3/print-color/actions/workflows/ci.yml)

Print Color is a minimalist approach to terminal color printing in Python. It is a wrapper around the `print()` function, and simply allows you to provide extra optional parameters such as:

- `tag`
- `tag_color` or `tag_colour`
- `color` or `colour`
- `background`
- `format`

It aims to be a customizable logger for your applications, and makes formatting warnings, info messages and errors a breeze.

---

## Information

This project has no dependencies, apart from `pytest` for testing.

Check out this project on [PyPi here](https://pypi.org/project/print-color/).

Colors:

```text
purple
blue
green
yellow
red
magenta
cyan
white
black
```

### Parameter values:

- `tag`
  - any string
- `tag_color` or `tag_colour`
  - color
- `color` or `colour`
  - color
- `background`
  - color
- `format`
  - bold
  - underline
  - blink

### Installing

```shell
pip3 install print-color
```

### Requirements

- python 3.7^

### Usage

```python
from print_color import print

print("Hello world", tag='success', tag_color='green', color='white')
```

![Success tag](https://i.imgur.com/qmeYTkR.png)

```python
print("Error detected", tag='failure', tag_color='red', color='magenta')
```

![Error tag](https://i.imgur.com/dksa03u.png)

```python
print("Printing in color", color='green', format='underline', background='grey')
```

![Printing in color is easy](https://i.imgur.com/3sUTi8z.png)

## Contributing

Feel free to add or improve this project :) Just create a pull request and explain the changes you propose.
Note that as this is a very simple project, feature requests should be kept minimal - things like more colors, formats etc would be ideal.

## Credits

Built with [Python Poetry](https://python-poetry.org/).

### Contributors

<a href="https://github.com/xy3/print-color/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=xy3/print-color" />
</a>

