oedb-backend/extractors/README_extractor_events.md

Extractors d'évènements (vacances, journées mondiales)

Scripts CLI ajoutant des évènements dans OEDB, avec cache JSON, paramètres et rapport.

Commun

• Cache: dossier extractors_cache/ (créé automatiquement)
• Paramètres: --dry-run pour simuler sans écrire dans OEDB
• API OEDB: --base-url (par défaut https://api.openeventdatabase.org)

Vacances scolaires FR

python3 extractors/fr_holidays_extractor.py \
  --start 2025-01-01 --end 2025-12-31 \
  --academie A \
  --cache extractors_cache/fr_holidays_cache.json \
  --cache-ttl $((24*3600)) \
  --base-url https://api.openeventdatabase.org \
  --dry-run

Sortie: JSON avec success, failed, networkErrors.

Journées mondiales / internationales

python3 extractors/world_days_extractor.py \
  --year 2025 \
  --cache extractors_cache/world_days_cache.json \
  --cache-ttl $((24*3600)) \
  --base-url https://api.openeventdatabase.org \
  --dry-run

Remarques:

• Les sources sont branchées de façon minimaliste (exemples). Brancher des sources plus riches selon besoin.
• Conversion en format OEDB: évènements non localisés (Point [0,0]) par défaut, online=yes pour journées mondiales.