/all

Author: ExpDev07

README.md

@@ -2,13 +2,43 @@
 
 > This is a fast (< 200ms) and basic API for tracking development of the new coronavirus (2019-nCoV). It's written in python using 🍼 Flask.
 
-## Live version
-View the live version here: [https://coronavirus-tracker-api.herokuapp.com/latest](https://coronavirus-tracker-api.herokuapp.com/latest).
+## Endpoints
+
+All requests must be made to the base url: ``https://coronavirus-tracker-api.herokuapp.com``. You can try them out in your browser to further inspect responses.
+
+Getting confirmed cases, deaths, and recoveries:
+```http
+GET /all
+```
+```json
+{ latest: { ... }, confirmed: { ... }, deaths: { ... }, recovered: { ... } }
+```
+
+Getting just confirmed:
+```http
+GET /confirmed
+```
+```json
+{ latest: 42767, locations: [ ... ] }
+```
+
+Getting just deaths:
+```http
+GET /deaths
+```
+
+Getting just recoveries:
+```http
+GET /recovered
+```
+
 
 ## Data
+
 The data is retrieved programatically and re-formatted from the [2019 Novel Coronavirus (nCoV) Data Repository, provided by JHU CCSE](https://github.com/CSSEGISandData/2019-nCoV).
 
 ## License
+
 The data is available to the public strictly for educational and academic research purposes.
 
 ## Prerequisites

app/data/__init__.py

@@ -9,16 +9,16 @@
 base_url = 'https://raw.githubusercontent.com/CSSEGISandData/2019-nCoV/master/time_series/time_series_2019-ncov-%s.csv';
 
 @cached(cache=TTLCache(maxsize=1024, ttl=3600))
-def get_data(type):
+def get_data(category):
     """
     Retrieves the data for the provided type.
     """
 
-    # Adhere to type naming standard.
-    type = type.lower().capitalize();
+    # Adhere to category naming standard.
+    category = category.lower().capitalize();
 
     # Request the data 
-    request = requests.get(base_url % type)
+    request = requests.get(base_url % category)
     text    = request.text
 
     # Parse the CSV.
@@ -51,8 +51,14 @@ def get_data(type):
             'latest': int(list(history.values())[-1]),
         })
 
+    # Latest total.
+    latest = sum(map(lambda location: location['latest'], locations))
+
     # Return the final data.
-    return locations
+    return {
+        'locations': locations,
+        'latest': latest
+    }
 
 
 

app/routes/__init__.py

@@ -1,4 +1,4 @@
 from . import confirmed
 from . import deaths
 from . import recovered
-from . import latest
+from . import all

app/routes/all.py

@@ -2,6 +2,23 @@
 from app import app
 from app.data import get_data
 
-@app.route('/deaths')
-def deaths():
-    return jsonify(get_data('deaths'))
+@app.route('/all')
+def all():
+    # Get all the categories.
+    confirmed = get_data('confirmed')
+    deaths    = get_data('deaths')
+    recovered = get_data('recovered')
+
+    return jsonify({
+        # Data.
+        'confirmed': confirmed,
+        'deaths':    deaths,
+        'recovered': recovered,
+
+        # Latest.
+        'latest': {
+            'confirmed': confirmed['latest'],
+            'deaths':    deaths['latest'],
+            'recovered': recovered['latest'],
+        }
+    })