protocol-http2 0.17.0 → 0.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 20ea1a9636c45a186fe714ec65ae7160bca6d76b2629416bce0b42940e35a8d6
-  data.tar.gz: 2197763799c0b2e70b24b0f95b10e1eeef2831a540346d65ca71334bdc83615e
+  metadata.gz: 6fa9a1478ba8829d9e4416cd5507ca611d5e502eb242b1d873d44d1d60a40850
+  data.tar.gz: 4c560c928f9027108f5cf6b4fd135ce2a7043815cf8c4e2077fd5d20865e26be
 SHA512:
-  metadata.gz: 9d853eadb2b0bdac2940bf4338c6afd2376e2857c1516d9306736792122ff0a8409ac906e77e16c5c465e85f018365c184a03de6f6d7631181ecde6322328f71
-  data.tar.gz: f989baa4230ebc3d511ee5a49836e3c794b7a6eba01e309b33471fe73effc4354c4e0929bc86a770f19663585e8d252942b184d4cda8d85d779e28babc0be5e5
+  metadata.gz: 95f413d65bbde12d848f7cbe342274d7e914aca16c1a60d2f3193b91e670ae0553233fe3ae1ef4699d87984c711311c7247daac0990bb44ab0f8d3aa44d4f604
+  data.tar.gz: 5abe10dc681f35b42a123e69b4fca512d8f0e43b5741d9ab4987c336efa508e6981f2370357fa384c22bbaed8ab5d7725257dc2816823b29926de2c2e7d68d6a

data/lib/protocol/http2/client.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'connection'
+require_relative "connection"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/connection.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2023, by Marco Concetto Rudilosso.
 
-require_relative 'framer'
-require_relative 'dependency'
-require_relative 'flow_controlled'
+require_relative "framer"
+require_relative "dependency"
+require_relative "flow_controlled"
 
-require 'protocol/hpack'
+require "protocol/hpack"
 
 module Protocol
 	module HTTP2
@@ -62,8 +62,9 @@ module Protocol
 				@remote_settings.maximum_frame_size
 			end
 			
+			# The maximum number of concurrent streams that this connection can initiate:
 			def maximum_concurrent_streams
-				@local_settings.maximum_concurrent_streams
+				@remote_settings.maximum_concurrent_streams
 			end
 			
 			attr :framer
@@ -214,16 +215,20 @@ module Protocol
 			def write_frame(frame)
 				synchronize do
 					@framer.write_frame(frame)
-					@framer.flush
 				end
+				
+				# The IO is already synchronized, and we don't want additional contention.
+				@framer.flush
 			end
 			
 			def write_frames
 				if @framer
 					synchronize do
 						yield @framer
-						@framer.flush
 					end
+					
+					# See above note.
+					@framer.flush
 				else
 					raise EOFError, "Connection closed!"
 				end
@@ -385,7 +390,8 @@ module Protocol
 						raise ProtocolError, "Invalid stream id: #{stream_id} <= #{@remote_stream_id}!"
 					end
 					
-					if @streams.size < self.maximum_concurrent_streams
+					# We need to validate that we have less streams than the specified maximum:
+					if @streams.size < @local_settings.maximum_concurrent_streams
 						stream = accept_stream(stream_id)
 						@remote_stream_id = stream_id
 						

data/lib/protocol/http2/continuation_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/data_frame.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
-require_relative 'padded'
+require_relative "frame"
+require_relative "padded"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/error.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require 'protocol/http/error'
+require "protocol/http/error"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/flow_controlled.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2019, by Yuta Iwama.
 
-require_relative 'window_update_frame'
+require_relative "window_update_frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/frame.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 # Copyright, 2019, by Yuta Iwama.
 
-require_relative 'error'
+require_relative "error"
 
 module Protocol
 	module HTTP2
@@ -106,7 +106,7 @@ module Protocol
 				@stream_id.zero?
 			end
 			
-			HEADER_FORMAT = 'CnCCN'.freeze
+			HEADER_FORMAT = "CnCCN".freeze
 			STREAM_ID_MASK  = 0x7fffffff
 			
 			# Generates common 9-byte frame header.

data/lib/protocol/http2/framer.rb

@@ -1,20 +1,20 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'error'
+require_relative "error"
 
-require_relative 'data_frame'
-require_relative 'headers_frame'
-require_relative 'priority_frame'
-require_relative 'reset_stream_frame'
-require_relative 'settings_frame'
-require_relative 'push_promise_frame'
-require_relative 'ping_frame'
-require_relative 'goaway_frame'
-require_relative 'window_update_frame'
-require_relative 'continuation_frame'
+require_relative "data_frame"
+require_relative "headers_frame"
+require_relative "priority_frame"
+require_relative "reset_stream_frame"
+require_relative "settings_frame"
+require_relative "push_promise_frame"
+require_relative "ping_frame"
+require_relative "goaway_frame"
+require_relative "window_update_frame"
+require_relative "continuation_frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/goaway_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/headers_frame.rb

@@ -1,12 +1,12 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
-require_relative 'padded'
-require_relative 'continuation_frame'
-require_relative 'priority_frame'
+require_relative "frame"
+require_relative "padded"
+require_relative "continuation_frame"
+require_relative "priority_frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/padded.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/ping_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/priority_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/push_promise_frame.rb

@@ -1,11 +1,11 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
-require_relative 'padded'
-require_relative 'continuation_frame'
+require_relative "frame"
+require_relative "padded"
+require_relative "continuation_frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/reset_stream_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/server.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'connection'
+require_relative "connection"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/settings_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'ping_frame'
+require_relative "ping_frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2/stream.rb

@@ -1,14 +1,14 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'connection'
-require_relative 'dependency'
+require_relative "connection"
+require_relative "dependency"
 
 module Protocol
 	module HTTP2
-		# A single HTTP 2.0 connection can multiplex multiple streams in parallel:
+		# A single HTTP/2 connection can multiplex multiple streams in parallel:
 		# multiple requests and responses can be in flight simultaneously and stream
 		# data can be interleaved and prioritized.
 		#
@@ -18,42 +18,44 @@ module Protocol
 		# diagram below) and provide your application logic to handle request
 		# and response processing.
 		#
-		#                          +--------+
-		#                  send PP |        | recv PP
-		#                 ,--------|  idle  |--------.
-		#                /         |        |         \
-		#               v          +--------+          v
-		#        +----------+          |           +----------+
-		#        |          |          | send H /  |          |
-		# ,------| reserved |          | recv H    | reserved |------.
-		# |      | (local)  |          |           | (remote) |      |
-		# |      +----------+          v           +----------+      |
-		# |          |             +--------+             |          |
-		# |          |     recv ES |        | send ES     |          |
-		# |   send H |     ,-------|  open  |-------.     | recv H   |
-		# |          |    /        |        |        \    |          |
-		# |          v   v         +--------+         v   v          |
-		# |      +----------+          |           +----------+      |
-		# |      |   half   |          |           |   half   |      |
-		# |      |  closed  |          | send R /  |  closed  |      |
-		# |      | (remote) |          | recv R    | (local)  |      |
-		# |      +----------+          |           +----------+      |
-		# |           |                |                 |           |
-		# |           | send ES /      |       recv ES / |           |
-		# |           | send R /       v        send R / |           |
-		# |           | recv R     +--------+   recv R   |           |
-		# | send R /  `----------->|        |<-----------'  send R / |
-		# | recv R                 | closed |               recv R   |
-		# `----------------------->|        |<----------------------'
-		#                          +--------+
-		# 
-		#    send:   endpoint sends this frame
-		#    recv:   endpoint receives this frame
-		# 
-		#    H:  HEADERS frame (with implied CONTINUATIONs)
-		#    PP: PUSH_PROMISE frame (with implied CONTINUATIONs)
-		#    ES: END_STREAM flag
-		#    R:  RST_STREAM frame
+		# ```
+		#                          ┌────────┐
+		#                  send PP │        │ recv PP
+		#               ┌──────────┤  idle  ├──────────┐
+		#               │          │        │          │
+		#               ▼          └───┬────┘          ▼
+		#        ┌──────────┐          │           ┌──────────┐
+		#        │          │          │ send H /  │          │
+		# ┌──────┼ reserved │          │ recv H    │ reserved ├──────┐
+		# │      │ (local)  │          │           │ (remote) │      │
+		# │      └───┬──────┘          ▼           └──────┬───┘      │
+		# │          │             ┌────────┐             │          │
+		# │          │     recv ES │        │ send ES     │          │
+		# │   send H │   ┌─────────┤  open  ├─────────┐   │ recv H   │
+		# │          │   │         │        │         │   │          │
+		# │          ▼   ▼         └───┬────┘         ▼   ▼          │
+		# │      ┌──────────┐          │           ┌──────────┐      │
+		# │      │   half   │          │           │   half   │      │
+		# │      │  closed  │          │ send R /  │  closed  │      │
+		# │      │ (remote) │          │ recv R    │ (local)  │      │
+		# │      └────┬─────┘          │           └─────┬────┘      │
+		# │           │                │                 │           │
+		# │           │ send ES /      │       recv ES / │           │
+		# │           │ send R /       ▼        send R / │           │
+		# │           │ recv R     ┌────────┐   recv R   │           │
+		# │ send R /  └───────────►│        │◄───────────┘  send R / │
+		# │ recv R                 │ closed │               recv R   │
+		# └───────────────────────►│        │◄───────────────────────┘
+		#                          └────────┘
+		# ```
+		#
+		# - `send`: endpoint sends this frame
+		# - `recv`: endpoint receives this frame
+		#
+		# - H:  HEADERS frame (with implied CONTINUATIONs)
+		# - PP: PUSH_PROMISE frame (with implied CONTINUATIONs)
+		# - ES: END_STREAM flag
+		# - R:  RST_STREAM frame
 		#
 		# State transition methods use a trailing "!".
 		class Stream
@@ -219,10 +221,6 @@ module Protocol
 				end
 			end
 			
-			# The stream has been opened.
-			def opened(error = nil)
-			end
-			
 			def open!
 				if @state == :idle
 					@state = :open
@@ -230,8 +228,6 @@ module Protocol
 					raise ProtocolError, "Cannot open stream in state: #{@state}"
 				end
 				
-				self.opened
-				
 				return self
 			end
 			

data/lib/protocol/http2/version.rb

@@ -1,10 +1,10 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
 module Protocol
 	module HTTP2
-		VERSION = "0.17.0"
+		VERSION = "0.19.0"
 	end
 end

data/lib/protocol/http2/window_update_frame.rb

@@ -1,9 +1,9 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'frame'
+require_relative "frame"
 
 module Protocol
 	module HTTP2

data/lib/protocol/http2.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 # Released under the MIT License.
-# Copyright, 2019-2023, by Samuel Williams.
+# Copyright, 2019-2024, by Samuel Williams.
 
-require_relative 'http2/version'
-require_relative 'http2/connection'
+require_relative "http2/version"
+require_relative "http2/connection"

data/readme.md

@@ -99,8 +99,8 @@ We welcome contributions to this project.
 
 ### Developer Certificate of Origin
 
-This project uses the [Developer Certificate of Origin](https://developercertificate.org/). All contributors to this project must agree to this document to have their contributions accepted.
+In order to protect users of this project, we require all contributors to comply with the [Developer Certificate of Origin](https://developercertificate.org/). This ensures that all contributions are properly licensed and attributed.
 
-### Contributor Covenant
+### Community Guidelines
 
-This project is governed by the [Contributor Covenant](https://www.contributor-covenant.org/). All contributors and participants agree to abide by its terms.
+This project is best served by a collaborative and respectful environment. Treat each other professionally, respect differing viewpoints, and engage constructively. Harassment, discrimination, or harmful behavior is not tolerated. Communicate clearly, listen actively, and support one another. If any issues arise, please inform the project maintainers.

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: protocol-http2
 version: !ruby/object:Gem::Version
-  version: 0.17.0
+  version: 0.19.0
 platform: ruby
 authors:
 - Samuel Williams
@@ -40,7 +40,7 @@ cert_chain:
   Q2K9NVun/S785AP05vKkXZEFYxqG6EW012U4oLcFl5MySFajYXRYbuUpH6AY+HP8
   voD0MPg1DssDLKwXyt1eKD/+Fq0bFWhwVM/1XiAXL7lyYUyOq24KHgQ2Csg=
   -----END CERTIFICATE-----
-date: 2024-04-21 00:00:00.000000000 Z
+date: 2024-09-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: protocol-hpack
@@ -103,7 +103,9 @@ files:
 homepage: https://github.com/socketry/protocol-http2
 licenses:
 - MIT
-metadata: {}
+metadata:
+  documentation_uri: https://socketry.github.io/protocol-http2/
+  source_code_uri: https://github.com/socketry/protocol-http2.git
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -112,14 +114,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '3.0'
+      version: '3.1'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.3
+rubygems_version: 3.5.11
 signing_key:
 specification_version: 4
 summary: A low level implementation of the HTTP/2 protocol.