gritz 0.3.0 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3bda0b84579ded3c97248068f964bbd787539219c4c4edb54cf5ae15376fbbd2
-  data.tar.gz: 38c0986b7de5977eb033907626e749081980db01cd3d2938984a779116862082
+  metadata.gz: 7154c46a5a71c65a57b26fc125278616bb90bdd204abc4d459f93d8d219539c3
+  data.tar.gz: 943680245a0e6a4e135e39052c0b7dc49c3ab9c16b26b263fc7230b11d1de6d8
 SHA512:
-  metadata.gz: 923f4e799fce1c91ad06530976492b3b2d9a8891f8c2dcde673d29b831ddc29c87276d75ec64d48eddc566953d063bfb4fbad82b26dbb2e23c7b9b51f4c6adb3
-  data.tar.gz: 2743a9dcfccae9aaecaa3d075568ea5e030d69764e9316c2e4330e0eb7c97297651d09de596a50e7a9b8ccf58e1b902f83cc1fb8e63261448e23563bd3d25f39
+  metadata.gz: 7830d83042d4a03a9be449357be2b15189583f2ceda81782aff0ead2ac07a3e80a3ebe7435713dc2ab98d7d603eeeb1f76acbf45b544430feb732755b84dab9d
+  data.tar.gz: 8e2d59aa9d6ff9e8787501a6f3acaa2940c255b20790cd7b82197213efd72f4dcde17ccd5b9528ffb68b91853260e1fca8d4fec73fc090c7fc6eb16bd4b85217

data/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.5.0
+
+- Include Gruf migration support and optional gRPC Reflection through gritz-core and gritz-native 0.5.0.
+
+## 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.

data/README.md

@@ -11,8 +11,10 @@ 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-rails` | [gritzrpc/gritz-rails](https://github.com/gritzrpc/gritz-rails) | Optional Rails execution, generators and development reloading |
+| `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.3.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.5.0"` to their Gemfile. It installs both the core and native adapter. Add `gritz-otel` for OpenTelemetry. Add `gritz-rails` for Rails execution, generators and development reloading. The Fiber adapter `gritz-async` is planned.
 
 ## Quickstart from source
 
@@ -67,6 +69,14 @@ 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).
+
+## Rails and Gruf migration
+
+Add [gritz-rails](https://github.com/gritzrpc/gritz-rails), run `bin/rails generate gritz:install`, and use `bin/gritz` to start RPCs with Rails execution and development reloading. See its [Rails sample](https://github.com/gritzrpc/gritz-rails/tree/main/examples/rails_app). Existing Gruf controllers can use the optional compatibility module in core; follow the [migration guide](https://github.com/gritzrpc/gritz-core/blob/main/docs/guides/migrating-from-gruf.md).
+
 ## Testing
 
 ```ruby
@@ -93,7 +103,7 @@ 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.
 
-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.
+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. Set `reflection true` to enable standard gRPC Reflection v1/v1alpha; it is disabled by default.
 
 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).
 

data/lib/gritz/version.rb

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

metadata

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