Skip to main content

A high-performance terminal styling engine for Python, designed for advanced UI/UX in command-line interfaces.

Project description

TerminalNexus: Advanced Terminal Styling

A high-performance terminal styling engine for Python, designed for advanced UI/UX in command-line interfaces. TerminalNexus provides seamless integration of HEX color codes into your terminal applications, enabling you to create visually stunning and professional command-line interfaces.

🚀 Features

  • High-Performance HEX Color Processing: Efficiently convert and apply HEX color codes to terminal text
  • Lightweight & Fast: Minimal overhead, maximum performance
  • Easy to Use: Simple, intuitive API for styling terminal output
  • Cross-Platform: Works on Windows, Linux, and macOS
  • Python 3.6+ Compatible: Supports all modern Python versions

📥 Installation

Install TerminalNexus using pip:

pip install terminalnexus

Or install directly from GitHub:

pip install git+https://github.com/NexusDev-Labs/TerminalNexus.git

🎨 Quick Start

Get started with TerminalNexus in just a few lines of code:

import terminalnexus

# Print colored text
print(terminalnexus.set("#ff0000") + "Hello, World!" + terminalnexus.reset())

# Use in input prompts
user_input = input(terminalnexus.set("#00ff00") + "Enter your name: " + terminalnexus.set("#0000ff"))

📖 Usage Examples

Basic Text Styling

import terminalnexus

# Red text
print(terminalnexus.set("#ff0000") + "This is red text" + terminalnexus.reset())

# Green text
print(terminalnexus.set("#00ff00") + "This is green text" + terminalnexus.reset())

# Blue text
print(terminalnexus.set("#0000ff") + "This is blue text" + terminalnexus.reset())

Interactive Prompts

import terminalnexus

name = input(
    terminalnexus.set("#00ff00") + 
    "What's your name? " + 
    terminalnexus.set("#ffff00")
)
print(terminalnexus.set("#ff00ff") + f"Hello, {name}!" + terminalnexus.reset())

Combining Colors

import terminalnexus

# Create colorful output
message = (
    terminalnexus.set("#ff5733") + "Welcome" +
    terminalnexus.reset() + " to " +
    terminalnexus.set("#33c3f0") + "TerminalNexus" +
    terminalnexus.reset()
)
print(message)

🔧 API Reference

terminalnexus.set(hex)

Sets the terminal color to the specified HEX code.

Parameters:

  • hex (str): A HEX color code in the format #RRGGBB (e.g., #ff0000 for red)

Returns:

  • str: ANSI escape sequence for the specified color

Example:

color_code = terminalnexus.set("#ff5733")

terminalnexus.reset()

Resets the terminal color to default.

Returns:

  • str: ANSI escape sequence to reset terminal formatting

Example:

reset_code = terminalnexus.reset()

📋 Requirements

  • Python 3.6 or higher
  • A terminal that supports ANSI color codes (most modern terminals)

🤝 Contributing

We welcome contributions! Please feel free to submit a Pull Request.

📜 License

TerminalNexus is open-source software released under the MIT License. See the LICENSE file for details.

🌐 Links

💡 Acknowledgments

Thank you for using TerminalNexus! We hope this library helps you create beautiful and engaging command-line interfaces.

Project details


Download files

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

Source Distribution

terminalnexus-1.0.0.tar.gz (3.9 kB view details)

Uploaded Source

Built Distribution

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

terminalnexus-1.0.0-py3-none-any.whl (4.1 kB view details)

Uploaded Python 3

File details

Details for the file terminalnexus-1.0.0.tar.gz.

File metadata

  • Download URL: terminalnexus-1.0.0.tar.gz
  • Upload date:
  • Size: 3.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for terminalnexus-1.0.0.tar.gz
Algorithm Hash digest
SHA256 7321cf409db65fa0596e70babfb78648f4420f20f4ec3994329cd4773b81ad0c
MD5 31f5e6dccdb3b72b8ab0fc6939c0144c
BLAKE2b-256 28322581474223b56b9f6c7f33fdae55278558e3fe13e9c40ca53ae8f607fac8

See more details on using hashes here.

File details

Details for the file terminalnexus-1.0.0-py3-none-any.whl.

File metadata

  • Download URL: terminalnexus-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 4.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for terminalnexus-1.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cad948bbb91ace705926c3f3c4f644f8f99849b2a61dc65170b83131b00b7015
MD5 451f770b8ce9463ec99a42831be32c96
BLAKE2b-256 d8eaf075ca1af0e7f5635bb714344f0f9259058f2eed30b1feed3f72f341286d

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