grpc-server-kit 0.1.1__tar.gz → 0.2.1__tar.gz

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## [0.2.1](https://github.com/bedrock-python/grpc-server-kit/compare/grpc-server-kit-v0.2.0...grpc-server-kit-v0.2.1) (2026-10-16)
+
+
+### Bug Fixes
+
+* map a failed outbound RPC instead of passing its status to the caller ([#50](https://github.com/bedrock-python/grpc-server-kit/issues/50)) ([232b190](https://github.com/bedrock-python/grpc-server-kit/commit/232b19076a083774dc52fbf01f1cc7809de04a98)), closes [#48](https://github.com/bedrock-python/grpc-server-kit/issues/48)
+
+## [0.2.0](https://github.com/bedrock-python/grpc-server-kit/compare/grpc-server-kit-v0.1.1...grpc-server-kit-v0.2.0) (2026-09-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* `BaseGrpcServerSettings(port=0)` now raises `ValidationError`; pass `allow_ephemeral_port=True` (or `GRPC__ALLOW_EPHEMERAL_PORT=true`) to bind an ephemeral port on purpose.
+
+### Features
+
+* BaseGrpcServerSettings rejects port=0 unless allow_ephemeral_port=True ([4a450e4](https://github.com/bedrock-python/grpc-server-kit/commit/4a450e4dbc7ffe0a7d5fd107e9b2d0e7e2c2d279)), closes [#24](https://github.com/bedrock-python/grpc-server-kit/issues/24)
+
 ## [0.1.1](https://github.com/bedrock-python/grpc-server-kit/compare/grpc-server-kit-v0.1.0...grpc-server-kit-v0.1.1) (2026-09-06)
 
 

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grpc-server-kit
-Version: 0.1.1
+Version: 0.2.1
 Summary: Batteries-optional async gRPC server toolkit (app facade, builder, TLS, lifecycle, health, streaming-aware interceptors, observability)
 Project-URL: Repository, https://github.com/bedrock-python/grpc-server-kit
 Project-URL: Documentation, https://bedrock-python.github.io/grpc-server-kit/
@@ -217,6 +217,7 @@ Classifier: License :: OSI Approved :: Apache Software License
 Classifier: Programming Language :: Python :: 3
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
 Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Classifier: Typing :: Typed
 Requires-Python: >=3.12

grpc_server_kit-0.2.1/grpc_server_kit/__version__.py

@@ -0,0 +1 @@
+__version__ = "0.2.1"

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/grpc_server_kit/aio/interceptors/__init__.py

@@ -10,8 +10,12 @@ Canonical execution order (outermost first):
 2. ``AsyncContextInterceptor``            (extract metadata into context vars)
 3. ``AsyncRequestLoggerInterceptor``      (request/response logging)
 4. ``AsyncTracingInterceptor``            (tracing span)
-5. ``AsyncSentryInterceptor``             (error tracking)
-6. ``AsyncExceptionHandlerInterceptor``   (exception → gRPC status mapping)
+5. ``AsyncExceptionHandlerInterceptor``   (exception → gRPC status mapping)
+6. ``AsyncSentryInterceptor``             (error tracking)
+
+Sentry sits inside the exception handler so it sees the original exception;
+outside, it would only see the ``grpc.aio.AbortError`` the handler turned it
+into, and it never captures those.
 """
 
 from .base import AsyncServerInterceptor, RpcCall, split_method_name

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/grpc_server_kit/aio/interceptors/exception_handler.py

@@ -97,13 +97,19 @@ class AsyncExceptionHandlerInterceptor(AsyncServerInterceptor):
     """Interceptor that catches exceptions and converts them to gRPC errors.
 
     Rules:
-    - ``grpc.aio.AbortError`` (the handler already aborted with its own status) and
-      ``grpc.RpcError`` are re-raised as-is.
+    - ``grpc.aio.AbortError`` (the handler already aborted with its own status) is
+      re-raised as-is.
     - ``CancelledError`` / ``KeyboardInterrupt`` / ``SystemExit`` are re-raised.
     - Any other exception is mapped to a ``grpc.StatusCode`` (via the MRO) and the request
       is aborted with details from the ``detail_factory``. Unmapped exceptions default to
       ``INTERNAL`` with a safe message (no internal details leaked).
 
+    A ``grpc.RpcError`` raised by an outbound call the handler made (``grpc.aio.AioRpcError``)
+    is one of those "other" exceptions: its status and details belong to the downstream
+    service, so it is mapped like anything else (``INTERNAL`` by default) instead of reaching
+    the caller as ``UNKNOWN`` with the downstream details. Map ``grpc.RpcError`` in
+    ``error_status_map`` to report downstream failures with another status.
+
     Covers streaming RPCs: exceptions raised while producing a response stream are
     mapped and aborted the same way as unary failures.
     """
@@ -142,8 +148,6 @@ class AsyncExceptionHandlerInterceptor(AsyncServerInterceptor):
             # The handler (or an inner interceptor) already aborted this RPC with
             # its own status — pass it through untouched.
             raise
-        except grpc.RpcError:
-            raise
         except Exception as exc:
             await self._abort_with_mapped_status(exc, call)
 

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/grpc_server_kit/settings.py

@@ -62,6 +62,10 @@ class BaseGrpcServerSettings(BaseModel):
     # Basic
     host: str = Field(default=DEFAULT_HOST, min_length=1, description="gRPC server host")
     port: int = Field(default=DEFAULT_PORT, ge=0, le=65535, description="gRPC server port (0 = ephemeral)")
+    allow_ephemeral_port: bool = Field(
+        default=False,
+        description="Accept port=0 (ephemeral); off by default, a Service targeting a fixed port cannot reach one",
+    )
 
     # TLS/SSL settings
     ssl_enabled: bool = Field(default=False, description="Enable TLS/SSL")
@@ -135,6 +139,15 @@ class BaseGrpcServerSettings(BaseModel):
     # Health (consumed by GrpcApp.enable_health as its defaults)
     health: BaseHealthSettings = Field(default_factory=BaseHealthSettings, description="Health check configuration")
 
+    @model_validator(mode="after")
+    def _validate_port(self) -> "BaseGrpcServerSettings":
+        if self.port == 0 and not self.allow_ephemeral_port:
+            raise ValueError(
+                "gRPC port=0 binds an ephemeral port and a Service targeting a fixed port will not reach this "
+                "process; set allow_ephemeral_port=True if that is intended"
+            )
+        return self
+
     @model_validator(mode="after")
     def _validate_ssl(self) -> "BaseGrpcServerSettings":
         if self.ssl_enabled:

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.1}/pyproject.toml

@@ -15,6 +15,7 @@ classifiers = [
     "Programming Language :: Python :: 3",
     "Programming Language :: Python :: 3.12",
     "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
     "Topic :: Software Development :: Libraries :: Python Modules",
     "Typing :: Typed",
 ]

grpc_server_kit-0.1.1/grpc_server_kit/__version__.py

@@ -1 +0,0 @@
-__version__ = "0.1.1"