À propos du projet

# odp-stockholm Un client Python asynchrone pour les jeux de données ouverts de Stockholm, Suède. Il communique avec l'API de la plateforme Open Data de la ville afin que les applications Python puissent extraire des jeux de données sans avoir à écrire manuellement des requêtes HTTP. ## Ce qu'il fait Le package a été initialement conçu pour récupérer uniquement des données de stationnement, mais la base de code est délibérément organisée pour que d'autres jeux de données de la même plateforme puissent être ajoutés ultérieurement. Le README documente actuellement un jeu de données : - **Parkings handicapés** (rörelsehindrade förare med särskilt tillstånd) — environ 2045 emplacements. ## Exigences et accès L'utilisation des données nécessite une clé API, qui peut être demandée sur le site web de la plateforme. Le projet cible Python 3.12 ou une version ultérieure et est distribué sur PyPI sous le nom `odp-stockholm`. ## Installation et utilisation ```bash pip install odp-stockholm ``` Le client est utilisé comme un gestionnaire de contexte asynchrone. L'exemple documenté instancie `ParkingStockholm` avec une clé API et appelle `disabled_parkings(limit=10)`, en affichant les emplacements retournés. ## Champs du jeu de données Les requêtes acceptent un paramètre `limit` (par défaut 10). Les enregistrements retournés incluent : - `location_id`, `location_type`, `number` de places de parking - `street`, `address`, `district` - `parking_rate` et `parking_rules` (une URL vers les réglementations de stationnement de Stockholm) - `valid_from` et `valid_to` (ce dernier peut être `None`) - `coordinates` sous forme de liste de flottants ## Configuration du développement Le projet utilise Poetry pour la gestion des dépendances et peut être ouvert dans un Dev Container VS Code ou un GitHub CodeSpace. Les commits sont analysés et testés via le framework de hooks `prek` (`poetry run prek install`, `poetry run prek run --all-files`). Les tests utilisent pytest, y compris des tests de snapshot syrupy qui peuvent être actualisés avec `poetry run pytest --snapshot-update`. ## Licence Publié sous la licence MIT, copyright Klaas Schoute (2023–2026). ## Notes pour les évaluateurs Il s'agit d'une bibliothèque d'accès aux données ciblée plutôt que d'une application complète : sa valeur réside dans la fourniture d'un accès asynchrone et typé à une source de données ouvertes municipales et d'un modèle pouvant être étendu à d'autres jeux de données de Stockholm. Il n'est ni affilié ni approuvé par la ville de Stockholm ; les utilisateurs fournissent leur propre clé API et sont soumis aux conditions de la plateforme.