termella 0.0.8.dev1

A Python library for rich text and beautiful formatting in the terminal.

Termella

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

📦 New in v0.0.7

• Markup Language: Style text inline like [red]Hello[/].
• TrueColor Support: Use [rgb(255,0,100)] for millions of colors.
• Hyperlinks: Clickable text with [link=https://example.com]Click Me[/].
• Semantic Themes: Defin aliases like [error] or [h1].
• Nested Styles: Combine styles cleanly [bold][red]Text[/][/].

🛠 Installation

pip install termella

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.

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.

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.

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 - Details on classes and functions.
2. Colors & Styles - A cheat sheet of all available options.

License

This project is licensed under the MIT License.