# ansi-to-html

<!-- [![downloads](https://static.pepy.tech/badge/ansi-to-html/month)](https://pepy.tech/project/ansi-to-html) -->
[![uv](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/uv/main/assets/badge/v0.json)](https://github.com/astral-sh/uv)
[![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm.fming.dev)
[![PyPI](https://img.shields.io/pypi/v/ansi-to-html-py.svg)](https://pypi.org/project/ansi-to-html-py)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/ansi-to-html-py.svg)](https://pypi.org/project/ansi-to-html-py)
[![License](https://img.shields.io/pypi/l/ansi-to-html-py.svg)](https://pypi.python.org/pypi/ansi-to-html-py)
[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/lmmx/ansi-to-html/master.svg)](https://results.pre-commit.ci/latest/github/lmmx/ansi-to-html/master)

Python bindings for the ansi-to-html Rust library, a fast ANSI terminal styling to HTML converter.

## Installation

```bash
pip install ansi-to-html-py
```

### Requirements

- Python 3.9+

## Features

Fast ANSI to HTML parser in Rust, shipped for Python via PyO3.

Refer to the [to-html docs](https://github.com/Aloso/to-html/) for usage guide.

## Contributing

Maintained by [lmmx](https://github.com/lmmx). Contributions welcome!

1. **Issues & Discussions**: Please open a GitHub issue or discussion for bugs, feature requests, or questions.
2. **Pull Requests**: PRs are welcome!
   - Install the dev extra (e.g. with [uv](https://docs.astral.sh/uv/): `uv pip install -e .[dev]`)
   - Run tests (when available) and include updates to docs or examples if relevant.
   - If reporting a bug, please include the version and the error message/traceback if available.
