myges-api 0.3.0__tar.gz

myges_api-0.3.0/.gitignore

@@ -0,0 +1,20 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+build/
+dist/
+*.egg-info/
+.mypy_cache/
+.pytest_cache/
+.ruff_cache/
+.coverage
+
+# Données personnelles : captures de vraies réponses, tokens, identifiants.
+# Les fixtures de tests/fixtures/ sont synthétiques et doivent le rester.
+.env
+.env.*
+!.env.example
+captures/
+tokens.json
+*.ics

myges_api-0.3.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Arnaudmyges
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

myges_api-0.3.0/PKG-INFO

@@ -0,0 +1,125 @@
+Metadata-Version: 2.5
+Name: myges-api
+Version: 0.3.0
+Summary: Client Python typé (sync + async), CLI et spécification OpenAPI de l'API myGES / Kordis (non officielle).
+Project-URL: Homepage, https://arnaudmyges.github.io/myges-api/
+Project-URL: Documentation, https://arnaudmyges.github.io/myges-api/docs/
+Project-URL: Source, https://github.com/Arnaudmyges/myges-api
+Author: Arnaudmyges
+License-Expression: MIT
+License-File: LICENSE
+Keywords: esgi,kordis,myges,openapi,skolae,swagger
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: French
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27
+Requires-Dist: pydantic>=2.7
+Requires-Dist: tzdata; sys_platform == 'win32'
+Provides-Extra: cli
+Requires-Dist: rich>=13; extra == 'cli'
+Requires-Dist: typer>=0.12; extra == 'cli'
+Provides-Extra: gcal
+Requires-Dist: google-auth>=2.20; extra == 'gcal'
+Description-Content-Type: text/markdown
+
+# myGES API : CLI, bibliothèque Python et doc Swagger non officielles
+
+<p align="center">
+  <a href="https://arnaudmyges.github.io/myges-api/docs/"><img alt="Swagger UI" src="https://img.shields.io/badge/Swagger_UI-docs-85EA2D?logo=swagger&logoColor=black&style=for-the-badge"></a>
+  <a href="https://arnaudmyges.github.io/myges-api/docs/redoc.html"><img alt="Redoc" src="https://img.shields.io/badge/Redoc-r%C3%A9f%C3%A9rence-E53935?logo=readthedocs&logoColor=white&style=for-the-badge"></a>
+  <a href="https://github.com/Arnaudmyges/myges-api/blob/main/openapi/myges.yaml"><img alt="OpenAPI 3.1" src="https://img.shields.io/badge/OpenAPI-3.1-6BA539?logo=openapiinitiative&logoColor=white&style=for-the-badge"></a>
+  <a href="https://arnaudmyges.github.io/myges-api/docs/"><img alt="33 endpoints" src="https://img.shields.io/badge/endpoints-33-blue?style=for-the-badge"></a>
+</p>
+
+**myGES dans ton terminal** : emploi du temps, notes, supports de cours en un clic, alertes
+sur ton téléphone. Pour les étudiants de l'**ESGI** et des autres écoles du **Réseau GES**
+qui utilisent myGES. Avec la documentation Swagger complète de l'API myGES.
+
+<p align="center">
+  <a href="https://arnaudmyges.github.io/myges-api/docs/">
+    <img alt="Documentation Swagger de l'API myGES" src="https://raw.githubusercontent.com/Arnaudmyges/myges-api/main/docs/assets/swagger.png" width="50%">
+  </a>
+</p>
+
+> Projet **non officiel**, sans lien avec Kordis ni le Réseau GES.
+
+## Installation
+
+```bash
+sudo apt install pipx && pipx ensurepath     # puis ouvrir un nouveau terminal
+pipx install "myges-api[cli] @ https://github.com/Arnaudmyges/myges-api/archive/refs/heads/main.zip"
+myges login
+```
+
+macOS, Windows, mise à jour : [installation](https://github.com/Arnaudmyges/myges-api/blob/main/docs/installation.md).
+
+## Utilisation
+
+```bash
+myges next                   # ton prochain cours, salle, prof
+myges agenda                 # la semaine
+myges grades                 # tes notes
+myges files --download       # tous les supports de cours, rangés par matière
+myges --help                 # tout le reste
+```
+
+Toutes les commandes : [docs/cli.md](https://github.com/Arnaudmyges/myges-api/blob/main/docs/cli.md).
+
+## Alertes
+
+Une nouvelle note, un nouveau support, un cours annulé ? Reçois-le sur ton téléphone, Discord
+ou par e-mail : [alertes](https://github.com/Arnaudmyges/myges-api/blob/main/docs/alertes.md).
+
+## Google Calendar
+
+Ton emploi du temps dans Google Calendar, toujours à jour : [synchro Google Calendar](https://github.com/Arnaudmyges/myges-api/blob/main/docs/google-calendar.md).
+
+## Questions fréquentes
+
+<details>
+<summary><b>Comment exporter son emploi du temps myGES vers Google Calendar ?</b></summary>
+
+`myges gcal sync` tient un agenda Google Calendar à jour tout seul (cours ajoutés, déplacés,
+annulés). Pour un export ponctuel vers n'importe quel agenda : `myges agenda --ics cours.ics`.
+</details>
+
+<details>
+<summary><b>Comment télécharger tous les supports de cours myGES d'un coup ?</b></summary>
+
+`myges files --download` : un dossier par matière. Relancer la commande ne récupère que les
+nouveaux supports.
+</details>
+
+<details>
+<summary><b>Comment être prévenu d'une nouvelle note ou d'un nouveau support ?</b></summary>
+
+`myges notify add ntfy` (ou Discord, e-mail) puis `myges watch --install` : les nouveaux
+supports arrivent en moins de 5 minutes.
+</details>
+
+<details>
+<summary><b>Comment s'inscrire à un événement myGES dès l'ouverture des inscriptions ?</b></summary>
+
+`myges events subscribe 4525` (l'id est à la fin de l'adresse de l'événement) : l'inscription
+part à la seconde où elles ouvrent.
+</details>
+
+<details>
+<summary><b>Mon mot de passe est-il en sécurité ?</b></summary>
+
+Il n'est envoyé qu'au serveur d'authentification de myGES (Kordis). Ta machine garde la
+session (un jeton valable ~6 jours), et le mot de passe seulement si tu le demandes
+(`--save-password`, pour les alertes automatiques), dans des fichiers lisibles par toi seul.
+Le code est ouvert : tout se vérifie.
+</details>
+
+## Pour les développeurs
+
+[Swagger](https://arnaudmyges.github.io/myges-api/docs/) ·
+[bibliothèque Python](https://github.com/Arnaudmyges/myges-api/blob/main/docs/bibliotheque.md) ·
+[notes sur l'API](https://github.com/Arnaudmyges/myges-api/blob/main/docs/api-notes.md) ·
+[contribuer](https://github.com/Arnaudmyges/myges-api/blob/main/CONTRIBUTING.md) — licence MIT.

myges_api-0.3.0/README.md

@@ -0,0 +1,97 @@
+# myGES API : CLI, bibliothèque Python et doc Swagger non officielles
+
+<p align="center">
+  <a href="https://arnaudmyges.github.io/myges-api/docs/"><img alt="Swagger UI" src="https://img.shields.io/badge/Swagger_UI-docs-85EA2D?logo=swagger&logoColor=black&style=for-the-badge"></a>
+  <a href="https://arnaudmyges.github.io/myges-api/docs/redoc.html"><img alt="Redoc" src="https://img.shields.io/badge/Redoc-r%C3%A9f%C3%A9rence-E53935?logo=readthedocs&logoColor=white&style=for-the-badge"></a>
+  <a href="https://github.com/Arnaudmyges/myges-api/blob/main/openapi/myges.yaml"><img alt="OpenAPI 3.1" src="https://img.shields.io/badge/OpenAPI-3.1-6BA539?logo=openapiinitiative&logoColor=white&style=for-the-badge"></a>
+  <a href="https://arnaudmyges.github.io/myges-api/docs/"><img alt="33 endpoints" src="https://img.shields.io/badge/endpoints-33-blue?style=for-the-badge"></a>
+</p>
+
+**myGES dans ton terminal** : emploi du temps, notes, supports de cours en un clic, alertes
+sur ton téléphone. Pour les étudiants de l'**ESGI** et des autres écoles du **Réseau GES**
+qui utilisent myGES. Avec la documentation Swagger complète de l'API myGES.
+
+<p align="center">
+  <a href="https://arnaudmyges.github.io/myges-api/docs/">
+    <img alt="Documentation Swagger de l'API myGES" src="https://raw.githubusercontent.com/Arnaudmyges/myges-api/main/docs/assets/swagger.png" width="50%">
+  </a>
+</p>
+
+> Projet **non officiel**, sans lien avec Kordis ni le Réseau GES.
+
+## Installation
+
+```bash
+sudo apt install pipx && pipx ensurepath     # puis ouvrir un nouveau terminal
+pipx install "myges-api[cli] @ https://github.com/Arnaudmyges/myges-api/archive/refs/heads/main.zip"
+myges login
+```
+
+macOS, Windows, mise à jour : [installation](https://github.com/Arnaudmyges/myges-api/blob/main/docs/installation.md).
+
+## Utilisation
+
+```bash
+myges next                   # ton prochain cours, salle, prof
+myges agenda                 # la semaine
+myges grades                 # tes notes
+myges files --download       # tous les supports de cours, rangés par matière
+myges --help                 # tout le reste
+```
+
+Toutes les commandes : [docs/cli.md](https://github.com/Arnaudmyges/myges-api/blob/main/docs/cli.md).
+
+## Alertes
+
+Une nouvelle note, un nouveau support, un cours annulé ? Reçois-le sur ton téléphone, Discord
+ou par e-mail : [alertes](https://github.com/Arnaudmyges/myges-api/blob/main/docs/alertes.md).
+
+## Google Calendar
+
+Ton emploi du temps dans Google Calendar, toujours à jour : [synchro Google Calendar](https://github.com/Arnaudmyges/myges-api/blob/main/docs/google-calendar.md).
+
+## Questions fréquentes
+
+<details>
+<summary><b>Comment exporter son emploi du temps myGES vers Google Calendar ?</b></summary>
+
+`myges gcal sync` tient un agenda Google Calendar à jour tout seul (cours ajoutés, déplacés,
+annulés). Pour un export ponctuel vers n'importe quel agenda : `myges agenda --ics cours.ics`.
+</details>
+
+<details>
+<summary><b>Comment télécharger tous les supports de cours myGES d'un coup ?</b></summary>
+
+`myges files --download` : un dossier par matière. Relancer la commande ne récupère que les
+nouveaux supports.
+</details>
+
+<details>
+<summary><b>Comment être prévenu d'une nouvelle note ou d'un nouveau support ?</b></summary>
+
+`myges notify add ntfy` (ou Discord, e-mail) puis `myges watch --install` : les nouveaux
+supports arrivent en moins de 5 minutes.
+</details>
+
+<details>
+<summary><b>Comment s'inscrire à un événement myGES dès l'ouverture des inscriptions ?</b></summary>
+
+`myges events subscribe 4525` (l'id est à la fin de l'adresse de l'événement) : l'inscription
+part à la seconde où elles ouvrent.
+</details>
+
+<details>
+<summary><b>Mon mot de passe est-il en sécurité ?</b></summary>
+
+Il n'est envoyé qu'au serveur d'authentification de myGES (Kordis). Ta machine garde la
+session (un jeton valable ~6 jours), et le mot de passe seulement si tu le demandes
+(`--save-password`, pour les alertes automatiques), dans des fichiers lisibles par toi seul.
+Le code est ouvert : tout se vérifie.
+</details>
+
+## Pour les développeurs
+
+[Swagger](https://arnaudmyges.github.io/myges-api/docs/) ·
+[bibliothèque Python](https://github.com/Arnaudmyges/myges-api/blob/main/docs/bibliotheque.md) ·
+[notes sur l'API](https://github.com/Arnaudmyges/myges-api/blob/main/docs/api-notes.md) ·
+[contribuer](https://github.com/Arnaudmyges/myges-api/blob/main/CONTRIBUTING.md) — licence MIT.