http-2 0.12.0 → 1.0.0

data/sig/header/decompressor.rbs

@@ -0,0 +1,22 @@
+module HTTP2
+  module Header
+    class Decompressor
+      @cc: EncodingContext
+
+      def table_size=: (Integer) -> void
+
+      def integer: (String, Integer) -> Integer
+
+      def string: (String) -> String
+
+      def header: (String) -> header_command
+
+      def decode: (String, frame?) -> Array[header_pair]
+                | (String) -> Array[header_pair]
+      private
+
+      def initialize: (context_hash options) -> untyped
+                    | () -> untyped
+    end
+  end
+end

data/sig/header/encoding_context.rbs

@@ -0,0 +1,34 @@
+module HTTP2
+  module Header
+    class EncodingContext
+      STATIC_TABLE: Array[header_pair]
+
+      attr_reader table: Array[header_pair]
+
+      attr_reader options: context_hash
+
+      def dup: () -> EncodingContext
+
+      def dereference: (Integer) -> header_pair
+
+      def process: (header_command cmd) -> header_pair?
+
+      def encode: (_Each[header_pair]) -> Array[header_command]
+
+      def addcmd: (String name, String value) -> header_command
+
+      def table_size=: (Integer) -> void
+
+      def current_table_size: () -> Integer
+
+      private
+
+      def initialize: (context_hash options) -> untyped
+                    | () -> untyped
+
+      def add_to_table: (header_pair) -> void
+
+      def size_check: (header_pair?) -> bool
+    end
+  end
+end

data/sig/header/huffman.rbs

@@ -0,0 +1,9 @@
+module HTTP2
+  module Header
+    class Huffman
+      def encode: (String str) -> String
+
+      def decode: (String str) -> String
+    end
+  end
+end

data/sig/header.rbs

@@ -0,0 +1,27 @@
+module HTTP2
+  module Header
+    type header_key = :type | :name | :value | :index
+    type header_value = Integer | String | :indexed | :changetablesize | :incremental | :noindex | :neverindexed
+
+    #type context_hash = {
+    #  huffman?: (:always | :never | :shorter),
+    #  index?: (:all | :static | :never),
+    #  table_size?: Integer
+    #}
+    type context_hash = Hash[Symbol, Symbol | Integer]
+
+    type header_command = Hash[header_key, header_value]
+
+    HEADREP: Hash[Symbol, Hash[Symbol, Integer]]
+
+    NAIVE: Hash[Symbol, Symbol]
+    LINEAR: Hash[Symbol, Symbol]
+    STATIC: Hash[Symbol, Symbol]
+    SHORTER: Hash[Symbol, Symbol]
+    NAIVEH: Hash[Symbol, Symbol]
+    LINEARH: Hash[Symbol, Symbol]
+    STATICH: Hash[Symbol, Symbol]
+    SHORTERH: Hash[Symbol, Symbol]
+
+  end
+end

data/sig/next.rbs

@@ -0,0 +1,101 @@
+module HTTP2
+  VERSION: String
+
+  DEFAULT_FLOW_WINDOW: Integer
+
+  DEFAULT_HEADER_SIZE: Integer
+
+  DEFAULT_MAX_CONCURRENT_STREAMS: Integer
+
+  type settings_hash = Hash[Symbol, Integer]
+
+  type settings_ary = Array[settings_enum]
+
+  type settings_enum = Enumerable[[Symbol, Integer]]
+
+  SPEC_DEFAULT_CONNECTION_SETTINGS: settings_hash
+
+  DEFAULT_CONNECTION_SETTINGS: settings_hash
+
+  DEFAULT_WEIGHT: Integer
+
+  CONNECTION_PREFACE_MAGIC: String
+
+  REQUEST_MANDATORY_HEADERS: Array[String]
+
+  RESPONSE_MANDATORY_HEADERS: Array[String]
+
+  type header_pair = [string, string]
+
+  # # FRAMES
+  type frame_control_flags = Array[:end_headers | :end_stream]
+
+  # # HEADERS
+  # type headers_frame = {
+  #   type: :headers, flags: frame_control_flags, stream: Integer, payload: Enumerable[header_pair],
+  #   ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, ?padding: Integer
+  # }
+
+  # # DATA
+  type data_frame = { type: :data, flags: frame_control_flags, stream: Integer, length: Integer, payload: String, padding: Integer }
+                  | { type: :data, flags: frame_control_flags, stream: Integer, length: Integer, payload: String }
+                  | { type: :data, flags: frame_control_flags, payload: String }
+
+  # # PUSH_PROMISE
+  # type push_promise_frame = { type: :push_promise, promise_stream: Integer, flags: frame_control_flags, stream: Integer, ?method: Symbol, ?trailer: Array[String], ?content_length: Integer, payload: Enumerable[header_pair], ?padding: Integer }
+
+  # # SETTINGS
+  # type settings_frame = { type: :settings, stream: 0, payload: Array[[Symbol | Integer, Integer]] }
+
+  # # WINDOW_UPDATE
+  # type window_update_frame = { type: :window_update, stream: Integer, increment: Integer }
+
+  # # PRIORITY
+  type priority_frame = { type: :priority, stream: Integer, dependency: Integer, exclusive: bool, weight: Integer }
+
+  # # ALTSVC
+  # type altsvc_frame = { type: :altsvc, stream: 0, max_age: Integer, port: Integer, proto: "String", host: String }
+
+  # # ORIGIN
+  # type origin_frame = { type: :origin, stream: 0, origin: Array[String] }
+
+  # # PING
+  # type ping_frame = { type: :ping, payload: String, length: Integer }
+
+  # # GOAWAY
+  # type goaway_frame = { type: :goaway, stream: 0, last_stream: Integer, error: Symbol? }
+
+  # type frame = headers_frame | data_frame | push_promise_frame |
+  #              settings_frame | window_update_frame | priority_frame | altsvc_frame |
+  #              origin_frame | ping_frame | goaway_frame
+
+  type frame_key = :type | :flags | :stream | :padding | :ignore |
+                   # headers
+                   :method | :trailer | :content_length | :status |
+                   # data, settings, ping
+                   :payload | :length |
+                   # promise
+                   :promise_stream |
+                   # window_update
+                   :increment |
+                   # priority
+                   :dependency | :exclusive | :weight |
+                   # altsvc
+                   :max_age | :port | :proto | :host |
+                   # origin
+                   :origin |
+                   # goaway
+                   :last_stream | :error
+
+  type frame_value = Integer |
+                     Symbol | # type (:data, :headers)
+                     Array[Symbol] |
+                     String |
+                     bool |
+                     Array[String] |
+                     Array[[Symbol | Integer, Integer]] |
+                     Enumerable[header_pair] |
+                     nil
+
+  type frame = Hash[frame_key, frame_value]
+end

data/sig/server.rbs

@@ -0,0 +1,12 @@
+module HTTP2
+  class Server < Connection
+
+    def upgrade: (String settings, Enumerable[header_pair] headers, String body) -> void
+
+    def origin_set=: (Array[_ToS]) -> void
+
+    private
+
+    def promise: (Stream parent, Enumerable[header_pair] headers, Array[Symbol] flags) { (Stream) -> void } -> void
+  end
+end

data/sig/stream.rbs

@@ -0,0 +1,91 @@
+module HTTP2
+  class Stream
+    include FlowBuffer
+    include Emitter
+
+    attr_reader id: Integer
+    attr_reader state: Symbol
+    attr_reader parent: Stream?
+    attr_reader weight: Integer
+    attr_reader dependency: Integer
+    attr_reader remote_window: Integer
+    attr_reader local_window: Integer
+    attr_reader closed: Symbol?
+
+    @connection: Connection
+    @local_window_max_size: Integer
+    @error: bool
+    @_method: String?
+    @_content_length: Integer?
+    @_status_code: Integer?
+    @_waiting_on_trailers: bool
+    @received_data: bool
+    @activated: bool
+
+    alias window local_window
+
+    def closed?: () -> bool
+
+    def receive: (frame) -> void
+
+    alias << receive
+
+    def verify_trailers: (frame) -> void
+
+    def calculate_content_length: (Integer?) -> void
+
+    def send: (frame) -> void
+
+    def headers: (Enumerable[header_pair] headers, ?end_headers: bool, ?end_stream: bool) -> void
+
+    def promise: (Enumerable[header_pair] headers, ?end_headers: bool) { (Stream) -> void } -> void
+
+    def reprioritize: (?weight: Integer, ?dependency: Integer, ?exclusive: bool) -> void
+
+    def data: (String payload, ?end_stream: bool) -> void
+
+    def chunk_data: (String payload, Integer max_size) { (String) -> void } -> String
+
+    def close: (Symbol error) -> void
+             | () -> void
+
+    def cancel: () -> void
+
+    def refuse: () -> void
+
+    def window_update: (Integer increment) -> void
+
+    private
+
+    def initialize: (
+      connection: Connection,
+      id: Integer,
+      ?weight: Integer,
+      ?dependency: Integer,
+      ?exclusive: bool,
+      ?parent: Stream?,
+      ?state: Symbol
+    ) -> untyped
+
+    def transition: (frame, bool sending) -> void
+
+    def event: (Symbol newstate) -> void
+
+    def activate_stream_in_conn: () -> void
+
+    def close_stream_in_conn: (*untyped) -> void
+
+    def complete_transition: (frame) -> void
+
+    def process_priority: ({weight: Integer, dependency: Integer, exclusive: bool}) -> void
+
+    def end_frame?: () -> bool
+
+    def stream_error: (Symbol error, ?msg: String?) -> void
+                    | () -> void
+
+    alias error stream_error
+
+    def manage_state: (frame) { () -> void } -> void
+  end
+end

metadata

@@ -1,57 +1,69 @@
 --- !ruby/object:Gem::Specification
 name: http-2
 version: !ruby/object:Gem::Version
-  version: 0.12.0
+  version: 1.0.0
 platform: ruby
 authors:
+- Tiago Cardoso
 - Ilya Grigorik
 - Kaoru Maeda
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-06-14 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: base64
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+date: 2024-06-28 00:00:00.000000000 Z
+dependencies: []
 description: Pure-ruby HTTP 2.0 protocol implementation
 email:
+- cardoso_tiago@hotmail.com
 - ilya@igvita.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- LICENSE
 - README.md
 - lib/http/2.rb
-- lib/http/2/buffer.rb
+- lib/http/2/base64.rb
 - lib/http/2/client.rb
-- lib/http/2/compressor.rb
 - lib/http/2/connection.rb
 - lib/http/2/emitter.rb
 - lib/http/2/error.rb
+- lib/http/2/extensions.rb
 - lib/http/2/flow_buffer.rb
 - lib/http/2/framer.rb
-- lib/http/2/huffman.rb
-- lib/http/2/huffman_statemachine.rb
+- lib/http/2/header.rb
+- lib/http/2/header/compressor.rb
+- lib/http/2/header/decompressor.rb
+- lib/http/2/header/encoding_context.rb
+- lib/http/2/header/huffman.rb
+- lib/http/2/header/huffman_statemachine.rb
 - lib/http/2/server.rb
 - lib/http/2/stream.rb
 - lib/http/2/version.rb
+- sig/client.rbs
+- sig/connection.rbs
+- sig/emitter.rbs
+- sig/error.rbs
+- sig/extensions.rbs
+- sig/flow_buffer.rbs
+- sig/frame_buffer.rbs
+- sig/framer.rbs
+- sig/header.rbs
+- sig/header/compressor.rbs
+- sig/header/decompressor.rbs
+- sig/header/encoding_context.rbs
+- sig/header/huffman.rbs
+- sig/next.rbs
+- sig/server.rbs
+- sig/stream.rbs
 homepage: https://github.com/igrigorik/http-2
 licenses:
 - MIT
-metadata: {}
+metadata:
+  bug_tracker_uri: https://github.com/igrigorik/http-2/issues
+  changelog_uri: https://github.com/igrigorik/http-2/blob/main/CHANGELOG.md
+  source_code_uri: https://github.com/igrigorik/http-2
+  homepage_uri: https://github.com/igrigorik/http-2
+  rubygems_mfa_required: 'true'
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -60,14 +72,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: 2.7.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.26
+rubygems_version: 3.5.3
 signing_key:
 specification_version: 4
 summary: Pure-ruby HTTP 2.0 protocol implementation

data/LICENSE

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2013 Ilya Grigorik
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.

data/lib/http/2/buffer.rb

@@ -1,78 +0,0 @@
-# frozen_string_literal: true
-
-require 'forwardable'
-
-module HTTP2
-  # Binary buffer wraps String.
-  #
-  class Buffer
-    extend Forwardable
-
-    def_delegators :@buffer, :ord, :encoding, :setbyte, :unpack, :unpack1,
-                   :size, :each_byte, :to_str, :to_s, :length, :inspect,
-                   :[], :[]=, :empty?, :bytesize, :include?
-
-    UINT32 = 'N'
-    private_constant :UINT32
-
-    # Forces binary encoding on the string
-    def initialize(str = '')
-      str = str.dup if str.frozen?
-      @buffer = str.force_encoding(Encoding::BINARY)
-    end
-
-    # Emulate StringIO#read: slice first n bytes from the buffer.
-    #
-    # @param n [Integer] number of bytes to slice from the buffer
-    def read(n)
-      Buffer.new(@buffer.slice!(0, n))
-    end
-
-    # Emulate StringIO#getbyte: slice first byte from buffer.
-    def getbyte
-      read(1).ord
-    end
-
-    def slice!(*args)
-      Buffer.new(@buffer.slice!(*args))
-    end
-
-    def slice(*args)
-      Buffer.new(@buffer.slice(*args))
-    end
-
-    def force_encoding(*args)
-      @buffer = @buffer.force_encoding(*args)
-    end
-
-    def ==(other)
-      @buffer == other
-    end
-
-    def +(other)
-      @buffer += other
-    end
-
-    # Emulate String#getbyte: return nth byte from buffer.
-    def readbyte(n)
-      @buffer[n].ord
-    end
-
-    # Slice unsigned 32-bit integer from buffer.
-    # @return [Integer]
-    def read_uint32
-      read(4).unpack1(UINT32)
-    end
-
-    # Ensures that data that is added is binary encoded as well,
-    # otherwise this could lead to the Buffer instance changing its encoding.
-    %i[<< prepend].each do |mutating_method|
-      define_method(mutating_method) do |string|
-        string = string.dup if string.frozen?
-        @buffer.send mutating_method, string.force_encoding(Encoding::BINARY)
-
-        self
-      end
-    end
-  end
-end