protocol-http2 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 74d3097dff56a20525423ad77d0f561d3c7571488dcb4c0eaa8714f6ac6a29ff
-  data.tar.gz: 795f564f2af3927fde4c0c0f76e04ba785d5b0056eb11978e883d3a0553bdaca
+  metadata.gz: 1a60f785211de9969cb282720013a13d2586d07b740ef1c7d944dab9da6dfd47
+  data.tar.gz: 27698d4cbbedb0aa3fea412962c36dc72f081d0c3e494bfaffc5beaa37d17806
 SHA512:
-  metadata.gz: eb8fe96eb3bdc7c3f8ba8b2185e2dba35af613985120ecb23b2750def0a3bc49ab62170b79c94b36f03856904df29effdc8f7250d5dee446e81062f9d8f9d610
-  data.tar.gz: 1904ab5ef55fb6ae3f327fc7305197cd809d11c6ea7992281d1e0035d987390fe07cb290fceb57107f094380c7553036d59a690803b9bb2f1a7bbc7a66de9fb1
+  metadata.gz: 525676f325a064c8e060352d8e865c99a7353a271fd44893ad7aa645f132cffb9e83b40d80c6e430496f517f7f777c3dac5dd666db343e14b3845b623065a375
+  data.tar.gz: d7da9b3249e5547f18378f2bb4fc060385d49469f5759af7dd775280567fa89334cd04b8c805573ec522ad7a4225fbd5ae683d9a685a4f1829af2d66cc317f31

data/lib/protocol/http2/connection.rb

@@ -149,6 +149,12 @@ module Protocol
 			
 			def receive_goaway(frame)
 				@state = :closed
+				
+				last_stream_id, error_code, message = frame.unpack
+				
+				if error_code != 0
+					raise GoawayError.new message, error_code
+				end
 			end
 			
 			def write_frame(frame)

data/lib/protocol/http2/error.rb

@@ -22,15 +22,85 @@ require 'protocol/http/error'
 
 module Protocol
 	module HTTP2
-		class ProtocolError < HTTP::ProtocolError
+		# Status codes as defined by <https://tools.ietf.org/html/rfc7540#section-7>.
+		class Error < HTTP::Error
+			# The associated condition is not a result of an error.  For example, a GOAWAY might include this code to indicate graceful shutdown of a connection.
+			NO_ERROR = 0x0
+			
+			# The endpoint detected an unspecific protocol error.  This error is for use when a more specific error code is not available.
+			PROTOCOL_ERROR = 0x1
+			
+			# The endpoint encountered an unexpected internal error.
+			INTERNAL_ERROR = 0x2
+			
+			# The endpoint detected that its peer violated the flow-control protocol.
+			FLOW_CONTROL_ERROR = 0x3
+			
+			# The endpoint sent a SETTINGS frame but did not receive a response in a timely manner.
+			SETTINGS_TIMEOUT = 0x4
+			
+			# The endpoint received a frame after a stream was half-closed.
+			STREAM_CLOSED = 0x5
+			
+			# The endpoint received a frame with an invalid size.
+			FRAME_SIZE_ERROR = 0x6
+			
+			# The endpoint refused the stream prior to performing any application processing.
+			REFUSED_STREAM = 0x7
+			
+			# Used by the endpoint to indicate that the stream is no longer needed.
+			CANCEL = 0x8
+			
+			# The endpoint is unable to maintain the header compression context for the connection.
+			COMPRESSION_ERROR = 0x9
+			
+			# The connection established in response to a CONNECT request was reset or abnormally closed.
+			CONNECT_ERROR = 0xA
+			
+			# The endpoint detected that its peer is exhibiting a behavior that might be generating excessive load.
+			ENHANCE_YOUR_CALM = 0xB
+			
+			# The underlying transport has properties that do not meet minimum security requirements.
+			INADEQUATE_SECURITY = 0xC
+			
+			# The endpoint requires that HTTP/1.1 be used instead of HTTP/2.
+			HTTP_1_1_REQUIRED = 0xD
+		end
+		
+		# Raised if connection header is missing or invalid indicating that
+		# this is an invalid HTTP 2.0 request - no frames are emitted and the
+		# connection must be aborted.
+		class HandshakeError < Error
+		end
+
+		# Raised by stream or connection handlers, results in GOAWAY frame
+		# which signals termination of the current connection. You *cannot*
+		# recover from this exception, or any exceptions subclassed from it.
+		class ProtocolError < Error
+			def initialize(message, code = PROTOCOL_ERROR)
+				super(message)
+				
+				@code = code
+			end
+			
+			attr :code
+		end
+		
+		class GoawayError < ProtocolError
 		end
 		
 		# When the frame payload does not match expectations.
 		class FrameSizeError < ProtocolError
+			def initialize(message)
+				super message, FRAME_SIZE_ERROR
+			end
 		end
 		
 		# Raised on invalid flow control frame or command.
 		class FlowControlError < ProtocolError
+			def initialize(message)
+				super message, FLOW_CONTROL_ERROR
+			end
 		end
 	end
 end

data/lib/protocol/http2/framer.rb

@@ -69,7 +69,7 @@ module Protocol
 				string = @stream.read(CONNECTION_PREFACE_MAGIC.bytesize)
 				
 				unless string == CONNECTION_PREFACE_MAGIC
-					raise ProtocolError, "Invalid connection preface: #{string.inspect}"
+					raise HandshakeError, "Invalid connection preface: #{string.inspect}"
 				end
 				
 				return string

data/lib/protocol/http2/settings_frame.rb

@@ -58,6 +58,7 @@ module Protocol
 				if value <= MAXIMUM_ALLOWED_WINDOW_SIZE
 					@initial_window_size = value
 				else
+					# An endpoint MUST treat a change to SETTINGS_INITIAL_WINDOW_SIZE that causes any flow-control window to exceed the maximum size as a connection error of type FLOW_CONTROL_ERROR.
 					raise FlowControlError, "Invalid value for initial_window_size: #{value} > #{MAXIMUM_ALLOWED_WINDOW_SIZE}"
 				end
 			end
@@ -158,7 +159,7 @@ module Protocol
 					
 					return changes
 				else
-					raise ProtocolError.new("Cannot acknowledge settings, no changes pending")
+					raise ProtocolError, "Cannot acknowledge settings, no changes pending"
 				end
 			end
 			

data/lib/protocol/http2/version.rb

@@ -20,6 +20,6 @@
 
 module Protocol
 	module HTTP2
-		VERSION = "0.1.1"
+		VERSION = "0.2.0"
 	end
 end

data/protocol-http2.gemspec

@@ -19,7 +19,7 @@ Gem::Specification.new do |spec|
 	spec.require_paths = ["lib"]
 	
 	spec.add_dependency "protocol-hpack", "~> 1.0"
-	spec.add_dependency "protocol-http"
+	spec.add_dependency "protocol-http", "~> 0.2"
 	
 	spec.add_development_dependency "covered"
 	spec.add_development_dependency "bundler"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http2
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -28,16 +28,16 @@ dependencies:
   name: protocol-http
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: '0'
+        version: '0.2'
 - !ruby/object:Gem::Dependency
   name: covered
   requirement: !ruby/object:Gem::Requirement
@@ -150,7 +150,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.0.2
 signing_key: 
 specification_version: 4
 summary: A low level implementation of the HTTP/2 protocol.