diff options
| -rw-r--r-- | .gitignore | 1 | ||||
| -rw-r--r-- | python-pycep-correios.spec | 473 | ||||
| -rw-r--r-- | sources | 1 |
3 files changed, 475 insertions, 0 deletions
@@ -0,0 +1 @@ +/pycep_correios-5.1.0.tar.gz diff --git a/python-pycep-correios.spec b/python-pycep-correios.spec new file mode 100644 index 0000000..147e10a --- /dev/null +++ b/python-pycep-correios.spec @@ -0,0 +1,473 @@ +%global _empty_manifest_terminate_build 0 +Name: python-pycep-correios +Version: 5.1.0 +Release: 1 +Summary: API para consulta de CEPs +License: MIT License +URL: https://github.com/mstuttgart/pycep-correios +Source0: https://mirrors.nju.edu.cn/pypi/web/packages/5a/5a/0b4617a9d54575ec5047e45419f0a3233035d783a9ef925ddcf6ff97d38c/pycep_correios-5.1.0.tar.gz +BuildArch: noarch + +Requires: python3-requests +Requires: python3-zeep + +%description + +<p align="center"> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://raw.githubusercontent.com/mstuttgart/pycep-correios/develop/.img/logo.jpg" width="30%"> + </a> + <h3 align="center">PyCEPCorreios</h3> + <h4 align="center">API para busca de CEP integrado ao serviços dos Correios, ViaCEP e ApiCEP (WideNet)</h4> +</p> + +<p align="center"> + <a href="https://github.com/mstuttgart/pycep-correios/actions?query=workflow%3A%22Github+CI%22"> + <img src="https://img.shields.io/github/workflow/status/mstuttgart/pycep-correios/Github%20CI/develop?label=Github%20CI&logo=Github&style=flat-square" alt="Version"> + </a> + <a href="https://coveralls.io/github/mstuttgart/pycep-correios"> + <img alt="Coveralls github" src="https://img.shields.io/coveralls/github/mstuttgart/pycep-correios?style=flat-square"> + </a> + <a href="https://codeclimate.com/github/mstuttgart/pycep-correios"> + <img alt="Code Climate maintainability" src="https://img.shields.io/codeclimate/maintainability/mstuttgart/pycep-correios.svg?style=flat-square"> + </a> + <a href="https://pypi.org/project/pycep-correios"> + <img src="https://img.shields.io/pypi/v/pycep-correios.svg?style=flat-square" alt="Ratings"> + </a> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://img.shields.io/pypi/pyversions/pycep-correios.svg?style=flat-square" alt="Version"> + </a> +</p> + +<p align="center"> + <a href="#instalação">Instalação</a> | + <a href="#como-usar">Como Usar</a> | + <a href="#como-contribuir">Como Contribuir</a> | + <a href="#créditos">Créditos</a> +</p> + + +## 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 + +<p align="center"> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://raw.githubusercontent.com/mstuttgart/pycep-correios/develop/.img/logo.jpg" width="30%"> + </a> + <h3 align="center">PyCEPCorreios</h3> + <h4 align="center">API para busca de CEP integrado ao serviços dos Correios, ViaCEP e ApiCEP (WideNet)</h4> +</p> + +<p align="center"> + <a href="https://github.com/mstuttgart/pycep-correios/actions?query=workflow%3A%22Github+CI%22"> + <img src="https://img.shields.io/github/workflow/status/mstuttgart/pycep-correios/Github%20CI/develop?label=Github%20CI&logo=Github&style=flat-square" alt="Version"> + </a> + <a href="https://coveralls.io/github/mstuttgart/pycep-correios"> + <img alt="Coveralls github" src="https://img.shields.io/coveralls/github/mstuttgart/pycep-correios?style=flat-square"> + </a> + <a href="https://codeclimate.com/github/mstuttgart/pycep-correios"> + <img alt="Code Climate maintainability" src="https://img.shields.io/codeclimate/maintainability/mstuttgart/pycep-correios.svg?style=flat-square"> + </a> + <a href="https://pypi.org/project/pycep-correios"> + <img src="https://img.shields.io/pypi/v/pycep-correios.svg?style=flat-square" alt="Ratings"> + </a> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://img.shields.io/pypi/pyversions/pycep-correios.svg?style=flat-square" alt="Version"> + </a> +</p> + +<p align="center"> + <a href="#instalação">Instalação</a> | + <a href="#como-usar">Como Usar</a> | + <a href="#como-contribuir">Como Contribuir</a> | + <a href="#créditos">Créditos</a> +</p> + + +## 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 + +<p align="center"> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://raw.githubusercontent.com/mstuttgart/pycep-correios/develop/.img/logo.jpg" width="30%"> + </a> + <h3 align="center">PyCEPCorreios</h3> + <h4 align="center">API para busca de CEP integrado ao serviços dos Correios, ViaCEP e ApiCEP (WideNet)</h4> +</p> + +<p align="center"> + <a href="https://github.com/mstuttgart/pycep-correios/actions?query=workflow%3A%22Github+CI%22"> + <img src="https://img.shields.io/github/workflow/status/mstuttgart/pycep-correios/Github%20CI/develop?label=Github%20CI&logo=Github&style=flat-square" alt="Version"> + </a> + <a href="https://coveralls.io/github/mstuttgart/pycep-correios"> + <img alt="Coveralls github" src="https://img.shields.io/coveralls/github/mstuttgart/pycep-correios?style=flat-square"> + </a> + <a href="https://codeclimate.com/github/mstuttgart/pycep-correios"> + <img alt="Code Climate maintainability" src="https://img.shields.io/codeclimate/maintainability/mstuttgart/pycep-correios.svg?style=flat-square"> + </a> + <a href="https://pypi.org/project/pycep-correios"> + <img src="https://img.shields.io/pypi/v/pycep-correios.svg?style=flat-square" alt="Ratings"> + </a> + <a href="https://pypi.org/project/pycep-correios/"> + <img src="https://img.shields.io/pypi/pyversions/pycep-correios.svg?style=flat-square" alt="Version"> + </a> +</p> + +<p align="center"> + <a href="#instalação">Instalação</a> | + <a href="#como-usar">Como Usar</a> | + <a href="#como-contribuir">Como Contribuir</a> | + <a href="#créditos">Créditos</a> +</p> + + +## 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 <Python_Bot@openeuler.org> - 5.1.0-1 +- Package Spec generated @@ -0,0 +1 @@ +4e4a7d38924e9ce01703d9b03a0007fc pycep_correios-5.1.0.tar.gz |