Metadata-Version: 2.4
Name: mau_html_visitor
Version: 3.0.0
Summary: A visitor for Mau that converts the AST into HTML
Author-email: Leonardo Giordani <giordani.leonardo@gmail.com>
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
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: Topic :: Software Development :: Libraries :: Python Modules
License-File: LICENSE
Requires-Dist: mau>=5.0.0,<6.0.0
Requires-Dist: Pygments>=2.18.0,<2.20.0
Requires-Dist: beautifulsoup4==4.*
Requires-Dist: pytest ; extra == "testing"
Project-URL: Home, https://github.com/Project-Mau/mau-html-visitor
Provides-Extra: development
Provides-Extra: testing

# Mau HTML Visitor

This is a plugin for the [Mau](https://github.com/Project-Mau/mau) markup language. The plugin provides the conversion from Mau source to HTML.

You can install this plugin with

```
pip install mau-html-visitor
```

and Mau will automatically be able to load it. To use the visitor you need to load it and to pass it to the class `Mau` when you instantiate it

``` python
from mau import Mau, load_visitors
from mau.message import LogMessageHandler

visitor_classes = load_visitors()

visitors = {i.format_code: i for i in visitor_classes.values()}
visitor_class = visitors["html"]

message_handler = LogMessageHandler()

mau = Mau(message_handler)

result = mau.process(visitor_class, text, "source.mau")
```

The default extension for templates is `.html`. The plugin uses [Pygments](https://pygments.org/) to provide source code highlighting.

