experella-proxy 0.0.6

data/.gitignore

@@ -0,0 +1,15 @@
+#IDE
+
+.idea
+
+#DEV
+.ruby-gemset
+.ruby-version
+
+#LOGS
+*.log
+
+.rspec
+
+Gemfile.lock
+*.gem

data/Gemfile

@@ -0,0 +1,3 @@
+source "http://rubygems.org"
+
+gemspec

data/README.md

@@ -0,0 +1,219 @@
+#Experella-Proxy
+
+A balancing EventMachine reverse proxy based on [em-proxy](https://github.com/igrigorik/em-proxy)
+
+Configurable in pure ruby!
+
+Supports:
+
++ Persistent connections and HTTP Pipelining for clients
++ Response streaming
++ Post Request data streaming
++ Request header routing logic completely configurable for each server
++ Request header manipulation completely configurable for each server
++ Daemonized control using ruby [Daemons](http://daemons.rubyforge.org/)
++ TLS support and a default self-signed ssl certification
+
+Proxy uses [http_parser](https://github.com/tmm1/http_parser.rb) to parse http data and is thereby subject to the parsers restrictions
+
+The proxy is build for low proxy to server latency and does not support persistent connections to servers. Keep that in mind
+as i can severely influence proxy performance overhead.
+
+It balances for every single http-request and not per client/connection.
+
+##Install as Gem
+
+To use experella-proxy simply install it as a gem.
+
+```
+gem install experella-proxy
+```
+
+##How to start
+
+Experella-Proxy is controlled by ruby Daemons default commands (run, start, restart, stop) and provides
+a template config initialization command (init destination).
+
+run, start and restart require an absolute config file path.
+
+To initialize the proxy with default config files init the proxy to a directory of your choice.
+
+For example
+
+```
+$> experella-proxy init ~
+```
+
+will initialize default config to $HOME/proxy
+
+
+Then simply use:
+
+```
+$> experella-proxy start -- --config=~/proxy/config.rb
+$> experella-proxy restart -- --config=~/proxy/config.rb
+$> experella-proxy stop
+```
+to control the proxy with the default config file.
+
+
+### BASE_PORT option for default config
+
+To set other base port you have to prefix the previous commands with BASE_PORT=xxxx e.g.
+
+Running ports below 1024 probably requires "rvmsudo" to run properly
+
+```
+$> BASE_PORT=3000 experella-proxy start -- --config=~/proxy/config.rb
+```
+
+##Config file
+
+You need to provide a valid config file for the proxy to run.
+
+Config files use a ruby DSL with the following options
+
+###Backend Server
+
+Each server is configured independent of other servers, so each desired routing dependency has to be added manually.
+i.e. if you want to route an inimitable request to an unique backend, you have to exclude that match in all other servers.
+
+
+```
+backend         Takes an options hash defining a backend_server
+    required keys =>    :host   Host address of the Server, can be IP or domain, String
+                        :port   Port of the Server, Integervalue as String
+
+    optional keys =>    :name   Name of the Server used in the Logger and Cashing, String
+                                Will default to #{host}:#{port} but needs to be unique, though theoretical there can be
+                                multiple servers with the same host:port value pair!
+
+                        :concurrency max Number of concurrent connections, Integervalue as String, Default is 1
+
+                        :accepts    Hash containing keys matching HTTP headers or URI :path, :port, :query
+                                    Values are Regexp as Strings or as Regex, use ^((?!pattern).)*$ to negate matching
+                                    Care: Will match any Header/value pairs not defined in the accepts Hash
+
+                        :mangle     Hash containing keys matching HTTP headers. Values can be callable block or Strings
+                                    Mangle modifies the header value based on the given block
+                                    or replaces the header value with the String
+```
+
+####Example
+
+```ruby
+    backend(:name => "Srv1", :host => "192.168.0.10", :port => "80", :concurrency => "1",
+     :accepts => {"request_url" => "^((?!/(#{not-for-srv1})($|/)).)*$"},
+     :mangle => {"Host" => lambda{ |host|
+                           if host.match(/localhost/)
+                              'www.host-i-need.com'
+                           else
+                              host
+                           end
+                           }
+              }
+    )
+```
+###Logging
+
+```
+set_logger      specifies the Logger used by the program. The Logger must support debug/info/warn/error/fatal functions
+```
+
+###Proxy Server
+
+```
+set_proxy       Add proxy as Hash with :host => "string-ip/domain", :port => Fixnum, :options => Hash
+                The proxy will listen on every host:port hash added with this function.
+                :options can activate :tls with given file paths to :private_key_file and :cert_chain_file
+                         file paths are relative to the config file directory
+```
+####Example
+
+```ruby
+    set_proxy(:host => "127.0.0.1", :port => 8080)
+    set_proxy(:host => "127.0.0.1", :port => 443,
+              :options => {:tls => true,
+                           :private_key_file => 'ssl/private/experella_proxy.key',
+                           :cert_chain_file => 'ssl/certs/experella_proxy.pem'})
+    set_proxy(:host => "127.0.0.2", :port => 8080)
+    set_proxy(:host => "192.168.100.168", :port => 6666)
+```
+
+###Connection timeout
+
+```
+set_timeout     Time as float when an idle persistent connection gets closed (no receive/send events occured)
+```
+
+###Error pages
+
+```
+set_error_pages Add html error-pages to the proxy, requires 2 arguments
+                1st arg: the error code as Fixnum
+                2nd arg: path to an error page html file relative to the config file directory
+                Currently 404 and 503 error codes are supported
+```
+
+####Example
+
+```ruby
+    set_error_pages(404, "404.html")
+    set_error_pages(503, "503.html")
+```
+
+
+## Modify connection logic and data streams
+
+Override server's run function
+
+```ruby
+    def run
+
+      Proxy.start(options = {}) do |conn|
+
+        log.info msec + "new Connection @" + signature.to_s
+
+        # called on successful backend connection
+        conn.on_connect do |backend|
+
+        end
+
+        # modify / process request stream
+        # and return modified data
+        conn.on_data do |data|
+          data
+        end
+
+        # modify / process response stream+
+        # and return modified response
+        conn.on_response do |backend, resp|
+          resp
+        end
+
+        # termination logic
+        conn.on_finish do |backend|
+
+        end
+
+        # called if client finishes connection
+        conn.on_unbind do
+
+        end
+      end
+
+    end
+```
+
+## Additional Information
+
++ [em-proxy](https://github.com/igrigorik/em-proxy)
++ [http_parser](https://github.com/tmm1/http_parser.rb)
++ [Eventmachine](https://github.com/eventmachine/eventmachine)
++ [Daemons](http://daemons.rubyforge.org/)
++ [What proxies must do](http://www.mnot.net/blog/2011/07/11/what_proxies_must_do)
+
+
+## License
+
+MIT License - Copyright (c) 2014 Dennis-Florian Herr @Experteer GmbH

data/Rakefile

@@ -0,0 +1,25 @@
+require 'rake'
+require 'rspec/core/rake_task'
+require 'yard'
+
+RSpec::Core::RakeTask.new(:spec)
+
+YARD::Rake::YardocTask.new(:yardoc)
+
+desc "Start Sinatra Server one on port 4567"
+task :sinatra_one do
+  require 'test/sinatra/server_one'
+  ServerOne.run!(:port => 4567)
+end
+
+desc "Start Sinatra Server two port 4568"
+task :sinatra_two do
+  require 'test/sinatra/server_two'
+  ServerTwo.run!(:port => 4568)
+end
+
+desc "Start Hello World! Sinatra Server port 4569"
+task :sinatra_hello_world do
+  require 'test/sinatra/hello_world_server'
+  HelloWorldServer.run!(:port => 4569)
+end

data/TODO.txt

@@ -0,0 +1,20 @@
+TODO:
+
+General:
+
+- Benchmarks for readme
+- Configuration routing debugging tool
+
+Performance:
+
+- improve server matching
+    * avoid negative regexp, e.g. add reject option instead of negative accept
+    * group servers which match same requests
+    * probably add a option for "fallback" servers
+
+Features:
+
+- self configuring backends
+    * detect disconnected backends
+- improve middleware support
+- SPDY

data/bin/experella-proxy

@@ -0,0 +1,54 @@
+#!/usr/bin/env ruby
+
+lib = File.expand_path(File.join(File.dirname(__FILE__), '../lib/'))
+
+require 'fileutils'
+
+ARGV << '--help' if ARGV.empty?
+
+if ARGV[0] == "init"
+  if ARGV[1] && File.directory?(File.expand_path(ARGV[1]))
+    source_dir = File.expand_path(File.join(File.dirname(__FILE__), "/../config/default/"))
+      dest_dir = File.join(File.expand_path(ARGV[1]), "proxy")
+      FileUtils.copy_entry source_dir, dest_dir
+      puts "Initialized template config to #{dest_dir}"
+    else
+      puts "ERROR: #{File.expand_path(ARGV[1])} is not a directory"
+      puts "Please provide an existing directory to initialize to as second argument"
+  end
+elsif ["start", "stop", "restart", "reload", "run", "zap", "status"].include? ARGV[0]
+  require 'daemons'
+  Daemons.run(File.join(lib, 'experella-proxy.rb'))
+else
+  unless ARGV[0] == "--help" || ARGV[0] == "-h"
+    puts "ERROR no command given"
+    puts
+  end
+  puts "To control the proxy use: experella-proxy <command> <options> -- <application options>"
+  puts
+  puts "* where <command> is one of Daemons:"
+  puts "  start         start an instance of the application"
+  puts "  stop          stop all instances of the application"
+  puts "  restart       stop all instances and restart them afterwards"
+  puts "  reload        send a SIGHUP to all instances of the application"
+  puts "  run           start the application and stay on top"
+  puts "  zap           set the application to a stopped state"
+  puts "  status        show status (PID) of application instances"
+  puts
+  puts "* and where <options> may contain several of the following:"
+  puts "  -t, --ontop   Stay on top (does not daemonize)"
+  puts "  -f, --force   Force operation"
+  puts "  -n, --no_wait Do not wait for processes to stop"
+  puts
+  puts "* and where <applicaion options> are"
+  puts "  --config=CONFIGFILE   absolute path to the proxy config file"
+  puts
+  puts
+  puts "To initialize the proxy use: experella-proxy init <path>"
+  puts
+  puts "* where <path> is the location the config files get copied to"
+  puts
+  puts "Common options: "
+  puts "  -h, --help    Show this message"
+  puts "  --version     Show daemons version"
+end

data/config/default/404.html

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <style type="text/css"> body {
+        text-align: center;
+        font-family: helvetica, arial;
+        font-size: 22px;
+        color: #000;
+        margin: 20px
+    }
+    </style>
+</head>
+<body>
+<h2>404 Page not found!</h2>
+</body>
+</html>

data/config/default/503.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <style type="text/css"> body {
+        text-align: center;
+        font-family: helvetica, arial;
+        font-size: 22px;
+        color: #000;
+        margin: 20px
+
+    }
+
+    </style>
+</head>
+<body>
+<h2> 503 Service unavailable!</h2>
+</body>
+</html>

data/config/default/config.rb

@@ -0,0 +1,64 @@
+#Backend Server
+base_backend_port=(ENV["BASE_PORT"] : 4000).to_i
+backend1_port=base_backend_port+1
+backend2_port=base_backend_port+2
+
+# add servers in schema, :name, :host, :port, :concurrency,
+# :host and :port are required, everything else is optional though name needs to be unique!
+# :accepts {"header" => regex} hash, :mangle {"header" => "string"||lambda do |header-value|}
+# accepts hash can additionally use uri :port, :path, :query for more efficient comparison
+# mangle hash can modify any http headers, use strings for simple replace, use lambda for logic
+# accepts and mangle are optional, but care: not using accepts means the server accepts every request and backends will
+# always ignore the settings of any other backend server.
+# use ^((?!pattern).)*$ to negate matching
+
+#template backend servers
+
+backend(:name => "srv1", :host => "localhost", :port => backend1_port, :concurrency => "1000",
+        :accepts => {"request_url" => "^((?!/(srv2)($|/)).)*$"}
+)
+
+backend(:name => "srv2", :host_port => "localhost:#{backend2_port}", :concurrency => "1",
+        :accepts => {"request_url" => "/(srv2)($|/)"},
+        :mangle => {"Host" => lambda { |host|
+          if host.match(/127.0.0/)
+            'localhost'
+          else
+            host
+          end
+        }
+        }
+)
+
+# experimental!
+# web support if used as a forward proxy. care, not all webservers accept http-proxy standard (e.g. wikimedia)
+# Host and Port will be set according to Requests Host header instead of :host and :port keys.
+# backend(:name => "web", :host => "0.0.0.0", :port => "80", :concurrency => "1000",
+#  :accepts => {"Host" => "^((?!localhost).)*$"}
+# )
+
+require 'logger'
+
+# set a logger. Has to support debug/info/warn/error/fatal logger functions
+set_logger Logger.new($stdout)
+logger.level = Logger::WARN
+
+# set proxy servers here, listens on every host, port hash pair
+# you can add one pair per call to set_proxy(hsh)
+# additionally you can activate ssl with provided private_key and cert_chain files
+set_proxy(:host => "localhost", :port => base_backend_port)
+set_proxy(:host => "localhost", :port => 443,
+          :options => {:tls => true,
+                       :private_key_file => 'ssl/private/experella-proxy.key',
+                       :cert_chain_file => 'ssl/certs/experella-proxy.pem'}
+)
+
+
+# set the timeout in seconds. Will unbind a keep-alive connection
+# if no send/receive event occured in specified seconds
+set_timeout(30.0)
+
+# provide errorpage locations. first arguument is error code, second is (html) file location in configfile folder
+set_error_pages(404, "404.html")
+set_error_pages(503, "503.html")
+

data/config/default/ssl/certs/experella-proxy.pem

@@ -0,0 +1,18 @@
+-----BEGIN CERTIFICATE-----
+MIIC4TCCAcmgAwIBAgIJAN8pDjDjYU8xMA0GCSqGSIb3DQEBBQUAMBQxEjAQBgNV
+BAMTCWxvY2FsaG9zdDAeFw0xNDAxMjIxNTI2NTZaFw0yNDAxMjAxNTI2NTZaMBQx
+EjAQBgNVBAMTCWxvY2FsaG9zdDCCASIwDQYJKoZIhvcNAQEBBQADggEPADCCAQoC
+ggEBAMOf6ah6DhHpIjEkJDrNVddo82Z+Bzk3OCyqaGhyWSDN7kQermErxqw0ioeK
+1p6j+od1aVcwjWds6TdRjPPlIb1ZmlAhwrCedF7TAN76jRVoay4reRzA5SJ4lR9i
+BkpYJbE7bx1l16dvnpwfP44thiPp4jHGwtkgZCnUsqyIW03Ssn6P5hGQqSBgy6GO
+Hb0ZuyyVIENCHaRMuFjjU4jrZzwcIt/nVWx2M1njxFDHt2FLpvtKtGkp8abrrQO6
+TeEpTUDQcncrMzXhm80Kr6PY9FVNauuOpWZXhbK0lndxyXQC3eN+8eeCFDV0EfU8
+pRkc+dfGFBI8zuHZY0VSeUsc8uMCAwEAAaM2MDQwCQYDVR0TBAIwADAnBgNVHREE
+IDAehwR/AAABhwR/AAAChwR/AAADhwR/AAAEhwR/AAAFMA0GCSqGSIb3DQEBBQUA
+A4IBAQBv4/A9F7lQ/TGVO28RoWGZrCouMhkmVC/mo1SQxpkGY0VlydU04mWAiayv
+32Fyy0SPq/2YgpFzAyXLVZ2hO/4NEHjjpd1utHWEXxVGy8nqMS73y7XOuc7bkT7V
+uqvxA0WgwtD9EOG+XIiRszybcR/C1Dpg37Ct9ZA1wmFQr5C19Hl0ki6PKkaGuy/I
+NGMtdgxGSKzCGTwQD7rclUbvf5QZYN+uoyZoC3yJ47sAER8CMpAYTl/GU34vL7p2
+NJiPH3Y570l6II96JU7nsdC6UA4sUx/H9HhDsd0TSXtLONqQU03M9qDckgmf+x0C
+oIjTcEDbcsGuPuo6j1HYrAzNEkso
+-----END CERTIFICATE-----

data/config/default/ssl/private/experella-proxy.key

@@ -0,0 +1,28 @@
+-----BEGIN PRIVATE KEY-----
+MIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQDDn+moeg4R6SIx
+JCQ6zVXXaPNmfgc5Nzgsqmhoclkgze5EHq5hK8asNIqHitaeo/qHdWlXMI1nbOk3
+UYzz5SG9WZpQIcKwnnRe0wDe+o0VaGsuK3kcwOUieJUfYgZKWCWxO28dZdenb56c
+Hz+OLYYj6eIxxsLZIGQp1LKsiFtN0rJ+j+YRkKkgYMuhjh29GbsslSBDQh2kTLhY
+41OI62c8HCLf51VsdjNZ48RQx7dhS6b7SrRpKfGm660Duk3hKU1A0HJ3KzM14ZvN
+Cq+j2PRVTWrrjqVmV4WytJZ3ccl0At3jfvHnghQ1dBH1PKUZHPnXxhQSPM7h2WNF
+UnlLHPLjAgMBAAECggEACqmInrooUimWx37kyp+uchMyUP/FfQTZdvXCww6YdQVE
+W0ogzwMHzRMACeszT2o4mXF40FvBGUYCYBV9zT1L3Xoowv1UEzRPu2tcvMqDLguG
+6/lKnJqW4o4X8qHxHdQ4GbTXlY6bdnDLAE9js2gfy41P2s6uiA8P5ofFRUoZT+B3
+jczy86d5FFD0RYnFOIAxR2s1MNKzbh+400L+PdLu3p8+PsdCgFD703eyCtnLIxFm
+NkGNpNnBwKSD3kufwOqtht+iIOrpR2LwBAZszO7h4P9/1gwX++296sq4uK7px3hh
+2n/vnv/k/IB0Ewp20vyVibTzrJees+A2x28GduW6wQKBgQDv/pJ/EakoMDWs5fFq
+4DFaiy+YznE5iUce74yxZusxTaCBMacbPYWLqs3ZtZ2weo161XLcyNEKkOALoslt
+4tcLuLlzbBBR3o0Z6ggmXgvgrvtd4hN7IfjcxzRp7jAhlZx2j7JfXiNsmJ+yQ+UZ
+FJejcaf4zNUtD1tP/Pc91bwCWwKBgQDQq9Cgk/DpTXp8lVaNbrk8QC3e48RCXLsj
+qUeeWPVEcMSr2yafH38fMdfi+FhTYbAIn/uvCHPzPbsJ0DT04cQtWmztOuex4A7j
+biiazkfbwb4ROe8fXzGFDCLAyhItkyLwuXCvR8GO7iRQiQaSOHOGrsEgCK40WU6V
+dTwiqq+oGQKBgQDZd0tV2zH1maG5lu7oUlhGXGL3yvEsGqmYbaaGReUOWvH6v3xV
+oay2P0KiaQCHnrU+vdWEHG/XbCmoQYzWhrsoAu4AmcY7+TbQaZGS+ps2sDhT/Px8
+Ee+IVvW2mz9/3yrVACa4ZfwhdjcW+JDK5i71ypJTT4BHgWfTljyPCnJ/iwKBgQCC
+7huEde8mY//j5cweCAhgHqDphp5hSU/+qzuNxqF2ZQ9yCZrtItUfnKWp+0toXhYX
+A1LnW3VtfSE7ohFoSbRPBLruCxTPzhdpang90grSf3kj0+cPFyq6IYg40VGgmP7G
+boSe5nYzmYbdpWyjGJqcOlBhKjEsFZEyRBIMam63GQKBgC76YY/TEoPV7BPcvaDc
+4p7d4YC+KLidy6tyOx2hn8a0FAUmgrQP0Jbl9pMf+oVTGJm460ASW+z6ZQjilx0s
+4PCGWXNioJJOdTWRRHB2RjrHOU3MXKbBJB4JBg4n+fBtEEE9nP0orCpsDVnGSlep
+t7n4VlIzT0CrlpXYiJQaG6hq
+-----END PRIVATE KEY-----

data/dev/experella-proxy

@@ -0,0 +1,62 @@
+#!/usr/bin/env ruby
+
+# binary file for developers
+require 'rubygems'
+require 'bundler'
+Bundler.setup
+
+#NOTE: This is exactly the same as /bin/experella-proxy from here
+
+lib = File.expand_path(File.join(File.dirname(__FILE__), '../lib/'))
+
+require 'fileutils'
+
+ARGV << '--help' if ARGV.empty?
+
+if ARGV[0] == "init"
+  if ARGV[1] && File.directory?(File.expand_path(ARGV[1]))
+    source_dir = File.expand_path(File.join(File.dirname(__FILE__), "/../config/default/"))
+    dest_dir = File.join(File.expand_path(ARGV[1]), "proxy")
+    FileUtils.copy_entry source_dir, dest_dir
+    puts "Initialized template config to #{dest_dir}"
+  else
+    puts "ERROR: #{File.expand_path(ARGV[1])} is not a directory"
+    puts "Please provide an existing directory to initialize to as second argument"
+  end
+elsif ["start", "stop", "restart", "reload", "run", "zap", "status"].include? ARGV[0]
+  require 'daemons'
+  Daemons.run(File.join(lib, 'experella-proxy.rb'))
+else
+  unless ARGV[0] == "--help" || ARGV[0] == "-h"
+    puts "ERROR no command given"
+    puts
+  end
+  puts "To control the proxy use: experella-proxy <command> <options> -- <application options>"
+  puts
+  puts "* where <command> is one of Daemons:"
+  puts "  start         start an instance of the application"
+  puts "  stop          stop all instances of the application"
+  puts "  restart       stop all instances and restart them afterwards"
+  puts "  reload        send a SIGHUP to all instances of the application"
+  puts "  run           start the application and stay on top"
+  puts "  zap           set the application to a stopped state"
+  puts "  status        show status (PID) of application instances"
+  puts
+  puts "* and where <options> may contain several of the following:"
+  puts "  -t, --ontop   Stay on top (does not daemonize)"
+  puts "  -f, --force   Force operation"
+  puts "  -n, --no_wait Do not wait for processes to stop"
+  puts
+  puts "* and where <applicaion options> are"
+  puts "  --config=CONFIGFILE   absolute path to the proxy config file"
+  puts
+  puts
+  puts "To initialize the proxy use: experella-proxy init <path>"
+  puts
+  puts "* where <path> is the location the config files get copied to"
+  puts
+  puts "Common options: "
+  puts "  -h, --help    Show this message"
+  puts "  --version     Show daemons version"
+end
+

data/experella-proxy.gemspec

@@ -0,0 +1,39 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'experella-proxy/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = "experella-proxy"
+  spec.version       = ExperellaProxy::VERSION
+  spec.authors       = ["Dennis-Florian Herr"]
+  spec.email         = ["dennis.herr@experteer.com"]
+  spec.description   = 'a balancing & routing proxy, see README for more details'
+  spec.summary       = 'experella-proxy gem'
+  spec.homepage      = "https://github.com/experteer/experella-proxy"
+  spec.license       = "MIT"
+
+  spec.add_runtime_dependency "daemons", "~> 1.1.4"
+  spec.add_runtime_dependency "eventmachine", "~> 1.0.3"
+  spec.add_runtime_dependency "http_parser.rb", "~> 0.5.3"
+
+  spec.add_development_dependency "rake", "~> 10.1.0"
+  # specs
+  spec.add_development_dependency "rspec", "2.14.1"
+  spec.add_development_dependency "posix-spawn"
+  spec.add_development_dependency "em-http-request"
+  # dev testing
+  spec.add_development_dependency "sinatra", "1.4.3"
+  spec.add_development_dependency "thin", "~> 1.5.1"
+  # documentation tool
+  spec.add_development_dependency "yard", "~> 0.8.7.3"
+  spec.add_development_dependency "redcarpet", "~> 2.3.0"
+
+  spec.files         = Dir["bin/*"] + Dir["dev/*"] + Dir["lib/**/*"] + Dir["config/default/**/*"]
+  spec.files        += Dir["spec/**/*"] + Dir["test/sinatra/*"]
+  spec.files        += [".gitignore", "Gemfile", "experella-proxy.gemspec", "README.md", "TODO.txt", "Rakefile"]
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec)/})
+  spec.extra_rdoc_files = ['README.md']
+  spec.require_paths = ["lib"]
+end

data/lib/experella-proxy/backend.rb

@@ -0,0 +1,58 @@
+module ExperellaProxy
+  # The Proxies connection to the backend server
+  #
+  # This class will never be directly initiated by user code, but initializing gets triggered in client {Connection}
+  class Backend < EventMachine::Connection
+
+    include ExperellaProxy::Globals
+
+    # @!visibility private
+    attr_accessor :plexer, :name
+
+    # Called by the EventMachine loop when a remote TCP connection attempt completes successfully
+    #
+    # Calls client {Connection} {Connection#connected} method
+    #
+    def connection_completed
+      log.debug [@name, :conn_complete]
+      @plexer.connected(@name)
+      @connected.succeed
+    end
+
+    # Called by the EventMachine loop whenever data has been received by the network connection.
+    # It is never called by user code. {#receive_data} is called with a single parameter,
+    # a String containing the network protocol data, which may of course be binary.
+    #
+    # Data gets passed to client {Connection} through {Connection#relay_from_backend}
+    #
+    # @param data [String] Opaque response data
+    def receive_data(data)
+      log.debug [:receive_backend, @name, data]
+      @plexer.relay_from_backend(@name, data)
+    end
+
+    # Buffer data for send until the connection to the backend server is established and is ready for use.
+    #
+    # @param data [String] data to be send to the connected backend server
+    def send(data)
+      log.debug [:send_backend, data]
+      @connected.callback { send_data data }
+    end
+
+    # Notify upstream plexer that the backend server is done processing the request
+    #
+    def unbind
+      log.debug [@name, :unbind]
+      @plexer.unbind_backend(@name)
+    end
+
+    private
+
+    # @private constructor, gets called by EventMachine::Connection's overwritten new method
+    #
+    def initialize
+      @connected = EM::DefaultDeferrable.new
+    end
+
+  end
+end