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

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

@@ -1,5 +1,16 @@
 # Changelog
 
+## [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.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: grpc-server-kit
-Version: 0.1.1
+Version: 0.2.0
 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/

grpc_server_kit-0.2.0/grpc_server_kit/__version__.py

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

{grpc_server_kit-0.1.1 → grpc_server_kit-0.2.0}/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/__version__.py

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