Método para busca de dados de CEP no webservice dos Correios
Project description
PyCEP Correios
O PyCEP Correios faz uso do webservice dos correios para efetuar a busca de um dado CEP fornecido pelo usuário. O retorno dessa consulta é o endereço pertencente ao CEP.
Instalação
O PyCEP Correios pode ser facilmente instalado com o comando a seguir:
pip3 install pycep-correios
Como usar
Consultar o endereço de um CEP é muito simples com o PyCEPCorreios. Não importa se o CEP fornecido possui hífen ou ponto. O PyCEPCorreios trata a entrada garantindo uma entrada válida para o webservice dos Correios. Veja os exemplos a seguir:
from pycep_correios.correios import Correios
from pycep_correios.correios_exceptions import CorreiosCEPInvalidCEPException
# Tambem pode ser usado .get_cep('37503130')
endereco = Correios.get_cep('37503130')
print(endereco['rua'])
print(endereco['bairro'])
print(endereco['cidade'])
print(endereco['complemento'])
print(endereco['uf'])
print(endereco['outro'])
# Terceiro exemplo, usando o mesmo cep usado anteriormente, porém com hífen e ponto.
endereco = Correios.get_cep('37.503-130')
print(endereco['rua'])
print(endereco['bairro'])
print(endereco['cidade'])
print(endereco['complemento'])
print(endereco['uf'])
print(endereco['outro'])
# Quarto exemplo, enviamos um cep incorreto, com o numero de digitos inferior a 8.
try:
endereco = Correios.get_cep('37.50-130')
except CorreiosCEPInvalidCEPException as exc:
print(exc.message)
Aviso de bugs, dúvidas e sugestões
Para dúvidas, sugestões e relatórios de bugs, por gentileza, crie uma issue:
Issue Tracker: https://github.com/mstuttgart/pycep-correios/issues
Contribuidores
Meus agradecimentos aos seguintes contribuidores:
Créditos
Copyright (C) 2015-2017 por Michell Stuttgart Faria
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for pycep_correios-1.1.6-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3948e9df1173902b4c928c5ae2d8bfa730d933321c7bc36330c95f47344c1e97 |
|
MD5 | 5ebf51abd46ac9082f755ed92a55f717 |
|
BLAKE2b-256 | 78d6573e24b60734ccd07ce67f605e6c0d9697aa2411b724467cebead3499686 |