Changelog¶
0.1.0 (2026-08-11)¶
Initial release of grpc-server-kit.
Features¶
GrpcAppfacade — server construction, TLS-aware port binding, signal handling and graceful shutdown behind a single object- Streaming-aware interceptors — one
around_callhook covers all four RPC kinds, spanning the full response stream - Canonical interceptor chain: metrics, request context, request logging, tracing, exception mapping, error reporting
- Exception-to-gRPC-status mapping over the MRO with safe, non-leaking details
- gRPC Health Checking Protocol v1 —
Check/Watch, Postgres and Redis dependency checkers, single-flight TTL cache - SDK-free observability seams for Prometheus metrics, OpenTelemetry tracing and Sentry error reporting
- Dishka DI providers wiring the canonical interceptor chain and the configured server
- Typed configuration: zero-dependency
GrpcServerConfigdataclass or pydanticBaseGrpcServerSettings - TLS/mTLS credential loading with private-key permission checks
- Zero-dependency core (
grpcioonly) — every integration is an opt-in extra