Initial public release

backend/core/exceptions.py

@@ -0,0 +1,83 @@
+from typing import Any
+
+
+class MusicseerrException(Exception):
+    def __init__(self, message: str, details: Any = None):
+        self.message = message
+        self.details = details
+        super().__init__(message)
+    
+    def __str__(self) -> str:
+        if self.details:
+            return f"{self.message}: {self.details}"
+        return self.message
+
+
+class ExternalServiceError(MusicseerrException):
+    pass
+
+
+class RateLimitedError(ExternalServiceError):
+    def __init__(
+        self,
+        message: str,
+        details: Any = None,
+        retry_after_seconds: float | None = None,
+    ):
+        super().__init__(message, details)
+        self.retry_after_seconds = retry_after_seconds
+
+
+class ResourceNotFoundError(MusicseerrException):
+    pass
+
+
+class ValidationError(MusicseerrException):
+    pass
+
+
+class PlaylistNotFoundError(ResourceNotFoundError):
+    pass
+
+
+class InvalidPlaylistDataError(ValidationError):
+    pass
+
+
+class SourceResolutionError(ValidationError):
+    pass
+
+
+class ConfigurationError(MusicseerrException):
+    pass
+
+
+class CacheError(MusicseerrException):
+    pass
+
+
+class PlaybackNotAllowedError(ExternalServiceError):
+    pass
+
+
+class TokenNotAuthorizedError(ExternalServiceError):
+    pass
+
+
+class NavidromeApiError(ExternalServiceError):
+    def __init__(
+        self,
+        message: str,
+        details: Any = None,
+        code: int | None = None,
+    ):
+        super().__init__(message, details)
+        self.code = code
+
+
+class NavidromeAuthError(NavidromeApiError):
+    pass
+
+
+class ClientDisconnectedError(MusicseerrException):
+    pass