BreizhHardware/ISEN_ICS_Scrapper
1
0
Fork 0
mirror of https://github.com/BreizhHardware/ISEN_ICS_Scrapper.git synced 2026-05-09 00:05:26 +02:00
Code Issues Projects Packages Wiki Activity
No description
2 commits 1 branch 0 tags 29 KiB
  • Python 100%
Find a file
Exact
Félix MARQUET 4b957819d6 chore(docs): Add warning for ICS duration
2026-01-05 11:43:09 +01:00
src/isen_ics_scrapper feat: init the project 2026-01-05 11:41:08 +01:00
tests feat: init the project 2026-01-05 11:41:08 +01:00
.gitignore feat: init the project 2026-01-05 11:41:08 +01:00
pyproject.toml feat: init the project 2026-01-05 11:41:08 +01:00
README.md chore(docs): Add warning for ICS duration 2026-01-05 11:43:09 +01:00

README.md

ISEN ICS Scrapper

Un outil en ligne de commande (CLI) moderne pour télécharger, analyser et visualiser les statistiques de votre emploi du temps ISEN (format ICS).

Il permet de récupérer automatiquement votre calendrier depuis web.isen-ouest.fr, de calculer le nombre total d'heures par matière et d'afficher le tout dans un tableau élégant directement dans votre terminal.

⚠️ Attention : L'export ICS fourni par l'école est limité aux deux prochains mois (le mois en cours et le suivant). Les heures calculées ne représentent donc pas la totalité du semestre ou de l'année.

🚀 Fonctionnalités

  • Téléchargement automatique de l'emploi du temps via ID étudiant.
  • Calcul des heures cumulées par matière.
  • Affichage riche et coloré dans le terminal (grâce à Rich).
  • Support UTF-8 pour un affichage correct des accents.

📋 Prérequis

  • Python 3.14 ou supérieur (adaptable selon votre version installée).
  • Poetry pour la gestion des dépendances.

Installation de Poetry (si nécessaire)

Si vous n'avez pas encore Poetry, installez-le avec la commande suivante :

curl -sSL https://install.python-poetry.org | python3 -

🛠️ Installation

  1. Clonez ce dépôt (ou téléchargez les sources) :

    git clone https://github.com/BreizhHardware/ISEN_ICS_Scrapper
cd ISEN_ICS_Scrapper

  2. Installez les dépendances :

    poetry install

💻 Utilisation

L'outil s'utilise via la commande isen-ics suivie de votre ID étudiant (le numéro présent dans le passeport informatique).

Lancer via Poetry

poetry run isen-ics <VOTRE_ID_ETUDIANT>

Exemple :

poetry run isen-ics 000000

Résultat

Vous obtiendrez un tableau trié par volume horaire décroissant :

┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━┓
┃ Matière                                      ┃ Heures Totales ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━┩
│ Développement Web S7                         │        30.00 h │
│ Cloud computing                              │        28.50 h │
│ ...                                          │            ... │
├──────────────────────────────────────────────┼────────────────┤
│ TOTAL                                        │       174.50 h │
└──────────────────────────────────────────────┴────────────────┘

📦 Dépendances principales

  • Requests : Pour le téléchargement HTTP.
  • ICS : Pour le parsing du format iCalendar.
  • Rich : Pour l'interface terminal (tableaux, barres de progression).
  • Typer : Pour la création de l'interface CLI.