Skip to main content

Python SDK to get information regarding the novel corona virus provided by Johns Hopkins university and worldometers.info

Project description

Covid

CircleCI codecov

Description

Python SDK to get information regarding the novel corona virus provided by Johns Hopkins university and worldometers.info

Full Documentation can be found here

corona.jpeg

Requirements

python >= 3.6

How to install

pip install covid

Dependencies

pydantic
requests

How to use

Get All Data

from covid import Covid

covid = Covid()
covid.get_data()

Result

[
    {
        'id': '53',
        'country': 'China',
        'confirmed': 81020,
        'active': 9960,
        'deaths': 3217,
        'recovered': 67843,
        'latitude': 30.5928,
        'longitude': 114.3055,
        'last_update': 1584097775000
    },
    {
        'id': '115',
        'country': 'Italy',
        'confirmed': 24747,
        'active': 20603,
        'deaths': 1809,
        'recovered': 2335,
        'latitude': 41.8719,
        'longitude': 12.5674,
        'last_update': 1584318130000
    },
    ...

List Countries

This comes in handy when you need to know the available names of countries when using get_status_by_country_name, eg. "The Republic of Moldova" or just "Moldova" So use this when you need to know the country exact name that you can use.

countries = covid.list_countries()

Result

[
    {'id': '53', 'country': 'China'},
    {'id': '115', 'country': 'Italy'}
    ...
]

Get Status By Country ID

italy_cases = covid.get_status_by_country_id(115)

Result

{
    'id': '115',
    'country': 'Italy',
    'confirmed': 24747,
    'active': 20603,
    'deaths': 1809,
    'recovered': 2335,
    'latitude': 41.8719,
    'longitude': 12.5674,
    'last_update': 1584318130000
}

Get Status By Country Name

italy_cases = covid.get_status_by_country_name("italy")

Result

{
    'id': '115',
    'country': 'Italy',
    'confirmed': 24747,
    'active': 20603,
    'deaths': 1809,
    'recovered': 2335,
    'latitude': 41.8719,
    'longitude': 12.5674,
    'last_update': 1584318130000
}

Get Total Active cases

active = covid.get_total_active_cases()

Get Total Confirmed cases

confirmed = covid.get_total_confirmed_cases()

Get Total Recovered cases

recovered = covid.get_total_recovered()

Get Total Deaths

deaths = covid.get_total_deaths()

Getting data from Worldometers.info (New)

covid = Covid(source="worldometers")

Get Data

covid.get_data()

Result

[
    {
        'country': 'Malta',
        'confirmed': 110,
        'new_cases': 3,
        'deaths': 0,
        'recovered': 2,
        'active': 108,
        'critical': 1,
        'total_cases_per_million': Decimal('249'),
        'total_deaths_per_million': Decimal('0')
    },
    {
        'country': 'Cameroon',
        'confirmed': 66,
        'new_cases': 10,
        'deaths': 0,
        'recovered': 2,
        'active': 64,
        'critical': 0,
        'total_cases_per_million': Decimal('2'),
        'total_deaths_per_million': Decimal('0')
    },
    ...
]

Get Status By Country Name

covid.get_status_by_country_name("italy")

Result

{
    'country': 'Italy',
    'confirmed': 69176,
    'new_cases': 5249,
    'deaths': 6820,
    'recovered': 8326,
    'active': 54030,
    'critical': 3393,
    'total_cases_per_million': Decimal('1144'),
    'total_deaths_per_million': Decimal('113')
}

List Countries

countries = covid.list_countries()

Result

[
    'china',
    'italy',
    'usa',
    'spain',
    'germany',
...
]

Get Total Active cases

active = covid.get_total_active_cases()

Get Total Confirmed cases

confirmed = covid.get_total_confirmed_cases()

Get Total Recovered cases

recovered = covid.get_total_recovered()

Get Total Deaths

deaths = covid.get_total_deaths()

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

covid-2.0.2.tar.gz (5.9 kB view details)

Uploaded Source

File details

Details for the file covid-2.0.2.tar.gz.

File metadata

  • Download URL: covid-2.0.2.tar.gz
  • Upload date:
  • Size: 5.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.0.0 requests-toolbelt/0.9.1 tqdm/4.43.0 CPython/3.7.7

File hashes

Hashes for covid-2.0.2.tar.gz
Algorithm Hash digest
SHA256 fd5cb968a5efdb36d1f8c2193055fa7b0b3a8a19a3e89edf7888e81b22a18c80
MD5 d15398b02ca6575c204720f67d1684fa
BLAKE2b-256 d735d23cd38ff92f89e79e9174d93272d00bbac241b188041d0c01525ae649f8

See more details on using hashes here.

Supported by

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