Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 1 | """REST API for accessing heartbeats.""" |
| 2 | |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 3 | from django.shortcuts import get_object_or_404 |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 4 | from django.utils.decorators import method_decorator |
| 5 | from drf_yasg import openapi |
| 6 | from drf_yasg.utils import swagger_auto_schema |
| 7 | from rest_framework import generics, status |
| 8 | from rest_framework.exceptions import NotFound, ValidationError |
| 9 | |
Dirk Vogt | c9e10ab | 2016-10-12 13:58:15 +0200 | [diff] [blame] | 10 | from crashreports.models import HeartBeat |
Dirk Vogt | c9e10ab | 2016-10-12 13:58:15 +0200 | [diff] [blame] | 11 | from crashreports.permissions import HasRightsOrIsDeviceOwnerDeviceCreation |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 12 | from crashreports.response_descriptions import default_desc |
| 13 | from crashreports.serializers import HeartBeatSerializer |
Dirk Vogt | c9e10ab | 2016-10-12 13:58:15 +0200 | [diff] [blame] | 14 | |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 15 | |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 16 | @method_decorator( |
| 17 | name="get", |
| 18 | decorator=swagger_auto_schema(operation_description="List heartbeats"), |
| 19 | ) |
| 20 | @method_decorator( |
| 21 | name="post", |
| 22 | decorator=swagger_auto_schema( |
| 23 | operation_description="Create a heartbeat", |
| 24 | request_body=HeartBeatSerializer, |
| 25 | responses=dict( |
| 26 | [ |
| 27 | default_desc(ValidationError), |
| 28 | ( |
| 29 | status.HTTP_404_NOT_FOUND, |
| 30 | openapi.Response( |
| 31 | "No device with the given uuid could be found." |
| 32 | ), |
| 33 | ), |
| 34 | ] |
| 35 | ), |
| 36 | ), |
| 37 | ) |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 38 | class ListCreateView(generics.ListCreateAPIView): |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 39 | """Endpoint for listing heartbeats and creating new heartbeats.""" |
| 40 | |
Dirk Vogt | c9e10ab | 2016-10-12 13:58:15 +0200 | [diff] [blame] | 41 | queryset = HeartBeat.objects.all() |
| 42 | paginate_by = 20 |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 43 | permission_classes = (HasRightsOrIsDeviceOwnerDeviceCreation,) |
Dirk Vogt | c9e10ab | 2016-10-12 13:58:15 +0200 | [diff] [blame] | 44 | serializer_class = HeartBeatSerializer |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 45 | filter_fields = ("device", "build_fingerprint", "radio_version") |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 46 | |
Mitja Nikolaus | 773d0cd | 2018-08-31 10:55:43 +0200 | [diff] [blame] | 47 | def get(self, request, *args, **kwargs): |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 48 | """Override device__uuid parameter with uuid.""" |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 49 | if "uuid" in kwargs: |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 50 | self.queryset = HeartBeat.objects.filter( |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 51 | device__uuid=kwargs["uuid"] |
| 52 | ) |
Mitja Nikolaus | 773d0cd | 2018-08-31 10:55:43 +0200 | [diff] [blame] | 53 | return generics.ListCreateAPIView.get(self, request, *args, **kwargs) |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 54 | |
| 55 | |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 56 | @method_decorator( |
| 57 | name="get", |
| 58 | decorator=swagger_auto_schema( |
| 59 | operation_description="Get a heartbeat", |
| 60 | responses=dict([default_desc(NotFound)]), |
| 61 | ), |
| 62 | ) |
| 63 | @method_decorator( |
| 64 | name="put", |
| 65 | decorator=swagger_auto_schema( |
| 66 | operation_description="Update a heartbeat", |
| 67 | responses=dict([default_desc(NotFound), default_desc(ValidationError)]), |
| 68 | ), |
| 69 | ) |
| 70 | @method_decorator( |
| 71 | name="patch", |
| 72 | decorator=swagger_auto_schema( |
| 73 | operation_description="Partially update a heartbeat", |
| 74 | responses=dict([default_desc(NotFound), default_desc(ValidationError)]), |
| 75 | ), |
| 76 | ) |
| 77 | @method_decorator( |
| 78 | name="delete", |
| 79 | decorator=swagger_auto_schema( |
| 80 | operation_description="Delete a heartbeat", |
| 81 | responses=dict([default_desc(NotFound)]), |
| 82 | ), |
| 83 | ) |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 84 | class RetrieveUpdateDestroyView(generics.RetrieveUpdateDestroyAPIView): |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 85 | """Endpoint for retrieving, updating and deleting heartbeats.""" |
| 86 | |
| 87 | # pylint: disable=too-many-ancestors |
| 88 | |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 89 | queryset = HeartBeat.objects.all() |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 90 | permission_classes = (HasRightsOrIsDeviceOwnerDeviceCreation,) |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 91 | serializer_class = HeartBeatSerializer |
Mitja Nikolaus | cb50f2c | 2018-08-24 13:54:48 +0200 | [diff] [blame] | 92 | multiple_lookup_fields = {"id", "device__uuid", "device_local_id"} |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 93 | |
| 94 | def get_object(self): |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 95 | """Retrieve a heartbeat.""" |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 96 | queryset = self.get_queryset() |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 97 | query_filter = {} |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 98 | for field in self.multiple_lookup_fields: |
| 99 | if field in self.kwargs: |
Mitja Nikolaus | 1280ef4 | 2018-08-21 16:20:07 +0200 | [diff] [blame] | 100 | query_filter[field] = self.kwargs[field] |
| 101 | obj = get_object_or_404(queryset, **query_filter) |
Dirk Vogt | e178488 | 2016-10-13 16:09:38 +0200 | [diff] [blame] | 102 | self.check_object_permissions(self.request, obj) |
| 103 | return obj |