httpkit 0.6.0.pre.3

data/spec/unit/response_spec.rb

@@ -0,0 +1,108 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe HTTPkit::Response do
+  describe '#initialize' do
+    subject do
+      HTTPkit::Response.new(200, { 'Key' => 'value' }, 'hello').freeze
+    end
+
+    its(:status) { should be(200) }
+    its(:headers) { should eq('Key' => 'value') }
+
+    specify { expect(subject.body.read).to eq('hello') }
+
+    its(:status_name) { should eq('OK') }
+
+    describe 'defaults' do
+      subject { HTTPkit::Response.new(200) }
+
+      its(:headers) { should eq({}) }
+      its(:http_version) { should eq(1.1) }
+
+      specify { expect(subject.body.read).to be_empty }
+    end
+
+    describe 'unknown status' do
+      subject { HTTPkit::Response.new(-1) }
+
+      its(:status) { should be(-1) }
+      its(:status_name) { should eq('Unknown Status') }
+    end
+  end
+
+  describe '#http_version=' do
+    subject { HTTPkit::Response.new(200) }
+
+    before { subject.http_version = 1.0 }
+
+    its(:http_version) { should eq(1.0) }
+  end
+
+  describe 'with 1xx status' do
+    subject { HTTPkit::Response.new(100) }
+
+    its(:status_class) { should be(1) }
+
+    it { should     be_informational }
+    it { should_not be_successful }
+    it { should_not be_redirection }
+    it { should_not be_client_error }
+    it { should_not be_server_error }
+  end
+
+  describe 'with 199 status' do
+    subject { HTTPkit::Response.new(199) }
+
+    its(:status_class) { should be(1) }
+  end
+
+  describe 'with 2xx status' do
+    subject { HTTPkit::Response.new(200) }
+
+    its(:status_class) { should be(2) }
+
+    it { should_not be_informational }
+    it { should     be_successful }
+    it { should_not be_redirection }
+    it { should_not be_client_error }
+    it { should_not be_server_error }
+  end
+
+  describe 'with 3xx status' do
+    subject { HTTPkit::Response.new(300) }
+
+    its(:status_class) { should be(3) }
+
+    it { should_not be_informational }
+    it { should_not be_successful }
+    it { should     be_redirection }
+    it { should_not be_client_error }
+    it { should_not be_server_error }
+  end
+
+  describe 'with 4xx status' do
+    subject { HTTPkit::Response.new(400) }
+
+    its(:status_class) { should be(4) }
+
+    it { should_not be_informational }
+    it { should_not be_successful }
+    it { should_not be_redirection }
+    it { should     be_client_error }
+    it { should_not be_server_error }
+  end
+
+  describe 'with 5xx status' do
+    subject { HTTPkit::Response.new(500) }
+
+    its(:status_class) { should be(5) }
+
+    it { should_not be_informational }
+    it { should_not be_successful }
+    it { should_not be_redirection }
+    it { should_not be_client_error }
+    it { should     be_server_error }
+  end
+end

data/spec/unit/server/keep_alive_spec.rb

@@ -0,0 +1,69 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe HTTPkit::Server::KeepAlive do
+  let(:config)     { double('config') }
+  let(:server)     { double('server') }
+  let(:connection) { double('connection') }
+
+  let(:object)  { described_class.new }
+  let(:request) do
+    double('request', http_version: http_version,
+                      headers: { 'Connection' => header })
+  end
+  let(:served)   { double('served', value: response) }
+  let(:response) { double('response', headers: { 'Connection' => header }) }
+
+  before { object.setup(config, server, connection) }
+
+  describe '#close_connection?' do
+    before { object.serve(request, served) }
+
+    let(:subject) { object.send(:close_connection?, request) }
+
+    describe 'with HTTP/1.0 request' do
+      let(:http_version) { 1.0 }
+
+      describe 'and no header' do
+        let(:header) { nil }
+
+        it { should be(true) }
+      end
+
+      describe 'and Connection: close' do
+        let(:header) { 'close' }
+
+        it { should be(true) }
+      end
+
+      describe 'and Connection: keep-alive' do
+        let(:header) { 'keep-alive' }
+
+        it { should be(false) }
+      end
+    end
+
+    describe 'with HTTP/1.1 request' do
+      let(:http_version) { 1.1 }
+
+      describe 'and no header' do
+        let(:header) { nil }
+
+        it { should be(false) }
+      end
+
+      describe 'and Connection: close' do
+        let(:header) { 'close' }
+
+        it { should be(true) }
+      end
+
+      describe 'and Connection: keep-alive' do
+        let(:header) { 'keep-alive' }
+
+        it { should be(false) }
+      end
+    end
+  end
+end

data/spec/unit/server_spec.rb

@@ -0,0 +1,128 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe HTTPkit::Server do
+  let(:server) { described_class.new(config, connection) }
+
+  let(:config) do
+    { address: localhost, port: random_port, handlers: [handler] }
+  end
+  let(:connection) do
+    double('connection', :'on_message=' => nil,
+                         closed:    double('closed', then: nil),
+                         serialize: nil,
+                         close: nil)
+  end
+  let(:handler) do
+    double('handler', setup: nil, respond: nil, finish: nil)
+  end
+
+  describe '.start' do
+    subject { described_class.start(config) }
+
+    it 'binds an EventMachine-backed server instance' do
+      expect(HTTPkit::Connection::EventMachine)
+        .to receive(:start_server).with(config, described_class)
+      subject
+    end
+  end
+
+  describe '#initialize' do
+    subject! { server }
+
+    its(:config) { should be(config) }
+
+    it 'sets up connection' do
+      expect(connection).to have_received(:on_message=)
+        .with(server.method(:serve))
+    end
+
+    it 'sets up handlers' do
+      expect(handler).to have_received(:setup).with(config, server, connection)
+    end
+  end
+
+  describe '#serve', reactor: true do
+    let(:request)  { open_request }
+    let(:response) { open_response }
+
+    before do
+      allow(server).to  receive(:respond)
+      allow(handler).to receive(:serve) { |_, served|
+        @served = served
+        @fiber = Fiber.current
+      }
+    end
+
+    subject! { server.serve(request) }
+
+    it 'sets up correlation' do
+      @served.fulfill(response)
+      tick
+      expect(server).to have_received(:respond).with(request, response)
+    end
+
+    it 'notifies the handlers' do
+      expect(handler).to    have_received(:serve)
+        .with(request, kind_of(HTTPkit::Promise))
+      expect(@fiber).not_to be(Fiber.current)
+    end
+  end
+
+  describe '#respond' do
+    let(:headers)  { {} }
+    let(:request)  { open_request }
+    let(:response) { open_response(200, headers) }
+
+    subject! { server.respond(request, response) }
+
+    it 'writes response to underlying connection' do
+      expect(connection).to have_received(:serialize).with(response)
+    end
+
+    it 'notifies the handlers' do
+      expect(handler).to have_received(:respond).with(request, response)
+    end
+
+    it 'sets Server and Date headers' do
+      expect(headers['Server']).to eq("httpkit/#{HTTPkit::VERSION}")
+      expect(headers['Date']).to eq(Time.now.httpdate)
+    end
+
+    describe 'with Server or Date header set to anything' do
+      let(:headers) { { 'Server' => nil, 'Date' => nil } }
+
+      it 'does not override' do
+        expect(headers['Server']).to be(nil)
+        expect(headers['Date']).to   be(nil)
+      end
+    end
+
+    describe 'wiring', reactor: true do
+      let(:request)  { closed_request }
+      let(:response) { open_response }
+
+      before do
+        allow(server).to receive(:finish)
+
+        response.close
+        tick
+      end
+
+      it 'wires up #finish' do
+        expect(server).to have_received(:finish).with(request)
+      end
+    end
+  end
+
+  describe '#finish' do
+    let(:request) { open_request }
+
+    subject! { server.finish(request) }
+
+    it 'notifies the handlers' do
+      expect(handler).to have_received(:finish).with(request)
+    end
+  end
+end

data/spec/unit/support/handler_manager_spec.rb

@@ -0,0 +1,21 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe HTTPkit::Support::HandlerManager do
+  let(:handler) { double('handler', message: nil) }
+  let(:manager) { described_class.new([handler]) }
+
+  describe '#notify' do
+    let(:args) { [double, double] }
+
+    subject! do
+      manager.notify(:message, *args)
+      manager.notify(:nope)
+    end
+
+    it 'notifies the handlers' do
+      expect(handler).to have_received(:message).with(*args)
+    end
+  end
+end

data/spec/unit/support/message_spec.rb

@@ -0,0 +1,115 @@
+# encoding: utf-8
+
+require 'spec_helper'
+
+describe HTTPkit::Support::Message do
+  let(:message) do
+    double('message', headers: { bar: '123' }, body: body)
+      .extend(described_class)
+  end
+
+  let(:body) do
+    double('body', closed: double('closed', pending?: pending,
+                                            sync:     double,
+                                            then:     nil,
+                                            fulfill:  nil,
+                                            reject:   nil))
+  end
+
+  let(:pending) { false }
+
+  describe '#closed?' do
+    subject { message.closed? }
+
+    it { should be(true) }
+
+    describe do
+      let(:pending) { true }
+
+      it { should be(false) }
+    end
+  end
+
+  describe '#closed!' do
+    subject { message.closed! }
+
+    it { should be(body.closed.sync) }
+  end
+
+  describe '#closed' do
+    subject { message.closed { throw :block } }
+
+    it 'forwards' do
+      expect(body.closed).to receive(:then) { |&block|
+        expect(block).to throw_symbol(:block)
+      }
+      subject
+    end
+  end
+
+  describe '#close' do
+    subject! { message.close }
+
+    it 'forwards' do
+      expect(body.closed).to have_received(:fulfill)
+    end
+  end
+
+  describe '#reject_closed' do
+    subject! { message.reject_closed(StandardError) }
+
+    it 'forwards' do
+      expect(body.closed).to have_received(:reject).with(StandardError)
+    end
+  end
+
+  describe '#add_extra_headers' do
+    subject! { message.add_extra_headers(foo: '456', bar: '789') }
+
+    it 'adds the headers that do not exist yet' do
+      expect(message.headers).to eq(foo: '456', bar: '123')
+    end
+  end
+
+  describe '.build' do
+    before do
+      allow(HTTPkit::Body).to receive(:new) { body }
+    end
+
+    describe 'given a parser holding a request' do
+      let(:parser) do
+        Struct.new(:http_method, :request_url, :headers, :http_version)
+          .new('GET', '/', { 'Key' => 'value' }, [1, 1])
+      end
+      let(:args) { [:get, '/', { 'Key' => 'value' }, body] }
+      let(:request) { double }
+
+      subject { HTTPkit::Support::Message.build(parser) }
+
+      it 'returns a Request object' do
+        expect(HTTPkit::Request)
+          .to receive(:new).with(*args).and_return(request)
+        expect(request).to receive(:http_version=).with(1.1)
+        expect(subject).to be(request)
+      end
+    end
+
+    describe 'given a parser holding a response' do
+      let(:parser) do
+        Struct.new(:http_method, :status_code, :headers, :http_version)
+          .new(nil, 200, { 'Key' => 'value' }, [1, 0])
+      end
+      let(:args) { [200, { 'Key' => 'value' }, body] }
+      let(:response) { double }
+
+      subject { HTTPkit::Support::Message.build(parser) }
+
+      it 'returns a Response object' do
+        expect(HTTPkit::Response)
+          .to receive(:new).with(*args).and_return(response)
+        expect(response).to receive(:http_version=).with(1.0)
+        expect(subject).to be(response)
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,190 @@
+--- !ruby/object:Gem::Specification
+name: httpkit
+version: !ruby/object:Gem::Version
+  version: 0.6.0.pre.3
+  prerelease: 6
+platform: ruby
+authors:
+- Lars Gierth
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-01-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: eventmachine
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: http_parser.rb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: promise.rb
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '0.6'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: HTTPkit is a Ruby toolkit for building HTTP clients and servers, as well
+  as compositions of them.
+email:
+- lars.gierth@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .travis.yml
+- .yardopts
+- Gemfile
+- Gemfile.devtools
+- Procfile
+- README.md
+- Rakefile
+- UNLICENSE
+- config/devtools.yml
+- config/flay.yml
+- config/flog.yml
+- config/mutant.yml
+- config/reek.yml
+- config/rubocop.yml
+- config/yardstick.yml
+- examples/echo_server.rb
+- examples/getting_started.rb
+- httpkit.gemspec
+- lib/httpkit.rb
+- lib/httpkit/body.rb
+- lib/httpkit/client.rb
+- lib/httpkit/client/keep_alive.rb
+- lib/httpkit/client/timeouts.rb
+- lib/httpkit/connection/eventmachine.rb
+- lib/httpkit/connection/status.rb
+- lib/httpkit/promise.rb
+- lib/httpkit/request.rb
+- lib/httpkit/response.rb
+- lib/httpkit/serializer.rb
+- lib/httpkit/serializer/encoding.rb
+- lib/httpkit/server.rb
+- lib/httpkit/server/keep_alive.rb
+- lib/httpkit/server/timeouts.rb
+- lib/httpkit/support/handler_manager.rb
+- lib/httpkit/support/message.rb
+- lib/httpkit/version.rb
+- spec/integration/error_handling_spec.rb
+- spec/integration/keep_alive_spec.rb
+- spec/integration/smoke_spec.rb
+- spec/integration/streaming_spec.rb
+- spec/integration/timeouts_spec.rb
+- spec/shared/integration/server_client_pair.rb
+- spec/spec_helper.rb
+- spec/support/handler.rb
+- spec/support/helper.rb
+- spec/unit/client_spec.rb
+- spec/unit/connection/eventmachine_spec.rb
+- spec/unit/connection/status_spec.rb
+- spec/unit/httpkit_spec.rb
+- spec/unit/promise_spec.rb
+- spec/unit/request_spec.rb
+- spec/unit/response_spec.rb
+- spec/unit/server/keep_alive_spec.rb
+- spec/unit/server_spec.rb
+- spec/unit/support/handler_manager_spec.rb
+- spec/unit/support/message_spec.rb
+homepage: https://github.com/lgierth/httpkit
+licenses:
+- Public Domain
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>'
+    - !ruby/object:Gem::Version
+      version: 1.3.1
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: The HTTP toolkit for Ruby
+test_files:
+- spec/integration/error_handling_spec.rb
+- spec/integration/keep_alive_spec.rb
+- spec/integration/smoke_spec.rb
+- spec/integration/streaming_spec.rb
+- spec/integration/timeouts_spec.rb
+- spec/shared/integration/server_client_pair.rb
+- spec/spec_helper.rb
+- spec/support/handler.rb
+- spec/support/helper.rb
+- spec/unit/client_spec.rb
+- spec/unit/connection/eventmachine_spec.rb
+- spec/unit/connection/status_spec.rb
+- spec/unit/httpkit_spec.rb
+- spec/unit/promise_spec.rb
+- spec/unit/request_spec.rb
+- spec/unit/response_spec.rb
+- spec/unit/server/keep_alive_spec.rb
+- spec/unit/server_spec.rb
+- spec/unit/support/handler_manager_spec.rb
+- spec/unit/support/message_spec.rb
+has_rdoc: