The eat-api will change its API to version 2 with support for the new unit based pricing system.
All changes can be found here: TUM-Dev#12
When will this change happen?
01.01.2020
Simple static API for the canteens of the Studentenwerk München as well as some other locations. By now, the following locations are supported:
| Name | API-key | Address location |
|---|---|---|
| Mensa Arcisstraße | mensa-arcisstr | Arcisstraße 17, München |
| Mensa Garching | mensa-garching | Lichtenbergstraße 2, Garching |
| Mensa Leopoldstraße | mensa-leopoldstr | Leopoldstraße 13a, München |
| Mensa Lothstraße | mensa-lothstr | Lothstraße 13d, München |
| Mensa Martinsried | mensa-martinsried | Großhaderner Straße 6, Planegg-Martinsried |
| Mensa Pasing | mensa-pasing | Am Stadtpark 20, München |
| Mensa Weihenstephan | mensa-weihenstephan | Maximus-von-Imhof-Forum 5, Freising |
| StuBistro Arcisstraße | stubistro-arcisstr | Arcisstraße 12, München |
| StuBistro Goethestraße | stubistro-goethestr | Goethestraße 70, München |
| StuBistro Großhadern | stubistro-grosshadern | Butenandtstraße 13, Gebäude F, München |
| StuBistro Rosenheim | stubistro-rosenheim | Hochschulstraße 1, Rosenheim |
| StuBistro Schellingstraße | stubistro-schellingstr | Schellingstraße 3, München |
| StuCafé Adalbertstraße | stucafe-adalbertstr | Adalbertstraße 5, München |
| StuCafé Akademie Weihenstephan | stucafe-akademie-weihenstephan | Alte Akademie 1, Freising |
| StuCafé Boltzmannstraße | stucafe-boltzmannstr | Boltzmannstraße 15, Garching |
| StuCafé in der Mensa Garching | stucafe-garching | Lichtenbergstraße 2, Garching |
| StuCafé Karlstraße | stucafe-karlstr | Karlstraße 6, München |
| StuCafé Pasing | stucafe-pasing | Am Stadtpark 20, München |
| FMI Bistro Garching | fmi-bistro | Boltzmannstraße 3, Garching |
| IPP Bistro Garching | ipp-bistro | Boltzmannstraße 2, Garching |
CLICK ME
ingredient_lookup = {
"GQB" : "Certified Quality - Bavaria",
"MSC" : "Marine Stewardship Council",
"1" : "with dyestuff",
"2" : "with preservative",
"3" : "with antioxidant",
"4" : "with flavor enhancers",
"5" : "sulphured",
"6" : "blackened (olive)",
"7" : "waxed",
"8" : "with phosphate",
"9" : "with sweeteners",
"10" : "contains a source of phenylalanine",
"11" : "with sugar and sweeteners",
"13" : "with cocoa-containing grease",
"14" : "with gelatin",
"99" : "with alcohol",
"f" : "meatless dish",
"v" : "vegan dish",
"S" : "with pork",
"R" : "with beef",
"K" : "with veal",
"G" : "with poultry", # mediziner mensa
"W" : "with wild meat", # mediziner mensa
"L" : "with lamb", # mediziner mensa
"Kn" : "with garlic",
"Ei" : "with chicken egg",
"En" : "with peanut",
"Fi" : "with fish",
"Gl" : "with gluten-containing cereals",
"GlW" : "with wheat",
"GlR" : "with rye",
"GlG" : "with barley",
"GlH" : "with oats",
"GlD" : "with spelt",
"Kr" : "with crustaceans",
"Lu" : "with lupines",
"Mi" : "with milk and lactose",
"Sc" : "with shell fruits",
"ScM" : "with almonds",
"ScH" : "with hazelnuts",
"ScW" : "with Walnuts",
"ScC" : "with cashew nuts",
"ScP" : "with pistachios",
"Se" : "with sesame seeds",
"Sf" : "with mustard",
"Sl" : "with celery",
"So" : "with soy",
"Sw" : "with sulfur dioxide and sulfites",
"Wt" : "with mollusks",
}Based on: Studentenwerk München
The actual API is provided by static JSON files, which can be found in the gh-pages branch of this repository. These files are created through automatic travis builds. You need to structure a link as follows in order to access the API:
https://tum-dev.github.io/eat-api/<location>/<year>/<week-number>.json
To get all menus for one specific location:
https://tum-dev.github.io/eat-api/<location>/combined/combined.json
To get all menus for all locations:
https://tum-dev.github.io/eat-api/all.json
To get all menus that are not older than one day for all locations:
Here dish_type is also normalized.
All tailing digits and spaces get removed from dish_type.
For example Tagesgericht 1 -> Tagesgericht and Aktionsessen 6 -> Aktionsessen.
Also ignores all menus older than one day.
This results in this file being usually half the size of the all.json file.
https://tum-dev.github.io/eat-api/all_ref.json
To get all available canteens and their location:
https://tum-dev.github.io/eat-api/canteens.json
The following link would give you the menu of Mensa Garching for week 20 in 2019:
https://tum-dev.github.io/eat-api/mensa-garching/2019/20.json
The JSON files are produced by the tool shown in this repository. Hence, it is either possible to access the API or use the tool itself to obtain the desired menu data. The CLI needs to be used as follows:
$ python src/main.py -h
main.py [-h] [-p LOCATION] [-d DATE] [-j PATH] [-c] [--openmensa PATH]
[-l]
optional arguments:
-h, --help show this help message and exit
-d DATE, --date DATE date (DD.MM.YYYY) of the day of which you want to get
the menu
-j PATH, --jsonify PATH
directory for JSON output (date parameter will be
ignored if this argument is used)
-c, --combine creates a "combined.json" file containing all dishes
for the location specified
--openmensa PATH directory for OpenMensa XML output (date parameter
will be ignored if this argument is used)
-l, --locations prints all available locations formated as JSON
It is mandatory to specify the canteen (e.g. mensa-garching). Furthermore, you can specify a date, for which you would like to get the menu. If no date is provided, all the dishes for the current week will be printed to the command line. the --jsonify option is used for the API and produces some JSON files containing the menu data.
Here are some sample calls:
# Get the menus for the whole current week at mensa-garching
$ python src/main.py mensa-garching
# Get the menu for April 2 at mensa-arcisstrasse
$ python src/main.py mensa-arcisstrasse -d 02.04.2019
- Parser for OpenMensa (GitHub)
- Hunger | TUM.sexy (Github)
FMeat.phpSDK (GitHub)- Telegram bot for Channel t.me/lunchgfz (GitLab)
- UWP-TUM-Campus-App (Github)
- Fork and clone this repository
- Install the python dependencies (Python 3.6+ required):
sudo apt install libxml2 libxml2-dev libxslt1-devpip3 install -r requirements.txt
- Run tests:
- All the tests:
PYTHONPATH=src/ pytest - A specific test class:
PYTHONPATH=src/ pytest src/test/test_menu_parser.py::MenuParserTest