Skip to main content

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

Project description

Termella

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

Version Licence

📦 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.

Project details


Release history Release notifications | RSS feed

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

termella-0.0.8.dev3.tar.gz (14.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

termella-0.0.8.dev3-py3-none-any.whl (17.5 kB view details)

Uploaded Python 3

File details

Details for the file termella-0.0.8.dev3.tar.gz.

File metadata

  • Download URL: termella-0.0.8.dev3.tar.gz
  • Upload date:
  • Size: 14.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for termella-0.0.8.dev3.tar.gz
Algorithm Hash digest
SHA256 e3787f6bcdd2d801d227c3f17b132b1d2d0e3059dc8013bd01fa567bed3e55d1
MD5 3309884a2b367532e485b8e6c880a313
BLAKE2b-256 2b3b170d97a99205bfca0b0ac4806d6a195442f5a363fd2273cc3fd065b950b3

See more details on using hashes here.

File details

Details for the file termella-0.0.8.dev3-py3-none-any.whl.

File metadata

  • Download URL: termella-0.0.8.dev3-py3-none-any.whl
  • Upload date:
  • Size: 17.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.0

File hashes

Hashes for termella-0.0.8.dev3-py3-none-any.whl
Algorithm Hash digest
SHA256 a28eb8109dc12281391a3ad5be6dfac728a29fbf35fcd87ff37d93a0e0c9649c
MD5 6a04f5ae794aa0519b34e9b63b96c7ab
BLAKE2b-256 e9775361b3c2ad940b655a517015399b0bee076da4bd870ea8908639d05503b0

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page