async-grpc 0.2.0 → 0.4.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc699a3d9a47acc1b8bdb7196b0da1280847caa14d5405e0150e8608cd701501
-  data.tar.gz: 3884004454f86b2a7cd7c1ad460c00f6c820edae6b0bccc7a87d177a0cccee72
+  metadata.gz: b1e1ab7ce49d13b36bbee671e1598de070bc068921dc46b26671ca8c13a45a19
+  data.tar.gz: fefcc712682312abdaf415ca87c9beaa5c81997332aebe3c50d366ba3157353d
 SHA512:
-  metadata.gz: 6d487819bdab689d575b8985e84b81d1ad1293126f9a7f64d697853cf723a4cdf67bb607f0e20faa0f1e547baf0eea6d9dc102da576b450bcba5e42f72ad2e95
-  data.tar.gz: 9f2bf511ff8fc16db342add52bedbfbf1c924c6109346e9d3e877abb2e2ff6f03f40c50ef9a46406df2895b22b6a32845a22a7d444617ed65bc11ab4ee82ae52
+  metadata.gz: 98ff4adf8e4570de34415d400c56ece807cfb153619ea1c12a058c9cfb46577f7ff533c8310c1a4d6c7ab1f7936f21d4e9d5559315ae52772a532b71513f585a
+  data.tar.gz: 5a6ccfc411717a17d8d6e2309ebd0710bf0226882d9cea239f9c73925115fbcfdccb2b6903dc84c13c9d1b401b5f9001bc20ffe5e1bf7c294f64d3b286ca8f33

data/context/getting-started.md

@@ -23,7 +23,7 @@ $ bundle add protocol-grpc async-http
   - {ruby Async::GRPC::Client} - An asynchronous gRPC client that wraps `Async::HTTP::Client`.
   - {ruby Async::GRPC::Stub} - A method-based stub for making RPC calls.
   - {ruby Async::GRPC::Service} - A concrete service implementation that uses a `Protocol::GRPC::Interface`.
-  - {ruby Async::GRPC::DispatcherMiddleware} - Middleware that routes requests to registered services.
+  - {ruby Async::GRPC::Dispatcher} - Middleware that routes requests to registered services.
 
 ## Client Usage
 
@@ -104,12 +104,12 @@ end
 ### Registering Services
 
 ``` ruby
-require "async/grpc/dispatcher_middleware"
+require "async/grpc/dispatcher"
 
-dispatcher = Async::GRPC::DispatcherMiddleware.new
+dispatcher = Async::GRPC::Dispatcher.new
 
 service = GreeterService.new(GreeterInterface, "hello.Greeter")
-dispatcher.register("hello.Greeter", service)
+dispatcher.register(service)
 ```
 
 ### Running a Server
@@ -151,8 +151,8 @@ end
 Async do
 		# Setup server
 	endpoint = Async::HTTP::Endpoint.parse("http://localhost:50051")
-	dispatcher = Async::GRPC::DispatcherMiddleware.new
-	dispatcher.register("hello.Greeter", GreeterService.new(GreeterInterface, "hello.Greeter"))
+	dispatcher = Async::GRPC::Dispatcher.new
+	dispatcher.register(GreeterService.new(GreeterInterface, "hello.Greeter"))
 	server = Async::HTTP::Server.for(endpoint, dispatcher)
 	
 		# Setup client

data/design.md

@@ -483,8 +483,8 @@ middleware.register("my_service.Greeter", GreeterService.new)
 
 # Use with Async::HTTP::Server - it handles everything!
 endpoint = Async::HTTP::Endpoint.parse(
-		"https://localhost:50051",
-		protocol: Async::HTTP::Protocol::HTTP2
+	"https://localhost:50051",
+	protocol: Async::HTTP::Protocol::HTTP2
 )
 
 server = Async::HTTP::Server.new(middleware, endpoint)

data/lib/async/grpc/client.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require "async"
 require "async/http/client"
@@ -173,7 +173,7 @@ module Async
 					
 					if response_body
 						response_value = response_body.read
-						response_body.close
+						response_body.finish
 					end
 					
 					# Check status after reading body (trailers are now available)
@@ -215,10 +215,12 @@ module Async
 					# Check status after reading all body chunks (trailers are now available):
 					check_status!(response)
 					
+					# Nullify the response so we don't close it in ensure:
+					response = nil
+					
 					return response_body
-				rescue
-					response.close
-					raise
+				ensure
+					response&.close
 				end
 			end
 			
@@ -236,8 +238,11 @@ module Async
 				
 				http_request = Protocol::HTTP::Request["POST", path, headers, body]
 				
-				block.call(body) if block_given?
-				body.close_write unless body.closed?
+				if block_given?
+					block.call(body)
+				end
+				
+				body.close_write
 				
 				response = call(http_request)
 				
@@ -251,12 +256,12 @@ module Async
 					)
 					
 					message = readable_body.read
-					readable_body.close
+					readable_body.finish
 					
 					# Check status after reading body (trailers are now available):
 					check_status!(response)
 					
-					message
+					return message
 				ensure
 					response.close
 				end
@@ -289,25 +294,25 @@ module Async
 						encoding: response_encoding
 					)
 					
-					return readable_body unless block_given?
-					
-					begin
-						block.call(readable_body, body)
-						body.close_write unless body.closed?
-						
-						# Consume all response chunks to ensure trailers are available:
-						readable_body.each{|_|}
-					ensure
-						readable_body.close
+					unless block_given?
+						return readable_body
 					end
 					
+					block.call(body, readable_body)
+					body.close_write
+					
+					# Consume all response chunks to ensure trailers are available:
+					readable_body.finish
+					
 					# Check status after reading all body chunks (trailers are now available):
 					check_status!(response)
 					
-					readable_body
-				rescue StandardError
-					response.close
-					raise
+					# Nullify the response so we don't close it in ensure:
+					response = nil
+					
+					return readable_body
+				ensure
+					response&.close
 				end
 			end
 			

data/lib/async/grpc/{dispatcher_middleware.rb → dispatcher.rb}

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2025, by Samuel Williams.
+# Copyright, 2025-2026, by Samuel Williams.
 
 require "async"
 require "async/deadline"
@@ -17,16 +17,16 @@ require "protocol/grpc/status"
 
 module Async
 	module GRPC
-		# Represents middleware that dispatches gRPC requests to registered services.
+		# Dispatches gRPC requests to registered services.
 		# Handles routing based on service name from the request path.
 		#
 		# @example Registering services:
-		#   dispatcher = DispatcherMiddleware.new
-		#   dispatcher.register("hello.Greeter", GreeterService.new(GreeterInterface, "hello.Greeter"))
-		#   dispatcher.register("world.Greeter", WorldService.new(WorldInterface, "world.Greeter"))
+		#   dispatcher = Dispatcher.new
+		#   dispatcher.register(GreeterService.new(GreeterInterface, "hello.Greeter"))
+		#   dispatcher.register(WorldService.new(WorldInterface, "world.Greeter"))
 		#
 		#   server = Async::HTTP::Server.for(endpoint, dispatcher)
-		class DispatcherMiddleware < Protocol::GRPC::Middleware
+		class Dispatcher < Protocol::GRPC::Middleware
 			# Initialize the dispatcher.
 			# @parameter app [#call | Nil] The next middleware in the chain
 			# @parameter services [Hash] Optional initial services hash (service_name => service_instance)
@@ -36,10 +36,10 @@ module Async
 			end
 			
 			# Register a service.
-			# @parameter service_name [String] Service name (e.g., "hello.Greeter")
 			# @parameter service [Async::GRPC::Service] Service instance
-			def register(service_name, service)
-				@services[service_name] = service
+			# @parameter name [String] Service name (defaults to service.service_name)
+			def register(service, name: service.service_name)
+				@services[name] = service
 			end
 			
 			protected

data/lib/async/grpc/service.rb

@@ -9,7 +9,7 @@ module Async
 	module GRPC
 		# Represents a concrete service implementation that uses an Interface.
 		# Subclass this and implement the RPC methods defined in the interface.
-		# Services are registered with DispatcherMiddleware for routing.
+		# Services are registered with Dispatcher for routing.
 		#
 		# @example Example service implementation:
 		#   class GreeterInterface < Protocol::GRPC::Interface
@@ -32,8 +32,8 @@ module Async
 		#   end
 		#
 		#   # Register with dispatcher:
-		#   dispatcher = DispatcherMiddleware.new
-		#   dispatcher.register("hello.Greeter", GreeterService.new(GreeterInterface, "hello.Greeter"))
+		#   dispatcher = Dispatcher.new
+		#   dispatcher.register(GreeterService.new(GreeterInterface, "hello.Greeter"))
 		#   server = Async::HTTP::Server.for(endpoint, dispatcher)
 		class Service
 			# Initialize a new service instance.

data/lib/async/grpc/version.rb

@@ -7,7 +7,7 @@
 module Async
 	# @namespace
 	module GRPC
-		VERSION = "0.2.0"
+		VERSION = "0.4.0"
 	end
 end
 

data/lib/async/grpc.rb

@@ -7,7 +7,7 @@ require_relative "grpc/version"
 require_relative "grpc/client"
 require_relative "grpc/service"
 require_relative "grpc/stub"
-require_relative "grpc/dispatcher_middleware"
+require_relative "grpc/dispatcher"
 
 module Async
 	module GRPC

data/license.md

@@ -1,6 +1,6 @@
 # MIT License
 
-Copyright, 2025, by Samuel Williams.  
+Copyright, 2025-2026, by Samuel Williams.  
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

data/readme.md

@@ -10,7 +10,7 @@ Asynchronous gRPC client and server implementation built on top of `protocol-grp
 
   - **Asynchronous client** - Wraps `Async::HTTP::Client` to provide gRPC-specific call methods with automatic message framing and status handling.
   - **Method-based stubs** - Create type-safe stubs from `Protocol::GRPC::Interface` definitions. Accepts both PascalCase and snake\_case method names for convenience.
-  - **Server middleware** - `DispatcherMiddleware` routes requests to registered services based on path.
+  - **Server middleware** - `Dispatcher` routes requests to registered services based on path.
   - **All RPC patterns** - Supports unary, server streaming, client streaming, and bidirectional streaming RPCs.
   - **HTTP/1 and HTTP/2 transport** - Built on `async-http` with automatic HTTP/2 multiplexing and connection pooling.
 
@@ -24,6 +24,15 @@ Please see the [project documentation](https://socketry.github.io/async-grpc/) f
 
 Please see the [project releases](https://socketry.github.io/async-grpc/releases/index) for all releases.
 
+### v0.4.0
+
+  - Fix handling of trailers.
+
+### v0.3.0
+
+  - **Breaking**: Renamed `DispatcherMiddleware` to `Dispatcher` for cleaner API.
+  - **Breaking**: Simplified `Dispatcher#register` API to `register(service, name: service.service_name)`, eliminating redundant service name specification.
+
 ### v0.2.0
 
   - Added `Async::GRPC::RemoteError` class to encapsulate remote error details including message and backtrace extracted from response headers.

data/releases.md

@@ -1,5 +1,14 @@
 # Releases
 
+## v0.4.0
+
+  - Fix handling of trailers.
+
+## v0.3.0
+
+  - **Breaking**: Renamed `DispatcherMiddleware` to `Dispatcher` for cleaner API.
+  - **Breaking**: Simplified `Dispatcher#register` API to `register(service, name: service.service_name)`, eliminating redundant service name specification.
+
 ## v0.2.0
 
   - Added `Async::GRPC::RemoteError` class to encapsulate remote error details including message and backtrace extracted from response headers.

data/spanner_integration.md

@@ -205,11 +205,11 @@ client.unary_binary(service, method, request_binary) # => response_binary
 
 ```ruby
 client.unary(
-		service,
-		method,
-		request,
-		marshal: ->(obj){obj.to_proto},
-		unmarshal: ->(data){MyReply.decode(data)}
+	service,
+	method,
+	request,
+	marshal: ->(obj){obj.to_proto},
+	unmarshal: ->(data){MyReply.decode(data)}
 )
 ```
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-grpc
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.4.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -76,7 +76,7 @@ files:
 - design.md
 - lib/async/grpc.rb
 - lib/async/grpc/client.rb
-- lib/async/grpc/dispatcher_middleware.rb
+- lib/async/grpc/dispatcher.rb
 - lib/async/grpc/remote_error.rb
 - lib/async/grpc/service.rb
 - lib/async/grpc/stub.rb
@@ -105,7 +105,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.9
+rubygems_version: 4.0.3
 specification_version: 4
 summary: Client and server implementation for gRPC using Async.
 test_files: []