Moved imports to lower level

Author: LucasAlvesSoares

src/sap_cloud_sdk/__init__.py

@@ -1,17 +1,8 @@
 # SAP Cloud SDK for Python
 
 from sap_cloud_sdk.core.bootstrap import bootstrap, TelemetryConfig
-from sap_cloud_sdk.core.runtime_context._registry import Adapter, get_framework_adapters
-from sap_cloud_sdk.core.telemetry.instrumentation._registry import (
-    Library,
-    get_instrumented_libraries,
-)
 
 __all__ = [
-    "Adapter",
     "bootstrap",
-    "get_framework_adapters",
-    "get_instrumented_libraries",
-    "Library",
     "TelemetryConfig",
 ]

src/sap_cloud_sdk/core/runtime_context/__init__.py

@@ -32,7 +32,12 @@
     TRIGGER_TYPE,
 )
 from sap_cloud_sdk.core.runtime_context._protocol import ContextProvider
-from sap_cloud_sdk.core.runtime_context._registry import FrameworkAdapter, register
+from sap_cloud_sdk.core.runtime_context._registry import (
+    Adapter,
+    FrameworkAdapter,
+    get_attached_adapters,
+    register,
+)
 from sap_cloud_sdk.core.runtime_context.providers import (
     DWCContextProvider,
     IASContextProvider,
@@ -46,6 +51,7 @@
 import sap_cloud_sdk.core.runtime_context.adapters  # noqa: F401
 
 __all__ = [
+    "Adapter",
     "APP_TENANT_ID",
     "ContextKey",
     "ContextProvider",
@@ -54,6 +60,7 @@
     "DWCContextProvider",
     "FEATURE_TOGGLES",
     "FrameworkAdapter",
+    "get_attached_adapters",
     "GLOBAL_TENANT_ID",
     "IASContextProvider",
     "RuntimeContext",

src/sap_cloud_sdk/core/runtime_context/_registry.py

@@ -37,7 +37,7 @@ def record_attached(name: Adapter) -> None:
         _attached.append(name)
 
 
-def get_framework_adapters() -> List[Adapter]:
+def get_attached_adapters() -> List[Adapter]:
     """Return the adapters attached via bootstrap().
 
     Each entry corresponds to one :func:`~sap_cloud_sdk.bootstrap` call that

src/sap_cloud_sdk/core/runtime_context/user-guide.md

@@ -202,8 +202,8 @@ editing `bootstrap`.
 ### Adding a new framework or invocation source
 
 ```python
-from sap_cloud_sdk import Adapter
 from sap_cloud_sdk.core.runtime_context import (
+    Adapter,
     ContextProvider,
     FrameworkAdapter,
     register,
@@ -233,18 +233,18 @@ register(FlaskContextAdapter())
 
 ## Introspection
 
-Use `get_framework_adapters()` to check which framework adapters have been attached at runtime:
+Use `get_attached_adapters()` to check which framework adapters have been attached at runtime:
 
 ```python
-from sap_cloud_sdk import Adapter, get_framework_adapters
+from sap_cloud_sdk.core.runtime_context import Adapter, get_attached_adapters
 
-get_framework_adapters()  # -> [Adapter.STARLETTE] after bootstrap(app), [] before
+get_attached_adapters()  # -> [Adapter.STARLETTE] after bootstrap(app), [] before
 ```
 
 This is useful for modules that need to fail fast if their required framework was never bootstrapped:
 
 ```python
-if Adapter.STARLETTE not in get_framework_adapters():
+if Adapter.STARLETTE not in get_attached_adapters():
     raise RuntimeError(
         "This client requires Starlette to be bootstrapped. "
         "Call bootstrap(app) with your Starlette/FastAPI app."

src/sap_cloud_sdk/core/telemetry/__init__.py

@@ -56,6 +56,10 @@
     ExtensionContextLogFilter,
 )
 from sap_cloud_sdk.core.telemetry.middleware import TelemetryMiddleware
+from sap_cloud_sdk.core.telemetry.instrumentation._registry import (
+    Library,
+    get_instrumented_libraries,
+)
 
 __all__ = [
     "Module",
@@ -103,6 +107,8 @@
     "emit_extensions_summary_span",
     "ExtensionContextLogFilter",
     "TelemetryMiddleware",
+    "Library",
+    "get_instrumented_libraries",
 ]
 
 try:

src/sap_cloud_sdk/core/telemetry/user-guide.md

@@ -83,7 +83,7 @@ The SDK ships `opentelemetry-instrumentation-*` packages for all of the above as
 Use `get_instrumented_libraries()` to query which libraries were actually patched at runtime:
 
 ```python
-from sap_cloud_sdk import Library, get_instrumented_libraries
+from sap_cloud_sdk.core.telemetry import Library, get_instrumented_libraries
 
 get_instrumented_libraries()  # -> [Library.HTTPX, Library.SQLALCHEMY, ...] after auto_instrument(), [] before
 ```

tests/core/unit/runtime_context/test_runtime_context.py

@@ -27,7 +27,7 @@
 )
 from sap_cloud_sdk.core.runtime_context._registry import (
     Adapter,
-    get_framework_adapters,
+    get_attached_adapters,
     record_attached,
 )
 from sap_cloud_sdk.core.runtime_context.providers._ias import (
@@ -440,7 +440,7 @@ def test_single_context_passthrough(self):
 
 
 # ---------------------------------------------------------------------------
-# get_framework_adapters
+# get_attached_adapters
 # ---------------------------------------------------------------------------
 
 
@@ -456,19 +456,19 @@ def teardown_method(self):
         registry_mod._attached.extend(self._original)
 
     def test_empty_before_bootstrap(self):
-        assert get_framework_adapters() == []
+        assert get_attached_adapters() == []
 
     def test_records_name_after_record_attached(self):
         record_attached(Adapter.STARLETTE)
-        assert get_framework_adapters() == [Adapter.STARLETTE]
+        assert get_attached_adapters() == [Adapter.STARLETTE]
 
     def test_multiple_calls_accumulate(self):
         record_attached(Adapter.STARLETTE)
         record_attached(Adapter.STARLETTE)  # idempotent
-        assert get_framework_adapters() == [Adapter.STARLETTE]
+        assert get_attached_adapters() == [Adapter.STARLETTE]
 
     def test_returns_copy(self):
         record_attached(Adapter.STARLETTE)
-        snapshot = get_framework_adapters()
+        snapshot = get_attached_adapters()
         snapshot.clear()
-        assert get_framework_adapters() == [Adapter.STARLETTE]
+        assert get_attached_adapters() == [Adapter.STARLETTE]