Metadata-Version: 2.1
Name: colour-splash
Version: 0.4.0
Summary: A simple tool enabling easy colouring of terminal outputs
Author: Lachlan Rehder
Author-email: lachlan2357@outlook.com
License: GPLv3
Project-URL: Homepage, https://github.com/lachlan2357/python-colour-splash
Project-URL: Changelog, https://github.com/lachlan2357/python-colour-splash/blob/main/CHANGELOG.md
Project-URL: Bug Tracker, https://github.com/lachlan2357/python-colour-splash/issues
Project-URL: Source, https://github.com/lachlan2357/python-colour-splash
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE

# Colour Splash
A simple tool enabling easy colouring of terminal outputs

# Download
## Using PIP to use a imported Module
`pip install colour_splash`
## Manually to embed into a project
`git clone https://github.com/lachlan2357/python-colour-splash` into your project directory

# Usage
Include `import colour_splash` at the top of your file
## Examples
### Red text colour with white background
`colour_splash.colour("this is red text with a white background", "red", "white")` or `colour_splash.colour("this is red text with a white background", colour_splash.colours.red, colour_splash.colours.white)`
### Only white background
`colour_splash.colour("this is text with a white background", background = "white")` or `colour_splash.colour("this is text with a white background", background = colour_splash.colours.white)`
### Dim text
`colour_splash.colour("this is dim text", "dim")` or `colour_splash.colour("this is dim text", colour_splash.styles.dim)`

## Functions
### `colour_splash.colour()`
Changes the foreground, background or both-grounds of text
#### Parameters:
- `text` the text you wish to be coloured
- `foreground` (optional): the string/colours value of the name of the colour you wish to use as the foreground (text) colour
- `background` (optional): the string/colours value of the name of the colour you wish to use as the background (highlighted) colour

### `colour_splash.style()`
Changes the style of text
#### Parameters:
- `text`: the text you wish to be styled
- `style` (optional): the string/styles value of the name of the style you wish to use

### `colour_splash.colour_start()`
Starts a specific colour for all proceeding text
#### Parameters:
- `foreground` (optional): the string/colours value of the name of the colour you wish to use as the foreground (text) colour
- `background` (optional): the string/colours value of the name of the colour you wish to use as the background (highlighted) colour

### `colour_splash.style_start()`
Starts a specific style for all proceeding text
#### Parameters:
- `style` (optional): the string/styles value of the name of the style you wish to use

### `colour_splash.colour_end()`
Returns the proceeding text to its previous colour/style

### `colour_splash.style_end()`
Returns the proceeding text to its previous colour/style

### `colour_splash.help()`
Lists colours and styles and how they appear on your system
