semantic cleanup

backend/src/core/utils/network.py

@@ -20,31 +20,71 @@ from ..logger import logger as app_logger, belief_scope
 # [/SECTION]
 
 # [DEF:SupersetAPIError:Class]
+# @PURPOSE: Base exception for all Superset API related errors.
 class SupersetAPIError(Exception):
+    # [DEF:__init__:Function]
+    # @PURPOSE: Initializes the exception with a message and context.
+    # @PRE: message is a string, context is a dict.
+    # @POST: Exception is initialized with context.
     def __init__(self, message: str = "Superset API error", **context: Any):
-        self.context = context
-        super().__init__(f"[API_FAILURE] {message} | Context: {self.context}")
+        with belief_scope("SupersetAPIError.__init__"):
+            self.context = context
+            super().__init__(f"[API_FAILURE] {message} | Context: {self.context}")
+    # [/DEF:__init__:Function]
+# [/DEF:SupersetAPIError:Class]
 
 # [DEF:AuthenticationError:Class]
+# @PURPOSE: Exception raised when authentication fails.
 class AuthenticationError(SupersetAPIError):
+    # [DEF:__init__:Function]
+    # @PURPOSE: Initializes the authentication error.
+    # @PRE: message is a string, context is a dict.
+    # @POST: AuthenticationError is initialized.
     def __init__(self, message: str = "Authentication failed", **context: Any):
-        super().__init__(message, type="authentication", **context)
+        with belief_scope("AuthenticationError.__init__"):
+            super().__init__(message, type="authentication", **context)
+    # [/DEF:__init__:Function]
+# [/DEF:AuthenticationError:Class]
 
 # [DEF:PermissionDeniedError:Class]
+# @PURPOSE: Exception raised when access is denied.
 class PermissionDeniedError(AuthenticationError):
+    # [DEF:__init__:Function]
+    # @PURPOSE: Initializes the permission denied error.
+    # @PRE: message is a string, context is a dict.
+    # @POST: PermissionDeniedError is initialized.
     def __init__(self, message: str = "Permission denied", **context: Any):
-        super().__init__(message, **context)
+        with belief_scope("PermissionDeniedError.__init__"):
+            super().__init__(message, **context)
+    # [/DEF:__init__:Function]
+# [/DEF:PermissionDeniedError:Class]
 
 # [DEF:DashboardNotFoundError:Class]
+# @PURPOSE: Exception raised when a dashboard cannot be found.
 class DashboardNotFoundError(SupersetAPIError):
+    # [DEF:__init__:Function]
+    # @PURPOSE: Initializes the not found error with resource ID.
+    # @PRE: resource_id is provided.
+    # @POST: DashboardNotFoundError is initialized.
     def __init__(self, resource_id: Union[int, str], message: str = "Dashboard not found", **context: Any):
-        super().__init__(f"Dashboard '{resource_id}' {message}", subtype="not_found", resource_id=resource_id, **context)
+        with belief_scope("DashboardNotFoundError.__init__"):
+            super().__init__(f"Dashboard '{resource_id}' {message}", subtype="not_found", resource_id=resource_id, **context)
+    # [/DEF:__init__:Function]
+# [/DEF:DashboardNotFoundError:Class]
 
 # [DEF:NetworkError:Class]
+# @PURPOSE: Exception raised when a network level error occurs.
 class NetworkError(Exception):
+    # [DEF:__init__:Function]
+    # @PURPOSE: Initializes the network error.
+    # @PRE: message is a string.
+    # @POST: NetworkError is initialized.
     def __init__(self, message: str = "Network connection failed", **context: Any):
-        self.context = context
-        super().__init__(f"[NETWORK_FAILURE] {message} | Context: {self.context}")
+        with belief_scope("NetworkError.__init__"):
+            self.context = context
+            super().__init__(f"[NETWORK_FAILURE] {message} | Context: {self.context}")
+    # [/DEF:__init__:Function]
+# [/DEF:NetworkError:Class]
 
 # [DEF:APIClient:Class]
 # @PURPOSE: Инкапсулирует HTTP-логику для работы с API, включая сессии, аутентификацию, и обработку запросов.