https://github.com/leogregianin/viacep-python

:mailbox: :snake: Buscar informações do CEP com o webservice do site http://www.viacep.com.br
https://github.com/leogregianin/viacep-python

cep python

Last synced: about 18 hours ago
JSON representation

:mailbox: :snake: Buscar informações do CEP com o webservice do site http://www.viacep.com.br

• Host: GitHub
• URL: https://github.com/leogregianin/viacep-python
• Owner: leogregianin
• License: mit
• Created: 2016-03-29T15:34:45.000Z (over 8 years ago)
• Default Branch: main
• Last Pushed: 2021-03-23T00:38:26.000Z (over 3 years ago)
• Last Synced: 2024-11-02T15:52:00.078Z (6 days ago)
• Topics: cep, python
• Language: Python
• Homepage:
• Size: 16.6 KB
• Stars: 45
• Watchers: 7
• Forks: 16
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# ViaCEP em Python

[![PyPI version](https://badge.fury.io/py/viacep.svg)](https://badge.fury.io/py/viacep)

[![Build Status](https://travis-ci.org/leogregianin/viacep-python.svg)](https://travis-ci.org/leogregianin/viacep-python)

[![codecov](https://codecov.io/gh/leogregianin/viacep-python/branch/master/graph/badge.svg)](https://codecov.io/gh/leogregianin/viacep-python)

Buscar informações do CEP com o webservice do site http://www.viacep.com.br

## Pré requisitos

  * Instalação de qualquer versão do Python (http://www.python.org/download)

  

## Instalação das dependências

```bash

$ pip install -r requirements.txt

```

## Utilização

```bash

>>> import viacep

>>> d = viacep.ViaCEP('78048000')

>>> data = d.getDadosCEP()

>>> data

{'cep': '78048-000', 'logradouro': 'Avenida Miguel Sutil', 'complemento': 'de 5686 a 6588 - lado par', 'bairro': 'Alvorada', 'localidade': 'Cuiabá', 'uf': 'MT', 'unidade': '', 'ibge': '5103403', 'gia': ''}

>>> data['localidade']

'Cuiabá'

>>> data['uf']

'MT'

>>> data.keys()

dict_keys(['cep', 'logradouro', 'complemento', 'bairro', 'localidade', 'uf', 'unidade', 'ibge', 'gia'])

>>> data.values()

dict_values(['78048-000', 'Avenida Miguel Sutil', 'de 5686 a 6588 - lado par', 'Alvorada', 'Cuiabá', 'MT', '', '5103403', ''])

>>>

```

## Testes unitários

---------

```bash

$ python .\test_viacep.py

.....

----------------------------------------------------------------------

Ran 5 tests in 0.984s

OK

```

## Exemplo com Python Flask

* https://github.com/leogregianin/viacep-flask

* https://viacep-flask.herokuapp.com

## Licença

-------

[Licença MIT](LICENSE)