oedb-backend/extractors/README_extractor_events.md
2025-10-10 17:45:23 +02:00

39 lines
1.2 KiB
Markdown

# 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
```bash
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
```bash
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.