wau 0.1.0

Web API Utils

wau — Web API Utils

Web API Utils, or short wau, is a thin layer on top of Werkzeug to provide a simple and consistent interface for writing APIs in Python. wau is built for educational purposes and is not intended for production use. It is opinionated, as it only supports JSON as data format. It uses simple type annotations to define the expected input and output of the API endpoints. Common tasks as authentication, CORS and server-sent events are supported by default.

Installation

Install from PyPI:

pip install wau

or with uv:

uv add wau

Testing

Test dependencies are separated from runtime dependencies in pyproject.toml using the test dependency group.

Run the test suite:

uv run --group test python -m pytest -q

Run doctests:

uv run --group test python -m doctest .\wau.py

Publishing

Build package artifacts:

uv build

Validate metadata and README rendering:

uvx twine check dist/*

Upload to TestPyPI first:

uv publish --publish-url https://test.pypi.org/legacy/

Then publish to PyPI:

uv publish

License

This project is licensed under GNU LGPL v3 or later (LGPL-3.0-or-later).

If you distribute modified versions of this library, those library modifications must be published under the same license terms.