Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

API para busca de CEP no webservice dos Correios

Project description

PyCEPCorreios

https://img.shields.io/travis/mstuttgart/pycep-correios/develop.svg?style=flat-square https://img.shields.io/coveralls/mstuttgart/pycep-correios/develop.svg?style=flat-square https://landscape.io/github/mstuttgart/pycep-correios/develop/landscape.svg?style=flat-square https://img.shields.io/pypi/v/pycep-correios.svg?style=flat-square https://img.shields.io/pypi/pyversions/pycep-correios.svg?style=flat-square https://img.shields.io/pypi/l/pycep-correios.svg?style=flat-square

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 (também disponível em Inglẽs):

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.4+.

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:

Como contribuir

Deseja participar do desenvolvimento da PyCepCorreios? Torne-se um contribuidor do PyCEPCorreios! visite a documentação para verificar a guideline de contribuição:

Contribuidores

Agradecimentos aos seguintes contribuidores pelo esforço de fazer a PyCEPCorreios melhor:

Créditos

Copyright (C) 2016-2018 por Michell Stuttgart Faria

Histórico

2.3.1 (2018-05-03)

  • Corrige README.rst
  • Adiciona comando para validação dpo setup.py no Makefile
  • Corrige link do repositorio e donwload

2.3.0 (2018-05-03)

  • Adiciona logging para consulta de CEP
  • Adiciona documentação em inglês
  • Versão requirida das libs requests e da Jinja2 limitadas por baixo, para fins de compatibilidade
  • Remove suporte para Python 3.3

2.2.0 (2017-07-16)

2.1.1 (2017-06-30)

  • Correção de erros de unicode com python2.7

2.1.0 (2017-06-29)

  • Adicionado suporte para Python 2.7+
  • Ajustes e correções na documentação

2.0.0 (2017-06-20)

  • Atualização do código da PyCEPCorreios, deixando-a mais facil de ser utilizada
  • Remoção das exceções antigas, deixando apenas a Exceção padrão da lib
  • Remoção da classe PyCEPCorreios
  • Alteração dos imports da lib para facilitar seu uso e diminuir tamanho dos imports
  • Adicionado documentação com Sphinx
  • Adicionado testes com TOX
  • Adicionado método de validação de CEP e formatação de CEP

1.1.7 (2017-05-09)

  • Corrigido erro jinja2.exceptions.TemplateNotFound: consultacep.xml
  • Erro durante instalação da PyCEPCorreios via pip
  • Atualizado código de exemplo no README.rst
  • Atualizado exemplos na documentação

1.1.6 (2017-05-08)

  • Correção de bug durante instalação. #15
  • Correção de template xml ausente no pacote do modulo
  • Melhorias gerais no código e correções de bugs

1.1.1 (2017-02-08)

  • Melhorias gerais no código
  • XML schema utilizando Jinja2

1.0.1 (2016-08-03)

  • Simplificação da classes Exceptions
  • Organização do código de teste
  • Utilização do mock para test

1.0.0 (2016-07-31)

  • API migrada para Python 3. Python 2.7 não será mais suportado
  • Substituição da lib suds pela lib requests para realizar as requisições

0.0.2 (2016-05-09)

  • setup.py com número de versão atualizado e dependência corrigidas.

0.0.1 (2016-05-05)

  • Versão inicial.
  • Permite busca no webservice dos correios dos dados de um CEP fornecido.

Project details


Release history Release notifications

This version
History Node

2.3.1

History Node

2.3.0

History Node

2.2.0

History Node

2.1.1

History Node

2.1.0

History Node

2.0.0

History Node

1.1.7

History Node

1.1.6

History Node

1.1.5

History Node

1.1.4

History Node

1.1.3

History Node

1.0.1

History Node

1.0.0

History Node

0.0.2

History Node

0.0.1.1

History Node

0.0.1

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
pycep_correios-2.3.1-py2.py3-none-any.whl (8.1 kB) Copy SHA256 hash SHA256 Wheel py2.py3 May 3, 2018
pycep_correios-2.3.1.tar.gz (54.2 kB) Copy SHA256 hash SHA256 Source None May 3, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page