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
449 Jan 07, 2023
1 Jan 10, 2022
8 Feb 16, 2022
1 Dec 13, 2021
2 Feb 14, 2022
0 Feb 13, 2022
4 Oct 12, 2022
19 Jun 03, 2021
3 Jun 30, 2022
806 Jan 04, 2023
15 Aug 11, 2022
3 May 04, 2022
2 Nov 29, 2021
49 Jul 10, 2022
52 Mar 15, 2022
0 Jan 28, 2022
1 Feb 04, 2022
5 Feb 23, 2022
0 Aug 02, 2022
1 Apr 08, 2022