Dadosabertosbrasil

A versão 0.2 do **DadosAbertosBrasil** trás uma extensa reestruturação em quase todas as funções disponíveis na versão 0.1.
As princiais são a expansão da documentação, funções `lista` para consulta de códigos identificadores, mais parâmetros de consulta e novas classes.

Documentação
- Adição de **Docstring** e **Type Hinting** em todas as funções e classes do pacote;
- [Nova documentação](https://www.gustavofurtado.com/DadosAbertosBrasil/index.html) gerada via [pdoc](https://pdoc3.github.io/pdoc/);
- Inclusão de Mini-Tutoriais em cada módulo do pacote que podem ser acessados com a função `help( ... )`.

DadosAbertosBrasil.[ipea](https://www.gustavofurtado.com/DadosAbertosBrasil/ipea.html)
- Funções `lista` para consulta de parâmetros;
- Classe `Serie` que captura atributos e valores da série.

DadosAbertosBrasil.[ibge](https://www.gustavofurtado.com/DadosAbertosBrasil/ibge.html)
- Troca do termo "Agregado" por "Tabela";
- Funções `lista_tabelas` e `lista_pesquisas`;
- Classe `Metadados` para captura de parâmetros de uma tabela SIDRA;
- Função `sidra` reestrutura com novos parâmetros. Agora ela retorna um pandas.DataFrame ao invés de um dicionário.

DadosAbertosBrasil.[camara](https://www.gustavofurtado.com/DadosAbertosBrasil/camara.html)
- Todas as consultas foram transformadas em classes com atributos e métodos para pesquisas mais especificas e detalhadas;
- Funções `lista` para consulta de códigos identificadores.

DadosAbertosBrasil.[senado](https://www.gustavofurtado.com/DadosAbertosBrasil/senado.html)
- Classe `Senador` com atributos e métodos para coleta de informações detalhadas.
- Funções `lista` para encontrar código identificador dos senadores.

Outros
- Nova classe `DadosAbertosBrasil.API` serve como wrapper de requisição dos outros pacotes e pode ser acessado diretamente pelo usuário que desejar.
- Novas funções no módulo [DadosAbertosBrasil.favoritos](https://www.gustavofurtado.com/DadosAbertosBrasil/favoritos.html).

Esta versão (0.1.3) do pacote **[DadosAbertosBrasil](https://www.gustavofurtado.com/dab.html)** trás uma reformulação completa do módulo **senado**, além da implementação de algumas boas práticas no código.

Changelog:

DadosAbertosBrasil.senado:

- O pacote **senado** agora realiza o request em *JSON*, ao invés de *XML*. Logo, a importação do pacote **xml** e as classes para converter a *ElementTree* em *dict* se tornaram desnecessárias e foram removidas;
- Criação da classe **senado.Lista** que substitui o antigo método **senado.lista**. Esta classe possui os métodos **atual**, **afastados** e **legislatura**, que permite uma busca mais precisa e intuitiva da lista de senadores;
- Criação da classe **senado.Senadores** que substitui o antigo método **senado.senador**. Esta classe possui vários métodos e parâmetros de busca para obter informações detalhadas dos senadores;
- Expansão da função **senado.partidos**, que agora retorna em formato *DataFrame* e possui filtro de partidos ativos e inativos.

Geral:

- Maior atenção ao **[PEP 8](https://www.python.org/dev/peps/pep-0008/)**;
- Adição de **[Type Hints](https://www.python.org/dev/peps/pep-0484/)** em todos os métodos e classes do pacote;
- Adição de **[Docstrings](https://www.python.org/dev/peps/pep-0257/)** em todos os métodos e classes do pacote. Nos próximos releases os Docstrings serão reescritos para estarem de acordo com padrões praticados na comunidade;

Update curto para ressuscitar o projeto:
- Nova função tse.perfil_eleitorado;
- Nova função favoritos.codigos_municipios;
- Correções gerais

O novo release (0.1.1) do pacote **[Dados Abertos Brasil](https://www.gustavofurtado.com/dab.html)** trás uma prévia dos módulos que devem surgir nas versões 0.2 e 0.3.

- Módulo **senado**: Inclui algumas das funções disponível na **[API do Senado Federal](http://legis.senado.gov.br/dadosabertos/docs/)**. Entre elas estão:
- senado.**lista**: Coleta a lista de senadores atuais e afastados;
- senado.**partidos**: Coleta os partidos dos senadores;
- senado.**Senador**: Classe que coleta as informações completas de um senador.

- Módulo **tse**: Baixa e extrai os arquivos do **[Repositório de Dados Eleitorias](http://www.tse.jus.br/eleicoes/estatisticas/repositorio-de-dados-eleitorais-1/repositorio-de-dados-eleitorais)**. Inclui classes para coleta de dados por partido, candidato, zona e seção eleitoral, como:
- tse.**VotacaoPartidoMunZona**
- tse.**VotacaoCandidatoMunZona**
- tse.**DetalheVotacaoSecao**
- tse.**DetalheVotacaoMunZona**

- Módulo **_utils**: Apresenta uma coletânea de funções de suporte para os outros módulos do pacote. No momento, só inclui uma função:
- _utils.**parse_uf**: Faz um mapping simples para converter nomes de estados nas siglas de duas letras maiúsculas. Com isso, para qualquer função que exija que o usuário informe uma UF, ele poderá inserir tanto a sigla do estado, quanto o nome completa, com letras maiúsculas ou minúsculas, com ou sem acentos e com qualquer quantidade de espaços.

Além disso, foram feitas algumas atualizações nos módulos já existentes:
- Expansão da classe `camara.Deputado`, que agora permite adicionar parâmetros de busca para a query de coleta de dados de deputados;
- Substituição dos pacotes `urllib` e `json` no módulo `camara` pelo pacote `requests`;
- Adição da função `favoritos.geojson` que coleta as coordenadas (latitude e longitude) do perímetro dos municípios. Ideal para desenhar mapas precisos.
- Adição de `Future Warnings` para os pacotes nos estágios iniciais de desenvolvimento.

Dados Abertos Brasil é uma iniciativa para facilitar o acesso a dados abertos e APIs do governo brasileiro.

É um pacote open-source para Python e Pandas e a forma mais simples de acessar dados de instituições como IGBE, IPEA , etc.

Atualmente o pacote Dados Abertos Brasil possui quatro módulos:

- DadosAbertosBrasil.[ibge](https://www.gustavofurtado.com/doc.html#SessaoIBGE)
- DadosAbertosBrasil.[ipea](https://www.gustavofurtado.com/doc.html#SessaoIPEA)
- DadosAbertosBrasil.[camara](https://www.gustavofurtado.com/doc.html#SessaoCamara)
- DadosAbertosBrasil.[favoritos](https://www.gustavofurtado.com/doc.html#SessaoFavoritos)

Sobre
- [Página Oficial](https://www.gustavofurtado.com/dab.html)
- [Documentação](https://www.gustavofurtado.com/doc.html)

Dependências
- [pandas](https://pandas.pydata.org/)
- [requests](https://requests.readthedocs.io/en/master/)

Licença
- MIT