DadosAbertosBrasil v0.3.0

Atualização final da versão 0.3 do DadosAbertosBrasil.

Adições

• Conclusão do módulo bacen com a nova função expectativas, para coleta de expectativas de mercado de diversos indicadores:

    >>> bacen.expectativa(expectativa='mensal', indicador='IGP-M')

          Indicador        Data DataReferencia  Media  Mediana  DesvioPadrao  \
    0         IGP-M  2021-06-25        07/2022   0.31     0.30          0.21  \
    1         IGP-M  2021-06-25        07/2021   0.64     0.61          0.42  \
    2         IGP-M  2021-06-25        06/2021   1.25     1.10          0.58  \
    3         IGP-M  2021-06-25        11/2022   0.47     0.47          0.16  \
    4         IGP-M  2021-06-25        11/2021   0.50     0.50          0.24  \
    ...         ...         ...            ...    ...      ...           ...  \

    >>> bacen.expectativa(
    ...     expectativa = 'trimestral',
    ...     indicador = 'PIB Total',
    ...     top = 3,
    ...     ordenar_por = 'Media',
    ...     asc = True
    ... )

       Indicador        Data DataReferencia  Media  Mediana  DesvioPadrao  \
    0  PIB Total  2020-06-02         2/2020 -14.00    -14.0          3.92  \
    1  PIB Total  2020-06-09         2/2020 -14.00    -13.4          3.55  \
    2  PIB Total  2020-06-01         2/2020 -13.99    -14.0          3.91  \

• Função favoritos.brasao que gera a URL para a imagem do brasão da UF desejada, construída nos moldes da função favoritos.bandeiras:

    >>> favoritos.brasao(uf='SC', tamanho=200)

    'https://upload.wikimedia.org/wikipedia/commons/thumb/1/1a/' ...

• Protótipo da classe UF que consolidará informações e indicadores da Unidade Federativa desejada. Será expandido e modificado nas próximas versões do DadosAbertosBrasil:

>>> from DadosAbertosBrasil import UF
>>> sp = UF('SP')

>>> sp.nome
'São Paulo'

>>> sp.governador
'João Dória'

>>> sp.populacao()
46653239

Os métodos e atributos disponíveis no momento para a classe `UF` são:
- sigla
- cod
- nome
- area
- capital
- extinto
- gentilico
- lema
- regiao
- governador
- vice-governador
- bandeira( )
- brasao( )
- densidade( )
- deputados( )
- geojson( )
- malha( )
- municipios( )
- populacao( )
- senadores( )

Documentação

• Adição de exemplos ao docstring de todas as funções e classes;
• Melhoria e correções no formato dos docstrings;
• Atualização da página oficial da documentação.

---

Desde o início do desenvolvimento da versão 0.3, o pacote DadosAbertosBrasil recebeu as seguintes atualizações:

• Subpacote auxiliar _utils, contendo os módulos:
  • parse para padronização de argumentos das funções;
  • errors contendo Exceptions customizadas;
  • get_data contendo a função de coleta de dados.
• Módulo bacen para coleta de dados das APIs do Banco Central:
  • cambio para cotações de várias moedas;
  • moedas para listar as moedas;
  • serie que busca qualquer série temporal do SGS;
  • expectativas para buscar as expectativas de mercado de diversos indicadores econômicos.
• O módulo favoritos agora é iniciado pelo __init__ e possui novas funções:
  • ipca
  • selic
  • taxa_referencial
  • rentabilidade_poupanca
  • reservas_internacionais
  • risco_brasil
  • salario_minimo
• Expansão da documentação e adição de exemplos em todas as funções e classes.
• Correções de bugs e typos.

DadosAbertosBrasil v0.2.3

Esta nova versão (0.2.3) expande significativamente os módulo bacen e favoritos, além de melhorias estruturais do pacote.

Changelog

DadosAbertosBrasil.bacen

• Nova função bacen.serie para capturar dados do Sistema Gerenciador de Séries Temporais do Banco Central:

>>> bacen.serie(cod=432, inicio='2010-01-01', fim='2021-01-01')
...            data valor
... 0    2010-01-01  8.75
... 1    2010-01-02  8.75
... 2    2010-01-03  8.75
... 3    2010-01-04  8.75
... 4    2010-01-05  8.75
... ...         ...   ...

• Adição dos argumentos cotacao e boletim na função bacen.cambio:

>>> bacen.cambio(
>>>     moedas = ['USD', 'CAD'],
>>>     inicio = '2021-01-01',
>>>     fim = '2021-01-10',
>>>     cotacao = 'venda',
>>>     boletim = 'abertura',
>>>     index = True
>>> )
...                USD     CAD
... Data                      
... 2021-01-04  5.1402  4.0500
... 2021-01-05  5.3405  4.1890
... 2021-01-06  5.3013  4.1798
... 2021-01-07  5.3174  4.1833
... 2021-01-08  5.3612  4.2237

DadosAbertosBrasil.favoritos

Adição de várias funções ao módulo favoritos que aproveitam a estrutura das funções bacen.serie e ipea.serie:

- favoritos.ipca
- favoritos.selic
- favoritos.taxa_referencial
- favoritos.rentabilidade_poupanca
- favoritos.reservas_internacionais
- favoritos.risco_brasil
- favoritos.salario_minimo

• Todas as funções do módulo favoritos agora são importadas diretamente pelo __init__ do pacote DadosAbertosBrasil.
  Essa mudança visa dedicar o módulo favoritos a funções de maior interesse público que, portanto, deveriam ter uma melhor acessibilidade.

# Antes
>>> from DadosAbertosBrasil import favoritos
>>> favoritos.ipca()

# Agora
>>> import DadosAbertosBrasil as dab
>>> dab.ipca()

Geral

• Opção de importar todos os submódulos ao importar o supermódulo DadosAbertosBrasil:

# Importando submódulos
>>> from DadosAbertosBrasil import ipea
>>> series = ipea.lista_series()

# Importando o supermódulo
>>> import DadosAbertosBrasil as dab
>>> series = dab.ipea.lista_series()

• Adição do método __repr__ a todas as classes do pacote DadosAbertosBrasil:

>>> from DadosAbertosBrasil import camara
>>> rodrigo_maia = camara.Deputado(74693)
>>> print(rodrigo_maia)
... DadosAbertosBrasil.camara: Deputado Rodrigo Maia

DadosAbertosBrasil v0.2.2

Esta é uma atualização (0.2.2) mais humilde do pacote DadosAbertosBrasil.

Changelog

• Nova função ipea.serie, que busca ser uma alternativa mais simples para a classe ipea.Serie;
• Adição de exemplos e comentários do docstring do módulo ipea;
• A função ibge.sidra agora aceita None no argumento classificacoes. Antes era necessário passar alguma classificação;
• Simplificação da função de coleta de dados via requests.

DadosAbertosBrasil v0.2.1

Esta versão (0.2.1) do pacote DadosAbertosBrasil cria a primeira versão três novos módulos: bacen, errors e parse.

Changelog

DadosAbertosBrasil.bacen

• Novo módulo que agrupará todas as funções de consulta dos dados do Banco Central do Brasil. Esse módulo foi criado pensando nas futuras expansões de coletas;
• Esse módulo herda as funções moedas, cambio e ipca do módulo favoritos.

DadosAbertosBrasil.favoritos

• O módulo favoritos doou todas suas funções do Banco Central do Brasil para o módulo bacen;
• Nova função favoritos.bandeira que retorna um link da WikiMedia das bandeiras das Unidades da Federação no tamanho desejado.

DadosAbertosBrasil._utils

• O antigo módulo _utils foi removido para abrir espaço para o pacote auxiliar _utils, que contará com os módulos errors e parse;
• O módulo _utils.errors apresenta Exceptions exclusivas para as funções do DadosAbertosBrasil;
• O módulo _utils.parse busca padronizar e facilitar os inputs das funções do DadosAbertosBrasil.

DadosAbertosBrasil v0.2.0

DadosAbertosBrasil v0.2

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 gerada via pdoc;
• Inclusão de Mini-Tutoriais em cada módulo do pacote que podem ser acessados com a função help( ... ).

DadosAbertosBrasil.ipea

• Funções lista para consulta de parâmetros;
• Classe Serie que captura atributos e valores da série.

DadosAbertosBrasil.ibge

• 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

• 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

• 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.

DadosAbertosBrasil v0.1.3

Esta versão (0.1.3) do pacote DadosAbertosBrasil 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;
• Adição de Type Hints em todos os métodos e classes do pacote;
• Adição de Docstrings 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;

DadosAbertosBrasil v0.1.2

Update curto para ressuscitar o projeto:

• Nova função tse.perfil_eleitorado;
• Nova função favoritos.codigos_municipios;
• Correções gerais

DadosAbertosBrasil v0.1.1

O novo release (0.1.1) do pacote Dados Abertos Brasil 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. 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. 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.

DadosAbertosBrasil v0.1

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
• DadosAbertosBrasil.ipea
• DadosAbertosBrasil.camara
• DadosAbertosBrasil.favoritos

Sobre

• Página Oficial
• Documentação

Dependências

• pandas
• requests

Licença

• MIT