protocol-grpc 0.13.0 → 0.14.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a991dcf85eaa66f7a1cbd8d31c919e82b37e0b2034ad594da58d342391b00590
-  data.tar.gz: 0fe139aeffb04fbaee3700bcfde98588625dc37706195598fa99dd632786396a
+  metadata.gz: c7aa96e69acd0574147e4c3e8c16fba62e8278d01e094267d3cb3427221d8fa0
+  data.tar.gz: 303976d191a6b5ff5e20db644ef2f29a71c5b7c346558eac2a3e5122c1197bff
 SHA512:
-  metadata.gz: cbd273eb5cb2481235b14404bdc2742f95b3dee7a53383e1a69926e5b93508e2701bbba165d26023953b73cd9cc1438872d3fffa9dd1e77f2c5f0116c2ec95ce
-  data.tar.gz: 7e532651a9629d38558c1078eb98fb97b13c4d3c999d13ef22e01d8f6e31822bfdd10c11ce7e9640eb42db393f3441420e804fc7c6d6b74ddcdc49b3ceef560e
+  metadata.gz: 1bc1343e7e2e8e21206139992f9483a1c970b21456f90bfb124d4fdd8728eedb51b921a7d93999ece219fd4b079cb9c9e0b2433750e6ee249c234124a1dfaba3
+  data.tar.gz: cea3a080a0cea063968a40939451b2c2f044f1e4b9068b64f231272e7f2c2d953f6f7ceabef437762700cf2d36b04a90ffb94dfd43ef76f2e5b4ed55d6e4ba29

data/context/getting-started.md

@@ -18,7 +18,7 @@ $ bundle add protocol-grpc
   - A {ruby Protocol::GRPC::Body::Readable} class which handles reading gRPC messages from HTTP request/response bodies with automatic framing and decoding.
   - A {ruby Protocol::GRPC::Body::Writable} class which handles writing gRPC messages to HTTP request/response bodies with automatic framing and encoding.
   - A {ruby Protocol::GRPC::Middleware} abstract base class for building gRPC server applications.
-  - A {ruby Protocol::GRPC::Call} class which represents the context of a single gRPC RPC call, including deadline tracking.
+  - A {ruby Protocol::GRPC::Call} class which represents the request, response, metadata, and deadline for a single gRPC RPC call.
   - A {ruby Protocol::GRPC::Status} module with gRPC status code constants.
   - A {ruby Protocol::GRPC::Error} hierarchy for gRPC-specific error handling.
 
@@ -132,13 +132,14 @@ end
 ``` ruby
 require "protocol/grpc/call"
 
-call = Protocol::GRPC::Call.new(request, deadline: deadline)
+call = Protocol::GRPC::Call.new(request, response, deadline: deadline)
 
 # Access request
 call.request  # => Protocol::HTTP::Request
 
-# Check deadline
+# Check deadline and status
 call.deadline.exceeded?  # => false
+call.status  # => Protocol::GRPC::Status::OK
 
 # Access peer information
 call.peer  # => Protocol::HTTP::Address

data/design.md

@@ -535,7 +535,6 @@ module Protocol
 			def initialize(request, deadline: nil)
 				@request = request
 				@deadline = deadline
-				@cancelled = false
 			end
 			
 			# @attribute [Protocol::HTTP::Request] The underlying HTTP request
@@ -562,17 +561,6 @@ module Protocol
 				@deadline ? [@deadline - Time.now, 0].max : nil
 			end
 			
-			# Mark this call as cancelled
-			def cancel!
-				@cancelled = true
-			end
-			
-			# Check if call was cancelled
-			# @returns [Boolean]
-			def cancelled?
-				@cancelled
-			end
-			
 			# Get peer information (client address)
 			# @returns [String | Nil]
 			def peer

data/lib/protocol/grpc/call.rb

@@ -31,7 +31,6 @@ module Protocol
 				@request = request
 				@response = response
 				@deadline = deadline
-				@cancelled = false
 			end
 			
 			# @attribute [Protocol::HTTP::Request] The underlying HTTP request.
@@ -67,15 +66,12 @@ module Protocol
 				@deadline&.remaining
 			end
 			
-			# Mark this call as cancelled.
-			def cancel!
-				@cancelled = true
-			end
-			
-			# Check if the call was cancelled.
-			# @returns [Boolean] `true` if the call was cancelled, `false` otherwise
-			def cancelled?
-				@cancelled
+			# Get the current gRPC status of the call.
+			# @returns [Integer | Nil] The current gRPC status code, if available.
+			def status
+				if headers = @response&.headers
+					headers["grpc-status"]&.to_i
+				end
 			end
 			
 			# Get peer information (client address).

data/lib/protocol/grpc/version.rb

@@ -7,7 +7,7 @@
 module Protocol
 	# @namespace
 	module GRPC
-		VERSION = "0.13.0"
+		VERSION = "0.14.0"
 	end
 end
 

data/lib/protocol/grpc.rb

@@ -10,7 +10,6 @@ require_relative "grpc/error"
 require_relative "grpc/route"
 require_relative "grpc/header"
 require_relative "grpc/metadata"
-require_relative "grpc/methods"
 require_relative "grpc/call"
 require_relative "grpc/body/readable"
 require_relative "grpc/body/writable"

data/readme.md

@@ -28,6 +28,15 @@ Please see the [project documentation](https://socketry.github.io/protocol-grpc/
 
 Please see the [project releases](https://socketry.github.io/protocol-grpc/releases/index) for all releases.
 
+### v0.14.0
+
+  - **Breaking**: Removed the unused `Protocol::GRPC::Call#cancel!` and `Protocol::GRPC::Call#cancelled?` methods.
+  - Added `Protocol::GRPC::Call#status` to report the status assigned to the response.
+
+### v0.13.1
+
+  - **Breaking**: Removed the deprecated `Protocol::GRPC::Methods` module. Use `Protocol::GRPC::Route`, `Protocol::GRPC::Metadata`, and `Protocol::GRPC::Header::Timeout` instead.
+
 ### v0.13.0
 
   - Added `Protocol::GRPC::Route` for building and parsing gRPC request paths.

data/releases.md

@@ -1,5 +1,14 @@
 # Releases
 
+## v0.14.0
+
+  - **Breaking**: Removed the unused `Protocol::GRPC::Call#cancel!` and `Protocol::GRPC::Call#cancelled?` methods.
+  - Added `Protocol::GRPC::Call#status` to report the status assigned to the response.
+
+## v0.13.1
+
+  - **Breaking**: Removed the deprecated `Protocol::GRPC::Methods` module. Use `Protocol::GRPC::Route`, `Protocol::GRPC::Metadata`, and `Protocol::GRPC::Header::Timeout` instead.
+
 ## v0.13.0
 
   - Added `Protocol::GRPC::Route` for building and parsing gRPC request paths.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-grpc
 version: !ruby/object:Gem::Version
-  version: 0.13.0
+  version: 0.14.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -116,7 +116,6 @@ files:
 - lib/protocol/grpc/health_check.rb
 - lib/protocol/grpc/interface.rb
 - lib/protocol/grpc/metadata.rb
-- lib/protocol/grpc/methods.rb
 - lib/protocol/grpc/middleware.rb
 - lib/protocol/grpc/route.rb
 - lib/protocol/grpc/status.rb

data/lib/protocol/grpc/methods.rb

@@ -1,81 +0,0 @@
-# frozen_string_literal: true
-
-# Released under the MIT License.
-# Copyright, 2025-2026, by Samuel Williams.
-
-require_relative "metadata"
-require_relative "route"
-
-module Protocol
-	module GRPC
-		# Provides utility methods for building and parsing gRPC-compatible HTTP requests.
-		module Methods
-			# Build gRPC path from service and method.
-			# @parameter service [String] e.g., "my_service.Greeter"
-			# @parameter method [String] e.g., "SayHello"
-			# @returns [String] e.g., "/my_service.Greeter/SayHello"
-			# @deprecated Use {Route.build} instead.
-			def self.build_path(service, method)
-				Kernel.warn("`Protocol::GRPC::Methods.build_path` is deprecated; use `Protocol::GRPC::Route.build` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				Route.build(service, method)
-			end
-			
-			# Parse service and method from gRPC path.
-			# @parameter path [String] e.g., "/my_service.Greeter/SayHello"
-			# @returns [Array(String | String)] [service, method]
-			# @deprecated Use {Route.parse} instead.
-			def self.parse_path(path)
-				Kernel.warn("`Protocol::GRPC::Methods.parse_path` is deprecated; use `Protocol::GRPC::Route.parse` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				Route.parse(path)
-			end
-			
-			# Build gRPC request headers.
-			# @parameter metadata [Hash] Custom metadata key-value pairs
-			# @parameter timeout [Numeric | Nil] Optional timeout in seconds
-			# @parameter content_type [String] Content type (default: "application/grpc+proto")
-			# @returns [Protocol::HTTP::Headers]
-			# @deprecated Use {Metadata.build} instead.
-			def self.build_headers(metadata: {}, timeout: nil, content_type: "application/grpc+proto")
-				Kernel.warn("`Protocol::GRPC::Methods.build_headers` is deprecated; use `Protocol::GRPC::Metadata.build` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				Metadata.build(metadata: metadata, timeout: timeout, content_type: content_type)
-			end
-			
-			# Extract metadata from gRPC headers.
-			# @parameter headers [Protocol::HTTP::Headers]
-			# @returns [Hash] Metadata key-value pairs
-			# @deprecated Use {Metadata.extract} instead.
-			def self.extract_metadata(headers)
-				Kernel.warn("`Protocol::GRPC::Methods.extract_metadata` is deprecated; use `Protocol::GRPC::Metadata.extract` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				Metadata.extract(headers)
-			end
-			
-			# Format timeout for grpc-timeout header.
-			# @parameter timeout [Numeric] Timeout in seconds
-			# @returns [String] e.g., "1000m" for 1 second
-			# @deprecated Use {Protocol::GRPC::Header::Timeout.format} instead.
-			def self.format_timeout(timeout)
-				Kernel.warn("`Protocol::GRPC::Methods.format_timeout` is deprecated; use `Protocol::GRPC::Header::Timeout.format` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				Header::Timeout.format(timeout)
-			end
-			
-			# Parse grpc-timeout header value.
-			# @parameter value [String] e.g., "1000m"
-			# @returns [Numeric | Nil] Timeout in seconds, or `Nil` if value is invalid
-			# @deprecated Use {Protocol::GRPC::Header::Timeout#to_seconds} instead.
-			def self.parse_timeout(value)
-				Kernel.warn("`Protocol::GRPC::Methods.parse_timeout` is deprecated; use `Protocol::GRPC::Header::Timeout#to_seconds` instead.", uplevel: 1, category: :deprecated) if $VERBOSE
-				
-				return nil unless value
-				
-				Header::Timeout.parse(value).to_seconds
-			rescue ArgumentError
-				return nil
-			end
-		end
-	end
-end