a8c-cusser 0.2.0

A curses wrapper that understands ANSI escape code sequences

For of cusser with added support of Python 3.11+

cusser 🤬

A curses wrapper that understands ANSI escape code sequences

cusser is a lightweight Python package for teaching curses how to use ANSI escape code sequences. It works by wrapping the curses standard window object and intercepting escape code sequences.

Features

• ♻️ Easily integrate with the standard curses module
• 🕹️ Use the same escape code sequences as you would with Colorama
• 🖍️ Only one dependency: stransi (for actuallly parsing escape code sequences)
• 🐍 Python 3.8+

Installation

$ pip install cusser

Usage

In[1]:
import curses

In[2]:
from a8c_cusser import Cusser

In[3]:


def app(stdscr) -> None:
    ...: """Start a new application."""
    ...:
    if not isinstance(stdscr, Cusser):
        ...: stdscr = Cusser(stdscr)
    ...:
    ...: ultra_violet = (100, 83, 148)
    ...: x, y = 34, 12
    ...: stdscr.addstr(
        ...:         f"\033[2J\033[{x};{y}H"
    ...: "\033[1;32mHello "
    ...:         f"\033[;3;38;2;{';'.join(map(str, ultra_violet))}m"
    ...: "cusser"
    ...:         "\033[m 🤬!"
    ...:     )
    ...: stdscr.refresh()
    ...: stdscr.getch()
    ...:


In[4]: curses.wrapper(app)

Credits

Photo by Gwendal Cottin on Unsplash.