If you're looking to consume this in your Ruby-based application, you might want to check Sarskov out. Sarskov returns statistics in a JSON format.
π¦ Kovid
Kovid is a small CLI app to fetch data surrounding the coronavirus pandemic of 2019. I found myself checking Wikipedia constantly for information so I thought I'd build this to provide info directly in the terminal. It's where some of us spend time more.
Code contribution and ideas welcome.
βοΈ Installation
To install:
οΈ Wash your hands with soap and water for at least 20 seconds.
Run
gem install kovid
.
It's recommended you update often with gem update kovid
.
βοΈ Usage
You can run kovid --help
to see the full list of available commands.
Commands Overview
π· Fetching
kovid check COUNTRY
aliased askovid country COUNTRY
.kovid check COUNTRY -f
aliased askovid country COUNTRY --full
.
You can get continental information with the following commands:
kovid africa
.kovid europe
.kovid eu
. (The European Union)kovid sa
. (South America)kovid asia
.kovid world
. (Worldwide Statistics)
πΊπΈπΊπΈπΊπΈ
You can fetch US state-specific data:
kovid state STATE
ORkovid state "STATE NAME"
.kovid states --all
orkovid states -a
for data on all US states.
You can also use USPS abbreviations. Example: kovid state me
Provinces
You can fetch province specific data:
kovid province PROVINCE
orkovid province "PROVINCE NAME"
.
π· Comparing
kovid compare FOO BAR
(sorts by cases DESC).kovid compare FOO BAR -f
ORkovid compare FOO BAR --full
(sorts by cases DESC).
Where FOO
and BAR
are different countries.
You can compare as many countries as you want; kovid compare FOO BAR BAZ
OR kovid compare FOO BAR BAZ -f
πΊπΈπΊπΈπΊπΈ
You can compare US states with:
kovid states STATE STATE
Example:kovid states illinois "new york" california
ORkovid states il ny ca
You can compare provicnes with:
kovid provinces PROVINCE PROVINCE
Example:kovid provinces ontario manitoba
___ π· Historykovid history COUNTRY
(full history).kovid history COUNTRY N
(history in the last N days).kovid history STATE --usa
___ π· Top N (by cases/deaths for countries and US States)kovid top N
(top N countries in number of cases).kovid top N -d
ORkovid top N --deaths
(top N countries in number of deaths).kovid top N --states
(top N US states in number of cases).kovid top N --states -d
(top N countries in number of deaths). ___
NOTE: If you find it irritating to have to type kovid state STATE
, covid state STATE
works as well.
Commands Details
To fetch basic data on a country run:
kovid check ghana
. If the location contains spaces: kovid check "Diamond Princess"
For full table info on a country:
kovid check italy -f
OR kovid check italy --full
To compare country stats:
kovid compare germany poland spain
To compare a countries stats with a full table:
kovid compare poland italy usa china -f
OR kovid compare poland italy usa china --full
To fetch state-specific data run:
kovid state colorado
OR kovid state "north carolina"
To fetch EU data run:
kovid eu
To fetch data on Africa:
kovid africa
You can check historical statistics by running
kovid history italy 7
eg:
To check for total figures:
kovid world
To fetch top 5 countries in number of cases or deaths:
kovid top
kovid top --deaths
OR kovid top -d
It is also possible to fetch top US states in number of cases or deaths:
kovid top --states
kovid top --states --deaths
OR kovid top --states -d
To fetch more number of countries or US states you can pass N. eg:
kovid top 10
Data Source
JHU CSSE GISand Data and https://www.worldometers.info/coronavirus/ via NovelCOVID/API
π¨βπ» Development
After checking out the repo, run bin/setup
to install dependencies. Then, run rake spec
to run the tests. You can also run bin/console
for an interactive prompt that will allow you to experiment.
To install this gem onto your local machine, run bundle exec rake install
.
π€² Contributing
There are multiple areas in this repo that can be improved or use some refactoring(there's a lot to be refactored in fact!). For that reason, bug reports and pull requests are welcome! This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.
π License
The gem is available as open-source under the terms of the MIT License.
β€οΈ Code of Conduct
Everyone interacting in the Kovid project's codebases and issue trackers is expected to follow the code of conduct.