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.

📦 New in v0.0.4

  • Intvractive Menus: Use arrow keys to select options (select).
  • Checkboxes: Multi-select options with Spacebar (checkbox).
  • Pagination: Handle long lists cleanly with scrolling limits.
  • Cross-Platform Input: Robust keyboard handling for Windows, Linux, and macOS.

🛠 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.5.dev4.tar.gz (11.3 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.5.dev4-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

File details

Details for the file termella-0.0.5.dev4.tar.gz.

File metadata

  • Download URL: termella-0.0.5.dev4.tar.gz
  • Upload date:
  • Size: 11.3 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.5.dev4.tar.gz
Algorithm Hash digest
SHA256 b08ed2fac8134d10fe6a71bb7212b97d60707243cef329075c1da1771b3b0cef
MD5 52d39205a5c2deade91ce38e8fc02930
BLAKE2b-256 fcbb052b0d099af0eb9f6a948d0e6c42896523e160ab00d94ee6568708740f0b

See more details on using hashes here.

File details

Details for the file termella-0.0.5.dev4-py3-none-any.whl.

File metadata

  • Download URL: termella-0.0.5.dev4-py3-none-any.whl
  • Upload date:
  • Size: 13.7 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.5.dev4-py3-none-any.whl
Algorithm Hash digest
SHA256 588929848d2a3e1cfdd7e9f76ed82dabe7b1d3ac29f4e8ec9ce90a9ea2795261
MD5 53f0c18720325f2bf64e18c6aec4b364
BLAKE2b-256 1b169f3e3552062f6dfd4a87ea4a00d30533ad7b1049cb119cfaaae8d2eb8f78

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