Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 1 | """Utility functions shared by all crashreports tests.""" |
| 2 | |
Mitja Nikolaus | 6e11847 | 2018-10-04 11:15:29 +0200 | [diff] [blame] | 3 | import os |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 4 | import shutil |
Mitja Nikolaus | bc03e68 | 2018-11-13 16:48:20 +0100 | [diff] [blame] | 5 | import threading |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 6 | import zipfile |
| 7 | from datetime import date, datetime |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 8 | from typing import Optional, Dict, Type, Union, Tuple, Any |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 9 | |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 10 | import pytz |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 11 | from django.conf import settings |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 12 | from django.contrib.auth.models import User, Group |
Mitja Nikolaus | bc03e68 | 2018-11-13 16:48:20 +0100 | [diff] [blame] | 13 | from django.test import TransactionTestCase |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 14 | from django.urls import reverse |
| 15 | from rest_framework import status |
Mitja Nikolaus | bc03e68 | 2018-11-13 16:48:20 +0100 | [diff] [blame] | 16 | from rest_framework.test import APIClient, APITestCase |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 17 | |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 18 | from crashreports.models import ( |
| 19 | Crashreport, |
| 20 | Device, |
| 21 | HeartBeat, |
| 22 | LogFile, |
| 23 | crashreport_file_name, |
| 24 | ) |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 25 | from hiccup.allauth_adapters import FP_STAFF_GROUP_NAME |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 26 | |
| 27 | |
| 28 | class InvalidCrashTypeError(BaseException): |
| 29 | """Invalid crash type encountered. |
| 30 | |
| 31 | The valid crash type values (strings) are: |
| 32 | - 'crash'; |
| 33 | - 'smpl'; |
| 34 | - 'other'. |
| 35 | |
| 36 | Args: |
| 37 | - crash_type: The invalid crash type. |
| 38 | """ |
| 39 | |
| 40 | def __init__(self, crash_type): |
| 41 | """Initialise the exception using the crash type to build a message. |
| 42 | |
| 43 | Args: |
| 44 | crash_type: The invalid crash type. |
| 45 | """ |
| 46 | super(InvalidCrashTypeError, self).__init__( |
| 47 | "{} is not a valid crash type".format(crash_type) |
| 48 | ) |
| 49 | |
| 50 | |
| 51 | class Dummy: |
| 52 | """Dummy values for devices, heartbeats and crashreports.""" |
| 53 | |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 54 | # Valid unique entries |
| 55 | BUILD_FINGERPRINTS = [ |
| 56 | ( |
| 57 | "Fairphone/FP2/FP2:5.1/FP2/r4275.1_FP2_gms76_1.13.0" |
| 58 | ":user/release-keys" |
| 59 | ), |
| 60 | ( |
| 61 | "Fairphone/FP2/FP2:5.1.1/FP2-gms75.1.13.0/FP2-gms75.1.13.0" |
| 62 | ":user/release-keys" |
| 63 | ), |
| 64 | ( |
| 65 | "Fairphone/FP2/FP2:6.0.1/FP2-gms-18.04.1/FP2-gms-18.04.1" |
| 66 | ":user/release-keys" |
| 67 | ), |
| 68 | ("Fairphone/FP2/FP2:7.1.2/18.07.2/gms-7480c31d:user/release-keys"), |
| 69 | ] |
| 70 | RADIO_VERSIONS = [ |
| 71 | "4437.1-FP2-0-07", |
| 72 | "4437.1-FP2-0-08", |
| 73 | "4437.1-FP2-0-09", |
| 74 | "4437.1-FP2-0-10", |
| 75 | ] |
| 76 | UUIDs = ["e1c0cc95-ab8d-461a-a768-cb8d9d7fdb04"] |
| 77 | |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 78 | USERNAMES = ["testuser1", "testuser2", "testuser3", "testuser4"] |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 79 | |
| 80 | DATES = [date(2018, 3, 19), date(2018, 3, 26), date(2018, 5, 1)] |
| 81 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 82 | DEFAULT_USER_VALUES = {"username": USERNAMES[0]} |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 83 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 84 | DEFAULT_DEVICE_REGISTER_VALUES = { |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 85 | "board_date": datetime(2015, 12, 15, 1, 23, 45, tzinfo=pytz.utc), |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 86 | "chipset": "Qualcomm MSM8974PRO-AA", |
| 87 | } |
| 88 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 89 | DEFAULT_DEVICE_VALUES = DEFAULT_DEVICE_REGISTER_VALUES.copy() |
| 90 | DEFAULT_DEVICE_VALUES.update( |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 91 | {"token": "64111c62d521fb4724454ca6dea27e18f93ef56e"} |
| 92 | ) |
| 93 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 94 | DEFAULT_HEARTBEAT_VALUES = { |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 95 | "app_version": 10100, |
| 96 | "uptime": ( |
| 97 | "up time: 16 days, 21:49:56, idle time: 5 days, 20:55:04, " |
| 98 | "sleep time: 10 days, 20:46:27" |
| 99 | ), |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 100 | "build_fingerprint": BUILD_FINGERPRINTS[0], |
| 101 | "radio_version": RADIO_VERSIONS[0], |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 102 | "date": date(2018, 3, 19), |
| 103 | } |
| 104 | |
| 105 | ALTERNATIVE_HEARTBEAT_VALUES = { |
| 106 | "app_version": 10101, |
| 107 | "uptime": ( |
| 108 | "up time: 2 days, 12:39:13, idle time: 2 days, 11:35:01, " |
| 109 | "sleep time: 2 days, 11:56:12" |
| 110 | ), |
| 111 | "build_fingerprint": BUILD_FINGERPRINTS[1], |
| 112 | "radio_version": RADIO_VERSIONS[1], |
| 113 | "date": date(2018, 3, 19), |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 114 | } |
| 115 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 116 | DEFAULT_CRASHREPORT_VALUES = DEFAULT_HEARTBEAT_VALUES.copy() |
| 117 | DEFAULT_CRASHREPORT_VALUES.update( |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 118 | { |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 119 | "is_fake_report": False, |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 120 | "boot_reason": Crashreport.BOOT_REASON_UNKOWN, |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 121 | "power_on_reason": "it was powered on", |
| 122 | "power_off_reason": "something happened and it went off", |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 123 | "date": datetime(2018, 3, 19, 12, 0, 0, tzinfo=pytz.utc), |
| 124 | } |
| 125 | ) |
| 126 | |
| 127 | ALTERNATIVE_CRASHREPORT_VALUES = ALTERNATIVE_HEARTBEAT_VALUES.copy() |
| 128 | ALTERNATIVE_CRASHREPORT_VALUES.update( |
| 129 | { |
| 130 | "is_fake_report": True, |
| 131 | "boot_reason": Crashreport.BOOT_REASON_KEYBOARD_POWER_ON, |
| 132 | "power_on_reason": "alternative power on reason", |
| 133 | "power_off_reason": "alternative power off reason", |
| 134 | "date": datetime(2018, 3, 19, 12, 0, 0, tzinfo=pytz.utc), |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 135 | } |
| 136 | ) |
| 137 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 138 | DEFAULT_LOG_FILE_NAME = "dmesg.log" |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 139 | |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 140 | CRASH_TYPE_TO_BOOT_REASON_MAP = { |
| 141 | "crash": Crashreport.BOOT_REASON_KEYBOARD_POWER_ON, |
| 142 | "smpl": Crashreport.BOOT_REASON_RTC_ALARM, |
| 143 | "other": "whatever", |
| 144 | } |
| 145 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 146 | DEFAULT_LOG_FILE_FILENAMES = ["test_logfile_1.zip", "test_logfile_2.zip"] |
| 147 | DEFAULT_LOG_FILE_DIRECTORY = os.path.join("resources", "test") |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 148 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 149 | DEFAULT_LOG_FILE_VALUES = { |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 150 | "logfile_type": "last_kmsg", |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 151 | "logfile": DEFAULT_LOG_FILE_FILENAMES[0], |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 152 | } |
| 153 | |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 154 | DEFAULT_LOG_FILE_PATHS = [ |
| 155 | os.path.join(DEFAULT_LOG_FILE_DIRECTORY, DEFAULT_LOG_FILE_FILENAMES[0]), |
| 156 | os.path.join(DEFAULT_LOG_FILE_DIRECTORY, DEFAULT_LOG_FILE_FILENAMES[1]), |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 157 | ] |
| 158 | |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 159 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 160 | def _update_copy( |
| 161 | original: Dict[str, Any], update: Dict[str, Any] |
| 162 | ) -> Dict[str, Any]: |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 163 | """Merge fields of update into a copy of original.""" |
| 164 | data = original.copy() |
| 165 | data.update(update) |
| 166 | return data |
| 167 | |
| 168 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 169 | def device_register_data(**kwargs: Any) -> Dict[str, Any]: |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 170 | """Return the data required to register a device. |
| 171 | |
| 172 | Use the values passed as keyword arguments or default to the ones |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 173 | from `Dummy.DEFAULT_DEVICE_REGISTER_VALUES`. |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 174 | """ |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 175 | return Dummy._update_copy(Dummy.DEFAULT_DEVICE_REGISTER_VALUES, kwargs) |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 176 | |
| 177 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 178 | def heartbeat_data(**kwargs: Any) -> Dict[str, Any]: |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 179 | """Return the data required to create a heartbeat. |
| 180 | |
| 181 | Use the values passed as keyword arguments or default to the ones |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 182 | from `Dummy.DEFAULT_HEARTBEAT_VALUES`. |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 183 | """ |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 184 | return Dummy._update_copy(Dummy.DEFAULT_HEARTBEAT_VALUES, kwargs) |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 185 | |
| 186 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 187 | def alternative_heartbeat_data(**kwargs: Any) -> Dict[str, Any]: |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 188 | """Return the alternative data required to create a heartbeat. |
| 189 | |
| 190 | Use the values passed as keyword arguments or default to the ones |
| 191 | from `Dummy.ALTERNATIVE_HEARTBEAT_VALUES`. |
| 192 | """ |
| 193 | return Dummy._update_copy(Dummy.ALTERNATIVE_HEARTBEAT_VALUES, kwargs) |
| 194 | |
| 195 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 196 | def crashreport_data( |
| 197 | report_type: Optional[str] = None, **kwargs: Any |
| 198 | ) -> Dict[str, Any]: |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 199 | """Return the data required to create a crashreport. |
| 200 | |
| 201 | Use the values passed as keyword arguments or default to the ones |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 202 | from `Dummy.DEFAULT_CRASHREPORTS_VALUES`. |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 203 | |
| 204 | Args: |
| 205 | report_type: A valid value from |
| 206 | `Dummy.CRASH_TYPE_TO_BOOT_REASON_MAP.keys()` that will |
| 207 | define the boot reason if not explicitly defined in the |
| 208 | keyword arguments already. |
| 209 | """ |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 210 | data = Dummy._update_copy(Dummy.DEFAULT_CRASHREPORT_VALUES, kwargs) |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 211 | if report_type and "boot_reason" not in kwargs: |
| 212 | if report_type not in Dummy.CRASH_TYPE_TO_BOOT_REASON_MAP: |
| 213 | raise InvalidCrashTypeError(report_type) |
| 214 | data["boot_reason"] = Dummy.CRASH_TYPE_TO_BOOT_REASON_MAP.get( |
| 215 | report_type |
| 216 | ) |
| 217 | return data |
| 218 | |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 219 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 220 | def alternative_crashreport_data(**kwargs: Any) -> Dict[str, Any]: |
Mitja Nikolaus | fd452f8 | 2018-11-07 11:53:59 +0100 | [diff] [blame] | 221 | """Return the alternative data required to create a crashreport. |
| 222 | |
| 223 | Use the values passed as keyword arguments or default to the ones |
| 224 | from `Dummy.ALTERNATIVE_CRASHREPORT_VALUES`. |
| 225 | """ |
| 226 | return Dummy._update_copy(Dummy.ALTERNATIVE_CRASHREPORT_VALUES, kwargs) |
| 227 | |
| 228 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 229 | def create_user(**kwargs: Any) -> User: |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 230 | """Create a dummy user instance. |
| 231 | |
| 232 | The dummy instance is created and saved to the database. |
| 233 | Args: |
| 234 | **kwargs: |
| 235 | Optional arguments to extend/overwrite the default values. |
| 236 | |
| 237 | Returns: The created user instance. |
| 238 | |
| 239 | """ |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 240 | entity = User(**Dummy._update_copy(Dummy.DEFAULT_USER_VALUES, kwargs)) |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 241 | entity.save() |
| 242 | return entity |
| 243 | |
| 244 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 245 | def create_device(user: User, **kwargs: Any) -> Device: |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 246 | """Create a dummy device instance. |
| 247 | |
| 248 | The dummy instance is created and saved to the database. |
| 249 | Args: |
| 250 | user: The user instance that the device should relate to |
| 251 | **kwargs: |
| 252 | Optional arguments to extend/overwrite the default values. |
| 253 | |
| 254 | Returns: The created device instance. |
| 255 | |
| 256 | """ |
| 257 | entity = Device( |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 258 | user=user, **Dummy._update_copy(Dummy.DEFAULT_DEVICE_VALUES, kwargs) |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 259 | ) |
| 260 | entity.save() |
| 261 | return entity |
| 262 | |
| 263 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 264 | def create_report( |
| 265 | report_type: Type[Union[HeartBeat, Crashreport]], |
| 266 | device: Device, |
| 267 | **kwargs: Any |
| 268 | ) -> Union[HeartBeat, Crashreport]: |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 269 | """Create a dummy report instance of the given report class type. |
| 270 | |
| 271 | The dummy instance is created and saved to the database. |
| 272 | Args: |
| 273 | report_type: The class of the report type to be created. |
| 274 | user: The device instance that the heartbeat should relate to |
| 275 | **kwargs: |
| 276 | Optional arguments to extend/overwrite the default values. |
| 277 | |
| 278 | Returns: The created report instance. |
| 279 | |
| 280 | Raises: |
| 281 | RuntimeError: If report_type is not a report class type. |
| 282 | |
| 283 | """ |
| 284 | if report_type == HeartBeat: |
| 285 | entity = HeartBeat( |
| 286 | device=device, |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 287 | **Dummy._update_copy(Dummy.DEFAULT_HEARTBEAT_VALUES, kwargs) |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 288 | ) |
| 289 | elif report_type == Crashreport: |
| 290 | entity = Crashreport( |
| 291 | device=device, |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 292 | **Dummy._update_copy(Dummy.DEFAULT_CRASHREPORT_VALUES, kwargs) |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 293 | ) |
| 294 | else: |
| 295 | raise RuntimeError( |
| 296 | "No dummy report instance can be created for {}".format( |
| 297 | report_type.__name__ |
| 298 | ) |
| 299 | ) |
| 300 | entity.save() |
| 301 | return entity |
| 302 | |
| 303 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 304 | def create_log_file(crashreport: Crashreport, **kwargs: Any) -> LogFile: |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 305 | """Create a dummy log file instance. |
| 306 | |
| 307 | The dummy instance is created and saved to the database. |
| 308 | |
| 309 | Args: |
| 310 | crashreport: The crashreport that the log file belongs to. |
| 311 | **kwargs: Optional arguments to extend/overwrite the default values. |
| 312 | |
| 313 | Returns: The created log file instance. |
| 314 | |
| 315 | """ |
| 316 | entity = LogFile( |
| 317 | crashreport=crashreport, |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 318 | **Dummy._update_copy(Dummy.DEFAULT_LOG_FILE_VALUES, kwargs) |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 319 | ) |
| 320 | |
| 321 | entity.save() |
| 322 | return entity |
| 323 | |
| 324 | @staticmethod |
Mitja Nikolaus | 1509d8f | 2018-12-06 11:33:17 +0100 | [diff] [blame] | 325 | def create_log_file_with_actual_file( |
| 326 | crashreport: Crashreport, **kwargs: Any |
| 327 | ) -> Tuple[LogFile, str]: |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 328 | """Create a dummy log file instance along with a file. |
| 329 | |
| 330 | The dummy instance is created and saved to the database. The log file |
| 331 | is copied to the respective location in the media directory. |
| 332 | |
| 333 | Args: |
| 334 | crashreport: The crashreport that the log file belongs to. |
| 335 | **kwargs: Optional arguments to extend/overwrite the default values. |
| 336 | |
| 337 | Returns: The created log file instance and the path to the copied file. |
| 338 | |
| 339 | """ |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 340 | logfile = Dummy.create_log_file(crashreport, **kwargs) |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 341 | logfile_filename = os.path.basename(logfile.logfile.path) |
| 342 | test_logfile_path = os.path.join( |
| 343 | settings.MEDIA_ROOT, |
| 344 | crashreport_file_name(logfile, logfile_filename), |
| 345 | ) |
| 346 | logfile.logfile = test_logfile_path |
| 347 | logfile.save() |
| 348 | |
| 349 | os.makedirs(os.path.dirname(test_logfile_path)) |
| 350 | shutil.copy( |
Mitja Nikolaus | 77dd565 | 2018-12-06 11:27:01 +0100 | [diff] [blame] | 351 | os.path.join(Dummy.DEFAULT_LOG_FILE_DIRECTORY, logfile_filename), |
Mitja Nikolaus | cc90d57 | 2018-11-22 16:40:15 +0100 | [diff] [blame] | 352 | test_logfile_path, |
| 353 | ) |
| 354 | return logfile, test_logfile_path |
| 355 | |
| 356 | @staticmethod |
Mitja Nikolaus | 7dc8672 | 2018-11-27 14:57:39 +0100 | [diff] [blame] | 357 | def read_logfile_contents(path_to_zipfile, logfile_name): |
| 358 | """Read bytes of a zipped logfile.""" |
| 359 | archive = zipfile.ZipFile(path_to_zipfile, "r") |
| 360 | return archive.read(logfile_name) |
| 361 | |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 362 | |
Mitja Nikolaus | bc03e68 | 2018-11-13 16:48:20 +0100 | [diff] [blame] | 363 | class HiccupCrashreportsTransactionTestCase(TransactionTestCase): |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 364 | """Base class that offers a device registration method.""" |
| 365 | |
| 366 | REGISTER_DEVICE_URL = "api_v1_register_device" |
| 367 | |
| 368 | def setUp(self): |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 369 | """Create a Fairphone staff user for accessing the API. |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 370 | |
| 371 | The APIClient that can be used to make authenticated requests to the |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 372 | server is stored in self.fp_staff_client. |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 373 | """ |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 374 | fp_staff_group = Group.objects.get(name=FP_STAFF_GROUP_NAME) |
| 375 | fp_staff_user = User.objects.create_user( |
| 376 | "fp_staff", "somebody@fairphone.com", "thepassword" |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 377 | ) |
Mitja Nikolaus | e0e8377 | 2018-11-05 10:00:53 +0100 | [diff] [blame] | 378 | fp_staff_user.groups.add(fp_staff_group) |
| 379 | self.fp_staff_client = APIClient() |
| 380 | self.fp_staff_client.force_login(fp_staff_user) |
Mitja Nikolaus | 03e412b | 2018-09-18 17:50:15 +0200 | [diff] [blame] | 381 | |
| 382 | def _register_device(self, **kwargs): |
| 383 | """Register a new device. |
| 384 | |
| 385 | Arguments: |
| 386 | **kwargs: The data to pass the dummy data creation |
| 387 | method `Dummy.device_register_data`. |
| 388 | Returns: |
| 389 | (UUID, APIClient, str): The uuid of the new device as well as an |
| 390 | authentication token and the associated user with credentials. |
| 391 | |
| 392 | """ |
| 393 | data = Dummy.device_register_data(**kwargs) |
| 394 | response = self.client.post(reverse(self.REGISTER_DEVICE_URL), data) |
| 395 | self.assertEqual(response.status_code, status.HTTP_200_OK) |
| 396 | |
| 397 | uuid = response.data["uuid"] |
| 398 | token = response.data["token"] |
| 399 | user = APIClient() |
| 400 | user.credentials(HTTP_AUTHORIZATION="Token " + token) |
| 401 | |
| 402 | return uuid, user, token |
Mitja Nikolaus | bc03e68 | 2018-11-13 16:48:20 +0100 | [diff] [blame] | 403 | |
| 404 | |
| 405 | class HiccupCrashreportsAPITestCase( |
| 406 | HiccupCrashreportsTransactionTestCase, APITestCase |
| 407 | ): |
| 408 | """Base class combining device registration methods and API test methods.""" |
| 409 | |
| 410 | pass |
| 411 | |
| 412 | |
| 413 | class RaceConditionsTestCase(HiccupCrashreportsTransactionTestCase): |
| 414 | """Test cases for race conditions.""" |
| 415 | |
| 416 | # Make data from migrations available in the test cases |
| 417 | serialized_rollback = True |
| 418 | |
| 419 | def _test_create_multiple( |
| 420 | self, report_type, create_function, argslist, local_id_name |
| 421 | ): |
| 422 | """Test that no race condition occurs when creating instances.""" |
| 423 | # Create multiple threads which send reports simultaneously |
| 424 | threads = [] |
| 425 | for args in argslist: |
| 426 | thread = threading.Thread(target=create_function, args=args) |
| 427 | threads.append(thread) |
| 428 | thread.start() |
| 429 | |
| 430 | # Wait until the threads have finished |
| 431 | for thread in threads: |
| 432 | thread.join() |
| 433 | |
| 434 | # Assert that no duplicate local IDs have been assigned |
| 435 | reports = report_type.objects.all() |
| 436 | self.assertEqual( |
| 437 | reports.count(), reports.distinct(local_id_name).count() |
| 438 | ) |
| 439 | self.assertEqual(reports.count(), len(argslist)) |