tonic-rails 0.7.0-aarch64-linux-gnu → 0.8.1-aarch64-linux-gnu

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 9cb047e633b5615d05ec9e90211399b5a086a450b13233f1ff0eeaab4cd38661
-  data.tar.gz: 24b9b7c5a51f4f307de3da0543ba4b22aa0d54d053f14dfbbae4bb3ba702b042
+  metadata.gz: 6d1f9d3967458bdef0ccca7a32cc6a667b5697d15e5438e2d5de4ef933648727
+  data.tar.gz: ad24f42debbefec05ce1732eed8c5c0f29f99b0274f492245eb66f0a46659bc4
 SHA512:
-  metadata.gz: 0fd90412e036a60d91fef0bf477d5b3931739aa59a730d21168129791812c1bd35794b3448b0a2006448c0109902479346e1bbd947acc803b59086c4db4ecbc0
-  data.tar.gz: f51b4e9815cf3ed8aa5626dea4770d8c08e74bbcc3cccd2af57b7917574a9011391a056963d12668553ee7068ea6d9825fe9d9c9a7c2a1caf57401b149cc1804
+  metadata.gz: 9299b0de21c4c8948224a1f7f0813fe6db76d26f5fbd2368069fe10170d1744f5f7897a546156755d5c63b773b8e18f93c8c2206e876433bc3b63704439c4457
+  data.tar.gz: 6e6f86cbfe7e6bfb0b2c4f8da6c25db03beb86ee7ca6f42a3c4234b3a4e9ee605de88314562601a56e23bd6c41809a71f8e637f838b24f34a76a0f0d70f98bd7

data/CHANGELOG.md

@@ -7,6 +7,37 @@ minor versions may contain breaking changes.
 
 ## [Unreleased]
 
+## [0.8.1] - 2026-10-13
+
+### Fixed
+
+- Client: a call whose deadline passed could raise `CANCELLED` ("Timeout
+  expired") instead of `DEADLINE_EXCEEDED` (#48), mostly on Windows.
+  tonic enforces the deadline too, and when its timer fired first the
+  call ended with its status. Calls now raise `DEADLINE_EXCEEDED`
+  whichever timer fires first.
+
+## [0.8.0] - 2026-10-12
+
+### Added
+
+- Client: `method_retries:` sets retry policies per service
+  (`"demo.v1.ItemService"`) or per method
+  (`"demo.v1.ItemService/GetItem"`), like gRPC's service config. The most
+  specific setting wins: the call's `retries:`, then the method, then the
+  service, then the client's `retries:`.
+
+### Fixed
+
+- Windows: the process could crash with a segfault under load (#41). The
+  extension's locks spun and then called `Sleep`, which the mingw linker
+  bound to the `Sleep` that Ruby's DLL exports instead of the system's,
+  and Ruby's version crashes on threads Ruby doesn't own. Locks now come
+  from Rust's standard library, which doesn't spin through `Sleep`, the
+  build binds `Sleep` to kernel32, and CI checks that the Windows build
+  imports nothing but Ruby's C API from Ruby's DLL. 0.6.0 and 0.7.0 crashed in about 1 in 5 runs of the test suite;
+  earlier versions could crash in the same way, but rarely.
+
 ## [0.7.0] - 2026-10-11
 
 ### Added
@@ -186,7 +217,9 @@ First public release.
 - Precompiled native gems for Linux (x86_64, aarch64; glibc and musl) and
   macOS (x86_64, arm64), Ruby 3.3 to 4.0.
 
-[Unreleased]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.7.0...HEAD
+[Unreleased]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.8.1...HEAD
+[0.8.1]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.8.0...v0.8.1
+[0.8.0]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.7.0...v0.8.0
 [0.7.0]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.6.0...v0.7.0
 [0.6.0]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.5.0...v0.6.0
 [0.5.0]: https://github.com/CodingAnarchy/tonic-rails/compare/v0.4.0...v0.5.0

data/README.md

@@ -518,6 +518,24 @@ items.get_item({ id: 1 }, retries: false)                    # not this call
 items.get_item({ id: 1 }, retries: { max_attempts: 5 })      # or differently
 ```
 
+Different methods often need different policies: a read can retry more
+eagerly than a write. `method_retries:` sets them per service or per
+method, by their protobuf names:
+
+```ruby
+ITEMS = Tonic::Rails::Client.new(
+  "items.internal:50051",
+  retries: true,                                                   # every call...
+  method_retries: {
+    "demo.v1.ItemService/GetItem" => { max_attempts: 5 },          # ...but this method,
+    "demo.v1.AdminService" => false,                               # and this whole service
+  },
+)
+```
+
+The most specific setting wins: the call's own `retries:`, then its
+method's entry, then its service's, then the client's `retries:`.
+
 `retries: true` tries a call up to 3 times when it fails with
 `UNAVAILABLE`. A Hash changes any of these:
 
@@ -612,6 +630,7 @@ the client is created, not on the first call.
 | `max_message_size` | 4 MiB | largest message sent or received |
 | `connect_timeout` | 5 | seconds to wait for a connection |
 | `retries` | `false` | retry calls the server never started on; see [Retries](#retries) |
+| `method_retries` | `{}` | retries per service or method, by name |
 | `logger` | `Tonic::Rails.configuration.logger` | where retries are logged |
 
 ### Fork safety

data/lib/tonic/rails/client.rb

@@ -16,6 +16,7 @@ module Tonic
     #
     # Retries are opt-in: `retries: true` (or a Hash; see RetryPolicy) on
     # the client or a call retries calls the server never started on.
+    # `method_retries:` sets them per service or method.
     #
     # Stubs are built from the protobuf descriptors that
     # `tonic_rails:compile_protos` (protoc --ruby_out) generates; no
@@ -46,6 +47,10 @@ module Tonic
       # @return [RetryPolicy, nil] how calls are retried, unless they say otherwise
       attr_reader :retries
 
+      # @return [Hash{String=>RetryPolicy, nil}] retry policies by service or
+      #   method name, which take precedence over #retries
+      attr_reader :method_retries
+
       # @param address [String] "host:port"
       # @param tls [Boolean] false for plaintext, which must be explicit
       # @param tls_ca_path [String, nil] CA certificates (PEM) to trust instead
@@ -61,11 +66,15 @@ module Tonic
       # @param connect_timeout [Numeric] seconds to wait for a connection
       # @param retries [RetryPolicy, Hash, Boolean] retry calls the server
       #   never started on (see RetryPolicy); off by default
+      # @param method_retries [Hash{String=>RetryPolicy, Hash, Boolean}]
+      #   retries for some services ("demo.v1.ItemService") or methods
+      #   ("demo.v1.ItemService/GetItem"), instead of `retries`.  A method's
+      #   entry beats its service's.
       # @param logger [Logger, nil] where retries are logged; defaults to
       #   Tonic::Rails.configuration.logger
       def initialize(address, tls: true, tls_ca_path: nil, tls_cert_path: nil, tls_key_path: nil,
                      tls_server_name: nil, deadline: nil, metadata: {}, max_message_size: DEFAULT_MAX_MESSAGE_SIZE,
-                     connect_timeout: 5, retries: false, logger: nil)
+                     connect_timeout: 5, retries: false, method_retries: {}, logger: nil)
         Tonic::Rails.native_extension!
         validate_address!(address)
         validate_tls!(tls, tls_cert_path, tls_key_path)
@@ -78,6 +87,7 @@ module Tonic
         @address = address
         @deadline = deadline
         @retries = RetryPolicy.from(retries)
+        @method_retries = method_retry_policies(method_retries)
         @logger = logger
         @metadata = Metadata.encode(metadata)
         @stubs = {}
@@ -127,7 +137,7 @@ module Tonic
         bytes = input.encode(request_message(path, input, request))
         metadata = call_metadata(metadata)
         deadline_at = deadline_at(deadline)
-        policy = retry_policy(retries)
+        policy = retry_policy(path, retries)
 
         Instrumentation.instrument_request(path, address, metadata) do |payload|
           code, error_message, response, headers, trailers, details = with_retries(path, policy, deadline_at, payload) do
@@ -150,7 +160,7 @@ module Tonic
         # Fixed now, so the stream keeps the deadline of the RPC this
         # thread is handling even if it's read later.
         deadline_at = deadline_at(deadline)
-        policy = retry_policy(retries)
+        policy = retry_policy(path, retries)
 
         ServerStream.new(path) do |stream, block|
           Instrumentation.instrument_request(path, address, metadata) do |payload|
@@ -238,8 +248,35 @@ module Tonic
         (remaining * 1000).ceil
       end
 
-      def retry_policy(retries)
-        retries.nil? ? @retries : RetryPolicy.from(retries)
+      METHOD_NAME = %r{\A[A-Za-z_][\w.]*(/[A-Za-z_]\w*)?\z}
+      private_constant :METHOD_NAME
+
+      def method_retry_policies(option)
+        raise ArgumentError, "method_retries must be a Hash" unless option.is_a?(Hash)
+
+        option.to_h do |name, retries|
+          name = name.to_s.delete_prefix("/")
+          unless name.match?(METHOD_NAME)
+            raise ArgumentError, "method_retries keys must be \"package.Service\" or \"package.Service/Method\", " \
+                                 "got #{name.inspect}"
+          end
+
+          [name, RetryPolicy.from(retries)]
+        end.freeze
+      end
+
+      # The most specific policy for a call: its own, its method's, its
+      # service's, then the client's.
+      def retry_policy(path, retries)
+        return RetryPolicy.from(retries) unless retries.nil?
+        return @retries if @method_retries.empty?
+
+        method = path.delete_prefix("/")
+        service = method.split("/", 2).first
+        return @method_retries[method] if @method_retries.key?(method)
+        return @method_retries[service] if @method_retries.key?(service)
+
+        @retries
       end
 
       # Yield each message of a native stream, then return its result.

data/lib/tonic/rails/version.rb

@@ -2,6 +2,6 @@
 
 module Tonic
   module Rails
-    VERSION = "0.7.0"
+    VERSION = "0.8.1"
   end
 end

data/lib/tonic-rails.rb

@@ -81,11 +81,13 @@ module Tonic
         # Precompiled platform gems ship one binary per Ruby minor version.
         ruby_version = RUBY_VERSION[/\d+\.\d+/]
         require "tonic/rails/#{ruby_version}/tonic_rails_native"
-      rescue LoadError
+      rescue LoadError => versioned
         begin
           require "tonic/rails/tonic_rails_native"
         rescue LoadError => e
-          @native_load_error = e
+          # A precompiled binary that exists but won't load says more than
+          # the missing fallback does.
+          @native_load_error = versioned.message.include?("cannot load such file") ? e : versioned
         end
       end
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tonic-rails
 version: !ruby/object:Gem::Version
-  version: 0.7.0
+  version: 0.8.1
 platform: aarch64-linux-gnu
 authors:
 - Matt Tanous
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-10-11 00:00:00.000000000 Z
+date: 2026-10-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport