Package Python pour les données administratives du Burundi
# 🇧🇮 TBurundiGeo - Données Administratives du Burundi
---
**TBurundiGeo** est un package Python robuste et complet pour exploiter les données administratives du Burundi (provinces, communes, zones, quartiers) avec **leurs capitales et chefs-lieux respectifs**.
🏗️ **Architecture :** Hexagonale (Clean Architecture)
👨💻 **Développeur :** NIYOMWUNGERE Trésor (travail solo)
🏢 **Organisation :** TELONA
📜 **Conformité :** Loi organique n°1/C5 du 16 mars 2023
📊 **Données :** 3044 quartiers, 451 zones, 42 communes, 5 provinces
---
## 🌟 **Nouveautés - Capitales et Chefs-lieux !**
✅ **Capitales des provinces** : Accédez aux capitales de chaque province
✅ **Chefs-lieux des zones** : Obtenez les chefs-lieux de chaque zone
✅ **CLI enrichie** : Options `--with-capitals` et `--with-chief-towns`
✅ **API étendue** : Fonctions `get_province_capital()` et `get_zone_chief_town()`
✅ **Statistiques détaillées** : Analyse par entité administrative
✅ **Validation intégrée** : Vérification de l'intégrité des données
## 🚀 Installation
### Avec pip (recommandé)
```bash
pip install tburundigeo
```
### Avec uv (plus rapide)
```bash
uv add tburundigeo
```
### Installation avec fonctionnalités optionnelles
```bash
# Support pandas
pip install tburundigeo[pandas]
# Support YAML
pip install tburundigeo[yaml]
# CLI avec click
pip install tburundigeo[click]
# Toutes les fonctionnalités
pip install tburundigeo[all]
```
## 📋 Caractéristiques
- **🏛️ Capitales & Chefs-lieux** : Accès aux capitales des provinces et chefs-lieux des zones
- **🏗️ Architecture Hexagonale** : Séparation claire entre domaine, application et infrastructure
- **🔧 Principes SOLID** : Code maintenable, testable et extensible
- **🎯 API Intuitive** : Interface simple et homogène pour toutes les opérations
- **📝 Typage Strict** : 100% typé avec mypy
- **⚡ Zero Dependencies** : Aucune dépendance obligatoire à l'exécution
- **🧪 Tests Complets** : Couverture > 90% avec pytest
- **💻 CLI Puissante** : Interface en …