telekinesis-dataengine 0.0.2__py3-none-any.whl

telekinesis/dataengine/__init__.py

@@ -0,0 +1,43 @@
+"""Public API for the Telekinesis Data Engine.
+
+Submodule imports are guarded because their third-party/runtime dependencies
+(``mcap``, ``babyros``, ``telekinesis-datatypes``, Pillow) are optional: a
+partial install should still expose whatever is usable. Any guarded import that
+fails is logged at DEBUG so a genuine error (a bad import, a missing dependency,
+a syntax-level ``ImportError``) is diagnosable instead of silently resurfacing
+later as a misleading ``cannot import name '...'``. ``__all__`` lists only the
+names that actually imported, so ``from telekinesis.dataengine import *`` never
+raises for an unbound name.
+"""
+
+from loguru import logger as _log
+
+__all__: list[str] = []
+
+try:
+    from telekinesis.dataengine.mcap.logger import MCAPLogger
+except ImportError as e:
+    _log.debug(f"MCAPLogger unavailable (optional deps missing?): {e}")
+else:
+    __all__.append("MCAPLogger")
+
+try:
+    from telekinesis.dataengine.detection.logger import (
+        DetectionLogger,
+        YoloDetectionLogger,
+        RfDetrDetectionLogger,
+    )
+except ImportError as e:
+    _log.debug(f"detection loggers unavailable (optional deps missing?): {e}")
+else:
+    __all__ += ["DetectionLogger", "YoloDetectionLogger", "RfDetrDetectionLogger"]
+
+try:
+    from telekinesis.dataengine.detection.node import (
+        DetectionLoggerPublisher,
+        DetectionLoggerSubscriber,
+    )
+except ImportError as e:
+    _log.debug(f"detection pub/sub nodes unavailable (optional deps missing?): {e}")
+else:
+    __all__ += ["DetectionLoggerPublisher", "DetectionLoggerSubscriber"]