llhttp 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: c367e8870364d3400220233c434081a75a6467ff864f50d1a24a83ee0abf90dd
+  data.tar.gz: 74628e99e4c978fcbaa6a37ba2b9bb3473cacaab0fd69ca1196384aa8781024a
+SHA512:
+  metadata.gz: c2e2249e81dee3cc6036debf2144f0ca64597a17dd66de4ceaa4b889860070bc09476bfa1a0f5a82b05bb9941d5719f8adcf28f01a2d665314e41860f49bed68
+  data.tar.gz: 06dccd9bb5b78bc7f62d06293d98fab34b325382ed0873b4702d9ef3fd04a73075e102358655c72474a0a1dc92eee20791e29895ce8c6c8a63b2bb9926cf5693

data/LICENSE

@@ -0,0 +1,22 @@
+This software is licensed under the MIT License.
+
+Copyright Bryan Powell, 2020.
+
+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/README.md

@@ -0,0 +1,37 @@
+# llhttp
+
+Ruby bindings for [llhttp](https://github.com/nodejs/llhttp).
+
+## Install
+
+```
+gem install llhttp
+```
+
+## Usage
+
+```ruby
+require "llhttp"
+
+# Define a delegate class for handling callbacks:
+#
+class Delegate < LLHttp::Delegate
+  def on_message_begin
+    ...
+  end
+end
+
+delegate = Delegate.new
+
+# Create a parser:
+#
+parser = LLHttp::Parser.new(delegate)
+
+# Parse a request:
+#
+parser << "GET / HTTP/1.1\r\n\r\n"
+
+# Reset the parser for the next request:
+#
+parser.finish
+```

data/ext/llhttp/extconf.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+require "mkmf"
+
+dir_config "llhttp_ext"
+
+create_makefile "llhttp_ext"

data/lib/llhttp.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module LLHttp
+  require_relative "llhttp/delegate"
+  require_relative "llhttp/error"
+  require_relative "llhttp/parser"
+  require_relative "llhttp/version"
+end

data/lib/llhttp/delegate.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module LLHttp
+  # Delegate for handling callbacks. Subclass this, implementing the necessary methods.
+  #
+  class Delegate
+    def on_message_begin
+    end
+
+    def on_url(url)
+    end
+
+    def on_status(status)
+    end
+
+    def on_header_field(field)
+    end
+
+    def on_header_value(value)
+    end
+
+    def on_headers_complete
+    end
+
+    def on_body(body)
+    end
+
+    def on_message_complete
+    end
+
+    def on_chunk_header
+    end
+
+    def on_chunk_complete
+    end
+  end
+end

data/lib/llhttp/error.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+module LLHttp
+  class Error < StandardError
+  end
+end

data/lib/llhttp/parser.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module LLHttp
+  # Wraps an llhttp context for parsing http requests and responses.
+  #
+  # = Finishing
+  #
+  # Call `LLHttp::Parser#finish` when processing is complete for the current request or response.
+  #
+  # = Introspection
+  #
+  # `LLHttp::Parser#keep_alive?` returns `true` if there might be any other messages following the last that was successfuly parsed.
+  #
+  class Parser
+    LLHTTP_TYPES = {both: 0, request: 1, response: 2}.freeze
+
+    attr_reader :type
+
+    def initialize(delegate, type: :both)
+      @type, @delegate = type.to_sym, delegate
+
+      llhttp_init(LLHTTP_TYPES.fetch(@type))
+    end
+  end
+end
+
+require_relative "llhttp_ext"

data/lib/llhttp/version.rb

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+module LLHttp
+  VERSION = "0.0.1"
+
+  def self.version
+    VERSION
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification
+name: llhttp
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Bryan Powell
+autorequire:
+bindir: bin
+cert_chain: []
+date: 2020-10-11 00:00:00.000000000 Z
+dependencies: []
+description: Ruby bindings for llhttp.
+email: bryan@bryanp.org
+executables: []
+extensions:
+- ext/llhttp/extconf.rb
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- ext/llhttp/extconf.rb
+- lib/llhttp.rb
+- lib/llhttp/delegate.rb
+- lib/llhttp/error.rb
+- lib/llhttp/llhttp_ext.bundle
+- lib/llhttp/parser.rb
+- lib/llhttp/version.rb
+homepage: https://metabahn.com/code/llhttp
+licenses:
+- MIT
+metadata: {}
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 2.5.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.1.2
+signing_key:
+specification_version: 4
+summary: Ruby bindings for llhttp.
+test_files: []