Metadata-Version: 2.4
Name: sista
Version: 3.0.0b1
Summary: Sista is a memory-safe and OS-agnostic library for making terminal videogames and animations
Author-email: FLAK-ZOSO <mattia.marchese.2006@gmail.com>
License-Expression: GPL-3.0-only
Project-URL: Homepage, https://github.com/FLAK-ZOSO/Sista
Project-URL: Repository, https://github.com/FLAK-ZOSO/Sista
Project-URL: Documentation, https://flak-zoso.github.io/Sista/sista-python/
Project-URL: Changelog, https://github.com/FLAK-ZOSO/Sista/blob/main/changelog.md
Project-URL: ReleaseNotes, https://github.com/FLAK-ZOSO/Sista/blob/main/ReleaseNotes.md
Keywords: ansi,graphics,terminal,videogames,animations
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Operating System :: Unix
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Games/Entertainment :: Simulation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE.md
Dynamic: license-file

# Sista - Python C extension for Sista C++ Library

This repository contains a Python C extension that provides bindings to the Sista C++ library, enabling Python developers to leverage its functionality for ANSI terminal graphics manipulation, videogame and animation development.

## Features

- Full access to Sista C API functions
- Enum values exposed for foreground colors, background colors, and text attributes
- Automatic memory management through Python capsules and objects

## Dependencies

- [Python 3.9 or higher](https://www.python.org/downloads/)
- [Sista C++ library](https://github.com/FLAK-ZOSO/Sista?tab=readme-ov-file#installation)

## Installation

Since the wheel package is available on PyPI, you can easily install it using pip:

```bash
pip install sista
```

## Usage

After successful installation, you can use the `sista` module in your Python scripts:

```python
import sista
```

## Documentation

- https://flak-zoso.github.io/Sista/sista-python

The documentation is generated with...

```bash
python -m pdoc --html sista --output-dir docs --force
```

...and can be found in the `docs` directory. You can also host it locally using:

```bash
python -m http.server --directory docs
```

Then, open your web browser and navigate to `http://localhost:8000/sista/index.html` to view the documentation.
