Metadata-Version: 2.1
Name: COVID19-ES-Py
Version: 1.0.4
Summary: Scraper de boletins de casos de COVID-19 no Espírito Santo.
Home-page: https://github.com/atilioa/COVID19-ES-Py
Author: Atílio Antônio
Author-email: atiliodadalto@protonmail.com
License: GLP-3
Description: <h1 align="center">
          <br>
          <a href="https://pypi.org/project/COVID19-ES-Py/">
          <img src="https://raw.githubusercontent.com/AtilioA/COVID19-ES-Py/5c84a08be8a32a7f2850b591fbf1b4664779f51a/docs/logo_COVID19-ES-Py.png" width="40%"></a>
          <br>
          COVID19-ES-Py
          <br>
        
        [![PyPI pyversions](https://img.shields.io/pypi/pyversions/COVID19-ES-Py.svg)](https://pypi.python.org/pypi/COVID19-ES-Py/) ![PyPI](https://img.shields.io/pypi/v/COVID19-ES-Py) [![HitCount](http://hits.dwyl.com/atilioa/COVID19-ES-Py.svg)](http://hits.dwyl.com/atilioa/COVID19-ES-Py) ![PyPI - Downloads](https://img.shields.io/pypi/dm/covid19-es-py) [![License: GPL v3](https://img.shields.io/badge/License-GPLv3-orange.svg)](https://www.gnu.org/licenses/gpl-3.0)
        </h1>
        
        
        <h4 align="center">API em Python para consulta de casos de COVID-19 no estado do Espírito Santo.</h4>
        
        <p align="center">
          <a href="#recursos">Recursos</a> |
          <a href="#instalação">Instalação</a> |
          <a href="#como-usar">Como usar</a> |
          <a href="#exemplos">Exemplos</a> |
          <a href="#considerações-finais">Considerações finais</a>
        </p>
        
        # Recursos
        * Extrai URLs de boletins emitidos pelo Governo do Estado do Espírito Santo
        * Coleta números de casos dos boletins
        * Possibilita pesquisa de casos por município
        
        # Instalação
        Atualmente, o COVID19-ES-Py possui suporte para Python 3.6+.
        
        ### Pelo repositório PyPI
        Utilize seu gerenciador de pacotes preferido para instalar o pacote. Com `pip`:
        
        ```shell
        pip install COVID19-ES-Py
        ```
        
        ### Pelo código fonte
        1. Clone o repositório ou baixe o código fonte (neste caso, descompacte o arquivo);
        2. Entre no diretório raiz do pacote pelo terminal e rode o comando `python setup.py install`
        
        # Como usar
        
        A API possui duas classes: `ScraperBoletim` e `Boletim`. A primeira é capaz de extrair links de boletins e usa objetos `Boletim` para fazer a interface para o programador. A segunda pode ser utilizada para extrair informações de um boletim específico.
        
        ## Exemplos
        Inicializando o scraper e obtendo dados do último boletim:
        ```python
        import COVID19_ES_Py
        
        # Inicializando o scraper
        scraper = COVID19_ES_Py.ScraperBoletim()
        
        # Carregando objeto Boletim com último boletim emitido
        boletim = scraper.carrega_ultimo_boletim()
        boletim.casos
        >>> {'Afonso Cláudio': {'casosConfirmados': '0', 'casosDescartados': '1', 'casosSuspeitos': '0', 'totalCasos': '1',},
        ...
        'Vitória': {'casosConfirmados': '18', 'casosDescartados': '96', 'casosSuspeitos': '142', 'totalCasos': '256'}}
        ```
        
        Total de casos do boletim:
        ```python
        boletim.totalGeral
        >>> {'casosConfirmados': '53 + 1*', 'casosDescartados': '411', 'casosSuspeitos': '1.105', 'totalCasos': '1.570'}
        ```
        
        Pesquisando casos por município:
        ```python
        boletim.pesquisa_casos_municipio("Vitória")
        >>> {'casosConfirmados': '18', 'casosDescartados': '96', 'casosSuspeitos': '142', 'totalCasos': '256'}
        
        # A busca ignora espaços extras e capitalização
        boletim.pesquisa_casos_municipio("  santa teresa ")
        >>> {'casosConfirmados': '1', 'casosDescartados': '1', 'casosSuspeitos': '0', 'totalCasos': '2'}
        
        # Também ignora caracteres especiais
        boletim.pesquisa_casos_municipio("AFONSO CLAUDIO")
        >>> {'casosConfirmados': '0', 'casosDescartados': '1', 'casosSuspeitos': '0', 'totalCasos': '1'}
        
        boletim.pesquisa_casos_municipio("arapiraca")
        >>> exceptions.BoletimError: O município "arapiraca" não foi encontrado no boletim. Pode ter ocorrido um erro de digitação ou o município não registrou casos de COVID-19.
        ```
        
        <!-- ## Documentação
        Você pode aprender mais sobre a API lendo a [documentação oficial](https://www.google.com.br). -->
        
        ## Considerações finais
        Encontrou algum erro? Tem alguma sugestão para melhorar a COVID19-ES-Py? [Crie uma issue!](https://github.com/atilioa/COVID19-ES-Py/issues) Contribuições são muito bem-vindas.
        
        Os dados são disponibilizados pelo Governo do Estado do Espírito Santo com a Superintendência Estadual de Comunicação Social do Espírito Santo (SECOM).
        
Platform: UNKNOWN
Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Description-Content-Type: text/markdown
