https://github.com/mhthies/mensa_aachen

Python3 module to fetch and parse Studierendenwerk Aachen's canteen menues
https://github.com/mhthies/mensa_aachen

aachen canteen python

Last synced: about 23 hours ago
JSON representation

Python3 module to fetch and parse Studierendenwerk Aachen's canteen menues

• Host: GitHub
• URL: https://github.com/mhthies/mensa_aachen
• Owner: mhthies
• Created: 2020-06-13T13:09:40.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-08-18T18:32:07.000Z (over 4 years ago)
• Last Synced: 2024-11-11T13:06:00.356Z (about 1 month ago)
• Topics: aachen, canteen, python
• Language: Python
• Size: 11.7 KB
• Stars: 2
• Watchers: 3
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: readme.md

Awesome Lists containing this project

README

        

# mensa_aachen.py

Fetch and parse Studierendenwerk Aachen's canteen menu

This Python module allows to fetch and parse the current week's menu of the university canteens in Aachen from the Studierendenwerk Aachen's website.

The module is build on top of the popular libraries *Requests* and *Beautifulsoup4*.

Typical usage:

```python

import mensa_aachen

dishes = mensa_aachen.get_dishes(mensa_aachen.Canteens.MENSA_ACADEMICA)

```

Which will yield a result in a form like

```python

{

    datetime.date(2020, 1, 20):

        Menu(

            main_dishes=[

                Dish(

                    menu_category='Tellergericht',

                    main_component=DishComponent(

                        title='Bulgureintopf',

                        flags=[]),

                    aux_components=[

                        DishComponent(

                            title='Kichererbsen, Gemüse',

                            flags=[, , ])

                        ],

                    meat=[, ],

                    price=Decimal('1.80'),

                    nutritional_values=NutritionalValues(caloric_val=None, fat=None, carbs=None, protein=None)),

                Dish(

                    menu_category='Vegetarisch',

                    main_component=DishComponent(

                        title='Spätzlepfanne',

                        flags=[]),

                    aux_components=[

                        DishComponent(

                            title='Röstzwiebeln',

                            flags=[, , , , , ]),

                        DishComponent(

                            title='Käsesauce',

                            flags=[, ])], meat=[],

                    price=Decimal('2.10'),

                    nutritional_values=NutritionalValues(caloric_val=3857.0, fat=44.6, carbs=97.1, protein=32.0)),

                ...],

            side_dishes=[

                Dish(

                    menu_category='Hauptbeilagen',

                    main_component=DishComponent(

                        title='Nudelreis',

                        flags=[, ]),

                    aux_components=[],

                    meat=[],

                    price=None,

                    nutritional_values=NutritionalValues(caloric_val=1859.0, fat=11.0, carbs=72.0, protein=12.0)),

                Dish(

                    menu_category='Nebenbeilage',

                    main_component=DishComponent(

                        title='Rosenkohl',

                        flags=[]),

                    aux_components=[],

                    meat=[],

                    price=None,

                    nutritional_values=NutritionalValues(caloric_val=502.0, fat=8.0, carbs=6.6, protein=5.5)),

                ...]

            ),

    datetime.date(2020, 1, 21):

        Menu(...),

    ...

}

```

The types `Menu`, `Dish`, `DishComponent`, and `NutritionalValues`, used in the result, are NamedTuples.

`Flags` and `MeatType` are Enums.

The `value` of each member of `Flags` corresponds to the abbreviation used in the menu. 

For more information about the fields and available enum options, please take a look at the module's source code.

## Installing

The module can be installed from its git repository via pip:

`pip install git+https://github.com/mhthies/mensa_aachen.git@master`

## License

This neat library is published under the terms of the MIT license.