pyToledo
pyToledo is a Python library to interact with the common virtual learning environment for the Association KU Leuven a.k.a Toledo.
Motivation
My goal was to provide an easy way to interact with the various KU Leuven API endpoints.
This library reproduces the Toledo login flow and returns a requests Session object that keeps track of your cookies and headers.
The Session object allows you to query the various endpoints.
Good to know:
-
Data will always be returned as JSON via stdout. You can redirect the output to any file using '>'.
-
Tested on Windows 11 & Ubuntu 20.04
-
Teacher accounts (u) are not supported!
Installation
Use the package manager pip to install pyToledo.
pip install toledo
Usage
As a package
from toledo import login
from toledo import api
# Create a session object | returns a requests Session object with the necessary cookies and headers
session = login.create_session_object(
user='',
password=''
)
# Create an api object with your session
toledo = api.create_api_object(
session=session
)
As a script
optional arguments:
-h, --help show this help message and exit
--enrollments, -en retrieve all your enrollments
--todo {task,test}, -td {task,test}
retrieve your to-do list (tasks or tests)
--upcoming, -up retrieve your upcoming courses
--events {message,update}, -ev {message,update}
retrieve your recent events (messages or updates)
--rnumber RNUMBER, -rn RNUMBER
your personal rnumber
--password PASSWORD, -pw PASSWORD
your password
--silent, -s surpress output
Examples
Enrollments/courses
# returns all your courses in JSON
toledo.get_enrollments()
or
python -m toledo -en
Todo (tasks & tests)
# returns open tasks in JSON
toledo.get_to_do(type='task')
or
python -m toledo -td task
# returns open tests in JSON
toledo.get_to_do(type='test')
or
python -m toledo -td test
Upcoming courses
# returns your upcoming courses (for a certain day) in JSON
toledo.get_upcoming()
or
python -m toledo -up
Events (messages & updates)
# returns your messages in JSON
toledo.get_events(type='message')
or
python -m toledo -ev message
# returns your updates in JSON
toledo.get_events(type='update')
or
python -m toledo -ev update
TODO
- Documentation
- Tests
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
1 Jan 18, 2022
95 Jan 8, 2023
60 Apr 1, 2022
1 Nov 13, 2021
3 Jan 23, 2022
1 Dec 18, 2021
311 Dec 25, 2022
6 Jun 13, 2022
2 Dec 9, 2021
24 Aug 24, 2022
37 Jan 03, 2023
6 Sep 18, 2022
5 Oct 28, 2022
1 Feb 09, 2022
1.8k Dec 31, 2022
2 Jun 24, 2022
1 Dec 07, 2021
3 Sep 20, 2021
17 Nov 02, 2022
5 Nov 08, 2021
3 Nov 28, 2021
6k Jan 06, 2023
1.2k Dec 30, 2022
6 Dec 03, 2022
2 Apr 22, 2022
8 Oct 29, 2022
1 Feb 09, 2022
2 Feb 17, 2022