Skip to main content

A command-line application to track COVID-19 cases

Project description

clicov

Quickly view and/or download COVID-19 case data from your Terminal.
Report issues

PyPI version

https://github.com/hhandika/clicov/blob/master/static/screenshot-2.png


Clicov is a multi-platform command-line application to track COVID-19 cases. The data are available for global and per country cases. The U.S cases are also available in per state basis and include positive and negative testing results.

Installation

For MacOS and Linux, you could install clicov directly from pip. You may also consider to setup virtual environment using conda or pip virtual environments. To install clicov, use this command in your Terminal shell:

pip install clicov

For Windows, you could install clicov on Windows Subsystem for Linux. The installation process is similar as above. Alternatively, you could also install it natively on Windows. One way to install it is using Anaconda/Miniconda. If you don't have either application yet, the instructions to install them are available here. Download Anaconda/Miniconda for python version 3.7 or above. After installation, open Anaconda command prompt. Then, install clicov by following the installation procedure for Linux and MacOS above.

Usages

Global Cases

To view summary of global cases:

clicov summary -w

To view summary of a selected country's cases, use the command -c and add the country two-letter ISO2 code. You can also use the country name, but ISO2 codes are less prone to errors, particularly for multi-word country names.

clicov summary -c [country-iso2-code]

You can check ISO2 codes using this command:

clicov id

For example, to view total U.S. cases:

clicov summary -c us

You can also chain the command with global cases:

clicov summary -w -c us

All countries' current cases can be saved into a spreadsheet:

clicov summary -sv

Cases from day one for a country is also available for download:

clicov download -c [country-iso2-code]

All files will be saved in your current working directory as a comma-separated values (.csv) format.

U.S Cases

This option is available to dig dive into the U.S states' cases. You can view a summary of all states' cases in the U.S or in per state basis. The data are available for current cases and historical data for each state. For the total U.S. cases, use 'clicov summary -c us' command instead.

To view a list of all states' current cases:

clicov usa

To view current cases per state:

clicov usa -s [state-code]

For example, to view New York cases:

clicov usa -s ny

To download all states' current cases:

clicov usa -sv

To download cases from day one for a selected state:

clicov usa -s [state-code] -sv

Data Providers

Global cases

Data aggregation: https://covid19api.com/

Data sources and terms of use: the Center for Systems Science and Engineering (CSSE) at Johns Hopkins University

U.S. state cases

Data aggregation and providers: the COVID Tracking Project at the Atlantic

Learn more about the data: https://covidtracking.com/data

Terms of use: https://covidtracking.com/license

License:

The app is under MIT license, meaning you are free to do however you want to the app. For the data usages, please refers to the terms of use provided by the data providers.

Contributions

This project was started as a hobby project. We are welcome for anyone to contribute. Please, send pull requests on Github.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

clicov-0.0.11.tar.gz (2.0 MB view details)

Uploaded Source

Built Distribution

clicov-0.0.11-py3-none-any.whl (9.9 kB view details)

Uploaded Python 3

File details

Details for the file clicov-0.0.11.tar.gz.

File metadata

  • Download URL: clicov-0.0.11.tar.gz
  • Upload date:
  • Size: 2.0 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1.post20200622 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for clicov-0.0.11.tar.gz
Algorithm Hash digest
SHA256 fedbb2b1e273282581cbe42a146c58e3accb95be158a768a897ab221cf4cd350
MD5 fab3885ddc328af1de8cd5d51eada6b6
BLAKE2b-256 2498b7fc3c5aea3121ab2f933cf869eed7d9f782f5e68813de3652b5634a61bc

See more details on using hashes here.

File details

Details for the file clicov-0.0.11-py3-none-any.whl.

File metadata

  • Download URL: clicov-0.0.11-py3-none-any.whl
  • Upload date:
  • Size: 9.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.3.1.post20200622 requests-toolbelt/0.9.1 tqdm/4.48.2 CPython/3.7.7

File hashes

Hashes for clicov-0.0.11-py3-none-any.whl
Algorithm Hash digest
SHA256 773500aa05a148b1219df5d00fa3347f76c7277a09a14647be8516a57d32d5cd
MD5 d488c6aa7980af8151fac69308af36fe
BLAKE2b-256 618aa2edd338429de5a646bc690338c2c669d742dd7ab02d1c74236a978c5dbb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page