pytexl

The Python library of Texl: renders text templates with Swan expressions, loads documents from local files and over HTTP(S), and lets templates call your Python functions, async ones included.

pip install maturin
maturin build --release -m pytexl/Cargo.toml   # builds a wheel into target/wheels
pip install target/wheels/pytexl-*.whl

import asyncio
import pytexl

engine = pytexl.Engine({"user": {"name": "Ada"}})
print(asyncio.run(engine.render("Hello <% user.name %>!")))   # Hello Ada!

See the Python API reference. The docstrings of the pytexl package document the same API.

Layout

Tests

cargo test -p pytexl --test python          # builds the module and runs the Python tests

The cargo test needs python3 (3.10 or later) with its development files; it is skipped, with a message, if Python is missing. Set PYTEXL_PYTHON to pick an interpreter. In a virtual environment with the package installed (maturin develop), run the tests directly:

python -m unittest discover -s pytexl/tests -v

License

MIT