Update: Major code refactor

exceptions.py

@@ -0,0 +1,84 @@
+"""
+Custom Exception Classes
+
+Defines application-specific exceptions for better error handling
+and clearer error messages throughout the codebase.
+"""
+
+
+class PterodisBotError(Exception):
+    """Base exception class for all PterodisBot errors."""
+
+    pass
+
+
+class ConfigValidationError(PterodisBotError):
+    """
+    Raised when configuration validation fails.
+
+    Contains detailed error messages for all validation failures.
+    """
+
+    pass
+
+
+class APIError(PterodisBotError):
+    """
+    Raised when an API request fails.
+
+    Attributes:
+        endpoint: The API endpoint that failed
+        status_code: HTTP status code if available
+        message: Error message from the API
+    """
+
+    def __init__(
+        self,
+        message: str,
+        endpoint: str = "",
+        status_code: int = 0,
+    ) -> None:
+        super().__init__(message)
+        self.endpoint = endpoint
+        self.status_code = status_code
+        self.message = message
+
+
+class ServerNotFoundError(PterodisBotError):
+    """
+    Raised when a requested server is not found in the panel.
+    """
+
+    pass
+
+
+class PermissionError(PterodisBotError):
+    """
+    Raised when a user lacks required permissions for an action.
+    """
+
+    pass
+
+
+class EmbedNotFoundError(PterodisBotError):
+    """
+    Raised when a tracked embed message is not found in Discord.
+    """
+
+    pass
+
+
+class MetricsError(PterodisBotError):
+    """
+    Raised when metrics graph generation fails.
+    """
+
+    pass
+
+
+class ConfigurationError(PterodisBotError):
+    """
+    Raised when there's a configuration issue not caught during startup validation.
+    """
+
+    pass