cornelioteixeira/angola_geo

iblioteca Python completa e CLI para divisões administrativas de Angola (Províncias, Municípios, Comunas) conforme a Lei n.º 14/24. 🇦🇴 # Angola Geolocation Library 🇦🇴 Biblioteca Python completa para trabalhar com as divisões administrativas de Angola de acordo com a **Lei 14/24** (vigente desde 1 de Janeiro de 2025). ## Características - ✅ **21 Províncias** com metadados completos - ✅ **326 Municípios** organizados por província - ✅ **378 Comunas** (estrutura de dados pronta) - 🔍 Funcionalidade de pesquisa para localizações - 🎯 Filtrar por província, município ou distrito - 📊 Dados estruturados em JSON limpo - 🐍 Type hints para melhor suporte de IDE - 📚 Documentação abrangente em português ## Instalação ```bash pip install angola-geo ``` ## Início Rápido ```python from angola_geo import AngolaGeo # Inicializar a biblioteca geo = AngolaGeo() # Listar todas as províncias provincias = geo.listar_provincias() print(f"Total de províncias: {len(provincias)}") # 21 # Obter uma província específica luanda = geo.obter_provincia("Luanda") print(f"Capital: {luanda['capital']}") # Ingombota print(f"Municípios: {luanda['total_municipios']}") # 16 # Listar municípios de uma província municipios_luanda = geo.listar_municipios(provincia="Luanda") print(f"Luanda tem {len(municipios_luanda)} municípios") # Pesquisar localizações resultados = geo.pesquisar("Bengo") # Retorna correspondências de províncias, municípios e comunas # Listar todos os municípios todos_municipios = geo.listar_municipios() print(f"Total de municípios: {len(todos_municipios)}") # 326 ``` ## Ferramenta CLI A biblioteca inclui uma ferramenta de linha de comando para consultas rápidas: ```bash # Informações do dataset angola-geo info # Listar todas as províncias angola-geo listar provincias # Obter detalhes de uma província angola-geo obter provincia Luanda # Listar municípios de uma província angola-geo listar municipios --provincia Luanda # Pesquisar localizações angola-geo pesquisar Bengo # Ver as novas províncias angola-geo novas ``` **Veja o CLI_GUIDE.md para documentação completa da CLI.** ## Estrutura dos Dados …