balancir 0.0.1

data/.gitignore

@@ -0,0 +1,17 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.travis.yml

@@ -0,0 +1,13 @@
+language: ruby
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - 1.9.3
+  - 2.0.0
+  - jruby-18mode
+  - jruby-19mode
+  # - rbx-18mode
+  # - rbx-19mode
+script: bundle exec rspec
+notifications:
+  irc: "irc.freenode.org#balancir"

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+gemspec
+
+gem 'rb-fsevent', :require => RUBY_PLATFORM.include?('darwin') && 'rb-fsevent'
+gem 'growl', :require => RUBY_PLATFORM.include?('darwin') && 'growl'

data/Guardfile

@@ -0,0 +1,8 @@
+
+guard 'rspec', :cli => "--color --format nested" do
+  watch(%r{^spec/(.+)_spec\.rb$}) { |m| "spec/#{m[1]}_spec.rb" }
+  watch(%r{^lib/(.+)\.rb$})       { |m| "spec/lib/#{m[1]}_spec.rb" }
+  watch(%r{^spec/support/*})      { 'spec' }
+  watch('spec/spec_helper.rb')    { "spec" }
+end
+

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 Michael Brodhead
+
+MIT License
+
+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,45 @@
+# Balancir
+
+Balancir is a client-side HTTP load balancer.
+
+[![Code Climate](https://codeclimate.com/github/mkb/balancir.png)](https://codeclimate.com/github/mkb/balancir)
+[![Build Status](https://travis-ci.org/mkb/balancir.png?branch=master)](https://travis-ci.org/mkb/balancir)
+[![Dependency Status](https://gemnasium.com/mkb/balancir.png)](https://gemnasium.com/mkb/balancir)
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'balancir'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install balancir
+
+## Usage
+
+TODO: Come up with a name.
+
+## Running the tests
+
+    bundle
+    bundle exec guard
+    # Hack away in another window. Guard will re-run tests as needed.
+
+Or alternately:
+
+    bundle
+    bundle exec rspec
+    # Lament that you are not using Guard.
+
+## 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 @@
+require "bundler/gem_tasks"

data/balancir.gemspec

@@ -0,0 +1,29 @@
+# -*- encoding: utf-8 -*-
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'balancir/version'
+
+Gem::Specification.new do |gem|
+  gem.name          = "balancir"
+  gem.version       = Balancir::VERSION
+  gem.authors       = ["Michael Brodhead", "Blaine Carlson"]
+  gem.email         = ["mkb@orthogonal.org", "blaineosiris@comcast.net"]
+  gem.description   = %q{A client side HTTP load balancer.}
+  gem.summary       = %q{Allocate load between multiple instances of an HTTP service. } +
+      %q{Remove non-functioning servers from rotation and add them back when they become available.}
+  gem.homepage      = "https://github.com/mkb/balancir"
+
+  gem.files         = `git ls-files`.split($/)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.require_paths = ['lib']
+
+  gem.add_dependency('excon')
+
+  gem.add_development_dependency('rspec')
+  gem.add_development_dependency('guard')
+  gem.add_development_dependency('guard-rspec')
+  gem.add_development_dependency('travis-lint')
+  gem.add_development_dependency('sinatra')
+  gem.add_development_dependency('realweb')
+end

data/lib/balancir.rb

@@ -0,0 +1,4 @@
+require "unnamed/version"
+
+module Unnamed
+end

data/lib/balancir/connector.rb

@@ -0,0 +1,14 @@
+module Balancir
+  # Represents a connection to a particular server
+  class Connector
+    attr_accessor :connection, :random, :recent_errors
+
+    def clear_errors
+      @recent_errors = []
+    end
+
+    def record_error
+      @recent_errors << true
+    end
+  end
+end

data/lib/balancir/distributor.rb

@@ -0,0 +1,20 @@
+module Balancir
+  # Accepts requests and distributes them between connectors.
+  class Distributor
+
+    def initialize
+      @connectors = []
+    end
+
+    def add_connector(connector, weight)
+      @connectors << connector
+    end
+
+    def get(path)
+      response = @connectors.first.get(path)
+      if (500..599).include? response.status
+        @connectors.first.record_error
+      end
+    end
+  end
+end

data/lib/balancir/version.rb

@@ -0,0 +1,3 @@
+module Balancir
+  VERSION = "0.0.1"
+end

data/spec/lib/balancir/connector_spec.rb

@@ -0,0 +1,17 @@
+require 'spec_helper'
+require 'realweb'
+require 'balancir/connector'
+
+describe Balancir::Connector do
+  # before :all do
+  #   fake_server = File.expand_path('./spec/support/fake_working_service.ru')
+  #   @server = RealWeb.start_server_in_thread(fake_server)
+  # end
+
+  # after :all do
+  #   @server.stop
+  # end
+
+  pending 'error recording'
+  # need to support HMAC
+end

data/spec/lib/balancir/distributor_spec.rb

@@ -0,0 +1,72 @@
+require 'spec_helper'
+require 'balancir/distributor'
+require 'balancir/connector'
+
+describe Balancir::Distributor do
+  SOME_PATH = '/stuff/and/things'
+  ERROR_STATUSES = (500..511).to_a + [598, 599]
+
+  context 'with a single connector' do
+    before do
+      @connector = Balancir::Connector.new
+      @distributor = Balancir::Distributor.new
+      @distributor.add_connector(@connector, 100)
+      @response = double(:status => 200)
+    end
+
+    describe 'message passing' do
+      it 'passes on calls to #get' do
+        @connector.should_receive(:get).and_return(@response)
+        @distributor.get(SOME_PATH)
+      end
+
+      it 'passes on calls to #post'
+      it 'passes on calls to #put'
+      it 'passes on calls to #delete'
+    end
+
+    describe 'error detection' do
+      it 'counts 500s as errors' do
+        ERROR_STATUSES.each do |status|
+          @connector.clear_errors
+          response = double(:status => status)
+          @connector.stub(:get).and_return(response)
+          @distributor.get(SOME_PATH)
+          @connector.recent_errors.count.should eq 1
+        end
+      end
+
+      pending "more error detection" do
+        it 'does not count 404 or 410 as errors'
+        it 'counts other 400s as errors'
+        it 'counts 700s as errors'
+
+        it 'counts Errno::ECONNRESET as an error'
+        it 'counts Errno::ETIMEDOUT as an error'
+        it 'counts Errno::ECONNREFUSED as an error'
+        it 'counts Errno::EHOSTUNREACH as an error'
+        it 'counts Errno::EAFNOSUPPORT as an error'
+
+        it "disables after enough errors"
+      end
+    end
+  end
+
+  pending 'with a single, failed connector' do
+    it 'raises Balancir::NoConnectorsAvailable when called'
+    it 'tests the failed connector'
+    it 'reenables the failed connecor when it comes back'
+  end
+
+  context 'with two well-behaved connectors' do
+    it 'distributes calls between them'
+  end
+
+  pending 'with two connectors, one well-behaved, one not' do
+    it 'tolerates occasional errors'
+    it 'disables a failing connector'
+    it 're-enables a failed connector which resumes working'
+  end
+
+  # what about notifications?
+end

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$: << './lib'
+

data/spec/support/fake_broken_service.ru

@@ -0,0 +1,9 @@
+require 'sinatra'
+
+SOME_JSON = %Q|{"tacos":{"cheese":"cheddar"}}}|
+get '/*' do
+  [500, {}, ['Horrible, horrible error.']]
+end
+
+run Sinatra::Application
+

data/spec/support/fake_working_service.ru

@@ -0,0 +1,9 @@
+require 'sinatra'
+
+SOME_JSON = %Q|{"tacos":{"cheese":"cheddar"}}}|
+get '/ok' do
+  [200, { 'Content-Type' => 'application/json' }, [SOME_JSON]]
+end
+
+run Sinatra::Application
+

metadata

@@ -0,0 +1,182 @@
+--- !ruby/object:Gem::Specification
+name: balancir
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Michael Brodhead
+- Blaine Carlson
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-02-13 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: excon
+  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: 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'
+- !ruby/object:Gem::Dependency
+  name: guard
+  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'
+- !ruby/object:Gem::Dependency
+  name: guard-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'
+- !ruby/object:Gem::Dependency
+  name: travis-lint
+  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'
+- !ruby/object:Gem::Dependency
+  name: sinatra
+  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'
+- !ruby/object:Gem::Dependency
+  name: realweb
+  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: A client side HTTP load balancer.
+email:
+- mkb@orthogonal.org
+- blaineosiris@comcast.net
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .travis.yml
+- Gemfile
+- Guardfile
+- LICENSE.txt
+- README.md
+- Rakefile
+- balancir.gemspec
+- lib/balancir.rb
+- lib/balancir/connector.rb
+- lib/balancir/distributor.rb
+- lib/balancir/version.rb
+- spec/lib/balancir/connector_spec.rb
+- spec/lib/balancir/distributor_spec.rb
+- spec/spec_helper.rb
+- spec/support/fake_broken_service.ru
+- spec/support/fake_working_service.ru
+homepage: https://github.com/mkb/balancir
+licenses: []
+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: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Allocate load between multiple instances of an HTTP service. Remove non-functioning
+  servers from rotation and add them back when they become available.
+test_files:
+- spec/lib/balancir/connector_spec.rb
+- spec/lib/balancir/distributor_spec.rb
+- spec/spec_helper.rb
+- spec/support/fake_broken_service.ru
+- spec/support/fake_working_service.ru