From 6c789455ac6724489c59848568eb8c1881010797 Mon Sep 17 00:00:00 2001
From: CoprDistGit
+
+
+
+
PyCEPCorreios
+ API para busca de CEP integrado ao serviços dos Correios, ViaCEP e ApiCEP (WideNet)
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Instalação | + Como Usar | + Como Contribuir | + Créditos +
+ + +## Instalação + +A PyCEPCorreios pode ser facilmente instalada com o comando a seguir: + +``` +pip install pycep-correios +``` + +Atualmente, a PyCEPCorreios possui suporte para Python 3.5+. + +## Como usar + +*A PyCEPCorreios foi desenvolvida para integração de consultas sob demandas em páginas web. A consulta de CEPs em massa através de *scripts* ou qualquer outros meios não é recomendada.* + +A PyCEPCorreios utiliza por padrão de consulta a API provida pelo serviço [ApiCEP](https://apicep.com/). Para utilização de outros serviços, devemos indica o serviço desejado ao chamar a função `get_address_from_cep`. O CEP sempre deve ser uma *string* e pode ou não conter pontuação. + +### Exemplo de consulta ao serviço *ApiCEP* (default): + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.APICEP) +``` + +### Exemplo de consulta ao serviço *ViaCEP*: + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.VIACEP) +``` + +### Exemplo de consulta ao serviço dos *Correios*: + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.CORREIOS) +``` + +**Obs.:** O serviço de busca de CEP dos Correios é parte integrante do serviço SIGEPWeb e para uso do mesmo é necessário ter contrato com os Correios, conforme indicado no capítulo *Introdução* presente no [manual de integração do serviço](http://www.corporativo.correios.com.br/encomendas/sigepweb/doc/Manual_de_Implementacao_do_Web_Service_SIGEP_WEB.pdf). + +### Retorno e Exceptions + +Independente do serviço escolhido, o formato de resposta sempre será um objeto `dict` contendo as seguintes chaves: + +```python +{ + 'bairro': 'str', + 'cep': 'str', + 'cidade': 'str', + 'logradouro': 'str', + 'uf': 'str', + 'complemento': 'str', +} +``` + +A PyCEPCorreios tambem dá suporte a um grupo de *exceptions* que podem ser utilizadas para tratamento de quaisquer erros que ocorram durante o processo de consulta. + +```python + +from pycep_correios import get_address_from_cep, WebService, exceptions + +try: + + address = get_address_from_cep('37503-130', webservice=WebService.APICEP) + +except exceptions.InvalidCEP as eic: + print(eic) + +except exceptions.CEPNotFound as ecnf: + print(ecnf) + +except exceptions.ConnectionError as errc: + print(errc) + +except exceptions.Timeout as errt: + print(errt) + +except exceptions.HTTPError as errh: + print(errh) + +except exceptions.BaseException as e: + print(e) + +``` + +## Como contribuir + +Deseja participar do desenvolvimento da PyCEPCorreios? Veja a *guideline* de contribuição [aqui](https://github.com/mstuttgart/pycep-correios/blob/develop/CONTRIBUTING.md). + +## Créditos + +Copyright (C) 2016-2022 por Michell Stuttgart + + + + +%package -n python3-pycep-correios +Summary: API para consulta de CEPs +Provides: python-pycep-correios +BuildRequires: python3-devel +BuildRequires: python3-setuptools +BuildRequires: python3-pip +%description -n python3-pycep-correios + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Instalação | + Como Usar | + Como Contribuir | + Créditos +
+ + +## Instalação + +A PyCEPCorreios pode ser facilmente instalada com o comando a seguir: + +``` +pip install pycep-correios +``` + +Atualmente, a PyCEPCorreios possui suporte para Python 3.5+. + +## Como usar + +*A PyCEPCorreios foi desenvolvida para integração de consultas sob demandas em páginas web. A consulta de CEPs em massa através de *scripts* ou qualquer outros meios não é recomendada.* + +A PyCEPCorreios utiliza por padrão de consulta a API provida pelo serviço [ApiCEP](https://apicep.com/). Para utilização de outros serviços, devemos indica o serviço desejado ao chamar a função `get_address_from_cep`. O CEP sempre deve ser uma *string* e pode ou não conter pontuação. + +### Exemplo de consulta ao serviço *ApiCEP* (default): + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.APICEP) +``` + +### Exemplo de consulta ao serviço *ViaCEP*: + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.VIACEP) +``` + +### Exemplo de consulta ao serviço dos *Correios*: + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.CORREIOS) +``` + +**Obs.:** O serviço de busca de CEP dos Correios é parte integrante do serviço SIGEPWeb e para uso do mesmo é necessário ter contrato com os Correios, conforme indicado no capítulo *Introdução* presente no [manual de integração do serviço](http://www.corporativo.correios.com.br/encomendas/sigepweb/doc/Manual_de_Implementacao_do_Web_Service_SIGEP_WEB.pdf). + +### Retorno e Exceptions + +Independente do serviço escolhido, o formato de resposta sempre será um objeto `dict` contendo as seguintes chaves: + +```python +{ + 'bairro': 'str', + 'cep': 'str', + 'cidade': 'str', + 'logradouro': 'str', + 'uf': 'str', + 'complemento': 'str', +} +``` + +A PyCEPCorreios tambem dá suporte a um grupo de *exceptions* que podem ser utilizadas para tratamento de quaisquer erros que ocorram durante o processo de consulta. + +```python + +from pycep_correios import get_address_from_cep, WebService, exceptions + +try: + + address = get_address_from_cep('37503-130', webservice=WebService.APICEP) + +except exceptions.InvalidCEP as eic: + print(eic) + +except exceptions.CEPNotFound as ecnf: + print(ecnf) + +except exceptions.ConnectionError as errc: + print(errc) + +except exceptions.Timeout as errt: + print(errt) + +except exceptions.HTTPError as errh: + print(errh) + +except exceptions.BaseException as e: + print(e) + +``` + +## Como contribuir + +Deseja participar do desenvolvimento da PyCEPCorreios? Veja a *guideline* de contribuição [aqui](https://github.com/mstuttgart/pycep-correios/blob/develop/CONTRIBUTING.md). + +## Créditos + +Copyright (C) 2016-2022 por Michell Stuttgart + + + + +%package help +Summary: Development documents and examples for pycep-correios +Provides: python3-pycep-correios-doc +%description help + +
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Instalação | + Como Usar | + Como Contribuir | + Créditos +
+ + +## Instalação + +A PyCEPCorreios pode ser facilmente instalada com o comando a seguir: + +``` +pip install pycep-correios +``` + +Atualmente, a PyCEPCorreios possui suporte para Python 3.5+. + +## Como usar + +*A PyCEPCorreios foi desenvolvida para integração de consultas sob demandas em páginas web. A consulta de CEPs em massa através de *scripts* ou qualquer outros meios não é recomendada.* + +A PyCEPCorreios utiliza por padrão de consulta a API provida pelo serviço [ApiCEP](https://apicep.com/). Para utilização de outros serviços, devemos indica o serviço desejado ao chamar a função `get_address_from_cep`. O CEP sempre deve ser uma *string* e pode ou não conter pontuação. + +### Exemplo de consulta ao serviço *ApiCEP* (default): + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.APICEP) +``` + +### Exemplo de consulta ao serviço *ViaCEP*: + + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.VIACEP) +``` + +### Exemplo de consulta ao serviço dos *Correios*: + +```python +from pycep_correios import get_address_from_cep, WebService + +address = get_address_from_cep('37503-130', webservice=WebService.CORREIOS) +``` + +**Obs.:** O serviço de busca de CEP dos Correios é parte integrante do serviço SIGEPWeb e para uso do mesmo é necessário ter contrato com os Correios, conforme indicado no capítulo *Introdução* presente no [manual de integração do serviço](http://www.corporativo.correios.com.br/encomendas/sigepweb/doc/Manual_de_Implementacao_do_Web_Service_SIGEP_WEB.pdf). + +### Retorno e Exceptions + +Independente do serviço escolhido, o formato de resposta sempre será um objeto `dict` contendo as seguintes chaves: + +```python +{ + 'bairro': 'str', + 'cep': 'str', + 'cidade': 'str', + 'logradouro': 'str', + 'uf': 'str', + 'complemento': 'str', +} +``` + +A PyCEPCorreios tambem dá suporte a um grupo de *exceptions* que podem ser utilizadas para tratamento de quaisquer erros que ocorram durante o processo de consulta. + +```python + +from pycep_correios import get_address_from_cep, WebService, exceptions + +try: + + address = get_address_from_cep('37503-130', webservice=WebService.APICEP) + +except exceptions.InvalidCEP as eic: + print(eic) + +except exceptions.CEPNotFound as ecnf: + print(ecnf) + +except exceptions.ConnectionError as errc: + print(errc) + +except exceptions.Timeout as errt: + print(errt) + +except exceptions.HTTPError as errh: + print(errh) + +except exceptions.BaseException as e: + print(e) + +``` + +## Como contribuir + +Deseja participar do desenvolvimento da PyCEPCorreios? Veja a *guideline* de contribuição [aqui](https://github.com/mstuttgart/pycep-correios/blob/develop/CONTRIBUTING.md). + +## Créditos + +Copyright (C) 2016-2022 por Michell Stuttgart + + + + +%prep +%autosetup -n pycep-correios-5.1.0 + +%build +%py3_build + +%install +%py3_install +install -d -m755 %{buildroot}/%{_pkgdocdir} +if [ -d doc ]; then cp -arf doc %{buildroot}/%{_pkgdocdir}; fi +if [ -d docs ]; then cp -arf docs %{buildroot}/%{_pkgdocdir}; fi +if [ -d example ]; then cp -arf example %{buildroot}/%{_pkgdocdir}; fi +if [ -d examples ]; then cp -arf examples %{buildroot}/%{_pkgdocdir}; fi +pushd %{buildroot} +if [ -d usr/lib ]; then + find usr/lib -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/lib64 ]; then + find usr/lib64 -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/bin ]; then + find usr/bin -type f -printf "/%h/%f\n" >> filelist.lst +fi +if [ -d usr/sbin ]; then + find usr/sbin -type f -printf "/%h/%f\n" >> filelist.lst +fi +touch doclist.lst +if [ -d usr/share/man ]; then + find usr/share/man -type f -printf "/%h/%f.gz\n" >> doclist.lst +fi +popd +mv %{buildroot}/filelist.lst . +mv %{buildroot}/doclist.lst . + +%files -n python3-pycep-correios -f filelist.lst +%dir %{python3_sitelib}/* + +%files help -f doclist.lst +%{_docdir}/* + +%changelog +* Tue Apr 11 2023 Python_Bot