Metadata-Version: 2.4
Name: termella
Version: 0.0.9.dev4
Summary: A Python library for rich text and beautiful formatting in the terminal.
Home-page: https://github.com/codewithzaqar/termella
Author: codewithzaqar
Author-email: your.email@example.com
License: MIT
Project-URL: Bug Tracker, https://github.com/codewithzaqar/termella/issues
Project-URL: Source, https://github.com/codewithzaqar/termella
Keywords: terminal,cli,colors,ansi,rich-text,formatting,ui,console
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
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: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Terminals
Classifier: Topic :: Utilities
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: project-url
Dynamic: requires-python
Dynamic: summary

# Termella

**Termella** is a Python library designed to make terminal output rich, colorful, and beautifully formatted with minimal effort.

![Version](https://img.shields.io/badge/version-0.0.8-blue.svg)
![Licence](https://img.shields.io/badge/license-MIT-green.svg)

## ✨ New in v0.0.8
*   **App Architecture**: Build full-screen applications that restore terminal history on exit.
*   **Event Loop**: Efficient hybrid loop handling inputs and animations.
*   **Input Handling**: Non-blocking keyboard support (`on_key`).
*   **Mouse Support**: Click handling (`on_click`) for Unix/Windows.
*   **Responsiveness**: Automatic resize detection (`on_resize`).

## 🛠 Installation

```bash
pip install termella
```
```bash
git clone https://github.com/codewithzaqar/termella.git
cd termella
pip install .
```
# Quick Start
## Basic Color Printing
The `cprint` function is the quickest way to output stylvd text.

```python
from termella import cprint

cprint("Operation Successful", color="green", styles="bold")
cprint("System Failure", color="white", bg="bg_red", styles=["blink", "bold"])
```
## The `Text` Object
For more control, use the `Text` class. It allows for method chaining and string concatenation.
```python
from termella import Text

# Create styled parts
prefix = Text("[INFO] ").style(color="blue", styles="bold")
message = Text("Server is running...").style(color="white")

# Combine and print
print(prefix + message)
```
## UI Components
Create professional-looking output using widgets.
```python
from termella import panel

content = "Termella v0.0.1\nStatus: Online\nPort: 8080"
panel(content, color="cyan", title="Server Status")
```
## Documentation
For detailed usage, please see the `docs/` folder:

1. [API Reference](docs/api.md) - Details on classes and functions.
2. [Colors & Styles](docs/colors.md) - A cheat sheet of all available options.

## License
This project is licensed under the [MIT License](LICENSE).
