Add WaitForAccessCodeFailedException

Author: razor-x

seamapi/access_codes.py

@@ -1,6 +1,7 @@
 import time
 from datetime import datetime, timezone, timedelta
 from seamapi.types import (
+    WaitForAccessCodeFailedException,
     AbstractAccessCodes,
     AccessCode,
     AccessCodeId,
@@ -185,7 +186,16 @@ def create(
         if wait_for_code:
             while (access_code.code is None):
                 if (access_code.status == "unknown"):
-                    raise RuntimeError("Gave up waiting for code since access code status is unknown")
+                    raise WaitForAccessCodeFailedException(
+                        "Access code status returned unknown",
+                        access_code_id=access_code.access_code_id
+                    )
+                if (len(access_code.errors) > 0):
+                    raise WaitForAccessCodeFailedException(
+                        "Access code returned errors",
+                        access_code_id=access_code.access_code_id,
+                        errors=access_code.errors
+                    )
                 time.sleep(0.25)
                 access_code = access_codes.get(access_code)
 

seamapi/types.py

@@ -1,6 +1,7 @@
 # TODO this file should eventually be generated by looking at openapi.json
 
 import abc
+from seamapi.types import WaitForAccessCodeFailedException
 from typing import List, Optional, Union, Dict, Any
 from dataclasses import dataclass
 from dataclasses_json import dataclass_json
@@ -46,6 +47,19 @@ def __init__(
             f'Action Attempt for "{action_type}" Failed. {error_type}: {error_message} (action_attempt_id={action_attempt_id})'
         )
 
+class WaitForAccessCodeFailedException(Exception):
+    def __init__(
+        self,
+        message: str,
+        access_code_id: str,
+        errors: Optional[list] = []
+    ):
+        self.access_code_id = access_code_id
+        self.errors = errors
+        super().__init__(
+            f'Failed while waiting for access code. ${message}'
+        )
+
 
 @dataclass
 class Device: