Files
OpenMensa-Parsers/README.md
T
Hadrian Burkhardt 1b7f563e03 clear github
2026-05-21 08:28:58 +00:00

1.7 KiB

OpenMensa Parsers

Read the Docs

OpenMensa parser components query canteen websites for menus and transform them into OpenMensa's data format. The default parser currently supports Studentenwerk Potsdam. The package is structured so additional city or provider parsers can be added behind the same OpenMensa XML renderer.

Among others, OpenMensa powers the popular Mensa Uni Potsdam Android app.

The current application is built with Python, PyOpenMensa, and Flask. Learn more about the technical details at Read the Docs.

Local development (modern)

Recommended: Python 3.12+.

Option A (uv, recommended) ::

$ uv venv
$ uv pip install -e ".[dev]"
$ uv run flask --app openmensa_parsers.views run

Option B (venv + pip) ::

$ python -m venv .venv
$ . .venv/bin/activate
$ pip install -e ".[dev]"
$ FLASK_APP=openmensa_parsers.views flask run

Contributions are always welcome, in particular if the response format of the canteens change. Feel free to file a PR with improvements.

Deployment Coordinate deployment with the maintainer responsible for the running parser instance and its OpenMensa registration.

Where to go next maybe use this parser or the OpenMensa API to source a new dataset for training a predictor for your favorite lunch?

License Just assume this project is licensed in terms of WTFPL ;)