Skip to main content

Unofficial Python API to interface with

Project description


Unofficial Python API for interfacing with, a Dutch website used by students to manage dinner status and expenses.

Linting Testing PyPI version

Current features include:

  • List all residents
  • Get the name of the list
  • Get or set the noticeboard
  • Get or set the dinner status


To install this module, run pip install python-eetlijst to install from Pip. If you prefer to install the latest version from Github, use pip install git+


Three examples are included in the examples/ folder. The purpose is to demonstrate some functionality.

Print or set the current dinner status, in a terminal window. Run it with python <username> <password> get|set.

It shall print something similar to this, when getting the current status:

Dinner status for 2014-03-30. The deadline is 16:00:00, and has passed.

In total, 4 people (including guests) will attend diner.

Unknown1 | Unknown2 | Unknown3 | Unknown4 | Unknown5
   C     |  D + 2   |    X     |    X     |    ?

X = No, C = Cook, D = Dinner, ? = Unknown

View or change the current noticeboard. Run it with python <username> <password> get|set.

Given a session id, print the name of the Eetlijst list. Run it with python <session_id>


See the file.


Currently, a minimal set of tests have been written. These tests only verify the 'scraping' functionality and correct sesision handling, by faking responses. However, they do not test any submit functionality, since it would require an active connection with during the tests.

To run the tests, please clone this repository and run poetry run pytest.


This is future work :-)

For now, please look at the source code, the tests and the examples.


See the file (GPLv3 license). You may change the code freely, but any change must be made available to the public.


Use this library at your own risk. I cannot be held responsible for any damages.

This page and its content is not affiliated with

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

python_eetlijst-2.0.0.tar.gz (20.5 kB view hashes)

Uploaded Source

Built Distribution

python_eetlijst-2.0.0-py3-none-any.whl (32.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page