gritz 0.4.0 → 0.5.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (5) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +4 -0
  3. data/README.md +7 -2
  4. data/lib/gritz/version.rb +1 -1
  5. metadata +5 -5
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: dc0e22df75d36cf07bf9460cedc802981539bb78f0498ebfced84d6439169abd
4
- data.tar.gz: 9f6969d88f42cfc646d6d55c22b4df5decfa295efaff75b74feafeec08b445c3
3
+ metadata.gz: 7154c46a5a71c65a57b26fc125278616bb90bdd204abc4d459f93d8d219539c3
4
+ data.tar.gz: 943680245a0e6a4e135e39052c0b7dc49c3ab9c16b26b263fc7230b11d1de6d8
5
5
  SHA512:
6
- metadata.gz: '05139a36134b9276b6cfaa9f33d59617bfaadb5f47f78d5436c075ab18c58be53a0e4178d64a3202b4fcd23c6a540eb90e896e6aeac97711f32eadae8448c927'
7
- data.tar.gz: fc8c7c87cfe8958731c9a45613bec960d33f2240e8d06786c667232c3b3a15b04428bfab7c03c9f3f4b2c27505c91644dfb5529e8945ceb32f32bfc8239c2b6f
6
+ metadata.gz: 7830d83042d4a03a9be449357be2b15189583f2ceda81782aff0ead2ac07a3e80a3ebe7435713dc2ab98d7d603eeeb1f76acbf45b544430feb732755b84dab9d
7
+ data.tar.gz: 8e2d59aa9d6ff9e8787501a6f3acaa2940c255b20790cd7b82197213efd72f4dcde17ccd5b9528ffb68b91853260e1fca8d4fec73fc090c7fc6eb16bd4b85217
data/CHANGELOG.md CHANGED
@@ -1,5 +1,9 @@
1
1
  # Changelog
2
2
 
3
+ ## 0.5.0
4
+
5
+ - Include Gruf migration support and optional gRPC Reflection through gritz-core and gritz-native 0.5.0.
6
+
3
7
  ## 0.4.0
4
8
 
5
9
  - Add fork-safe clients for all four RPC forms, with deadline and request-header propagation and client middleware.
data/README.md CHANGED
@@ -11,9 +11,10 @@ Requires CRuby 3.3 or later and grpc 1.83 or later. Linux and macOS are tested.
11
11
  | `gritz` | [gritzrpc/gritz](https://github.com/gritzrpc/gritz) | Default combination and executable |
12
12
  | `gritz-core` | [gritzrpc/gritz-core](https://github.com/gritzrpc/gritz-core) | Transport-independent application framework |
13
13
  | `gritz-native` | [gritzrpc/gritz-native](https://github.com/gritzrpc/gritz-native) | Official grpc gem adapter and thread pool |
14
+ | `gritz-rails` | [gritzrpc/gritz-rails](https://github.com/gritzrpc/gritz-rails) | Optional Rails execution, generators and development reloading |
14
15
  | `gritz-otel` | [gritzrpc/gritz-otel](https://github.com/gritzrpc/gritz-otel) | Optional server/client tracing and worker OTLP metrics |
15
16
 
16
- 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.
17
+ 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.
17
18
 
18
19
  ## Quickstart from source
19
20
 
@@ -72,6 +73,10 @@ The default middleware adds request IDs, scopes context, writes JSON completion
72
73
 
73
74
  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).
74
75
 
76
+ ## Rails and Gruf migration
77
+
78
+ 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).
79
+
75
80
  ## Testing
76
81
 
77
82
  ```ruby
@@ -98,7 +103,7 @@ Configuration precedence is CLI options, `GRITZ_*` environment variables, config
98
103
 
99
104
  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.
100
105
 
101
- 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.
106
+ 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.
102
107
 
103
108
  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).
104
109
 
data/lib/gritz/version.rb CHANGED
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Gritz
4
- VERSION = "0.4.0"
4
+ VERSION = "0.5.0"
5
5
  end
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: gritz
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.0
4
+ version: 0.5.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Yudai Takada
@@ -15,28 +15,28 @@ dependencies:
15
15
  requirements:
16
16
  - - '='
17
17
  - !ruby/object:Gem::Version
18
- version: 0.4.0
18
+ version: 0.5.0
19
19
  type: :runtime
20
20
  prerelease: false
21
21
  version_requirements: !ruby/object:Gem::Requirement
22
22
  requirements:
23
23
  - - '='
24
24
  - !ruby/object:Gem::Version
25
- version: 0.4.0
25
+ version: 0.5.0
26
26
  - !ruby/object:Gem::Dependency
27
27
  name: gritz-native
28
28
  requirement: !ruby/object:Gem::Requirement
29
29
  requirements:
30
30
  - - '='
31
31
  - !ruby/object:Gem::Version
32
- version: 0.4.0
32
+ version: 0.5.0
33
33
  type: :runtime
34
34
  prerelease: false
35
35
  version_requirements: !ruby/object:Gem::Requirement
36
36
  requirements:
37
37
  - - '='
38
38
  - !ruby/object:Gem::Version
39
- version: 0.4.0
39
+ version: 0.5.0
40
40
  description: Gritz combines transport-independent controllers, middleware and testing
41
41
  with a gRPC C-core server.
42
42
  email: