Lazy-load IPython in singlestoredb.utils.events

Defer IPython import and handler registration from module load time to
first subscribe() call, preventing IPython from being eagerly imported
on every `import singlestoredb`. Also defer _setup_authentication_info_handler()
in management/utils.py since it was calling subscribe() at module level.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: kesmit13

singlestoredb/management/utils.py

@@ -192,7 +192,15 @@ def get_authentication_info(include_env: bool = True) -> Dict[str, Any]:
     return get_authentication_info
 
 
-get_authentication_info = _setup_authentication_info_handler()
+_get_authentication_info: Optional[Callable[..., Dict[str, Any]]] = None
+
+
+def get_authentication_info(include_env: bool = True) -> Dict[str, Any]:
+    """Return authentication info, initializing on first call."""
+    global _get_authentication_info
+    if _get_authentication_info is None:
+        _get_authentication_info = _setup_authentication_info_handler()
+    return _get_authentication_info(include_env=include_env)
 
 
 def get_token() -> Optional[str]:

singlestoredb/utils/events.py

@@ -4,14 +4,24 @@
 from typing import Dict
 from typing import Set
 
-try:
-    from IPython import get_ipython
-    has_ipython = True
-except (ImportError, OSError):
-    has_ipython = False
-
 
 _subscribers: Set[Callable[[Dict[str, Any]], None]] = set()
+_initialized = False
+
+
+def _ensure_initialized() -> None:
+    """Lazily detect IPython and register the control handler."""
+    global _initialized
+    if _initialized:
+        return
+    _initialized = True
+
+    try:
+        from IPython import get_ipython
+        _handlers = get_ipython().kernel.control_handlers
+        _handlers['singlestore_portal_request'] = _event_handler
+    except (ImportError, OSError, AttributeError):
+        pass
 
 
 def subscribe(func: Callable[[Dict[str, Any]], None]) -> None:
@@ -24,6 +34,7 @@ def subscribe(func: Callable[[Dict[str, Any]], None]) -> None:
         The function to call when an event is received
 
     """
+    _ensure_initialized()
     _subscribers.add(func)
 
 
@@ -54,12 +65,3 @@ def _event_handler(stream: Any, ident: Any, msg: Dict[str, Any]) -> None:
 
     for func in _subscribers:
         func(content)
-
-
-# Inject a control handler to receive SingleStore events
-if has_ipython:
-    try:
-        _handlers = get_ipython().kernel.control_handlers
-        _handlers['singlestore_portal_request'] = _event_handler
-    except AttributeError:
-        pass