1386 lines
40 KiB
Python
1386 lines
40 KiB
Python
import json
|
|
import os
|
|
import shutil
|
|
from datetime import timedelta
|
|
from typing import Dict, List, Optional, Tuple, Union
|
|
|
|
import requests
|
|
from flask import (
|
|
Blueprint,
|
|
Response,
|
|
current_app,
|
|
request,
|
|
send_from_directory,
|
|
)
|
|
from sqlalchemy import asc, desc, exc
|
|
from werkzeug.exceptions import NotFound, RequestEntityTooLarge
|
|
from werkzeug.utils import secure_filename
|
|
|
|
from fittrackee import appLog, db, limiter
|
|
from fittrackee.oauth2.server import require_auth
|
|
from fittrackee.responses import (
|
|
DataInvalidPayloadErrorResponse,
|
|
DataNotFoundErrorResponse,
|
|
HttpResponse,
|
|
InternalServerErrorResponse,
|
|
InvalidPayloadErrorResponse,
|
|
NotFoundErrorResponse,
|
|
PayloadTooLargeErrorResponse,
|
|
get_error_response_if_file_is_invalid,
|
|
handle_error_and_return_response,
|
|
)
|
|
from fittrackee.users.models import User
|
|
|
|
from .models import Workout
|
|
from .utils.convert import convert_in_duration
|
|
from .utils.gpx import (
|
|
WorkoutGPXException,
|
|
extract_segment_from_gpx_file,
|
|
get_chart_data,
|
|
)
|
|
from .utils.short_id import decode_short_id
|
|
from .utils.visibility import can_view_workout
|
|
from .utils.workouts import (
|
|
WorkoutException,
|
|
create_workout,
|
|
edit_workout,
|
|
get_absolute_file_path,
|
|
get_datetime_from_request_args,
|
|
process_files,
|
|
)
|
|
|
|
workouts_blueprint = Blueprint('workouts', __name__)
|
|
|
|
DEFAULT_WORKOUTS_PER_PAGE = 5
|
|
MAX_WORKOUTS_PER_PAGE = 100
|
|
|
|
|
|
@workouts_blueprint.route('/workouts', methods=['GET'])
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_workouts(auth_user: User) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get workouts for the authenticated user.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example requests**:
|
|
|
|
- without parameters
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/ HTTP/1.1
|
|
|
|
- with some query parameters
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts?from=2019-07-02&to=2019-07-31&sport_id=1 HTTP/1.1
|
|
|
|
**Example responses**:
|
|
|
|
- returning at least one workout
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": [
|
|
{
|
|
"ascent": null,
|
|
"ave_speed": 10.0,
|
|
"bounds": [],
|
|
"creation_date": "Sun, 14 Jul 2019 13:51:01 GMT",
|
|
"descent": null,
|
|
"distance": 10.0,
|
|
"duration": "0:17:04",
|
|
"id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
"map": null,
|
|
"max_alt": null,
|
|
"max_speed": 10.0,
|
|
"min_alt": null,
|
|
"modification_date": null,
|
|
"moving": "0:17:04",
|
|
"next_workout": 3,
|
|
"notes": null,
|
|
"pauses": null,
|
|
"previous_workout": null,
|
|
"records": [
|
|
{
|
|
"id": 4,
|
|
"record_type": "MS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 13,
|
|
"record_type": "HA",
|
|
"sport_id": 1,
|
|
"user": "Sam",
|
|
"value": 43.97,
|
|
"workout_date": "Sun, 07 Jul 2019 08:00:00 GMT",
|
|
"workout_id": "hvYBqYBRa7wwXpaStWR4V2"
|
|
},
|
|
{
|
|
"id": 3,
|
|
"record_type": "LD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": "0:17:04",
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 2,
|
|
"record_type": "FD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 1,
|
|
"record_type": "AS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
}
|
|
],
|
|
"segments": [],
|
|
"sport_id": 1,
|
|
"title": null,
|
|
"user": "admin",
|
|
"weather_end": null,
|
|
"weather_start": null,
|
|
"with_gpx": false,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT"
|
|
}
|
|
]
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
- returning no workouts
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": []
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
:query integer page: page if using pagination (default: 1)
|
|
:query integer per_page: number of workouts per page
|
|
(default: 5, max: 100)
|
|
:query integer sport_id: sport id
|
|
:query string from: start date (format: ``%Y-%m-%d``)
|
|
:query string to: end date (format: ``%Y-%m-%d``)
|
|
:query float distance_from: minimal distance
|
|
:query float distance_to: maximal distance
|
|
:query string duration_from: minimal duration (format: ``%H:%M``)
|
|
:query string duration_to: maximal distance (format: ``%H:%M``)
|
|
:query float ave_speed_from: minimal average speed
|
|
:query float ave_speed_to: maximal average speed
|
|
:query float max_speed_from: minimal max. speed
|
|
:query float max_speed_to: maximal max. speed
|
|
:query string order: sorting order (default: ``desc``)
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 500:
|
|
|
|
"""
|
|
try:
|
|
params = request.args.copy()
|
|
page = int(params.get('page', 1))
|
|
date_from, date_to = get_datetime_from_request_args(params, auth_user)
|
|
distance_from = params.get('distance_from')
|
|
distance_to = params.get('distance_to')
|
|
duration_from = params.get('duration_from')
|
|
duration_to = params.get('duration_to')
|
|
ave_speed_from = params.get('ave_speed_from')
|
|
ave_speed_to = params.get('ave_speed_to')
|
|
max_speed_from = params.get('max_speed_from')
|
|
max_speed_to = params.get('max_speed_to')
|
|
workout_column = getattr(
|
|
Workout, params.get('order_by', 'workout_date')
|
|
)
|
|
order = params.get('order', 'desc')
|
|
sport_id = params.get('sport_id')
|
|
per_page = int(params.get('per_page', DEFAULT_WORKOUTS_PER_PAGE))
|
|
if per_page > MAX_WORKOUTS_PER_PAGE:
|
|
per_page = MAX_WORKOUTS_PER_PAGE
|
|
workouts_pagination = (
|
|
Workout.query.filter(
|
|
Workout.user_id == auth_user.id,
|
|
Workout.sport_id == sport_id if sport_id else True,
|
|
Workout.workout_date >= date_from if date_from else True,
|
|
Workout.workout_date < date_to + timedelta(seconds=1)
|
|
if date_to
|
|
else True,
|
|
Workout.distance >= float(distance_from)
|
|
if distance_from
|
|
else True,
|
|
Workout.distance <= float(distance_to)
|
|
if distance_to
|
|
else True,
|
|
Workout.moving >= convert_in_duration(duration_from)
|
|
if duration_from
|
|
else True,
|
|
Workout.moving <= convert_in_duration(duration_to)
|
|
if duration_to
|
|
else True,
|
|
Workout.ave_speed >= float(ave_speed_from)
|
|
if ave_speed_from
|
|
else True,
|
|
Workout.ave_speed <= float(ave_speed_to)
|
|
if ave_speed_to
|
|
else True,
|
|
Workout.max_speed >= float(max_speed_from)
|
|
if max_speed_from
|
|
else True,
|
|
Workout.max_speed <= float(max_speed_to)
|
|
if max_speed_to
|
|
else True,
|
|
)
|
|
.order_by(
|
|
asc(workout_column)
|
|
if order == 'asc'
|
|
else desc(workout_column),
|
|
)
|
|
.paginate(page, per_page, False)
|
|
)
|
|
workouts = workouts_pagination.items
|
|
return {
|
|
'status': 'success',
|
|
'data': {
|
|
'workouts': [workout.serialize(params) for workout in workouts]
|
|
},
|
|
'pagination': {
|
|
'has_next': workouts_pagination.has_next,
|
|
'has_prev': workouts_pagination.has_prev,
|
|
'page': workouts_pagination.page,
|
|
'pages': workouts_pagination.pages,
|
|
'total': workouts_pagination.total,
|
|
},
|
|
}
|
|
except Exception as e:
|
|
return handle_error_and_return_response(e)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>', methods=['GET']
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_workout(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get a workout.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF HTTP/1.1
|
|
|
|
**Example responses**:
|
|
|
|
- success
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": [
|
|
{
|
|
"ascent": null,
|
|
"ave_speed": 16,
|
|
"bounds": [],
|
|
"creation_date": "Sun, 14 Jul 2019 18:57:14 GMT",
|
|
"descent": null,
|
|
"distance": 12,
|
|
"duration": "0:45:00",
|
|
"id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
"map": null,
|
|
"max_alt": null,
|
|
"max_speed": 16,
|
|
"min_alt": null,
|
|
"modification_date": "Sun, 14 Jul 2019 18:57:22 GMT",
|
|
"moving": "0:45:00",
|
|
"next_workout": 4,
|
|
"notes": "workout without gpx",
|
|
"pauses": null,
|
|
"previous_workout": 3,
|
|
"records": [],
|
|
"segments": [],
|
|
"sport_id": 1,
|
|
"title": "biking on sunday morning",
|
|
"user": "admin",
|
|
"weather_end": null,
|
|
"weather_start": null,
|
|
"with_gpx": false,
|
|
"workout_date": "Sun, 07 Jul 2019 07:00:00 GMT"
|
|
}
|
|
]
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
- workout not found:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 404 NOT FOUND
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": []
|
|
},
|
|
"status": "not found"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 403: you do not have permissions
|
|
:statuscode 404: workout not found
|
|
|
|
"""
|
|
workout_uuid = decode_short_id(workout_short_id)
|
|
workout = Workout.query.filter_by(uuid=workout_uuid).first()
|
|
if not workout:
|
|
return DataNotFoundErrorResponse('workouts')
|
|
|
|
error_response = can_view_workout(auth_user.id, workout.user_id)
|
|
if error_response:
|
|
return error_response
|
|
|
|
return {
|
|
'status': 'success',
|
|
'data': {'workouts': [workout.serialize()]},
|
|
}
|
|
|
|
|
|
def get_workout_data(
|
|
auth_user: User,
|
|
workout_short_id: str,
|
|
data_type: str,
|
|
segment_id: Optional[int] = None,
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""Get data from a workout gpx file"""
|
|
workout_uuid = decode_short_id(workout_short_id)
|
|
workout = Workout.query.filter_by(uuid=workout_uuid).first()
|
|
if not workout:
|
|
return DataNotFoundErrorResponse(
|
|
data_type=data_type,
|
|
message=f'workout not found (id: {workout_short_id})',
|
|
)
|
|
|
|
error_response = can_view_workout(auth_user.id, workout.user_id)
|
|
if error_response:
|
|
return error_response
|
|
if not workout.gpx or workout.gpx == '':
|
|
return NotFoundErrorResponse(
|
|
f'no gpx file for this workout (id: {workout_short_id})'
|
|
)
|
|
|
|
try:
|
|
absolute_gpx_filepath = get_absolute_file_path(workout.gpx)
|
|
chart_data_content: Optional[List] = []
|
|
if data_type == 'chart_data':
|
|
chart_data_content = get_chart_data(
|
|
absolute_gpx_filepath, segment_id
|
|
)
|
|
else: # data_type == 'gpx'
|
|
with open(absolute_gpx_filepath, encoding='utf-8') as f:
|
|
gpx_content = f.read()
|
|
if segment_id is not None:
|
|
gpx_segment_content = extract_segment_from_gpx_file(
|
|
gpx_content, segment_id
|
|
)
|
|
except WorkoutGPXException as e:
|
|
appLog.error(e.message)
|
|
if e.status == 'not found':
|
|
return NotFoundErrorResponse(e.message)
|
|
return InternalServerErrorResponse(e.message)
|
|
except Exception as e:
|
|
return handle_error_and_return_response(e)
|
|
|
|
return {
|
|
'status': 'success',
|
|
'message': '',
|
|
'data': (
|
|
{
|
|
data_type: chart_data_content
|
|
if data_type == 'chart_data'
|
|
else gpx_content
|
|
if segment_id is None
|
|
else gpx_segment_content
|
|
}
|
|
),
|
|
}
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>/gpx', methods=['GET']
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_workout_gpx(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get gpx file for a workout displayed on map with Leaflet.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/gpx HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"gpx": "gpx file content"
|
|
},
|
|
"message": "",
|
|
"status": "success"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404:
|
|
- workout not found
|
|
- no gpx file for this workout
|
|
:statuscode 500:
|
|
|
|
"""
|
|
return get_workout_data(auth_user, workout_short_id, 'gpx')
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>/chart_data', methods=['GET']
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_workout_chart_data(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get chart data from a workout gpx file, to display it with Chart.js.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/chart HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"chart_data": [
|
|
{
|
|
"distance": 0,
|
|
"duration": 0,
|
|
"elevation": 279.4,
|
|
"latitude": 51.5078118,
|
|
"longitude": -0.1232004,
|
|
"speed": 8.63,
|
|
"time": "Fri, 14 Jul 2017 13:44:03 GMT"
|
|
},
|
|
{
|
|
"distance": 7.5,
|
|
"duration": 7380,
|
|
"elevation": 280,
|
|
"latitude": 51.5079733,
|
|
"longitude": -0.1234538,
|
|
"speed": 6.39,
|
|
"time": "Fri, 14 Jul 2017 15:47:03 GMT"
|
|
}
|
|
]
|
|
},
|
|
"message": "",
|
|
"status": "success"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404:
|
|
- workout not found
|
|
- no gpx file for this workout
|
|
:statuscode 500:
|
|
|
|
"""
|
|
return get_workout_data(auth_user, workout_short_id, 'chart_data')
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>/gpx/segment/<int:segment_id>',
|
|
methods=['GET'],
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_segment_gpx(
|
|
auth_user: User, workout_short_id: str, segment_id: int
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get gpx file for a workout segment displayed on map with Leaflet.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/gpx/segment/0 HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"gpx": "gpx file content"
|
|
},
|
|
"message": "",
|
|
"status": "success"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
:param integer segment_id: segment id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 400: no gpx file for this workout
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404: workout not found
|
|
:statuscode 500:
|
|
|
|
"""
|
|
return get_workout_data(auth_user, workout_short_id, 'gpx', segment_id)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>/chart_data/segment/'
|
|
'<int:segment_id>',
|
|
methods=['GET'],
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def get_segment_chart_data(
|
|
auth_user: User, workout_short_id: str, segment_id: int
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Get chart data from a workout gpx file, to display it with Recharts
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/chart/segment/0 HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"chart_data": [
|
|
{
|
|
"distance": 0,
|
|
"duration": 0,
|
|
"elevation": 279.4,
|
|
"latitude": 51.5078118,
|
|
"longitude": -0.1232004,
|
|
"speed": 8.63,
|
|
"time": "Fri, 14 Jul 2017 13:44:03 GMT"
|
|
},
|
|
{
|
|
"distance": 7.5,
|
|
"duration": 7380,
|
|
"elevation": 280,
|
|
"latitude": 51.5079733,
|
|
"longitude": -0.1234538,
|
|
"speed": 6.39,
|
|
"time": "Fri, 14 Jul 2017 15:47:03 GMT"
|
|
}
|
|
]
|
|
},
|
|
"message": "",
|
|
"status": "success"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
:param integer segment_id: segment id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: success
|
|
:statuscode 400: no gpx file for this workout
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404: workout not found
|
|
:statuscode 500:
|
|
|
|
"""
|
|
return get_workout_data(
|
|
auth_user, workout_short_id, 'chart_data', segment_id
|
|
)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>/gpx/download', methods=['GET']
|
|
)
|
|
@require_auth(scopes=['workouts:read'])
|
|
def download_workout_gpx(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[HttpResponse, Response]:
|
|
"""
|
|
Download gpx file.
|
|
|
|
**Scope**: ``workouts:read``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/kjxavSTUrJvoAh2wvCeGEF/gpx/download HTTP/1.1
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/gpx+xml
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404:
|
|
- workout not found
|
|
- no gpx file for workout
|
|
"""
|
|
workout_uuid = decode_short_id(workout_short_id)
|
|
workout = Workout.query.filter_by(
|
|
uuid=workout_uuid, user_id=auth_user.id
|
|
).first()
|
|
if not workout:
|
|
return DataNotFoundErrorResponse(
|
|
data_type='workout',
|
|
message=f'workout not found (id: {workout_short_id})',
|
|
)
|
|
|
|
if workout.gpx is None:
|
|
return DataNotFoundErrorResponse(
|
|
data_type='gpx',
|
|
message=f'no gpx file for workout (id: {workout_short_id})',
|
|
)
|
|
|
|
return send_from_directory(
|
|
current_app.config['UPLOAD_FOLDER'],
|
|
workout.gpx,
|
|
mimetype='application/gpx+xml',
|
|
as_attachment=True,
|
|
)
|
|
|
|
|
|
@workouts_blueprint.route('/workouts/map/<map_id>', methods=['GET'])
|
|
@limiter.exempt
|
|
def get_map(map_id: int) -> Union[HttpResponse, Response]:
|
|
"""
|
|
Get map image for workouts with gpx.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/map/fa33f4d996844a5c73ecd1ae24456ab8?1563529507772
|
|
HTTP/1.1
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: image/png
|
|
|
|
:param string map_id: workout map id
|
|
|
|
:statuscode 200: success
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404: map does not exist
|
|
:statuscode 500:
|
|
|
|
"""
|
|
try:
|
|
workout = Workout.query.filter_by(map_id=map_id).first()
|
|
if not workout:
|
|
return NotFoundErrorResponse('Map does not exist.')
|
|
return send_from_directory(
|
|
current_app.config['UPLOAD_FOLDER'],
|
|
workout.map,
|
|
)
|
|
except NotFound:
|
|
return NotFoundErrorResponse('Map file does not exist.')
|
|
except Exception as e:
|
|
return handle_error_and_return_response(e)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/map_tile/<s>/<z>/<x>/<y>.png', methods=['GET']
|
|
)
|
|
@limiter.exempt
|
|
def get_map_tile(s: str, z: str, x: str, y: str) -> Tuple[Response, int]:
|
|
"""
|
|
Get map tile from tile server.
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
GET /api/workouts/map_tile/c/13/4109/2930.png HTTP/1.1
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: image/png
|
|
|
|
:param string s: subdomain
|
|
:param string z: zoom
|
|
:param string x: index of the tile along the map's x axis
|
|
:param string y: index of the tile along the map's y axis
|
|
|
|
Status codes are status codes returned by tile server
|
|
|
|
"""
|
|
url = current_app.config['TILE_SERVER']['URL'].format(
|
|
s=secure_filename(s),
|
|
z=secure_filename(z),
|
|
x=secure_filename(x),
|
|
y=secure_filename(y),
|
|
)
|
|
headers = {'User-Agent': 'Mozilla/5.0 (X11; Linux x86_64; rv:88.0)'}
|
|
response = requests.get(url, headers=headers)
|
|
return (
|
|
Response(
|
|
response.content,
|
|
content_type=response.headers['content-type'],
|
|
),
|
|
response.status_code,
|
|
)
|
|
|
|
|
|
@workouts_blueprint.route('/workouts', methods=['POST'])
|
|
@require_auth(scopes=['workouts:write'])
|
|
def post_workout(auth_user: User) -> Union[Tuple[Dict, int], HttpResponse]:
|
|
"""
|
|
Post a workout with a gpx file.
|
|
|
|
**Scope**: ``workouts:write``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
POST /api/workouts/ HTTP/1.1
|
|
Content-Type: multipart/form-data
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 201 CREATED
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": [
|
|
{
|
|
"ascent": null,
|
|
"ave_speed": 10.0,
|
|
"bounds": [],
|
|
"creation_date": "Sun, 14 Jul 2019 13:51:01 GMT",
|
|
"descent": null,
|
|
"distance": 10.0,
|
|
"duration": "0:17:04",
|
|
"id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
"map": null,
|
|
"max_alt": null,
|
|
"max_speed": 10.0,
|
|
"min_alt": null,
|
|
"modification_date": null,
|
|
"moving": "0:17:04",
|
|
"next_workout": 3,
|
|
"notes": null,
|
|
"pauses": null,
|
|
"previous_workout": null,
|
|
"records": [
|
|
{
|
|
"id": 4,
|
|
"record_type": "MS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 3,
|
|
"record_type": "LD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": "0:17:04",
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
},
|
|
{
|
|
"id": 2,
|
|
"record_type": "FD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 1,
|
|
"record_type": "AS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
}
|
|
],
|
|
"segments": [],
|
|
"sport_id": 1,
|
|
"title": null,
|
|
"user": "admin",
|
|
"weather_end": null,
|
|
"weather_start": null,
|
|
"with_gpx": false,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT"
|
|
}
|
|
]
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
:form file: gpx file (allowed extensions: .gpx, .zip)
|
|
:form data: sport id and notes (example: ``{"sport_id": 1, "notes": ""}``)
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 201: workout created
|
|
:statuscode 400:
|
|
- invalid payload
|
|
- no file part
|
|
- no selected file
|
|
- file extension not allowed
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 413: error during picture update: file size exceeds 1.0MB
|
|
:statuscode 500:
|
|
|
|
"""
|
|
try:
|
|
error_response = get_error_response_if_file_is_invalid(
|
|
'workout', request
|
|
)
|
|
except RequestEntityTooLarge as e:
|
|
appLog.error(e)
|
|
return PayloadTooLargeErrorResponse(
|
|
file_type='workout',
|
|
file_size=request.content_length,
|
|
max_size=current_app.config['MAX_CONTENT_LENGTH'],
|
|
)
|
|
if error_response:
|
|
return error_response
|
|
|
|
workout_data = json.loads(request.form['data'], strict=False)
|
|
if not workout_data or workout_data.get('sport_id') is None:
|
|
return InvalidPayloadErrorResponse()
|
|
|
|
workout_file = request.files['file']
|
|
upload_dir = os.path.join(
|
|
current_app.config['UPLOAD_FOLDER'], 'workouts', str(auth_user.id)
|
|
)
|
|
folders = {
|
|
'extract_dir': os.path.join(upload_dir, 'extract'),
|
|
'tmp_dir': os.path.join(upload_dir, 'tmp'),
|
|
}
|
|
|
|
try:
|
|
new_workouts = process_files(
|
|
auth_user, workout_data, workout_file, folders
|
|
)
|
|
if len(new_workouts) > 0:
|
|
response_object = {
|
|
'status': 'created',
|
|
'data': {
|
|
'workouts': [
|
|
new_workout.serialize() for new_workout in new_workouts
|
|
]
|
|
},
|
|
}
|
|
else:
|
|
return DataInvalidPayloadErrorResponse('workouts', 'fail')
|
|
except WorkoutException as e:
|
|
db.session.rollback()
|
|
if e.e:
|
|
appLog.error(e.e)
|
|
if e.status == 'error':
|
|
return InternalServerErrorResponse(e.message)
|
|
return InvalidPayloadErrorResponse(e.message)
|
|
|
|
shutil.rmtree(folders['extract_dir'], ignore_errors=True)
|
|
shutil.rmtree(folders['tmp_dir'], ignore_errors=True)
|
|
return response_object, 201
|
|
|
|
|
|
@workouts_blueprint.route('/workouts/no_gpx', methods=['POST'])
|
|
@require_auth(scopes=['workouts:write'])
|
|
def post_workout_no_gpx(
|
|
auth_user: User,
|
|
) -> Union[Tuple[Dict, int], HttpResponse]:
|
|
"""
|
|
Post a workout without gpx file.
|
|
|
|
**Scope**: ``workouts:write``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
POST /api/workouts/no_gpx HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 201 CREATED
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": [
|
|
{
|
|
"ascent": null,
|
|
"ave_speed": 10.0,
|
|
"bounds": [],
|
|
"creation_date": "Sun, 14 Jul 2019 13:51:01 GMT",
|
|
"descent": null,
|
|
"distance": 10.0,
|
|
"duration": "0:17:04",
|
|
"map": null,
|
|
"max_alt": null,
|
|
"max_speed": 10.0,
|
|
"min_alt": null,
|
|
"modification_date": null,
|
|
"moving": "0:17:04",
|
|
"next_workout": 3,
|
|
"notes": null,
|
|
"pauses": null,
|
|
"previous_workout": null,
|
|
"records": [
|
|
{
|
|
"id": 4,
|
|
"record_type": "MS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 3,
|
|
"record_type": "LD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": "0:17:04",
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 2,
|
|
"record_type": "FD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 1,
|
|
"record_type": "AS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
}
|
|
],
|
|
"segments": [],
|
|
"sport_id": 1,
|
|
"title": null,
|
|
"user": "admin",
|
|
"uuid": "kjxavSTUrJvoAh2wvCeGEF"
|
|
"weather_end": null,
|
|
"weather_start": null,
|
|
"with_gpx": false,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT"
|
|
}
|
|
]
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
:<json string workout_date: workout date, in user timezone
|
|
(format: ``%Y-%m-%d %H:%M``)
|
|
:<json float distance: workout distance in km
|
|
:<json integer duration: workout duration in seconds
|
|
:<json string notes: notes (not mandatory)
|
|
:<json integer sport_id: workout sport id
|
|
:<json string title: workout title
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 201: workout created
|
|
:statuscode 400: invalid payload
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 500:
|
|
|
|
"""
|
|
workout_data = request.get_json()
|
|
if (
|
|
not workout_data
|
|
or workout_data.get('sport_id') is None
|
|
or workout_data.get('duration') is None
|
|
or workout_data.get('distance') is None
|
|
or workout_data.get('workout_date') is None
|
|
):
|
|
return InvalidPayloadErrorResponse()
|
|
|
|
try:
|
|
new_workout = create_workout(auth_user, workout_data)
|
|
db.session.add(new_workout)
|
|
db.session.commit()
|
|
|
|
return (
|
|
{
|
|
'status': 'created',
|
|
'data': {'workouts': [new_workout.serialize()]},
|
|
},
|
|
201,
|
|
)
|
|
|
|
except (exc.IntegrityError, ValueError) as e:
|
|
return handle_error_and_return_response(
|
|
error=e,
|
|
message='Error during workout save.',
|
|
status='fail',
|
|
db=db,
|
|
)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>', methods=['PATCH']
|
|
)
|
|
@require_auth(scopes=['workouts:write'])
|
|
def update_workout(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[Dict, HttpResponse]:
|
|
"""
|
|
Update a workout.
|
|
|
|
**Scope**: ``workouts:write``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
PATCH /api/workouts/1 HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 200 OK
|
|
Content-Type: application/json
|
|
|
|
{
|
|
"data": {
|
|
"workouts": [
|
|
{
|
|
"ascent": null,
|
|
"ave_speed": 10.0,
|
|
"bounds": [],
|
|
"creation_date": "Sun, 14 Jul 2019 13:51:01 GMT",
|
|
"descent": null,
|
|
"distance": 10.0,
|
|
"duration": "0:17:04",
|
|
"map": null,
|
|
"max_alt": null,
|
|
"max_speed": 10.0,
|
|
"min_alt": null,
|
|
"modification_date": null,
|
|
"moving": "0:17:04",
|
|
"next_workout": 3,
|
|
"notes": null,
|
|
"pauses": null,
|
|
"previous_workout": null,
|
|
"records": [
|
|
{
|
|
"id": 4,
|
|
"record_type": "MS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 3,
|
|
"record_type": "LD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": "0:17:04",
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF"
|
|
},
|
|
{
|
|
"id": 2,
|
|
"record_type": "FD",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
},
|
|
{
|
|
"id": 1,
|
|
"record_type": "AS",
|
|
"sport_id": 1,
|
|
"user": "admin",
|
|
"value": 10.0,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT",
|
|
"workout_id": "kjxavSTUrJvoAh2wvCeGEF",
|
|
}
|
|
],
|
|
"segments": [],
|
|
"sport_id": 1,
|
|
"title": null,
|
|
"user": "admin",
|
|
"uuid": "kjxavSTUrJvoAh2wvCeGEF"
|
|
"weather_end": null,
|
|
"weather_start": null,
|
|
"with_gpx": false,
|
|
"workout_date": "Mon, 01 Jan 2018 00:00:00 GMT"
|
|
}
|
|
]
|
|
},
|
|
"status": "success"
|
|
}
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:<json string workout_date: workout date in user timezone
|
|
(format: ``%Y-%m-%d %H:%M``)
|
|
(only for workout without gpx)
|
|
:<json float distance: workout distance in km
|
|
(only for workout without gpx)
|
|
:<json integer duration: workout duration in seconds
|
|
(only for workout without gpx)
|
|
:<json string notes: notes
|
|
:<json integer sport_id: workout sport id
|
|
:<json string title: workout title
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 200: workout updated
|
|
:statuscode 400: invalid payload
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404: workout not found
|
|
:statuscode 500:
|
|
|
|
"""
|
|
workout_data = request.get_json()
|
|
if not workout_data:
|
|
return InvalidPayloadErrorResponse()
|
|
|
|
try:
|
|
workout_uuid = decode_short_id(workout_short_id)
|
|
workout = Workout.query.filter_by(uuid=workout_uuid).first()
|
|
if not workout:
|
|
return DataNotFoundErrorResponse('workouts')
|
|
|
|
response_object = can_view_workout(auth_user.id, workout.user_id)
|
|
if response_object:
|
|
return response_object
|
|
|
|
workout = edit_workout(workout, workout_data, auth_user)
|
|
db.session.commit()
|
|
return {
|
|
'status': 'success',
|
|
'data': {'workouts': [workout.serialize()]},
|
|
}
|
|
|
|
except (exc.IntegrityError, exc.OperationalError, ValueError) as e:
|
|
return handle_error_and_return_response(e)
|
|
|
|
|
|
@workouts_blueprint.route(
|
|
'/workouts/<string:workout_short_id>', methods=['DELETE']
|
|
)
|
|
@require_auth(scopes=['workouts:write'])
|
|
def delete_workout(
|
|
auth_user: User, workout_short_id: str
|
|
) -> Union[Tuple[Dict, int], HttpResponse]:
|
|
"""
|
|
Delete a workout.
|
|
|
|
**Scope**: ``workouts:write``
|
|
|
|
**Example request**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
DELETE /api/workouts/kjxavSTUrJvoAh2wvCeGEF HTTP/1.1
|
|
Content-Type: application/json
|
|
|
|
**Example response**:
|
|
|
|
.. sourcecode:: http
|
|
|
|
HTTP/1.1 204 NO CONTENT
|
|
Content-Type: application/json
|
|
|
|
:param string workout_short_id: workout short id
|
|
|
|
:reqheader Authorization: OAuth 2.0 Bearer Token
|
|
|
|
:statuscode 204: workout deleted
|
|
:statuscode 401:
|
|
- provide a valid auth token
|
|
- signature expired, please log in again
|
|
- invalid token, please log in again
|
|
:statuscode 404: workout not found
|
|
:statuscode 500: error, please try again or contact the administrator
|
|
|
|
"""
|
|
|
|
try:
|
|
workout_uuid = decode_short_id(workout_short_id)
|
|
workout = Workout.query.filter_by(uuid=workout_uuid).first()
|
|
if not workout:
|
|
return DataNotFoundErrorResponse('workouts')
|
|
error_response = can_view_workout(auth_user.id, workout.user_id)
|
|
if error_response:
|
|
return error_response
|
|
|
|
db.session.delete(workout)
|
|
db.session.commit()
|
|
return {'status': 'no content'}, 204
|
|
except (
|
|
exc.IntegrityError,
|
|
exc.OperationalError,
|
|
ValueError,
|
|
OSError,
|
|
) as e:
|
|
return handle_error_and_return_response(e, db=db)
|