README.md

THIS SCRIPT IS OUTDATED FOR THE MOMENT AND WILL NOT WORK

vulcan-exams-calendar-sync

A script made for synchronising exams from the UONET+ Vulcan online grade book with Google Calendar. Made basing on an existing unofficial documentation of the UONET+ Vulcan online grade book available here: https://gitlab.com/erupcja/uonet-api-docs.

Acknowledgements:

• SynneK1337 for inspiration (librus-synchro)
• selfisekai for creating an unofficial UONET+ Vulcan documentation (uonet-api-docs)
• googleapis for creating Google Calendar API library
• wulkanowy for creating UONET+ request signing library (uonet-request-signer)
• psf for creating Requests library (requests)

Requirements:

• requests
• oauth2client
• uonet-request-signer
• google-api-python-client
• google-auth-oauthlib

Usage:

Dependencies installation

pip install -r requirements.txt

Creating a Google API project:

• Open the Google API console
• Click New project
• Enter a name and click Create

Downloading API credentials

• Enter here
• Click Create credentials
• From a opened list box select OAuth client ID
• Select Other, give a custom name and then click Create
• Close the dialog window which appeared a while before
• Download user login data file, rename it to credentials.json, create a directory named config and put this file there

Register the script

• Open the UONET+ Vulcan website, log in and choose Dostęp mobilny (Mobile access) section
• Click Zarejestruj urządzenie mobilne (Register the mobile device)
• Run the configure.py script with proper parameters: python3 configure.py <token> <symbol> <PIN>

How to use the script

• Simply run the main.py script. At the first launch, you will be prompted to log in into your Google account - the link to authentication will appear in the console.
• After the first launch you can add it to scheduled tasks (ex. cron)