docstring

Signed-off-by: Rakhi Dutta <rakhibiswas@yahoo.com>

Author: rakdutta

mcpgateway/admin.py

@@ -10127,6 +10127,19 @@ async def admin_unified_search(
         }
 
     async def _safe_entity_search(search_callable, empty_key: str, **kwargs: Any) -> dict[str, Any]:
+        """Safely execute entity search, returning empty results on auth errors.
+
+        Args:
+            search_callable: Async function to call for searching entities
+            empty_key: Key name for empty results list in response
+            **kwargs: Additional arguments to pass to search_callable
+
+        Returns:
+            Search results dict, or empty results dict on 401/403 errors
+
+        Raises:
+            HTTPException: Re-raises non-auth HTTP exceptions
+        """
         try:
             return await search_callable(**kwargs)
         except HTTPException as exc:

mcpgateway/schemas.py

@@ -760,6 +760,14 @@ def extract_base_url_and_populate_schemas(cls, values: dict) -> dict:
         # 2. It has no properties defined (empty properties dict)
         # 3. It's the default factory value
         def is_empty_schema(schema):
+            """Check if a JSON schema is empty or has no properties defined.
+
+            Args:
+                schema: JSON schema dict to check
+
+            Returns:
+                True if schema is None, empty dict, or has no properties
+            """
             if not schema or schema == {}:
                 return True
             # Check if it's a schema with empty properties
@@ -1309,6 +1317,14 @@ def extract_base_url_and_populate_schemas(cls, values: dict) -> dict:
 
         # Determine if schemas need population
         def is_empty_schema(schema):
+            """Check if a JSON schema is empty or has no properties defined.
+
+            Args:
+                schema: JSON schema dict to check
+
+            Returns:
+                True if schema is None, empty dict, or has no properties
+            """
             if not schema or schema == {}:
                 return True
             if isinstance(schema, dict):