andersonberg / pycep-correios

Busca CEP utilizando webservice SIGEPWEB dos Correios

PyCEPCorreios

API para consulta de CEP diretamente do webservice dos Correios.

Features

• Consulta de dados do endereço de um CEP
• Formatacao de CEP
• Validação de estrutura do CEP

Documentação

Para mais detalhes sobre a PyCEPCorreios, por gentileza, consulte a documentação oficial:

• Documentação online: https://pycep-correios.readthedocs.io.
• Documentação PDF: https://media.readthedocs.org/pdf/pycep-correios/stable/pycep-correios.pdf

Instalação

O PyCEP Correios pode ser facilmente instalado com o comando a seguir:

pip install pycep-correios

Atualmente, a PyCEPCorreios possui suporte para Python 2.7+ e 3.3+.

Como usar

Consultar o endereço de um CEP é muito simples com o PyCEPCorreios. Veja os exemplos a seguir:

>>> import pycep_correios

>>> endereco = pycep_correios.consultar_cep('37503130')
>>> print(endereco)
{
    'bairro': 'Santo Antônio',
    'cep': '37503130',
    'cidade': 'Itajubá',
    'end': 'Rua Geraldino Campista',
    'id': '0',
    'uf': 'MG',
    'complemento': '',
    'complemento2': '- até 214/215',
}

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

Créditos

Copyright (C) 2016-2017 por Michell Stuttgart Faria