Metadata-Version: 2.1
Name: covid19poland
Version: 0.2.1
Summary: Web Scraper for Poland COVID19 data.
Home-page: https://github.com/martinbenes1996/covid19poland
Author: Martin Beneš
Author-email: martinbenes1996@gmail.com
License: MIT
Download-URL: https://github.com/martinbenes1996/covid19poland/archive/0.2.1.tar.gz
Description: 
        # Web Scraper of COVID-19 data for Poland
        
        Python package [covid19poland](https://pypi.org/project/covid19poland/) is part of MFRatio project.
        
        It provides access to death data in Poland due to COVID-19 as well as overall deaths data.
        
        ## Setup and usage
        
        Install from [pip](https://pypi.org/project/covid19poland/) with
        
        ```python
        pip install covid19poland
        ```
        
        Several data sources are in current version
        * Covid-19 deaths from Wikipedia
        * Online parser of Twitter of Polish Ministry of Health
        * Offline manually checked data from online parser
        
        Package is regularly updated. Update with
        
        ```bash
        pip install --upgrade covid19poland
        ```
        
        ### Wikipedia
        
        The table comes from version from beginning of June on Wikipedia page
        https://en.wikipedia.org/wiki/COVID-19_pandemic_in_Poland
        
        ```python
        import covid19poland as PL
        
        x = PL.wiki()
        ```
        
        Once better tabular source is found, it will replace the current one.
        
        **Parametrization**
        
        Level is a setting for granularity of data
        
        1. Country level (default)
        2. State level
        
        ```python
        import covid19poland as PL
        
        # country level
        x1 = PL.fetch(level = 1)
        # state level
        x2 = PL.fetch(level = 2)
        ```
        
        ### Twitter data
        
        The data from twitter can be downloaded and parsed with
        
        ```python
        data,filtered,checklist = PL.twitter(start = "2020-06-01", end = "2020-07-01")
        ```
        
        Turn on logs by typing following code before the `twitter()` function call.
        
        ```python
        import logging
        logging.basicConfig(level = logging.INFO)
        ```
        
        The result of the `twitter()` call are three values
        
        * data - containing the deceased people with their place and date of death
        * filtered - tweets, that were filtered out. Just for validation that nothing was missed.
        * checklist - list of dates that the parser is not sure about
        
        The data can be saved to output files with 
        
        ```python
        with open("data/6_in.json", "w") as fd:
            json.dump(data, fd)
        with open("data/6_out.json", "w") as fd:
            json.dump(filtered, fd)
        print(checklist)
        ```
        
        ### Offline data
        
        The twitter data has already been manually checked and it is part of the package.
        Use function `read()` from `offline` submodule to get them
        
        ```python
        import covid19poland as PL
        
        x = PL.offline.read()
        ```
        
        Here the result is `pandas.DataFrame` with rows being each deceased person.
        
        The NUTS-2 and NUTS-3 classification is done using offline clone of file from
        https://ec.europa.eu/eurostat/web/nuts/local-administrative-units.
        
        ## Contribution
        
        Developed by [Martin Benes](https://github.com/martinbenes1996).
        
        Join on [GitHub](https://github.com/martinbenes1996/covid19poland).
        
        
        
        
Keywords: 2019-nCov,poland,coronavirus,covid-19,covid-data,covid19-data
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Other Audience
Classifier: Topic :: Database
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Scientific/Engineering :: Information Analysis
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Utilities
Classifier: License :: OSI Approved :: Mozilla Public License 2.0 (MPL 2.0)
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
