subagents

backend/src/core/utils/network.py

@@ -111,6 +111,7 @@ class SupersetAuthCache:
         return (str(base_url or "").strip(), username, bool(verify_ssl))
 
     @classmethod
+    # [DEF:SupersetAuthCache.get:Function]
     def get(cls, key: Tuple[str, str, bool]) -> Optional[Dict[str, str]]:
         now = time.time()
         with cls._lock:
@@ -129,8 +130,10 @@ class SupersetAuthCache:
                 "access_token": str(tokens.get("access_token") or ""),
                 "csrf_token": str(tokens.get("csrf_token") or ""),
             }
+    # [/DEF:SupersetAuthCache.get:Function]
 
     @classmethod
+    # [DEF:SupersetAuthCache.set:Function]
     def set(cls, key: Tuple[str, str, bool], tokens: Dict[str, str], ttl_seconds: Optional[int] = None) -> None:
         normalized_ttl = max(int(ttl_seconds or cls.TTL_SECONDS), 1)
         with cls._lock:
@@ -141,6 +144,7 @@ class SupersetAuthCache:
                 },
                 "expires_at": time.time() + normalized_ttl,
             }
+    # [/DEF:SupersetAuthCache.set:Function]
 
     @classmethod
     def invalidate(cls, key: Tuple[str, str, bool]) -> None:
@@ -156,7 +160,7 @@ class SupersetAuthCache:
 class APIClient:
     DEFAULT_TIMEOUT = 30
 
-    # [DEF:__init__:Function]
+    # [DEF:APIClient.__init__:Function]
     # @PURPOSE: Инициализирует API клиент с конфигурацией, сессией и логгером.
     # @PARAM: config (Dict[str, Any]) - Конфигурация.
     # @PARAM: verify_ssl (bool) - Проверять ли SSL.
@@ -179,7 +183,7 @@ class APIClient:
         )
         self._authenticated = False
         app_logger.info("[APIClient.__init__][Exit] APIClient initialized.")
-    # [/DEF:__init__:Function]
+    # [/DEF:APIClient.__init__:Function]
 
     # [DEF:_init_session:Function]
     # @PURPOSE: Создает и настраивает `requests.Session` с retry-логикой.
@@ -261,6 +265,8 @@ class APIClient:
     # @POST: `self._tokens` заполнен, `self._authenticated` установлен в `True`.
     # @RETURN: Dict[str, str] - Словарь с токенами.
     # @THROW: AuthenticationError, NetworkError - при ошибках.
+    # @RELATION: [CALLS] ->[SupersetAuthCache.get]
+    # @RELATION: [CALLS] ->[SupersetAuthCache.set]
     def authenticate(self) -> Dict[str, str]:
         with belief_scope("authenticate"):
             app_logger.info("[authenticate][Enter] Authenticating to %s", self.base_url)