Renames

Author: LucasAlvesSoares

src/sap_cloud_sdk/core/runtime_context/__init__.py

@@ -19,14 +19,14 @@
 
 In tests or scripts without a framework::
 
-    from sap_cloud_sdk.core.runtime_context import sdk_context, RequestContext, TENANT_ID
+    from sap_cloud_sdk.core.runtime_context import sdk_context, RuntimeContext, TENANT_ID
 
-    with sdk_context(RequestContext({TENANT_ID: "test-tenant"})):
+    with sdk_context(RuntimeContext({TENANT_ID: "test-tenant"})):
         ...
 """
 
 from sap_cloud_sdk.core.runtime_context._context import (
-    RequestContext,
+    RuntimeContext,
     async_sdk_context,
     get_context,
     sdk_context,
@@ -54,7 +54,7 @@
     "HeaderContextProvider",
     "IAS_CLAIMS",
     "IASContextProvider",
-    "RequestContext",
+    "RuntimeContext",
     "RequestEnvelope",
     "TENANT_ID",
     "TRIGGER_TYPE",

src/sap_cloud_sdk/core/runtime_context/_context.py

@@ -9,7 +9,7 @@
 T = TypeVar("T")
 
 
-class RequestContext:
+class RuntimeContext:
     """Immutable typed bag of caller-identity values for the current execution.
 
     Values are keyed by :class:`ContextKey` instances, which carry the
@@ -20,7 +20,7 @@ class RequestContext:
 
         MY_KEY = ContextKey[str]("my_key")
 
-        ctx = RequestContext({MY_KEY: "hello"})
+        ctx = RuntimeContext({MY_KEY: "hello"})
         ctx.get(MY_KEY)  # -> "hello"
     """
 
@@ -31,41 +31,41 @@ def get(self, key: ContextKey[T]) -> Optional[T]:
         """Return the value for *key*, or ``None`` if not set."""
         return self._values.get(key)
 
-    def with_value(self, key: ContextKey[T], value: T) -> "RequestContext":
-        """Return a new RequestContext with *key* set to *value*."""
-        return RequestContext({**self._values, key: value})
+    def with_value(self, key: ContextKey[T], value: T) -> "RuntimeContext":
+        """Return a new RuntimeContext with *key* set to *value*."""
+        return RuntimeContext({**self._values, key: value})
 
     def _raw(self) -> Dict[ContextKey, Any]:
         """Return a shallow copy of the internal values dict."""
         return dict(self._values)
 
     def __repr__(self) -> str:
         pairs = ", ".join(f"{k.name}={v!r}" for k, v in self._values.items())
-        return f"RequestContext({{{pairs}}})"
+        return f"RuntimeContext({{{pairs}}})"
 
 
-_EMPTY = RequestContext()
+_EMPTY = RuntimeContext()
 
-_context_var: ContextVar[RequestContext] = ContextVar(
+_context_var: ContextVar[RuntimeContext] = ContextVar(
     "sap_sdk_request_context", default=_EMPTY
 )
 
 
-def set_context(ctx: RequestContext) -> None:
+def set_context(ctx: RuntimeContext) -> None:
     """Set the runtime context for the current async/thread scope."""
     _context_var.set(ctx)
 
 
-def get_context() -> RequestContext:
+def get_context() -> RuntimeContext:
     """Return the runtime context for the current async/thread scope.
 
-    Returns an empty :class:`RequestContext` when no context has been set.
+    Returns an empty :class:`RuntimeContext` when no context has been set.
     """
     return _context_var.get()
 
 
 @contextmanager
-def sdk_context(ctx: RequestContext) -> Generator[RequestContext, None, None]:
+def sdk_context(ctx: RuntimeContext) -> Generator[RuntimeContext, None, None]:
     """Sync context manager that sets *ctx* for the duration of the block."""
     token = _context_var.set(ctx)
     try:
@@ -76,8 +76,8 @@ def sdk_context(ctx: RequestContext) -> Generator[RequestContext, None, None]:
 
 @asynccontextmanager
 async def async_sdk_context(
-    ctx: RequestContext,
-) -> AsyncGenerator[RequestContext, None]:
+    ctx: RuntimeContext,
+) -> AsyncGenerator[RuntimeContext, None]:
     """Async context manager that sets *ctx* for the duration of the block."""
     token = _context_var.set(ctx)
     try:

src/sap_cloud_sdk/core/runtime_context/_keys.py

@@ -1,21 +1,21 @@
-"""Typed context key for RequestContext."""
+"""Typed context key for RuntimeContext."""
 
 from typing import Generic, TypeVar
 
 T = TypeVar("T")
 
 
 class ContextKey(Generic[T]):
-    """A typed key for reading and writing values in a :class:`RequestContext`.
+    """A typed key for reading and writing values in a :class:`RuntimeContext`.
 
     Each provider defines its own keys. The type parameter ensures consumers
-    get the right type back from :meth:`RequestContext.get`.
+    get the right type back from :meth:`RuntimeContext.get`.
 
     Example::
 
         MY_KEY = ContextKey[str]("my_key")
 
-        ctx = RequestContext({MY_KEY: "value"})
+        ctx = RuntimeContext({MY_KEY: "value"})
         ctx.get(MY_KEY)  # -> "value"
     """
 

src/sap_cloud_sdk/core/runtime_context/_protocol.py

@@ -2,13 +2,13 @@
 
 from typing import Protocol, runtime_checkable
 
-from sap_cloud_sdk.core.runtime_context._context import RequestContext
+from sap_cloud_sdk.core.runtime_context._context import RuntimeContext
 from sap_cloud_sdk.core.runtime_context._envelope import RequestEnvelope
 
 
 @runtime_checkable
 class ContextProvider(Protocol):
-    """Extracts a :class:`RequestContext` from a :class:`RequestEnvelope`.
+    """Extracts a :class:`RuntimeContext` from a :class:`RequestEnvelope`.
 
     Implement this to add a new auth provider or header convention. The envelope
     is framework-agnostic — providers never touch Starlette, Flask, or gRPC types.
@@ -18,10 +18,10 @@ class ContextProvider(Protocol):
         MY_KEY = ContextKey[str]("my_key")
 
         class MyProvider(ContextProvider):
-            def extract(self, envelope: RequestEnvelope) -> RequestContext:
+            def extract(self, envelope: RequestEnvelope) -> RuntimeContext:
                 value = envelope.headers.get("x-my-header", "")
-                return RequestContext({MY_KEY: value} if value else {})
+                return RuntimeContext({MY_KEY: value} if value else {})
     """
 
-    def extract(self, envelope: RequestEnvelope) -> RequestContext:  # pragma: no cover
+    def extract(self, envelope: RequestEnvelope) -> RuntimeContext:  # pragma: no cover
         ...

src/sap_cloud_sdk/core/runtime_context/providers/_headers.py

@@ -1,6 +1,6 @@
 """SAP standard headers context provider."""
 
-from sap_cloud_sdk.core.runtime_context._context import RequestContext
+from sap_cloud_sdk.core.runtime_context._context import RuntimeContext
 from sap_cloud_sdk.core.runtime_context._envelope import RequestEnvelope
 from sap_cloud_sdk.core.runtime_context._keys import TRIGGER_TYPE
 from sap_cloud_sdk.core.runtime_context._protocol import ContextProvider
@@ -15,9 +15,9 @@ class HeaderContextProvider(ContextProvider):
         from ``x-sap-origin``
     """
 
-    def extract(self, envelope: RequestEnvelope) -> RequestContext:
+    def extract(self, envelope: RequestEnvelope) -> RuntimeContext:
         values = {}
         origin = envelope.headers.get("x-sap-origin")
         if origin:
             values[TRIGGER_TYPE] = origin
-        return RequestContext(values)
+        return RuntimeContext(values)

src/sap_cloud_sdk/core/runtime_context/providers/_ias.py

@@ -1,6 +1,6 @@
 """IAS context provider and its typed keys."""
 
-from sap_cloud_sdk.core.runtime_context._context import RequestContext
+from sap_cloud_sdk.core.runtime_context._context import RuntimeContext
 from sap_cloud_sdk.core.runtime_context._envelope import RequestEnvelope
 from sap_cloud_sdk.core.runtime_context._keys import ContextKey
 from sap_cloud_sdk.core.runtime_context._protocol import ContextProvider
@@ -24,7 +24,7 @@ class IASContextProvider(ContextProvider):
       - :data:`IAS_CLAIMS` full :class:`~sap_cloud_sdk.ias.IASClaims` object
     """
 
-    def extract(self, envelope: RequestEnvelope) -> RequestContext:
+    def extract(self, envelope: RequestEnvelope) -> RuntimeContext:
         auth = envelope.headers.get("authorization", "")
 
         claims = None
@@ -42,4 +42,4 @@ def extract(self, envelope: RequestEnvelope) -> RequestContext:
                 values[USER_ID] = claims.user_uuid
             values[IAS_CLAIMS] = claims
 
-        return RequestContext(values)
+        return RuntimeContext(values)

src/sap_cloud_sdk/core/runtime_context/starlette.py

@@ -3,7 +3,7 @@
 from typing import Any, List
 
 from sap_cloud_sdk.core.runtime_context._context import (
-    RequestContext,
+    RuntimeContext,
     async_sdk_context,
 )
 from sap_cloud_sdk.core.runtime_context._envelope import RequestEnvelope
@@ -20,21 +20,21 @@
     ) from exc
 
 
-def _merge(contexts: List[RequestContext]) -> RequestContext:
-    """Merge multiple RequestContexts — first writer wins per key."""
+def _merge(contexts: List[RuntimeContext]) -> RuntimeContext:
+    """Merge multiple RuntimeContexts — first writer wins per key."""
     merged: dict = {}
     for ctx in contexts:
         for key, value in ctx._raw().items():
             merged.setdefault(key, value)
-    return RequestContext(merged)
+    return RuntimeContext(merged)
 
 
 class StarletteContextMiddleware(BaseHTTPMiddleware):
     """Starlette/FastAPI middleware that populates the SDK runtime context.
 
     Builds a :class:`~sap_cloud_sdk.core.runtime_context.RequestEnvelope` from
     each inbound request, runs all *providers* against it, and merges the results
-    into a single :class:`~sap_cloud_sdk.core.runtime_context.RequestContext`
+    into a single :class:`~sap_cloud_sdk.core.runtime_context.RuntimeContext`
     available via :func:`~sap_cloud_sdk.core.runtime_context.get_context` for
     the duration of that request.
 

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

@@ -13,7 +13,7 @@ information came from or what framework is running.
 ```
 bootstrap(app)
   └─ registers middleware on your framework
-       └─ on each invocation: providers extract → RequestContext set in ContextVar
+       └─ on each invocation: providers extract → RuntimeContext set in ContextVar
             └─ anywhere: get_context().get(TENANT_ID)
 ```
 
@@ -73,7 +73,7 @@ keys. Always import the key from the module that defined it.
 
 ## Providers
 
-A provider extracts a `RequestContext` from a `RequestEnvelope` — a
+A provider extracts a `RuntimeContext` from a `RequestEnvelope` — a
 framework-agnostic carrier of whatever signals were available at invocation time
 (headers, body, metadata). The provider doesn't know which framework built the
 envelope; the framework adapter doesn't know what the provider does with it.
@@ -94,15 +94,15 @@ metadata or a message queue envelope — as long as the adapter populates
 
 ```python
 from sap_cloud_sdk.core.runtime_context import (
-    ContextKey, ContextProvider, RequestContext, RequestEnvelope
+    ContextKey, ContextProvider, RuntimeContext, RequestEnvelope
 )
 
 CORRELATION_ID = ContextKey[str]("correlation_id")
 
 class CorrelationIdProvider(ContextProvider):
-    def extract(self, envelope: RequestEnvelope) -> RequestContext:
+    def extract(self, envelope: RequestEnvelope) -> RuntimeContext:
         value = envelope.headers.get("x-correlation-id")
-        return RequestContext({CORRELATION_ID: value} if value else {})
+        return RuntimeContext({CORRELATION_ID: value} if value else {})
 ```
 
 Pass it to `bootstrap`:
@@ -159,16 +159,16 @@ When there is no framework to bootstrap — unit tests, CLI tools, background
 jobs — set the context directly for the duration of a block:
 
 ```python
-from sap_cloud_sdk.core.runtime_context import sdk_context, RequestContext, TENANT_ID, USER_ID
+from sap_cloud_sdk.core.runtime_context import sdk_context, RuntimeContext, TENANT_ID, USER_ID
 
 # Sync:
-with sdk_context(RequestContext({TENANT_ID: "test-tenant", USER_ID: "test-user"})):
+with sdk_context(RuntimeContext({TENANT_ID: "test-tenant", USER_ID: "test-user"})):
     result = some_sdk_call()
 
 # Async:
 from sap_cloud_sdk.core.runtime_context import async_sdk_context
 
-async with async_sdk_context(RequestContext({TENANT_ID: "test-tenant"})):
+async with async_sdk_context(RuntimeContext({TENANT_ID: "test-tenant"})):
     result = await some_async_sdk_call()
 ```