Quick Start

Utilisation de base

from tburundigeo import (
    get_all_provinces,
    get_all_communes,
    get_all_zones,
    get_province_capital,
    get_commune_capital,
    get_zone_chief_town
)

# Lister toutes les provinces avec leurs capitales
provinces = get_all_provinces()
for province in provinces:
    print(f"{province.name} - Capitale: {province.capital}")

# Obtenir la capitale d'une province spécifique
capital = get_province_capital("BI-PR-01")
print(f"Capitale de Bujumbura Mairie: {capital}")

# Obtenir le chef-lieu d'une zone
chief_town = get_zone_chief_town("BI-ZO-01-01-01")
print(f"Chef-lieu: {chief_town}")

Utilisation de la CLI

# Lister les provinces avec capitales
tburundigeo provinces list --with-capitals

# Lister les communes avec capitales
tburundigeo communes list --with-capitals

# Lister les zones avec chefs-lieux
tburundigeo zones list --with-chief-towns

# Exporter en JSON
tburundigeo provinces list --format json --with-capitals

# Rechercher des entités
tburundigeo provinces search "Bujumbura"
tburundigeo communes search "Gitega" --by capital