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
4 Dec 14, 2022
8 Nov 04, 2022
24 Dec 28, 2022
124 Nov 30, 2022
4 May 31, 2022
12 Sep 05, 2022
14 Nov 11, 2022
49 Nov 25, 2022
1 Dec 14, 2021
3 Oct 14, 2022
2 Jan 21, 2022
2 Jan 18, 2022
18 Jul 31, 2022
133 Nov 12, 2022
10 Aug 19, 2022
27 Jul 23, 2022
5k Jan 04, 2023
1 Nov 23, 2021
2 Feb 18, 2022