Metadata-Version: 2.4
Name: PyCepBR
Version: 1.1
Summary: Buscar informações de locais do Brasil por CEP ou Informações adicionais.
Author: Jefferson Silva
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests==2.32.5
Requires-Dist: requests-toolbelt==1.0.0
Dynamic: author
Dynamic: description
Dynamic: description-content-type
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# PyCep

Biblioteca criada com o intuito de facilitar a busca de localizaÃ§Ãµes em todo o Brasil, seja por CEP ou outros dados.

[Meu GitHub](https://github.com/silvaphb)

## Agilidade com poucas linhas

A biblioteca pode ser utilizada com apenas 3 linhas de codigos! Ja entregando oque ela pode oferecer de melhor. Veja um exemplo abaixo:

```
from PyCepBR import BuscarCEP

buscador = BuscarCEP()
resultado = buscador.porCep('64207203', texto=True)
print(resultado)
```

# Como instalar?

Rode esse comando em seu terminal:
```
pip install PyCepBR
```

## Como usar?

Inicialmente nesta versÃ£o Ã© oferecido dois tipos de busca de localidades. A primeira Ã© a por CEP, retornando em texto ou dicionario as informaÃ§Ãµes dessa localidade (Ex: Rua, Cidade, Bairro, Unidade...) e a segunda Ã© por 3 informaÃ§Ãµes, rua, cidade e uf. Abaixo serÃ¡ possivel visualizar a forma de utilizaÃ§Ã£o das duas formas de busca:

```
from PyCepBR import BuscarCEP

buscador = BuscarCEP()

# Buscar por cep
resultado = buscador.porCep('64207203', texto=True)
print(resultado)

# Buscar por InformaÃ§Ãµes
resultados = buscador.porInfo(rua='Prudente de Moraes', cidade='Parnaiba', uf='PI', texto=True)
print(resultados)
```

Se vocÃª notar nas duas formas tem o parametro `texto`. Ele Ã© utilizado para definir qual vai ser o tipo de resposta da requisiÃ§Ã£o, se for `True` ele retorna um texto formatado completo, se for `False` (definido por padrÃ£o) ele retorna um dicionario com as informaÃ§Ãµes (Normalmente o dicionario entrega mais dados que o texto).

# Historia do PyCep

Inicialmente um simples codigo feito no celular utilizando o PyDroid 3, por volta de 2023. Hoje em dia (2026) estou no curso de Desenvolvimento de Sistemas e voltei a ativa no meu GitHub para criaÃ§Ã£o de portfolio e armazenar oque eu for fazendo, como primeiro projeto dessa mudanÃ§a foi aprimorar/refazer aquele codigo e disponibilizar para todos instalarem no Pypi. Espero que ajude! AtÃ© a proxima.
