fluxura 0.1.1a2
A soon-to-be easy way to style outputs in terminal
Requires Python: >=3.6

# 🎨 Fluxura - A Styler For Terminal Outputs 🖌️
### ⚠️ FLUXURA IS IN THE ALPHA STAGE OF DEVELOPMENT, EXPECT BUGS ⚠️
### Current Stage: v0.1.1-alpha0
![GitHub License](https://img.shields.io/github/license/Broothers-Inc/fluxura) ![GitHub last commit](https://img.shields.io/github/last-commit/Broothers-Inc/fluxura) ![PyPI - Downloads](https://img.shields.io/pypi/dm/fluxura)


Fluxura is a Python library that provides terminal styling and coloring options for enhancing the appearance of command-line applications. With support for text styles like bold, italic, underline, and strikethrough, as well as foreground and background colors (including custom RGB colors), Fluxura gives the power to customize the look of terminal output with ease.

## 🔦 Features

- **Text Styles**: Apply styles like `BOLD`, `ITALIC`, `DIM`, `UNDERLINE`, and `STRIKETHROUGH` to terminal text.
- **Colors**: Choose from predefined color options for foreground and background text colors.
- **Custom RGB Colors**: Set custom RGB background colors for a more personalized look.
- **Gradient (hoping to develop)**: Apply gradients to text using two colors.
- **Simple API**: Easy-to-use functions for styling and coloring text in the terminal.

## 📦 Installation

You can install Fluxura using `pip` from PyPI.

### From PyPI:

`pip install fluxura`

### 4. **Example Usage**:

````markdown

Once installed, you can start using Fluxura to style terminal text.

```python
from fluxura import Color, Style, flux

# Example 1: Apply bold and red color to text
print(flux("Hello, World!", Style.BOLD, Color.fore.RED))

# Example 2: Apply italic and blue color to text
print(flux("This is a test!",  Style.ITALIC, Color.fore.BLUE))

# Example 3: Use a custom RGB background color
print(flux("Custom background colour!",  Style.ITALIC, Color.Back.CUSTOM(255, 165, 0)))

# Example 4: Combine multiple styles and colors
print(flux("Bold, underlined, and green text",  Style.BOLD, Style.UNDERLINE, Color.Fore.GREEN))
````

For more examples, check test_fluxura.py in the tests folder.

## 🎨 Customization

Fluxura can customize the foreground and background colors using built-in colors or by specifying RGB values. It can also customise the styles of the text in multiple ways.


- Colours
  - Predefined colors:
    - Classic Variants: `BLACK`, `RED`, `GREEN`, `YELLOW`, `BLUE`, `MAGENTA`, `CYAN`, `WHITE`.
    - Light Variants: `LIGHT_BLACK`, `LIGHT_RED`, `LIGHT_GREEN`, `LIGHT_YELLOW`, `LIGHT_BLUE`, `LIGHT_MAGENTA`, `LIGHT_CYAN`,     `LIGHT_WHITE`.
  - To use a custom RGB color, pass the RGB values to the `Color.____.CUSTOM()` method like this:
    ```python
    Color.Fore.CUSTOM(255, 165, 0)  # RGB values for orange foreground
    Color.Back.CUSTOM(255, 165, 0)  # RGB values for orange backgroun
    ```
- Styles!

    - Style Variants: `BOLD`, `BRIGHT`, `DIM`, `ITALIC`, `STRIKETHROUGH`
---
 
### 🔨MANY MORE FEATURES ARE EXPECTED TO COME SOON🔨

<br>

![Banner Broothers Logo (White)](https://github.com/user-attachments/assets/27886cee-b1e4-455b-ba3a-6870c7a27f10#gh-dark-mode-only)
![Banner Broothers Logo (Black)](https://github.com/user-attachments/assets/70704fc6-7ffe-472c-ba3a-6e967b05a512#gh-light-mode-only)