Skip to main content

Python SDK to get information regarding the novel corona virus provided by Johns Hopkins university

Project description

Covid

CircleCI codecov

Description

Python SDK to get information regarding the novel corona virus provided by Johns Hopkins university

Full Documentation can be found here

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.0.tar.gz (3.2 kB view details)

Uploaded Source

File details

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

File metadata

  • Download URL: covid-2.0.0.tar.gz
  • Upload date:
  • Size: 3.2 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.0.tar.gz
Algorithm Hash digest
SHA256 2bdc189155ac03c1f820ae14a8ebb2d5318d279aaba2561a0f132deff9f75771
MD5 5a0caa3f1c1b89aeead02939137f5f54
BLAKE2b-256 c66bed8d5da3f5b75e04489bd832360577d7970a68fe625fc126e78afbae8a27

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