Home

Awesome

<h1 align="center"> Coronavirus Tg API </h1>

Provides up-to-date data about Coronavirus outbreak in Togo. Includes numbers about confirmed cases, deaths and recovered. Support unique government source.

Travis build License GitHub stars GitHub forks GitHub last commit GitHub pull requests GitHub issues Code style: black Tweet

Available data-sources:

Currently 1 data-source is available to retrieve the data:

API Reference

All endpoints are located at coronavirus-tg-api.herokuapp.com/v1/ and are accessible via https.

You can open the URL in your browser to further inspect the response. Or you can make this curl call in your terminal to see the prettified response:

curl https://coronavirus-tg-api.herokuapp.com/v1/cases | json_pp

Swagger/OpenAPI

Consume our API through our super awesome and interactive SwaggerUI (on mobile, use the mobile friendly ReDocs instead for the best experience).

The OpenAPI json definition can be downloaded at https://coronavirus-tg-api.herokuapp.com/openapi.json

Technologies used for the project

API Endpoints

Cases Endpoint

Getting total of confirmed cases, deaths, recovered and the last updated date.

GET /v1/cases

Sample response

{
  "confirmed": 99,
  "recovered": 62,
  "deaths": 6,
  "last_updated": "2020-04-27 11:12:00"
}

Sources Endpoint

Getting the data-sources that are currently available to Coronavirus Tg API to retrieve the data of the pandemic. Currently,the government website and the tracker api project.

GET /v1/sources

Sample response

{
  "government_website": "https://covid19.gouv.tg",
  "tracker_api_project": "https://github.com/egbakou/coronavirus-tg-api"
}

Confirmed cases Endpoint

Getting confirmed cases data.

GET /v1/cases/confirmed

Sample response

{
  "confirmed": 99,
  "last_updated": "2020-04-27 11:12:00"
}

Recovered cases Endpoint

Getting recovered cases data.

GET /v1/cases/recovered

Sample response

{
  "recovered": 62,
  "last_updated": "2020-04-27 11:12:00"
}

Deaths data Endpoint

Getting number of deaths.

GET /v1/cases/deaths

Sample response

{
  "deaths": 6,
  "last_updated": "2020-04-27 11:12:00"
}

Response definitions

Response ItemDescriptionType
{cases}total of confirmed cases, deaths, recovered and the last updated date.Object
{cases}/confirmedThe up-to-date total number of confirmed casesInteger
{cases}/deathsThe up-to-date total number of deathsInteger
{cases}/recoveredThe up-to-date total number of recoveredInteger
{sources}Data-sources used to provide dataObject

We strongly recommend using the endpoint /v1/cases instead of using the endpoints returning each case.

Wrappers

No wrapper at the moment.

Prerequisites

You will need the following things properly installed on your computer.

Installation

  1. Make sure you have python3.8 installed and on your PATH.
  2. Install the pipenv dependency manager
  3. Create virtual environment and install all dependencies $ pipenv sync --dev
  4. Activate/enter the virtual environment $ pipenv shell

And don't despair if don't get the python setup working on the first try. No one did. Guido got pretty close... once. But that's another story. Good luck.

Running / Development

For a live reloading on code changes.

Without live reloading.

Visit your app at http://localhost:8000.

Alternatively run our API with Docker.

Running Tests

pytest

pipenv run test

Linting

pylint

pipenv run lint

Formatting

black

pipenv run fmt

Update requirements files

invoke generate-reqs

Pipfile.lock will be automatically updated during pipenv install.

Docker

Our Docker image is based on tiangolo/uvicorn-gunicorn-fastapi/.

invoke docker --build

Run with docker run or docker-compose

Alternate Docker images

If a full gunicorn deployment is unnecessary or impractical on your hardware consider using our single instance Uvicorn based Dockerfile.

Invoke

Additional developer commands can be run by calling them with the python invoke task runner.

invoke --list

Deploying

Created by: Kodjo Laurent Egbakou

Contribution

Feel free to create issues and PRs :)