gritz 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a95e6912024249ab3efc8753e49f5c6221348413a9a9fd3f4d17157169336676
-  data.tar.gz: 40abe904ca3558e321c80db1bb3f87294ca1c98f47ed9f695c37048c2510fd2d
+  metadata.gz: dc0e22df75d36cf07bf9460cedc802981539bb78f0498ebfced84d6439169abd
+  data.tar.gz: 9f6969d88f42cfc646d6d55c22b4df5decfa295efaff75b74feafeec08b445c3
 SHA512:
-  metadata.gz: 3e47c08e7623f8c44055996696945cbd77a8cbd32b730836ebee07a3b95ea6eb50b0a9d213daa83b74f28a7d415b32310277c1596ffe0982945deccf9db9763c
-  data.tar.gz: 577748ed23020e59a82224bc074044ee77ec6ed065fc47a7243754fc00e553ef2f32e4417c8bbdcbd0401f8216a3350e54d55194469c4fd00c1438ca973b0e49
+  metadata.gz: '05139a36134b9276b6cfaa9f33d59617bfaadb5f47f78d5436c075ab18c58be53a0e4178d64a3202b4fcd23c6a540eb90e896e6aeac97711f32eadae8448c927'
+  data.tar.gz: fc8c7c87cfe8958731c9a45613bec960d33f2240e8d06786c667232c3b3a15b04428bfab7c03c9f3f4b2c27505c91644dfb5529e8945ceb32f32bfc8239c2b6f

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.4.0
+
+- Add fork-safe clients for all four RPC forms, with deadline and request-header propagation and client middleware.
+- Preserve typed downstream errors and rich details while returning safe `INTERNAL` responses for unhandled downstream failures.
+- Support native retry and load-balancing service configuration and optional OpenTelemetry integration.
+
+## 0.3.0
+
+- Add phased worker replacement, hot application reload, worker recycling and stable admin probes with Prometheus metrics.
+- Support native TLS, mTLS and gRPC Health Check/Watch.
+- Add structured RPC logs with credential redaction and preserve accepted calls during graceful shutdown.
+
 ## 0.2.0
 
 - Support Linux forked workers, automatic replacement, graceful shutdown and dynamic worker counts.

data/README.md

@@ -11,8 +11,9 @@ Requires CRuby 3.3 or later and grpc 1.83 or later. Linux and macOS are tested.
 | `gritz` | [gritzrpc/gritz](https://github.com/gritzrpc/gritz) | Default combination and executable |
 | `gritz-core` | [gritzrpc/gritz-core](https://github.com/gritzrpc/gritz-core) | Transport-independent application framework |
 | `gritz-native` | [gritzrpc/gritz-native](https://github.com/gritzrpc/gritz-native) | Official grpc gem adapter and thread pool |
+| `gritz-otel` | [gritzrpc/gritz-otel](https://github.com/gritzrpc/gritz-otel) | Optional server/client tracing and worker OTLP metrics |
 
-Applications can add `gem "gritz", "~> 0.2.0"` to their Gemfile. It installs both the core and native adapter. The Fiber adapter `gritz-async` and integrations `gritz-rails` / `gritz-otel` are planned.
+Applications can add `gem "gritz", "~> 0.4.0"` to their Gemfile. It installs both the core and native adapter. Add `gritz-otel` for OpenTelemetry. The Fiber adapter `gritz-async` and Rails integration `gritz-rails` are planned.
 
 ## Quickstart from source
 
@@ -67,6 +68,10 @@ Set `strict_routes true` once every RPC in the bound service has an action; othe
 
 The default middleware adds request IDs, scopes context, writes JSON completion logs and converts exceptions to gRPC errors. Internal errors expose an `error-id` trailer rather than application exception messages. `fail!` accepts status symbols, trailing metadata and protobuf rich error details. Middleware wraps the full stream, including incremental response writes.
 
+## Clients
+
+For downstream calls, define a lazy client with `Gritz::Client.define(Helloworld::Greeter::Stub, target: "localhost:50051", deadline: 2.0)`. It shares a channel within each worker, inherits the parent deadline and selected request headers, and wraps complete streams in client middleware. See the [client guide](https://github.com/gritzrpc/gritz-core/blob/main/docs/guides/clients.md).
+
 ## Testing
 
 ```ruby
@@ -93,7 +98,9 @@ Configuration precedence is CLI options, `GRITZ_*` environment variables, config
 
 Use `TERM` or `INT` to finish in-flight calls within `shutdown_timeout`; `QUIT` closes immediately. Application code should check deadlines and cancellation during long work. The grpc 1.83 server view can report cancellation late; deadlines remain the practical limit for long handlers. The native thread pool rejects excess requests immediately with `RESOURCE_EXHAUSTED`; grpc 1.83 ignores its deprecated `max_waiting_requests` setting.
 
-The server binds insecure gRPC sockets. Use a trusted network or a TLS-terminating proxy. Native TLS, health checks, reflection and metrics export are unavailable. Unsupported transport and TLS features fail at startup.
+Configure `tls cert:, key:` for TLS and add `client_ca:` for required client certificates. Native gRPC Health Check/Watch follows named `health_check` callbacks and worker draining. Admin HTTP provides `/livez`, `/readyz`, `/status` and Prometheus `/metrics` at `127.0.0.1:9090` by default. Reflection is planned.
+
+For Linux operations, use `USR1` to replace workers one at a time and `USR2` to load fresh Ruby code/configuration in a new master. The CLI launcher retains probes and metric totals while old masters drain; a failed replacement leaves the active master serving. Configure `worker_recycle` to replace workers by requests, PSS/RSS or lifetime. See the [Kubernetes guide](https://github.com/gritzrpc/gritz-native/blob/main/docs/guides/kubernetes.md).
 
 The default transport is `:native` (`Gritz::Transport::Native`). `gritz-core` can be loaded separately with `require "gritz/core"` without loading grpc.
 

data/exe/gritz

@@ -1,6 +1,10 @@
 #!/usr/bin/env ruby
 # frozen_string_literal: true
 
-require "gritz"
+require "gritz/core"
+require "rbconfig"
+require "socket"
 
-exit Gritz::CLI.new.run(ARGV)
+owner_fd = ENV.delete("GRITZ_INTERNAL_OWNER_FD")
+exit Gritz::CLI.new(launch: owner_fd.nil?, owner_io: owner_fd && UNIXSocket.for_fd(Integer(owner_fd)),
+                    launch_command: [RbConfig.ruby, File.expand_path($PROGRAM_NAME), *ARGV]).run(ARGV)

data/lib/gritz/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Gritz
-  VERSION = "0.2.0"
+  VERSION = "0.4.0"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: gritz
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Yudai Takada
@@ -15,28 +15,28 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.4.0
 - !ruby/object:Gem::Dependency
   name: gritz-native
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.4.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.0
+        version: 0.4.0
 description: Gritz combines transport-independent controllers, middleware and testing
   with a gRPC C-core server.
 email: