Metadata-Version: 2.2
Name: ConsoleM
Version: 0.1.1
Summary: A powerful Python library for terminal manipulation and text styling
Home-page: https://github.com/Remi-Avec-Un-I/ConsoleM
Author: Remi
License: MIT
Project-URL: Homepage, https://github.com/yourusername/ConsoleM
Project-URL: Bug Tracker, https://github.com/yourusername/ConsoleM/issues
Keywords: terminal,console,text styling,cursor control,keyboard input
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: home-page
Dynamic: requires-python

# ConsoleM

A powerful Python library for terminal manipulation and text styling. ConsoleM provides a simple and intuitive API for creating beautiful terminal applications with advanced features like cursor control, text styling, and keyboard input handling.

## Features

* **Terminal Manipulation**
  * Precise cursor movement (absolute and relative positioning)
  * Screen clearing and line management
  * Alternate screen support for full-screen applications
  * Terminal size detection and cursor position tracking
  * Cursor visibility control
  * Non-blocking keyboard input handling

* **Text Styling**
  * Rich text formatting with intuitive markup syntax
  * 256-color support (foreground and background)
  * Text styles (bold, underline, italic, etc.)
  * Emoji support with automatic conversion
  * Easy-to-use BBCode-like markup syntax
  * Automatic style reset and cleanup

* **Input Handling**
  * Non-blocking keyboard input capture
  * Key event queue management
  * Special key detection (arrows, function keys, etc.)
  * Thread-safe input processing
  * Clean shutdown handling

## Installation

```bash
pip install ConsoleM
```

## Quick Start

```python
from ConsoleM import Terminal
from ConsoleM.Style.text import Text

# Create a terminal instance
term = Terminal()

# Print styled text
Text("[blue bold]Welcome to ConsoleM![/]").print()

# Get terminal size
width, height = term.get_terminal_size()
Text(f"[green]Terminal size: {width}x{height}[/]").print()
```

## Documentation

For detailed documentation, visit: https://consolem.readthedocs.io/en/latest/index.html

## License

This project is licensed under the MIT License - see the LICENSE file for details. 
