Installation

Créer l’environnement

Version recommandée : Python 3.12. Le package accepte Python 3.10 à 3.12, mais exclut Python 3.13+ pour limiter les problèmes de compatibilité des dépendances géospatiales.

Depuis le dossier package-xyt-gps :

python3.12 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -r requirements-dev.txt

Pour lancer le notebook tutoriel :

python -m ipykernel install --user --name xyt-gps --display-name "Python (xyt-gps)"

Installer la documentation

Les dépendances de documentation sont séparées du noyau du package :

python -m pip install -r requirements-docs.txt

Lancer le site local :

mkdocs serve

Construire le site statique :

python -m mkdocs build

Pourquoi des extras séparés

Le cœur du package doit rester léger : pandas, geopandas, shapely.

Les bibliothèques d’export, de notebook, de test et de documentation sont installées seulement quand elles sont nécessaires.