httpkit 0.6.0.pre.3

data/.gitignore

@@ -0,0 +1,7 @@
+*.gem
+.bundle/
+coverage/
+doc/
+.yardoc/
+measurements/
+Gemfile.lock

data/.rspec

@@ -0,0 +1,3 @@
+--order rand
+--color
+--format Fuubar

data/.travis.yml

@@ -0,0 +1,15 @@
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - jruby
+  - rbx
+  - ruby-head
+  - jruby-head
+matrix:
+  allow_failures:
+    - rvm: jruby
+    - rvm: ruby-head
+    - rvm: jruby-head
+  fast_finish: true
+script: bundle exec rake -t ci:metrics spec:integration

data/.yardopts

@@ -0,0 +1,2 @@
+- UNLICENSE
+- examples/*

data/Gemfile

@@ -0,0 +1,19 @@
+# encoding: utf-8
+
+source 'https://rubygems.org'
+
+gemspec
+
+gem 'devtools', git: 'https://github.com/rom-rb/devtools.git'
+gem 'fuubar',   git: 'https://github.com/lgierth/fuubar.git',
+                ref: 'static-percentage'
+gem 'awesome_print'
+
+platform :rbx do
+  gem 'rubysl-fiber', '~> 2.0'
+  gem 'rubysl-weakref', '~> 2.0'
+  gem 'rubinius', '~> 2.0'
+end
+
+# Added by devtools
+eval_gemfile 'Gemfile.devtools'

data/Gemfile.devtools

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+group :development do
+  gem 'rake',  '~> 10.1.0'
+  gem 'rspec', '~> 2.14.1'
+  gem 'yard',  '~> 0.8.7'
+
+  platform :rbx do
+    gem 'rubysl-singleton', '~> 2.0.0'
+  end
+end
+
+group :yard do
+  gem 'kramdown', '~> 1.2.0'
+end
+
+group :guard do
+  gem 'guard',         '~> 2.2.4'
+  gem 'guard-bundler', '~> 2.0.0'
+  gem 'guard-rspec',   '~> 4.0.4'
+  gem 'guard-rubocop', '~> 1.0.0'
+
+  # file system change event handling
+  gem 'listen',     '~> 2.2.0'
+  gem 'rb-fchange', '~> 0.0.6', require: false
+  gem 'rb-fsevent', '~> 0.9.3', require: false
+  gem 'rb-inotify', '~> 0.9.0', require: false
+
+  # notification handling
+  gem 'libnotify',               '~> 0.8.0', require: false
+  gem 'rb-notifu',               '~> 0.0.4', require: false
+  gem 'terminal-notifier-guard', '~> 1.5.3', require: false
+end
+
+group :metrics do
+  gem 'coveralls', '~> 0.7.0'
+  gem 'flay',      '~> 2.4.0'
+  gem 'flog',      '~> 4.2.0'
+  gem 'reek',      '~> 1.3.2'
+  gem 'rubocop',   '~> 0.15.0'
+  gem 'simplecov', '~> 0.8.2'
+  gem 'yardstick', '~> 0.9.7', git: 'https://github.com/dkubb/yardstick.git'
+
+  platforms :ruby_19, :ruby_20 do
+    gem 'mutant',          '~> 0.3.0.rc3', git: 'https://github.com/mbj/mutant.git'
+    gem 'unparser',        '~> 0.1.5',     git: 'https://github.com/mbj/unparser.git'
+    gem 'yard-spellcheck', '~> 0.1.5'
+  end
+
+  platform :rbx do
+    gem 'json',               '~> 1.8.1'
+    gem 'racc',               '~> 1.4.10'
+    gem 'rubysl-logger',      '~> 2.0.0'
+    gem 'rubysl-open-uri',    '~> 2.0.0'
+    gem 'rubysl-prettyprint', '~> 2.0.2'
+  end
+end
+
+group :benchmarks do
+  gem 'rbench', '~> 0.2.3'
+end
+
+platform :jruby do
+  group :jruby do
+    gem 'jruby-openssl', '~> 0.8.5'
+  end
+end

data/Procfile

@@ -0,0 +1 @@
+web: env PORT=$PORT ADDRESS=0.0.0.0 bundle exec ruby examples/echo_server.rb

data/README.md

@@ -0,0 +1,66 @@
+# The HTTP toolkit for Ruby [![Build Status](https://travis-ci.org/lgierth/httpkit.png?branch=master)](https://travis-ci.org/lgierth/httpkit) [![Code Climate](https://codeclimate.com/github/lgierth/httpkit.png)](https://codeclimate.com/github/lgierth/httpkit) [![Coverage Status](https://coveralls.io/repos/lgierth/httpkit/badge.png?branch=master)](https://coveralls.io/r/lgierth/httpkit?branch=master)
+
+HTTPkit is a Ruby toolkit for building HTTP clients and servers,
+as well as compositions of them.
+
+- \#1 feature: readable, high-quality, extendable code with 66.81% mutation coverage (wip)
+- \#2 feature: sophisticated request and response streaming
+- \#3 feature: compatible with Rack, Faraday, and Webmachine for Ruby (todo)
+- \#4 feature: concurrenct or non-concurrent
+  - Non-concurrent using one-off EventMachine reactor (clients only)
+  - Evented using EventMachine
+  - Synchronously evented using EventMachine and Fibers
+  - Threaded using Celluloid (todo)
+
+*Note:* The `master` branch contains the latest development effort. Look at the
+`0.5.x` branch for stable, but very old releases. HTTPkit used to be called
+Hatetepe.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'httpkit'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install httpkit
+
+## Usage
+
+Code examples
+
+- [Getting started ](http://rubydoc.info/github/lgierth/httpkit/master/file/examples/getting_started.rb)
+- [HTTP echo server](http://rubydoc.info/github/lgierth/httpkit/master/file/examples/echo_server.rb)
+
+API Reference
+
+- [HTTPkit::Client    ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Client)
+- [HTTPkit::Server    ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Server)
+- [HTTPkit::Response  ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Request)
+- [HTTPkit::Request   ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Response)
+- [HTTPkit::Body      ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Body)
+- [HTTPkit::Promise   ](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Promise)
+- [HTTPkit::Serializer](http://rubydoc.info/github/lgierth/httpkit/master/HTTPkit/Serializer)
+
+## To do
+
+Here: https://trello.com/b/OoxEq1ze/httpkit
+
+## License
+
+HTTPkit is free and unencumbered public domain software. For more
+information, see [unlicense.org](http://unlicense.org/) or the accompanying
+UNLICENSE file.
+
+## Contributing
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request

data/Rakefile

@@ -0,0 +1,5 @@
+task :default => :spec
+
+# Added by devtools
+require 'devtools'
+Devtools.init_rake_tasks

data/UNLICENSE

@@ -0,0 +1,24 @@
+This is free and unencumbered software released into the public domain.
+
+Anyone is free to copy, modify, publish, use, compile, sell, or
+distribute this software, either in source code form or as a compiled
+binary, for any purpose, commercial or non-commercial, and by any
+means.
+
+In jurisdictions that recognize copyright laws, the author or authors
+of this software dedicate any and all copyright interest in the
+software to the public domain. We make this dedication for the benefit
+of the public at large and to the detriment of our heirs and
+successors. We intend this dedication to be an overt act of
+relinquishment in perpetuity of all present and future rights to this
+software under copyright law.
+
+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 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.
+
+For more information, please refer to <http://unlicense.org/>

data/config/devtools.yml

@@ -0,0 +1,2 @@
+---
+unit_test_timeout: 0.0

data/config/flay.yml

@@ -0,0 +1,3 @@
+---
+threshold: 8
+total_score: 181

data/config/flog.yml

@@ -0,0 +1,2 @@
+---
+threshold: 10.0

data/config/mutant.yml

@@ -0,0 +1,3 @@
+---
+name: httpkit
+namespace: HTTPkit

data/config/reek.yml

@@ -0,0 +1,114 @@
+---
+Attribute:
+  enabled: false
+  exclude: []
+BooleanParameter:
+  enabled: true
+  exclude: []
+ClassVariable:
+  enabled: true
+  exclude: []
+ControlParameter:
+  enabled: true
+  exclude:
+  - "HTTPkit::Connection::EventMachine#close"
+  - "HTTPkit::Connection::EventMachine#unbind"
+DataClump:
+  enabled: true
+  exclude: []
+  max_copies: 2
+  min_clump_size: 2
+DuplicateMethodCall:
+  enabled: true
+  exclude: []
+  max_calls: 2
+  allow_calls: []
+FeatureEnvy:
+  enabled: false
+  exclude: []
+IrresponsibleModule:
+  enabled: false
+  exclude: []
+LongParameterList:
+  enabled: true
+  exclude: []
+  max_params: 2
+  overrides:
+    initialize:
+      max_params: 4
+    setup:
+      max_params: 3
+LongYieldList:
+  enabled: true
+  exclude: []
+  max_params: 2
+NestedIterators:
+  enabled: true
+  exclude: []
+  max_allowed_nesting: 2
+  ignore_iterators: []
+NilCheck:
+  enabled: true
+  exclude: []
+RepeatedConditional:
+  enabled: true
+  exclude: []
+  max_ifs: 2
+TooManyInstanceVariables:
+  enabled: true
+  exclude:
+  - HTTPkit::Connection::EventMachine
+  max_instance_variables: 4
+TooManyMethods:
+  enabled: true
+  exclude: []
+  max_methods: 11
+TooManyStatements:
+  enabled: true
+  exclude:
+  - each
+  max_statements: 5
+UncommunicativeMethodName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^[a-z]$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept: []
+UncommunicativeModuleName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  accept: []
+UncommunicativeParameterName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept:
+  - _
+UncommunicativeVariableName:
+  enabled: true
+  exclude: []
+  reject:
+  - !ruby/regexp /^.$/
+  - !ruby/regexp /[0-9]$/
+  - !ruby/regexp /[A-Z]/
+  accept:
+  - k
+  - v
+  - a
+  - e
+  - _
+UnusedParameters:
+  enabled: true
+  exclude: []
+UtilityFunction:
+  enabled: false
+  exclude: []
+  max_helper_calls: 0

data/config/rubocop.yml

@@ -0,0 +1,56 @@
+AllCops:
+  Includes:
+    - '**/*.rake'
+    - 'Gemfile'
+    - 'Gemfile.devtools'
+  Excludes:
+    - '**/vendor/**'
+    - '**/benchmarks/**'
+
+# Avoid parameter lists longer than five parameters.
+ParameterLists:
+  Max: 4
+  CountKeywordArgs: true
+
+# Avoid more than `Max` levels of nesting.
+BlockNesting:
+  Max: 3
+
+# Align with the style guide.
+CollectionMethods:
+  PreferredMethods:
+    collect:  'map'
+    inject:   'reduce'
+    find:     'detect'
+    find_all: 'select'
+
+AccessModifierIndentation:
+  EnforcedStyle: indent
+
+# Limit line length
+LineLength:
+  Max: 79
+
+# Disable documentation checking until a class needs to be documented once
+Documentation:
+  Enabled: false
+
+# Do not favor modifier if/unless usage when you have a single-line body
+IfUnlessModifier:
+  Enabled: false
+
+# Allow case equality operator (in limited use within the specs)
+CaseEquality:
+  Enabled: false
+
+# Constants do not always have to use SCREAMING_SNAKE_CASE
+ConstantName:
+  Enabled: false
+
+# Not all trivial readers/writers can be defined with attr_* methods
+TrivialAccessors:
+  Enabled: false
+
+SignalException:
+  # Valid values are: semantic, only_raise and only_fail
+  EnforcedStyle: only_raise

data/config/yardstick.yml

@@ -0,0 +1,2 @@
+---
+threshold: 52.5

data/examples/echo_server.rb

@@ -0,0 +1,36 @@
+# encoding: utf-8
+
+require 'httpkit'
+
+class EchoServer
+  def serve(request, served)
+    response = streaming_response
+    served.fulfill(response)
+
+    serialize(request, response)
+    request.closed { response.close }
+  end
+
+  private
+
+  def streaming_response
+    HTTPkit::Response.new(200, { 'Content-Type' => 'text/plain' },
+                          HTTPkit::Body.new)
+  end
+
+  def serialize(request, response)
+    writer     = response.body.closed.method(:progress)
+    serializer = HTTPkit::Serializer.new(request, writer)
+    serializer.serialize
+  end
+end
+
+HTTPkit.start do
+  HTTPkit::Server.start(address:  ENV.fetch('ADDRESS', '127.0.0.1'),
+                        port:     ENV.fetch('PORT', 3000).to_i,
+                        handlers: [HTTPkit::Server::KeepAlive.new,
+                                   EchoServer.new])
+
+  Signal.trap(:INT)  { HTTPkit.stop }
+  Signal.trap(:TERM) { HTTPkit.stop }
+end

data/examples/getting_started.rb

@@ -0,0 +1,34 @@
+# encoding: utf-8
+
+require 'httpkit'
+
+class HelloServer
+  def serve(request, served)
+    p request.http_method # => :get
+    p request.uri         # => "/"
+    p request.headers     # => {"Host"=>"127.0.0.1:3000",
+                          #     "Content-Length"=>"0"}
+    p request.body.to_s   # => ""
+
+    served.fulfill(response)
+  end
+
+  def response
+    HTTPkit::Response.new(200, { 'Content-Type' => 'text/plain' }, 'hello')
+  end
+end
+
+HTTPkit.run do
+  HTTPkit::Server.start(address:  '127.0.0.1', port: 3000,
+                        handlers: [HelloServer.new])
+
+  client = HTTPkit::Client.start(address: '127.0.0.1', port: 3000)
+
+  response = client.request(:get, '/')
+
+  p response.status      # => 200
+  p response.status_name # => "OK"
+  p response.headers     # => {"Content-Type"=>"text/plain",
+                         #     "Content-Length"=>"5"}
+  p response.body.to_s   # => "hello"
+end

data/httpkit.gemspec

@@ -0,0 +1,27 @@
+# encoding: utf-8
+
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'httpkit/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "httpkit"
+  spec.version       = HTTPkit::VERSION
+  spec.authors       = ["Lars Gierth"]
+  spec.email         = ["lars.gierth@gmail.com"]
+  spec.summary       = %q{The HTTP toolkit for Ruby}
+  spec.description   = %q{HTTPkit is a Ruby toolkit for building HTTP clients and servers, as well as compositions of them.}
+  spec.homepage      = "https://github.com/lgierth/httpkit"
+  spec.license       = "Public Domain"
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^spec/})
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "eventmachine"
+  spec.add_dependency "http_parser.rb"
+  spec.add_dependency "promise.rb", "~> 0.6"
+
+  spec.add_development_dependency "rspec"
+end

data/lib/httpkit/body.rb

@@ -0,0 +1,67 @@
+# encoding: utf-8
+
+module HTTPkit
+  class Body
+    def self.build(arg)
+      if arg.is_a?(Body)
+        arg
+      else
+        body = new(arg.to_s)
+        body.closed.fulfill
+        body
+      end
+    end
+
+    attr_reader :closed
+
+    # TODO: eliminate string param
+    def initialize(string = '')
+      @io = StringIO.new(string)
+
+      @closed = Promise.new
+      closed.on_progress { |str| @io.write(str) }
+    end
+
+    # don't optimize the sync call, we don't wanna search in @io.string
+    # because search time increases with its size.
+    def gets(*args)
+      closed.sync
+      @io.gets(*args)
+    end
+
+    def read(length = nil, buffer = nil)
+      closed.sync unless optimized_read?(length)
+      @io.read(length, buffer)
+    end
+
+    def rewind
+      closed.sync
+      @io.rewind
+    end
+
+    def each(&block)
+      yield_string(&block)
+      closed.on_progress(&block)
+      closed.sync
+    end
+
+    def to_s
+      closed.sync
+      @io.string
+    end
+
+    def string
+      @io.string
+    end
+
+    private
+
+    def optimized_read?(length)
+      length && length < (@io.length - pos)
+    end
+
+    def yield_string(&block)
+      block.call(@io.string) unless @io.string.empty?
+    end
+  end
+end

data/lib/httpkit/client/keep_alive.rb

@@ -0,0 +1,10 @@
+# encoding: utf-8
+
+module HTTPkit
+  class Client::KeepAlive
+    def perform(request)
+      @previous, previous = request, @previous
+      previous.closed! if previous
+    end
+  end
+end

data/lib/httpkit/client/timeouts.rb

@@ -0,0 +1,14 @@
+# encoding: utf-8
+
+module HTTPkit
+  # @see EM.heartbeat_interval
+  class Client::Timeouts
+    def setup(config, _, connection)
+      @config = config
+      @connection = connection
+
+      @connection.comm_inactivity_timeout = @config[:timeout]         ||= 2.0
+      @connection.pending_connect_timeout = @config[:connect_timeout] ||= 2.0
+    end
+  end
+end