Tomuss Grade API

Obtenir ses notes de Tomuss

A propos

Ceci est un petit projet node.js avec typescript pour obtenir ses notes de Tomuss (nécessite de se connecter avec le CAS).
C'est un projet perso qui peut avoir quelques bugs, mais si vous voulez contribuer, n'hésitez pas à faire un pull request.

Pour commencer

Installer en tant que package Node.js :

npm install shawiizz/tomuss-api

Contribuer / Modifier le code source

Clonez le repository et installez les dépendances :

git clone https://github.com/Shawiizz/tomuss-api.git
cd tomuss-api
npm install

Exemples

Comment obtenir ses notes

const casAuthenticator = new CASAuthenticator()
await casAuthenticator.login('pXXXXXXX', 'password')

const tomuss = new Tomuss(casAuthenticator)
const subjects = await tomuss.getSubjects(Semester.S1, Semester.S2)
const mergedSubjects = mergeSubjectsWithSameUeId(subjects) // Merge les matières qui ont le même id d'UE (pas obligatoire)

Remplir un fichier xlsx avec ses notes (pour l'IUT Info)

Une version avec un site web a mettre en place facilement est disponible à ce lien.

Si vous avez le fichier Calculer ses moyennes BUT - Info Doua.xlsx et que vous êtes en 1ʳᵉ année, il y a un bout de code qui permet de préremplir le fichier avec vos notes.
Je ne garantis pas que ça marche à 100%, mais ça peut vous faire gagner du temps.
Pour les matières où il n'y a pas de notes, le programme laissera la case vide.

const path = '/chemin/vers/le/fichier.xlsx'
const modifiedXlsxFileBuffer = await fillXlsxFile(subjects, path, false)
fs.writeFileSync(path, modifiedXlsxFileBuffer)

En ce qui concerne le 3ᵉ paramètre qui est par défaut à false, il permet de calculer la moyenne d'une matière si la moyenne n'a pas déjà été calculée par les professeurs sur Tomuss. Vous pouvez donc mettre true si vous voulez que la moyenne soit calculée avec les notes récupérées.