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 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.
️ Wash your hands with soap and water for at least 20 seconds.
gem install kovid.
It's recommended you update often with
gem update kovid.
You can run
kovid --help to see the full list of available commands.
kovid check COUNTRYaliased as
kovid country COUNTRY.
kovid check COUNTRY -faliased as
kovid country COUNTRY --full.
You can get continental information with the following commands:
kovid eu. (The European Union)
kovid sa. (South America)
kovid world. (Worldwide Statistics)
You can fetch US state-specific data:
kovid state STATEOR
kovid state "STATE NAME".
kovid states --allor
kovid states -afor data on all US states.
You can also use USPS abbreviations. Example:
kovid state me
You can fetch province specific data:
kovid province PROVINCEor
kovid province "PROVINCE NAME".
kovid compare FOO BAR(sorts by cases DESC).
kovid compare FOO BAR -fOR
kovid compare FOO BAR --full(sorts by cases DESC).
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 STATEExample:
kovid states illinois "new york" californiaOR
kovid states il ny ca
You can compare provicnes with:
kovid provinces PROVINCE PROVINCEExample:
kovid provinces ontario manitoba
kovid 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 -dOR
kovid 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.
Histogram (Experimental) 🧪
kovid histogram COUNTRY M.YY (draws a histogram of cases in the given month
M and years
(If the histogram appears messy, you might want to resize your window.)
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:
To fetch data on Africa:
You can check historical statistics by running
kovid history italy 7 eg:
To check for total figures:
To fetch top 5 countries in number of cases or deaths:
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
👩🏾🔬 Experimental Feature
kovid histogram italy 3.20 tries to build a histogram on number of cases. In the example here
3.20 is date in the format of
M.YY. If you can please play with it and report issues on how this could be improved.
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.
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.
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.