Codex 0dd4ee68c1 docs: define strict dry-run contract
# Conflicts:
#	.secrets.baseline
2026-09-11 11:57:21 +02:00
2026-09-11 11:57:21 +02:00
2026-09-10 23:41:19 +02:00
2026-09-11 11:57:21 +02:00
2026-09-11 11:57:21 +02:00

pronote-sync

Synchronisation Pronote → CalDAV + XMPP.


Synchronise l'agenda et les devoirs de Pronote vers un calendrier CalDAV et envoie un résumé quotidien par XMPP. Supporte les sources iCal et pronotepy avec repli automatique. Synthèse IA optionnelle.


🚀 Démarrage rapide

# Cloner le dépôt
git clone <repo-url>
cd pronote-sync

# Créer l'environnement virtuel
python3.13 -m venv .venv
source .venv/bin/activate

# Installer
pip install -e ".[dev]"

# Configurer
cp .env.example .env
# Éditer .env avec vos paramètres (voir .env.example pour le détail)

# Tester
pronote-sync --dry-run --log-level DEBUG

📖 Utilisation

pronote-sync                    # Exécute la synchronisation
pronote-sync --dry-run          # Simulation : lectures autorisées, aucune écriture persistante ni sortie distante
pronote-sync --log-level DEBUG  # Verbosité des journaux

En --dry-run, les données peuvent être lues pour construire la simulation, mais aucun état local de source n'est enregistré : l'état RSS reste en mémoire pendant l'exécution. Les écritures CalDAV et l'envoi XMPP sont également désactivés. Le mode PRONOTE_AUTH_MODE=qr_token est refusé avant toute connexion, car la rotation de son token ne peut pas garantir un état persistant cohérent pendant une simulation.


🛠️ Déploiement

Les artefacts pour systemd/timer et logrotate sont fournis dans deploy/. Voir docs/exploitation.md pour plus de détails.


🙏 Remerciements

Ce projet repose sur les bibliothèques open-source suivantes :

Inspiré de pronote-digest par Yoan Bernabeu.


Licence

MIT — voir LICENSE.

Description
Outil python pour récupérer les informations transmises par le collège via Pronote et leur site internet.
Readme MIT 3.4 MiB
Languages
Python 100%