chase 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 72eefdf46b326be759f69345fb5234e1a873137c
+  data.tar.gz: a603c8ce78dba15cfe203aeb18b84cfc7c72a436
+SHA512:
+  metadata.gz: f3e270e13da9d72c0f22a7ae199499295455befd9b035c6ee3f625516a9942ea90262b9a7ee22cdc592a436167fad2bf4dafefe7acb7e5b3452a6e7a88b81b11
+  data.tar.gz: 92856fd255a979f89b91a664e651ab91d456c8263e0feac5858a823d118490b8c19ebd557e13daf24a0ae7eac7a3947e6531b1dbaf7cb19350c34940efcc08c1

data/.gitignore

@@ -0,0 +1,5 @@
+Gemfile.lock
+.DS_Store
+spec/examples.txt
+pkg
+.bundle

data/.rspec

@@ -0,0 +1,2 @@
+--color
+--require spec_helper

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'byebug'

data/chase.gemspec

@@ -0,0 +1,23 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'chase/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'chase'
+  spec.version       = Chase::VERSION
+  spec.licenses      = ['MIT']
+  spec.authors       = ['Joe Osburn']
+  spec.email         = ['joe@jnodev.com']
+
+  spec.summary       = 'Chase is an event machine http server'
+  spec.homepage      = 'https://github.com/joeosburn/chase'
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ['lib']
+  spec.test_files = Dir['spec/**/*']
+
+  spec.add_dependency 'eventmachine', '~> 1.2', '>= 1.2.0'
+  spec.add_dependency 'http-parser-lite', '~> 0.6.0'
+
+  spec.add_development_dependency 'rspec', '~> 3.5', '>= 3.5.0'
+end

data/lib/chase/events.rb

@@ -0,0 +1,18 @@
+module Chase
+  # Basic events emitter
+  module Events
+    def on(event, &block)
+      __events[event] << block
+    end
+
+    def emit(event, *args)
+      __events[event].each { |cb| cb.call(*args) }
+    end
+
+    private
+
+    def __events
+      @__events ||= Hash.new { |hash, key| hash[key] = [] }
+    end
+  end
+end

data/lib/chase/http_parser.rb

@@ -0,0 +1,56 @@
+require 'http-parser-lite'
+
+module Chase
+  # Handle parsing of incoming http requests
+  module HttpParser
+    VALID_METHODS = %w(GET POST PUT DELETE PATCH HEAD OPTIONS).freeze
+    MAPPED_HEADERS = { 'cookie' => 'HTTP_COOKIE', 'if-none-match' => 'IF_NONE_MATCH',
+                       'content-type' => 'CONTENT_TYPE', 'content-length' => 'CONTENT_LENGTH' }.freeze
+
+    def http_parser
+      @parser ||= HTTP::Parser.new.tap do |parser|
+        parser.on_headers_complete { @current_header = nil }
+
+        parser.on_url do |url|
+          raise HTTP::Parser::Error, 'Invalid method' unless VALID_METHODS.include?(http_method)
+
+          set_env('HTTP_METHOD', http_method)
+          set_env('REQUEST_URI', url)
+          matches = url.match(/^(([^:\/?#]+):)?(\/\/([^\/?#]*))?([^?#]*)(\?([^#]*))?(#(.*))?/)
+          matches ||= Hash.new('')
+          set_env('PROTOCOL', matches[2])
+          set_env('PATH_INFO', matches[5])
+          set_env('QUERY_STRING', matches[7])
+        end
+
+        parser.on_header_field { |name| @current_header = name }
+
+        parser.on_header_value do |value|
+          if key = MAPPED_HEADERS[@current_header.downcase]
+            set_env(key, value)
+          else
+            request.headers[@current_header] = value
+          end
+        end
+
+        parser.on_body { |body| set_env('POST_CONTENT', body) }
+
+        # parser.on_message_begin do
+        #   puts "message begin"
+        # end
+        #
+        # parser.on_message_complete do
+        #   puts "message complete"
+        # end
+      end
+    end
+
+    def http_method
+      http_parser.http_method
+    end
+
+    def set_env(key, value)
+      request.env[key] = value
+    end
+  end
+end

data/lib/chase/request.rb

@@ -0,0 +1,16 @@
+module Chase
+  # HTTP Request Class
+  class Request
+    include Events
+
+    attr_reader :env
+
+    def initialize()
+      @env = {}
+    end
+
+    def headers
+      @headers ||= {}
+    end
+  end
+end

data/lib/chase/response.rb

@@ -0,0 +1,88 @@
+module Chase
+  # HTTP Response Class
+  class Response
+    include Events
+
+    STATUS_CODES = {
+      100 => '100 Continue',
+      101 => '101 Switching Protocols',
+      200 => '200 OK',
+      201 => '201 Created',
+      202 => '202 Accepted',
+      203 => '203 Non-Authoritative Information',
+      204 => '204 No Content',
+      205 => '205 Reset Content',
+      206 => '206 Partial Content',
+      300 => '300 Multiple Choices',
+      301 => '301 Moved Permanently',
+      302 => '302 Found',
+      303 => '303 See Other',
+      304 => '304 Not Modified',
+      305 => '305 Use Proxy',
+      307 => '307 Temporary Redirect',
+      400 => '400 Bad Request',
+      401 => '401 Unauthorized',
+      402 => '402 Payment Required',
+      403 => '403 Forbidden',
+      404 => '404 Not Found',
+      405 => '405 Method Not Allowed',
+      406 => '406 Not Acceptable',
+      407 => '407 Proxy Authentication Required',
+      408 => '408 Request Timeout',
+      409 => '409 Conflict',
+      410 => '410 Gone',
+      411 => '411 Length Required',
+      412 => '412 Precondition Failed',
+      413 => '413 Request Entity Too Large',
+      414 => '414 Request-URI Too Long',
+      415 => '415 Unsupported Media Type',
+      416 => '416 Requested Range Not Satisfiable',
+      417 => '417 Expectation Failed',
+      500 => '500 Internal Server Error',
+      501 => '501 Not Implemented',
+      502 => '502 Bad Gateway',
+      503 => '503 Service Unavailable',
+      504 => '504 Gateway Timeout',
+      505 => '505 HTTP Version Not Supported'
+    }.freeze
+
+    attr_accessor :status
+    attr_reader :content, :headers
+
+    def initialize
+      @content = ''
+      @headers = {}
+
+      on(:flushed) { @flushed = true }
+    end
+
+    def content=(value)
+      @content = value.to_s
+    end
+
+    def flush
+      return if flushed?
+
+      send_headers
+      send("\r\n")
+      send(content)
+
+      emit(:flushed)
+    end
+
+    def flushed?
+      @flushed ||= false
+    end
+
+    private
+
+    def send(data)
+      emit(:send, data)
+    end
+
+    def send_headers
+      send "HTTP/1.1 #{STATUS_CODES[status] || '200 OK'}\r\n"
+      headers.each { |key, value| send("#{key}: #{value}\r\n") }
+    end
+  end
+end

data/lib/chase/server.rb

@@ -0,0 +1,42 @@
+require 'eventmachine'
+
+module Chase
+  # General server error
+  class ServerError < StandardError; end
+
+  # HTTP Server Module
+  module Server
+    include HttpParser
+
+    def receive_data(data)
+      parse_request data
+      prepare_response
+      handle
+    rescue ServerError, HTTP::Parser::Error
+      send_error('400 Bad Request')
+    end
+
+    def request
+      @request ||= Request.new
+    end
+
+    def response
+      @response ||= Response.new
+    end
+
+    def send_error(status_code)
+      send_data "HTTP/1.1 #{status_code}\r\nConnection: close\r\nContent-Type: text/plain\r\n"
+      close_connection_after_writing
+    end
+
+    def parse_request(data)
+      http_parser << data
+      raise ServerError unless request.env['HTTP_METHOD']
+    end
+
+    def prepare_response
+      response.on(:flushed) { close_connection_after_writing }
+      response.on(:send) { |data| send_data(data) }
+    end
+  end
+end

data/lib/chase/version.rb

@@ -0,0 +1,3 @@
+module Chase
+  VERSION = '0.0.1'.freeze
+end

data/lib/chase.rb

@@ -0,0 +1,5 @@
+require 'chase/events'
+require 'chase/http_parser'
+require 'chase/server'
+require 'chase/request'
+require 'chase/response'

data/spec/chase/events_spec.rb

@@ -0,0 +1,33 @@
+require 'spec_helper'
+
+RSpec.describe Chase::Events do
+  let(:example_class) { Class.new { include Chase::Events } }
+  subject { example_class.new }
+  let(:dummy) { double }
+
+  describe 'emitting events' do
+    before { allow(dummy).to receive(:call) }
+
+    it 'calls the block on emit' do
+      subject.on(:event) { dummy.call }
+      expect(dummy).to receive(:call)
+      subject.emit(:event)
+    end
+
+    it 'passes arguments to the block' do
+      subject.on(:bad_event) { dummy.call(:x, 1) }
+      subject.on(:good_event) { |a, b| dummy.call(a, b) }
+      expect(dummy).to receive(:call).with(3, :y)
+      expect(dummy).to_not receive(:call).with(:x, 1)
+      subject.emit(:good_event, 3, :y)
+    end
+
+    it 'calls multiple event listeners in the order they were added' do
+      subject.on(:event) { dummy.call(1) }
+      subject.on(:event) { dummy.call(2) }
+      expect(dummy).to receive(:call).with(1).exactly(1).times.ordered
+      expect(dummy).to receive(:call).with(2).exactly(1).times.ordered
+      subject.emit(:event)
+    end
+  end
+end

data/spec/chase/response_spec.rb

@@ -0,0 +1,43 @@
+require 'spec_helper'
+
+RSpec.describe Chase::Response do
+  describe '#flush' do
+    before do
+      subject.headers['Content-Type'] = 'text/plain'
+      subject.headers['Content-Length'] = 40
+      subject.content = 'Some content'
+    end
+
+    it 'flushes the response' do
+      subject.flush
+      expect(subject).to be_flushed
+    end
+
+    it 'emits the headers and content' do
+      output = ''
+      subject.on(:send) { |data| output += data }
+
+      subject.flush
+
+      expect(output).to eq(<<~eos.strip)
+        HTTP/1.1 200 OK\r
+        Content-Type: text/plain\r
+        Content-Length: 40\r
+        \r
+        Some content
+      eos
+    end
+
+    context 'has been run' do
+      before { subject.flush }
+
+      it 'does not emit content again' do
+        output = ''
+        subject.on(:send) { |data| output += data }
+        
+        subject.flush
+        expect(output).to eq('')
+      end
+    end
+  end
+end

data/spec/chase/server_spec.rb

@@ -0,0 +1,67 @@
+require 'spec_helper'
+
+RSpec.describe Chase::Server do
+  let(:included_class) do
+    Class.new do
+      include Chase::Server
+
+      def handle; end
+      def send_data(_data); end
+      def close_connection_after_writing; end
+    end
+  end
+  subject { included_class.new }
+
+  describe '#receive_data' do
+    context 'invalid request' do
+      it 'sends a 400 error response' do
+        expect(subject).to receive(:send_data).with(/400 Bad Request/).ordered
+        expect(subject).to receive(:close_connection_after_writing).ordered
+        subject.receive_data('BAD REQUEST')
+      end
+    end
+
+    context 'valid request' do
+      it 'calls #handle' do
+        expect(subject).to receive(:handle)
+        subject.receive_data('GET / HTTP/1.1')
+      end
+
+      it 'creates a request object' do
+        subject.receive_data('GET / HTTP/1.1')
+        expect(subject.request).to be_a(Chase::Request)
+      end
+
+      it 'creates a response object' do
+        subject.receive_data('GET / HTTP/1.1')
+        expect(subject.response).to be_a(Chase::Response)
+      end
+
+      describe 'the request object' do
+        it 'sets env and header variables' do
+          subject.receive_data(<<~eos)
+            PATCH https://www.google.com/chase/request?key=value&other=123 HTTP/1.1
+            Content-Type: text/plain
+            Content-Length: 45
+            Cookie: cookie-content
+            If-None-Match: *
+            Random-Header: Value
+
+            Some-Post-Content=Value&Some-Other=abc2
+          eos
+          expect(subject.request.env['HTTP_METHOD']).to eq('PATCH')
+          expect(subject.request.env['REQUEST_URI']).to eq('https://www.google.com/chase/request?key=value&other=123')
+          expect(subject.request.env['PROTOCOL']).to eq('https')
+          expect(subject.request.env['PATH_INFO']).to eq('/chase/request')
+          expect(subject.request.env['QUERY_STRING']).to eq('key=value&other=123')
+          expect(subject.request.env['CONTENT_TYPE']).to eq('text/plain')
+          expect(subject.request.env['CONTENT_LENGTH']).to eq('45')
+          expect(subject.request.env['HTTP_COOKIE']).to eq('cookie-content')
+          expect(subject.request.env['IF_NONE_MATCH']).to eq('*')
+          expect(subject.request.env['POST_CONTENT']).to eq("Some-Post-Content=Value&Some-Other=abc2\n")
+          expect(subject.request.headers['Random-Header']).to eq('Value')
+        end
+      end
+    end
+  end
+end

data/spec/examples.txt

@@ -0,0 +1,13 @@
+example_id                             | status | run_time        |
+-------------------------------------- | ------ | --------------- |
+./spec/chase/events_spec.rb[1:1:1]     | passed | 0.00025 seconds |
+./spec/chase/events_spec.rb[1:1:2]     | passed | 0.00047 seconds |
+./spec/chase/events_spec.rb[1:1:3]     | passed | 0.0048 seconds  |
+./spec/chase/response_spec.rb[1:1:1]   | passed | 0.00131 seconds |
+./spec/chase/response_spec.rb[1:1:2]   | passed | 0.00041 seconds |
+./spec/chase/response_spec.rb[1:1:3:1] | passed | 0.0001 seconds  |
+./spec/chase/server_spec.rb[1:1:1:1]   | passed | 0.00046 seconds |
+./spec/chase/server_spec.rb[1:1:2:1]   | passed | 0.00042 seconds |
+./spec/chase/server_spec.rb[1:1:2:2]   | passed | 0.00045 seconds |
+./spec/chase/server_spec.rb[1:1:2:3]   | passed | 0.00019 seconds |
+./spec/chase/server_spec.rb[1:1:2:4:1] | passed | 0.00017 seconds |

data/spec/spec_helper.rb

@@ -0,0 +1,103 @@
+require 'chase'
+
+# This file was generated by the `rspec --init` command. Conventionally, all
+# specs live under a `spec` directory, which RSpec adds to the `$LOAD_PATH`.
+# The generated `.rspec` file contains `--require spec_helper` which will cause
+# this file to always be loaded, without a need to explicitly require it in any
+# files.
+#
+# Given that it is always loaded, you are encouraged to keep this file as
+# light-weight as possible. Requiring heavyweight dependencies from this file
+# will add to the boot time of your test suite on EVERY test run, even for an
+# individual file that may not need all of that loaded. Instead, consider making
+# a separate helper file that requires the additional dependencies and performs
+# the additional setup, and require it from the spec files that actually need
+# it.
+#
+# The `.rspec` file also contains a few flags that are not defaults but that
+# users commonly want.
+#
+# See http://rubydoc.info/gems/rspec-core/RSpec/Core/Configuration
+RSpec.configure do |config|
+  # rspec-expectations config goes here. You can use an alternate
+  # assertion/expectation library such as wrong or the stdlib/minitest
+  # assertions if you prefer.
+  config.expect_with :rspec do |expectations|
+    # This option will default to `true` in RSpec 4. It makes the `description`
+    # and `failure_message` of custom matchers include text for helper methods
+    # defined using `chain`, e.g.:
+    #     be_bigger_than(2).and_smaller_than(4).description
+    #     # => "be bigger than 2 and smaller than 4"
+    # ...rather than:
+    #     # => "be bigger than 2"
+    expectations.include_chain_clauses_in_custom_matcher_descriptions = true
+  end
+
+  # rspec-mocks config goes here. You can use an alternate test double
+  # library (such as bogus or mocha) by changing the `mock_with` option here.
+  config.mock_with :rspec do |mocks|
+    # Prevents you from mocking or stubbing a method that does not exist on
+    # a real object. This is generally recommended, and will default to
+    # `true` in RSpec 4.
+    mocks.verify_partial_doubles = true
+  end
+
+  # This option will default to `:apply_to_host_groups` in RSpec 4 (and will
+  # have no way to turn it off -- the option exists only for backwards
+  # compatibility in RSpec 3). It causes shared context metadata to be
+  # inherited by the metadata hash of host groups and examples, rather than
+  # triggering implicit auto-inclusion in groups with matching metadata.
+  config.shared_context_metadata_behavior = :apply_to_host_groups
+
+# The settings below are suggested to provide a good initial experience
+# with RSpec, but feel free to customize to your heart's content.
+  # This allows you to limit a spec run to individual examples or groups
+  # you care about by tagging them with `:focus` metadata. When nothing
+  # is tagged with `:focus`, all examples get run. RSpec also provides
+  # aliases for `it`, `describe`, and `context` that include `:focus`
+  # metadata: `fit`, `fdescribe` and `fcontext`, respectively.
+  config.filter_run_when_matching :focus
+
+  # Allows RSpec to persist some state between runs in order to support
+  # the `--only-failures` and `--next-failure` CLI options. We recommend
+  # you configure your source control system to ignore this file.
+  config.example_status_persistence_file_path = "spec/examples.txt"
+
+  # Limits the available syntax to the non-monkey patched syntax that is
+  # recommended. For more details, see:
+  #   - http://rspec.info/blog/2012/06/rspecs-new-expectation-syntax/
+  #   - http://www.teaisaweso.me/blog/2013/05/27/rspecs-new-message-expectation-syntax/
+  #   - http://rspec.info/blog/2014/05/notable-changes-in-rspec-3/#zero-monkey-patching-mode
+  config.disable_monkey_patching!
+
+  # This setting enables warnings. It's recommended, but in some cases may
+  # be too noisy due to issues in dependencies.
+  config.warnings = true
+
+  # Many RSpec users commonly either run the entire suite or an individual
+  # file, and it's useful to allow more verbose output when running an
+  # individual spec file.
+  if config.files_to_run.one?
+    # Use the documentation formatter for detailed output,
+    # unless a formatter has already been configured
+    # (e.g. via a command-line flag).
+    config.default_formatter = 'doc'
+  end
+
+  # Print the 10 slowest examples and example groups at the
+  # end of the spec run, to help surface which specs are running
+  # particularly slow.
+  config.profile_examples = 10
+
+  # Run specs in random order to surface order dependencies. If you find an
+  # order dependency and want to debug it, you can fix the order by providing
+  # the seed, which is printed after each run.
+  #     --seed 1234
+  config.order = :random
+
+  # Seed global randomization in this process using the `--seed` CLI option.
+  # Setting this allows you to use `--seed` to deterministically reproduce
+  # test failures related to randomization by passing the same `--seed` value
+  # as the one that triggered the failure.
+  Kernel.srand config.seed
+end

metadata

@@ -0,0 +1,119 @@
+--- !ruby/object:Gem::Specification
+name: chase
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Joe Osburn
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2017-03-17 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.0
+- !ruby/object:Gem::Dependency
+  name: http-parser-lite
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.6.0
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.5'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 3.5.0
+description: 
+email:
+- joe@jnodev.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".gitignore"
+- ".rspec"
+- Gemfile
+- chase.gemspec
+- lib/chase.rb
+- lib/chase/events.rb
+- lib/chase/http_parser.rb
+- lib/chase/request.rb
+- lib/chase/response.rb
+- lib/chase/server.rb
+- lib/chase/version.rb
+- spec/chase/events_spec.rb
+- spec/chase/response_spec.rb
+- spec/chase/server_spec.rb
+- spec/examples.txt
+- spec/spec_helper.rb
+homepage: https://github.com/joeosburn/chase
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.6.8
+signing_key: 
+specification_version: 4
+summary: Chase is an event machine http server
+test_files:
+- spec/chase/events_spec.rb
+- spec/chase/response_spec.rb
+- spec/chase/server_spec.rb
+- spec/examples.txt
+- spec/spec_helper.rb