async-grpc 0.2.0 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dc699a3d9a47acc1b8bdb7196b0da1280847caa14d5405e0150e8608cd701501
-  data.tar.gz: 3884004454f86b2a7cd7c1ad460c00f6c820edae6b0bccc7a87d177a0cccee72
+  metadata.gz: 33e1af099cdab3092bc722b175b4dc16cc4fdacbbe7c59c12d1f186cfec95b0b
+  data.tar.gz: 70c6f471fde84394a3a6aa5cb014d98a16be1746c132b0e932f516a6c175f8f3
 SHA512:
-  metadata.gz: 6d487819bdab689d575b8985e84b81d1ad1293126f9a7f64d697853cf723a4cdf67bb607f0e20faa0f1e547baf0eea6d9dc102da576b450bcba5e42f72ad2e95
-  data.tar.gz: 9f2bf511ff8fc16db342add52bedbfbf1c924c6109346e9d3e877abb2e2ff6f03f40c50ef9a46406df2895b22b6a32845a22a7d444617ed65bc11ab4ee82ae52
+  metadata.gz: a243cbd19d766995b1e63037f21357d97ff3878cd8020227df2652cd11be2bbbb367f753d8182ee319a0e47e7ecddc335ce38b4dca03209873ae869aee150acc
+  data.tar.gz: 9096b9bccc77a7860f164325dadc427c0e4ebc8ce4f9ff1411f87e3ccaa9c094c2502075b83ba21c5c9e458ac10e90034198e85d6f41d1d26f2b6e436010cc9b

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/lib/async/grpc/{dispatcher_middleware.rb → dispatcher.rb}

@@ -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)
@@ -35,12 +35,12 @@ module Async
 				@services = services
 			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
-			end
+		# Register a service.
+		# @parameter service [Async::GRPC::Service] Service instance
+		# @parameter name [String] Service name (defaults to service.service_name)
+		def register(service, name: service.service_name)
+			@services[name] = service
+		end
 			
 			protected
 			
@@ -146,3 +146,4 @@ module Async
 		end
 	end
 end
+

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.3.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/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,11 @@ 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.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,10 @@
 # Releases
 
+## 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.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: async-grpc
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.3.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