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