Skip to content

joepreludian/brasilapy

 
 

Repository files navigation

BrasilApy

Um cliente da Brasil API em python3. Link do repositório oficial.

codecov Quality Gate Status

Nesta versão 1.0.0 esse cliente possui suporte a autocomplete por meio de Typed Hints. Todos as respostas são traduzidas para objetos do Pydantic, que trazem previsibilidade ao explorar a API através da sua IDE favorita.

Instalação

Rode o comando pip install brasilapy e estará tudo pronto. A versão do python que é compativel com essa biblioteca é a 3.10+.

Documentação

Documentação oficial da API com todas as chamadas poderão se encontradas neste link.

Código de exemplo

Para efetuar as consultas na API, basta instanciar a classe e fazer as consultas.

from brasilapy import BrasilAPI

client = BrasilAPI()
estado = client.get_ibge_estado(state_uf="pb")

print(estado.id)
print(estado.regiao)
print(estado.sigla)

###
# para um caso mais complexo, temos
###
from brasilapy.constants import IBGEProvider

municipios = client.get_ibge_municipios(state_uf="pb", providers=(IBGEProvider.DADOS_ABERTOS_BR,))

for municipio in municipios:
    print(municipio.nome)
    print(municipio.codigo_ibge)

Métodos disponíveis do BrasilAPI

Método Detalhes
get_banks()
get_bank(code: str)
get_cep(test_cep: str, api_version: APIVersion)
get_cnpj(test_cnpj: str)
get_ddd(test_ddd: str)
get_feriados(year: int)
get_fipe_veiculos(tipo_veiculos: FipeTipoVeiculo, tabela_referencia: int)
get_fipe_precos(codigo_fipe: str, tabela_referencia: int)
get_fipe_tabelas()
get_ibge_municipios(state_uf: str, providers: tuple[IBGEProvider]
get_ibge_estados()
get_registro_br_domain(fqdn: str)
get_taxas_juros()
get_taxa_juros(taxa: TaxaJurosType)

Os tipos de dados APIVersion, FipeTipoVeiculo, IBGEProvider e TaxaJurosType são classes de constants que podem ser importadas através do seguinte comando:

from brasilapy.constants import APIVersion, FipeTipoVeiculo, IBGEProvider, TaxaJurosType

Autores

Filipe Soares Jonhnatha Trigueiro

Gostaria de contribuir?

Escrevemos um guia que pode ser encontrado em CONTRIBUTE.md.

About

Brasil API client

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 100.0%