🕷️ ragnetto-console

Ragnetto-Console is a lightweight Python utility for terminal manipulation using ANSI escape sequences

It provides an easy-to-use interface for colors, cursor positioning, and non-blocking input handling.

This module is part of the ragnetto software suite.

🚀 Features

• ANSI Colors : Full support for 16 foreground and background colors.
• Cursor Control : Move (X, Y), toggle visibility (ON/OFF), and change shapes (Block, Bar, Underline).
• Advanced Input : Read single keys immediately without pressing Enter (Non-blocking input) with or without Echo.
• Cross-platform : Support for Unix-like systems (Linux/macOS) and Windows (via PowerShell integration).
• Terminal Info : Auto-detect console width and height.

📦 Installation

Install the module via PyPI:

pip install ragnetto-console

🛠️ Quick Start

from ragnetto import console

# Clear screen and set window title
console.clear()
console.title("Ragnetto-Console Demo")

# Write colored text at specific coordinates (X, Y)
console.write("Welcome to Ragnetto-Console!", "LIGHT_GREEN", "BLACK", 10, 5)

# Read a key without waiting for Enter
print("\nPress any key to exit...")
console.getkey()

# Reset terminal styles to default
console.reset()

📖 API Reference

💎 Constants

🎨 Colors

You can use these strings for foreground (f) and background (b) parameters:

• Standard: BLACK, RED, GREEN, YELLOW, BLUE, MAGENTA, CYAN, WHITE
• Bright: GRAY, LIGHT_RED, LIGHT_GREEN, LIGHT_YELLOW, LIGHT_BLUE, LIGHT_MAGENTA, LIGHT_CYAN, LIGHT_WHITE

🖱️ Caret Shapes

Values for the console.caret(shape) function:

⚙️ States

Values for console.cursor(state):

• 1 or "ON": Show cursor.
• 0 or "OFF": Hide cursor.

📝 License

Distributed under the MIT License. See LICENSE for more information.

Author: ragnetto-gab (Ragnetto®)

E-Mail: ragnettosoftware@gmail.com