pycep 1.0.3

Consulta CEPs em vários serviços (Correios, ViaCep, OpenCep) de maneira totalmente assíncrona

PyCEP

Consulta CEPs em vários serviços (Correios, ViaCep, OpenCep) de maneira totalmente assíncrona

Comece por aqui

Nesta seção você encontrará instruções de como instalar o pacote e também encontrará exemplos de uso

Requerimentos

Esse projeto é compatível com as versões 3.10, 3.11 e 3.12 do python no momento. A compatibilização com versões anteriores está prevista, e qualquer contribuição é bem vinda.

Instalação

PIP

pip install pycep

Poetry

poetry add pycep

Fazendo uma consulta

Tenha em mente que a lib vai retornar o serviço que responder mais rápido

from pycep import Cep

cep = Cep("75140070")

Acessando os dados da consulta

Você pode usar os atributos listados abaixo para acessar os dados do Cep:

from pycep import Cep

cep = Cep("75140070")

print(cep.number) # 75140070
print(cep.state) # GO
print(cep.city) # Anápolis
print(cep.street) # Rua Senador Mardocheu Diniz
print(cep.district) # Dom Pedro II
print(cep.query_service) #CorreiosService
print(cep.status) # query_done

Você também pode converter os dados para dict

from pycep import Cep

cep = Cep("75140070")
print(dict(cep))

{
 'street': 'Rua Senador Mardocheu Diniz',
 'district': 'Dom Pedro II',
 'city': 'Anápolis',
 'state': 'GO',
 'cep': '75140070',
 'provider': 'CorreiosService'
 }

Este projeto utiliza

• HttpX - Adapter padrão para requisições HTTP
• AioHTTP - Adapter alternativo para requisições HTTP
• Poetry - Gerenciamento de dependências e publicação
• Pytest - Testes automatizados

Autor

• Erick Duarte - Implementação inicial - erickod

Licença

O projeto está disponível através da licença MIT - Consulte o arquivo LICENSE.md para mais detalhes.