{"id":13631686,"url":"https://github.com/siaw23/kovid","last_synced_at":"2025-11-11T18:44:04.012Z","repository":{"id":43060512,"uuid":"248792748","full_name":"siaw23/kovid","owner":"siaw23","description":"Fetch and compare COVID statistics on the CLI.","archived":false,"fork":false,"pushed_at":"2022-03-21T15:00:07.000Z","size":320,"stargazers_count":102,"open_issues_count":3,"forks_count":15,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-05T05:02:29.649Z","etag":null,"topics":["cli","coronavirus","coronavirus-analysis","coronavirus-info","coronavirus-real-time","coronavirus-tracking","covid-19","covid-2019","covid-api","covid-data","covid19","gem","ruby"],"latest_commit_sha":null,"homepage":"","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/siaw23.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-03-20T15:43:27.000Z","updated_at":"2023-08-04T18:32:45.000Z","dependencies_parsed_at":"2022-08-20T16:00:07.786Z","dependency_job_id":null,"html_url":"https://github.com/siaw23/kovid","commit_stats":null,"previous_names":[],"tags_count":77,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siaw23%2Fkovid","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siaw23%2Fkovid/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siaw23%2Fkovid/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/siaw23%2Fkovid/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/siaw23","download_url":"https://codeload.github.com/siaw23/kovid/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247464222,"owners_count":20942970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","coronavirus","coronavirus-analysis","coronavirus-info","coronavirus-real-time","coronavirus-tracking","covid-19","covid-2019","covid-api","covid-data","covid19","gem","ruby"],"created_at":"2024-08-01T22:02:34.399Z","updated_at":"2025-11-11T18:43:58.973Z","avatar_url":"https://github.com/siaw23.png","language":"Ruby","funding_links":[],"categories":["Ruby"],"sub_categories":[],"readme":"[![Gem Version](https://badge.fury.io/rb/kovid.svg)](https://badge.fury.io/rb/kovid)\n[![Open Source Helpers](https://www.codetriage.com/siaw23/kovid/badges/users.svg)](https://www.codetriage.com/siaw23/kovid)\n\n\nIf you're looking to consume this in your Ruby-based application, you might want to check [Sarskov](https://github.com/siaw23/sarskov) out. Sarskov returns statistics in a JSON format.\n\n# 🦠 Kovid\n\nKovid is a small CLI app to fetch data surrounding the coronavirus pandemic of 2019. I found myself checking [Wikipedia](https://en.wikipedia.org/wiki/2019%E2%80%9320_coronavirus_pandemic) 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.\n\nCode contribution and ideas welcome.\n\n\n## ⚙️ Installation\n\nTo install:\n\n* ️ Wash your hands with soap and water for at least 20 seconds.\n\n*  Run `gem install kovid`.\n\nIt's recommended you update often with `gem update kovid`.\n\n## ⚒️ Usage\n\nYou can run `kovid --help` to see the full list of available commands.\n\n#### Commands Overview\n\n😷 **Fetching**\n* `kovid check COUNTRY` aliased as `kovid country COUNTRY`.\n* `kovid check COUNTRY -f` aliased as `kovid country COUNTRY --full`.\n\nYou can get continental information with the following commands:\n\n* `kovid africa`.\n* `kovid europe`.\n* `kovid eu`. (The European Union)\n* `kovid sa`. (South America)\n* `kovid asia`.\n* `kovid world`. (Worldwide Statistics)\n\n🇺🇸🇺🇸🇺🇸\n\nYou can fetch US state-specific data:\n* `kovid state STATE` OR `kovid state \"STATE NAME\"`.\n* `kovid states --all` or `kovid states -a` for data on all US states.\n\nYou can also use USPS abbreviations.  Example: `kovid state me`\n\nProvinces\n\nYou can fetch province specific data:\n\n* `kovid province PROVINCE` or `kovid province \"PROVINCE NAME\"`.\n\n___\n😷 **Comparing**\n* `kovid compare FOO BAR` (sorts by cases DESC).\n* `kovid compare FOO BAR -f` OR `kovid compare FOO BAR --full` (sorts by cases DESC).\n\nWhere `FOO` and `BAR` are different countries.\n\nYou can compare as many countries as you want; `kovid compare FOO BAR BAZ` OR `kovid compare FOO BAR BAZ -f`\n\n🇺🇸🇺🇸🇺🇸\n\nYou can compare US states with:\n* `kovid states STATE STATE` Example: `kovid states illinois \"new york\" california` OR `kovid states il ny ca`\n\nYou can compare provicnes with:\n* `kovid provinces PROVINCE PROVINCE` Example: `kovid provinces ontario manitoba`\n___\n😷 **History**\n* `kovid history COUNTRY` (full history).\n* `kovid history COUNTRY N` (history in the last N days).\n* `kovid history STATE --usa`\n___\n😷 **Top N (by cases/deaths for countries and US States)**\n* `kovid top N` (top N countries in number of cases).\n* `kovid top N -d` OR `kovid top N --deaths` (top N countries in number of deaths).\n* `kovid top N --states` (top N US states in number of cases).\n* `kovid top N --states -d` (top N countries in number of deaths).\n___\n\n**NOTE:** If you find it irritating to have to type `kovid state STATE`, `covid state STATE` works as well.\n\n\n#### Commands Details\nTo fetch basic data on a country run:\n\n`kovid check ghana`. If the location contains spaces: `kovid check \"Diamond Princess\"`\n\n![kovid](https://i.gyazo.com/1d86ba2cd05f215b16c8d1fd13085c6e.png \"Covid data.\")\n\nFor full table info on a country:\n\n`kovid check italy -f` OR `kovid check italy --full`\n\n![kovid](https://i.gyazo.com/1d9720b9fa2c08fb801f5361fba359bb.png \"Covid data.\")\n\nTo compare country stats:\n\n`kovid compare germany poland spain`\n\n![kovid](https://i.gyazo.com/4100e845fea6936f5c8d21d78617110d.png \"Covid data.\")\n\nTo compare a countries stats with a full table:\n\n`kovid compare poland italy usa china -f` OR `kovid compare poland italy usa china --full`\n\n![kovid](https://i.gyazo.com/8b57865ae9b28f5afa895ebc49a2de31.png \"Covid data.\")\n\nTo fetch state-specific data run:\n\n`kovid state colorado` OR `kovid state \"north carolina\"`\n\n![kovid](https://i.gyazo.com/51509c3986f56bbc25068e0d541d9bdd.png \"Covid data.\")\n\nTo fetch EU data run:\n\n`kovid eu`\n\n![kovid](https://i.gyazo.com/0a78afae2a5b9d2beb9f2c61dc1d3ac7.png \"Covid data.\")\n\nTo fetch data on Africa:\n\n`kovid africa`\n\n![kovid](https://i.gyazo.com/bc45fa53e2ff688e8a1f759f1bd1b972.png \"Covid data.\")\n\nYou can check historical statistics by running\n\n`kovid history italy 7` eg:\n\n![kovid](https://i.gyazo.com/bc18fdaf99cacf2c921086f189d542b4.png \"Covid data.\")\n\nTo check for total figures:\n\n`kovid world`\n\n![kovid](https://i.gyazo.com/e01f4769a2b9e31ce50cec212e55810c.png \"Covid data.\")\n\nTo fetch top 5 countries in number of cases or deaths:\n\n`kovid top`\n\n![kovid](https://i.gyazo.com/79443079a6c834094fc21c90dd02b78c.png \"Covid data.\")\n\n`kovid top --deaths` OR `kovid top -d`\n\n![kovid](https://i.gyazo.com/8136a7acc2cb67d1621b3db0df822cd5.png \"Covid data.\")\n\nIt is also possible to fetch top US states in number of cases or deaths:\n\n`kovid top --states`\n\n![kovid](https://i.gyazo.com/7ee5a1e6affdec838783183024c4604d.png \"Covid data.\")\n\n`kovid top --states --deaths` OR `kovid top --states -d`\n\n![kovid](https://i.gyazo.com/2c3cb7e1218deff44c9d440dab93a3b1.png \"Covid data.\")\n\nTo fetch more number of countries or US states you can pass N. eg:\n\n`kovid top 10`\n\n![kovid](https://i.gyazo.com/64663ff25c1ff61701e84871948640f4.png \"Covid data.\")\n\n\n## Data Source\n\u003e [JHU CSSE GISand Data](https://gisanddata.maps.arcgis.com/apps/opsdashboard/index.html#/bda7594740fd40299423467b48e9ecf6) and https://www.worldometers.info/coronavirus/ via [NovelCOVID/API](https://github.com/novelcovid/api)\n\n\n## 👨‍💻 Development\n\nAfter 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.\n\nTo install this gem onto your local machine, run `bundle exec rake install`.\n\n\n## 🤲 Contributing\n\nThere 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](https://github.com/siaw23/kovid/blob/master/CODE_OF_CONDUCT.md).\n\n\n## 🔖 License\n\nThe gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n## ❤️ Code of Conduct\n\nEveryone interacting in the Kovid project's codebases and issue trackers is expected to follow the [code of conduct](https://github.com/siaw23/kovid/blob/master/CODE_OF_CONDUCT.md).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiaw23%2Fkovid","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsiaw23%2Fkovid","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsiaw23%2Fkovid/lists"}