PyCepBR 1.0__tar.gz

pycepbr-1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jefferson Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pycepbr-1.0/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: PyCepBR
+Version: 1.0
+Summary: # PyCep
+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-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary

pycepbr-1.0/PyCepBR/__init__.py

@@ -0,0 +1 @@
+from .main import BuscarCEP

pycepbr-1.0/PyCepBR/main.py

@@ -0,0 +1,79 @@
+from datetime import datetime
+import requests       
+ 
+class BuscarCEP():
+    def __init__(self):
+      self.criacao = datetime.now().strftime('%D')
+      self.usos = 0
+
+    def porInfo(self, rua: str = 'Avenida Paulista', cidade: str = 'Sao Paulo', uf: str = 'SP', texto: bool = False):
+       resultados = requests.get(f'https://viacep.com.br/ws/{uf}/{cidade}/{rua}/json/').json()
+       texto_locais = 'LOCALIZAÇÕES ENCONTRADAS:\n'
+       texto_locais += '---------------------------------------------------------------------\n'
+       lista_locais = []
+       id_atual = 0
+       for loc in resultados:
+          id = id_atual
+          cep = loc['cep']
+          logradouro = loc['logradouro']
+          unidade = loc['unidade']
+          bairro = loc['bairro']
+          uf = loc['uf']
+          regiao = loc['regiao']
+          ddd = loc['ddd']
+          ibge = loc['ibge']
+          lista_locais.append(
+            {
+               'id': id,
+               'cep': cep,
+               'logradouro': logradouro,
+               'unidade': unidade,
+               'bairro': bairro,
+               'uf': uf,
+               'regiao': regiao,
+               'ddd': ddd,
+               'ibge': ibge
+            }
+          )
+          id_atual += 1
+          texto_locais += f'ID: {id}\nCEP: {cep}\nLOGRADOURO (RUA): {logradouro}\nUNIDADE: {unidade}\nBAIRRO: {bairro}\nUF: {uf}\nDDD: {ddd}\nIBGE: {ibge}\n'
+          texto_locais += '---------------------------------------------------------------------\n'
+
+       texto_locais += f'Total de localizações encontradas: {id_atual}'
+       self.usos += 1
+
+       if texto:
+          return texto_locais
+       else:
+          return lista_locais
+    
+    def porCep(self, cep: str, texto: bool = False):
+       texto_result = 'LOCAL ENCONTRADO!\n'
+       resultado = requests.get(f'https://viacep.com.br/ws/{cep}/json/').json()
+       logradouro = resultado['logradouro']
+       unidade = resultado['unidade']
+       bairro = resultado['bairro']
+       uf = resultado['uf']
+       regiao = resultado['regiao']
+       ddd = resultado['ddd']
+       ibge = resultado['ibge']
+       texto_result += f'LOGRADOURO (RUA): {logradouro}\nUNIDADE: {unidade}\nBAIRRO: {bairro}\nUF: {uf}\nREGIAO: {regiao}\nDDD: {ddd}\nIBGE: {ibge}'
+       self.usos += 1
+
+       if texto:
+          return texto_result
+       else:
+          return resultado
+
+       
+
+    
+  
+ 
+  
+  
+#cep = BuscarCEP()
+#dados = cep.porInfo(texto=True)
+#dados = cep.porCep('64207013')
+#print(dados)
+  

pycepbr-1.0/PyCepBR.egg-info/PKG-INFO

@@ -0,0 +1,14 @@
+Metadata-Version: 2.4
+Name: PyCepBR
+Version: 1.0
+Summary: # PyCep
+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-content-type
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: summary

pycepbr-1.0/PyCepBR.egg-info/SOURCES.txt

@@ -0,0 +1,10 @@
+LICENSE
+README.md
+setup.py
+PyCepBR/__init__.py
+PyCepBR/main.py
+PyCepBR.egg-info/PKG-INFO
+PyCepBR.egg-info/SOURCES.txt
+PyCepBR.egg-info/dependency_links.txt
+PyCepBR.egg-info/requires.txt
+PyCepBR.egg-info/top_level.txt

pycepbr-1.0/PyCepBR.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pycepbr-1.0/PyCepBR.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests==2.32.5
+requests-toolbelt==1.0.0

pycepbr-1.0/PyCepBR.egg-info/top_level.txt

@@ -0,0 +1 @@
+PyCepBR

pycepbr-1.0/README.md

@@ -0,0 +1,48 @@
+# 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 PyCep import BuscarCEP
+
+buscador = BuscarCEP()
+resultado = buscador.porCep('64207203', texto=True)
+print(resultado)
+```
+
+# Como instalar?
+
+Rode esse comando em seu terminal:
+```
+pip install PyCep
+```
+
+## 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 PyCep 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.

pycepbr-1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pycepbr-1.0/setup.py

@@ -0,0 +1,18 @@
+from setuptools import setup, find_packages
+
+with open('README.md', 'r') as file:
+    description = file.read()
+
+setup(
+    name='PyCepBR',
+    version='1.0',
+    packages=find_packages(),
+    author='Jefferson Silva',
+    install_requires=[
+        # Requirements
+        'requests==2.32.5',
+        'requests-toolbelt==1.0.0'
+    ],
+    description=description,
+    long_description_content_type='text/markdown'
+)