Metadata-Version: 2.4
Name: color_stream
Version: 0.3.0
Summary: A tool to run another shell command, and color the stdout/stderr streams green/red
Project-URL: homepage, https://github.com/DeflateAwning/color_stream
Project-URL: repository, https://github.com/DeflateAwning/color_stream
Project-URL: issues, https://github.com/DeflateAwning/color_stream/issues
Project-URL: pypi, https://pypi.org/project/color-stream/
Author: DeflateAwning
License-File: LICENSE
Classifier: License :: OSI Approved :: The Unlicense (Unlicense)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Provides-Extra: dev
Requires-Dist: pyright; extra == 'dev'
Requires-Dist: ruff; extra == 'dev'
Description-Content-Type: text/markdown

# color_stream
A quick Python script to run another shell command, and split/color the
stdout/stderr streams green/red

## Story

While working with redirecting and assessing the output from another CLI tool,
I needed a way to see what was going to stderr, and what was going to stdout.

This tool highlights the two streams, in real time.

## Usage

```bash
pip install color_stream

color_stream '<another command here>'
## OR ##
python3 -m color_stream '<another command here>'

# Test it with the demo script in this repo:
color_stream python demo_1.py

# Test it with "ls" (success, and error with file that doesn't exist):
color_stream ls file_that_exists.txt file_that_does_not_exist.txt

# Print out the total bytes count statistics:
color_stream --stat python demo_1.py
```

## Limitations

- [ ] reading from stdin is untested, and likely doesn't work
- [ ] throughput speed is currently not benchmarked
- [ ] switching colors is not currently supported
