restrack-balancer 1.0.0

data/.document

@@ -0,0 +1,5 @@
+lib/**/*.rb
+bin/*
+- 
+features/**/*.feature
+LICENSE.txt

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specifying gem's dependencies in restrack.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,20 @@
+Copyright (c) 2011 Chris St. John
+
+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.rdoc

@@ -0,0 +1,19 @@
+= restrack-balancer
+
+Description goes here.
+
+== Contributing to restrack-balancer
+ 
+* Check out the latest master to make sure the feature hasn't been implemented or the bug hasn't been fixed yet
+* Check out the issue tracker to make sure someone already hasn't requested it and/or contributed it
+* Fork the project
+* Start a feature/bugfix branch
+* Commit and push until you are happy with your contribution
+* Make sure to add tests for it. This is important so I don't break it in a future version unintentionally.
+* Please try not to mess with the Rakefile, version, or history. If you want to have your own version, or is otherwise necessary, that is fine, but please isolate to its own commit so I can cherry-pick around it.
+
+== Copyright
+
+Copyright (c) 2011 Chris St. John. See LICENSE.txt for
+further details.
+

data/Rakefile

@@ -0,0 +1,12 @@
+require 'rake'
+require 'rake/testtask'
+
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+task :default => [:test]
+
+desc 'Run tests.'
+Rake::TestTask.new('test') { |t|
+  t.pattern = 'test/test_*.rb'
+}

data/lib/restrack-balancer/version.rb

@@ -0,0 +1,3 @@
+module RESTRackBalancer
+  VERSION = "1.0.0"
+end

data/lib/restrack-balancer.rb

@@ -0,0 +1,61 @@
+require 'rubygems'
+require 'restrack-client'
+
+module RESTRack
+  class Balancer
+
+    attr_reader :last_client, :clients
+
+    def initialize(uri_list, format=:JSON)
+      raise 'You must supply an array as the list of URI to RESTRack::Balancer#initialize.' unless uri_list.is_a? Array
+      @clients = uri_list.collect do |uri|
+        RESTRack::Client.new(uri, format)
+      end
+      @path = ''
+      @uri = uri_list
+      @last_client = nil
+      @next_client_i = rand(@clients.length)
+    end
+
+    def method_missing(resource_name, *args)
+      @clients[@next_client_i].__send__(resource_name.to_sym, *args)
+      self
+    end
+
+    def get
+      response = @clients[@next_client_i].get
+      get_next_client
+      response
+    end
+
+    def delete
+      response = @clients[@next_client_i].delete
+      get_next_client
+      response
+    end
+
+    def post(data=nil)
+      response = @clients[@next_client_i].post(data)
+      get_next_client
+      response
+    end
+
+    def put(data=nil)
+      response = @clients[@next_client_i].put(data)
+      get_next_client
+      response
+    end
+
+    private
+    def get_next_client
+      @last_client = @uri[@next_client_i]
+      if @next_client_i < @clients.length - 1
+        @next_client_i += 1
+      else
+        @next_client_i = 0
+      end
+      @next_client = @uri[@next_client_i]
+    end
+
+  end
+end

data/restrack-balancer.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "restrack-balancer/version"
+
+Gem::Specification.new do |s|
+  s.name        = "restrack-balancer"
+  s.version     = RESTRackBalancer::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ['Chris St. John']
+  s.email       = ['chris@stjohnstudios.com']
+  s.homepage    = 'http://github.com/stjohncj/RESTRack-Splitter'
+  s.summary     = %q{A library for interacting with RESTful web services.  Use this to communicate with RESTRack based services.}
+  s.description = %q{A library for interacting with RESTful web services.  Use this to communicate with RESTRack based services.}
+  s.rubyforge_project = "restrack-splitter"
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_development_dependency 'shoulda'
+  s.add_runtime_dependency 'restrack-client'
+
+end

data/test/helper.rb

@@ -0,0 +1,18 @@
+require 'rubygems'
+require 'bundler'
+begin
+  Bundler.setup(:default, :development)
+rescue Bundler::BundlerError => e
+  $stderr.puts e.message
+  $stderr.puts "Run `bundle install` to install missing gems"
+  exit e.status_code
+end
+require 'test/unit'
+require 'shoulda'
+
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+require 'restrack-balancer'
+
+class Test::Unit::TestCase
+end

data/test/test_app/config/constants.yaml

@@ -0,0 +1,24 @@
+#GENERATOR-CONST# -DO NOT REMOVE OR CHANGE THIS LINE- Application-Namespace => test_app
+#
+# = constants.yaml
+# This is where RESTRack applications define the constants relevant to their particular
+# application that are used by the RESTRack base classes.
+
+# Application log path definition
+:LOG:                     '/var/log/test_app/test_app.log'
+# Request log path definition
+:REQUEST_LOG:             '/var/log/test_app/test_app.request.log'
+
+# Logger object levels
+:LOG_LEVEL:               :DEBUG
+:REQUEST_LOG_LEVEL:       :DEBUG
+
+# Supported formats are :JSON, :XML, :YAML, :BIN, :TEXT
+:DEFAULT_FORMAT:          :JSON
+# The resource which will handle root level requests where the name is not specified.  Best for users of this not to implement method_missing in their default controller, unless they are checking for bad URI.
+:DEFAULT_RESOURCE:        nil
+
+# These are the resources which can be accessed from the root of your web service. If left empty, all resources are available at the root.
+:ROOT_RESOURCE_ACCEPT:    []
+# These are the resources which cannot be accessed from the root of your web service. Use either this or ROOT_RESOURCE_ACCEPT as a blacklist or whitelist to establish routing (relationships defined in resource controllers define further routing).
+:ROOT_RESOURCE_DENY:      []

data/test/test_app/config.ru

@@ -0,0 +1,3 @@
+# Rails.root/config.ru
+require 'loader'
+run TestApp::WebService.new

data/test/test_app/controllers/parent_controller.rb

@@ -0,0 +1,39 @@
+class TestApp::ParentController < RESTRack::ResourceController
+  
+  has_relationship_to :responses do |id|
+    id
+  end
+
+  def index
+
+  end
+  
+  def create
+
+  end
+
+  def replace
+
+  end
+
+  def destroy
+
+  end
+
+  def show(id)
+
+  end
+
+  def update(id)
+
+  end
+
+  def delete(id)
+
+  end
+
+  def add(id)
+
+  end
+
+end

data/test/test_app/controllers/responses_controller.rb

@@ -0,0 +1,66 @@
+class TestApp::ResponsesController < RESTRack::ResourceController
+
+  def method_missing(method_name, *args)
+    {
+      :method_called => method_name.to_s,
+      :args => args.join(':')
+    }
+  end
+
+  def index
+    {
+      :action => :index
+    }
+  end
+  
+  def create
+    {
+      :action => :create,
+      :data => @input
+    }
+  end
+
+  def replace
+    {
+      :action => :replace,
+      :data => @input
+    }
+  end
+
+  def drop
+    {
+      :action => :destroy
+    }
+  end
+
+  def show(id)
+    {
+      :action => :show,
+      :id => id
+    }
+  end
+
+  def update(id)
+    {
+      :action => :update,
+      :id => id,
+      :data => @input
+    }
+  end
+
+  def destroy(id)
+    {
+      :action => :delete,
+      :id => id
+    }
+  end
+
+  def add(id)
+    {
+      :action => :add,
+      :id => id,
+      :data => @input
+    }
+  end
+
+end

data/test/test_app/loader.rb

@@ -0,0 +1,21 @@
+require 'restrack'
+
+module TestApp; end
+class TestApp::WebService < RESTRack::WebService; end
+
+RESTRack::CONFIG = RESTRack::load_config(File.join(File.dirname(__FILE__), 'config/constants.yaml'))
+RESTRack::CONFIG[:ROOT] = File.dirname(__FILE__)
+
+# Dynamically load all controllers
+Find.find(  File.join(File.dirname(__FILE__), 'controllers') ) do |file|
+  next if File.extname(file) != '.rb'
+  require file
+end
+
+if File.directory?( File.join(File.dirname(__FILE__), 'models') )
+  # Dynamically load all models
+  Find.find(  File.join(File.dirname(__FILE__), 'models') ) do |file|
+    next if File.extname(file) != '.rb'
+    require file
+  end
+end

data/test/test_restrack-balancer.rb

@@ -0,0 +1,170 @@
+require File.join( File.dirname(__FILE__ ), 'helper' )
+
+class TestRESTRackBalancer < Test::Unit::TestCase
+
+  context 'instantiation' do
+    should 'accept a String URI' do
+      assert_nothing_raised { client_1 = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293']) }
+    end
+    should 'accept a URI object' do
+      uri_1 = URI.parse('http://localhost:9292')
+      uri_2 = URI.parse('http://localhost:9293')
+      uri = [uri_1, uri_2]
+      assert_nothing_raised { client_2 = RESTRack::Balancer.new(uri) }
+    end
+  end
+
+  should 'get a resource' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    get_response = nil
+    assert_nothing_raised do
+      get_response = client.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+  end
+  should 'get a collection' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    get_response = nil
+    assert_nothing_raised do
+      get_response = client.responses.get
+    end
+    expected_response = { 'action' => 'index' }
+    assert_equal expected_response, get_response
+  end
+
+  should 'delete a resource' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    delete_response = nil
+    assert_nothing_raised do
+      delete_response = client.responses(1).delete
+    end
+    expected_response = { 'action' => 'delete', 'id' => '1' }
+    assert_equal expected_response, delete_response
+  end
+  should 'delete a collection' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    delete_response = nil
+    assert_nothing_raised do
+      delete_response = client.responses.delete
+    end
+    expected_response = { 'action' => 'destroy' }
+    assert_equal expected_response, delete_response
+  end
+
+  should 'post a resource' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    post_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      post_response = client.responses(1).post(data)
+    end
+    expected_response = { 'action' => 'add', 'id' => '1', 'data' => data }
+    assert_equal expected_response, post_response
+  end
+  should 'post a collection' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    post_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      post_response = client.responses.post(data)
+    end
+    expected_response = { 'action' => 'create', 'data' => data }
+    assert_equal expected_response, post_response
+  end
+
+  should 'put a resource' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    put_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      put_response = client.responses(1).put(data)
+    end
+    expected_response = { 'action' => 'update', 'id' => '1', 'data' => data }
+    assert_equal expected_response, put_response
+  end
+  should 'put a collection' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    put_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      put_response = client.responses.put(data)
+    end
+    expected_response = { 'action' => 'replace', 'data' => data }
+    assert_equal expected_response, put_response
+  end
+
+  should 'send and parse response json data' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'], :JSON)
+    post_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      post_response = client.responses(1).post(data)
+    end
+    expected_response = { 'action' => 'add', 'id' => '1', 'data' => data }
+    assert_equal expected_response, post_response
+  end
+  should 'send and parse response xml data' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'], :XML)
+    post_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      post_response = client.responses(1).post(data)
+    end
+    expected_response = { 'action' => 'add', 'id' => '1', 'data' => data }
+    assert_equal expected_response, post_response
+  end
+  #should 'send and parse response yaml data' do
+  #  client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'], :YAML)
+  #  post_response = nil
+  #  data = {
+  #    'test' => 'data'
+  #  }
+  #  assert_nothing_raised do
+  #    post_response = client.responses(1).post(data)
+  #  end
+  #  expected_response = { 'action' => 'add', 'id' => '1', 'data' => data }
+  #  assert_equal expected_response, post_response
+  #end
+  should 'allow building of request path prior to request' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    object = client.responses(1)
+    assert object.class.to_s, 'RESTRack::Balancer'
+    assert object.const_get(:path), '/responses/1'
+  end
+  should 'pivot' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    object = client.responses(1)
+    get_response = nil
+    assert_nothing_raised do
+      get_response = object.get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+  end
+  should 'walk a relation path to a child resource' do
+    client = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293'])
+    post_response = nil
+    data = {
+      'test' => 'data'
+    }
+    assert_nothing_raised do
+      post_response = client.parent(1).responses.post(data)
+    end
+    expected_response = { 'action' => 'add', 'id' => '1', 'data' => data }
+    assert_equal expected_response, post_response
+  end
+
+end

data/test/test_restrack-balancer_requests.rb

@@ -0,0 +1,62 @@
+require File.join( File.dirname(__FILE__ ), 'helper' )
+
+class TestRESTRackBalancer < Test::Unit::TestCase
+
+  should 'iterate over servers' do
+    used_servers = []
+
+    balancer = RESTRack::Balancer.new(['http://localhost:9292', 'http://localhost:9293', 'http://localhost:9294'])
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    used_servers << balancer.last_client
+    first = balancer.last_client
+
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    assert !used_servers.include?(balancer.last_client)
+    used_servers << balancer.last_client
+    second = balancer.last_client
+
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    assert !used_servers.include?(balancer.last_client)
+    third = balancer.last_client
+
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    assert_equal first, balancer.last_client
+
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    assert_equal second, balancer.last_client
+
+    get_response = nil
+    assert_nothing_raised do
+      get_response = balancer.responses(1).get
+    end
+    expected_response = { 'action' => 'show', 'id' => '1' }
+    assert_equal expected_response, get_response
+    assert_equal third, balancer.last_client
+  end
+
+end

metadata

@@ -0,0 +1,100 @@
+--- !ruby/object:Gem::Specification 
+name: restrack-balancer
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Chris St. John
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-18 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: shoulda
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: restrack-client
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: A library for interacting with RESTful web services.  Use this to communicate with RESTRack based services.
+email: 
+- chris@stjohnstudios.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .document
+- Gemfile
+- LICENSE.txt
+- README.rdoc
+- Rakefile
+- lib/restrack-balancer.rb
+- lib/restrack-balancer/version.rb
+- restrack-balancer.gemspec
+- test/helper.rb
+- test/test_app/config.ru
+- test/test_app/config/constants.yaml
+- test/test_app/controllers/parent_controller.rb
+- test/test_app/controllers/responses_controller.rb
+- test/test_app/loader.rb
+- test/test_restrack-balancer.rb
+- test/test_restrack-balancer_requests.rb
+has_rdoc: true
+homepage: http://github.com/stjohncj/RESTRack-Splitter
+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: restrack-splitter
+rubygems_version: 1.5.2
+signing_key: 
+specification_version: 3
+summary: A library for interacting with RESTful web services.  Use this to communicate with RESTRack based services.
+test_files: 
+- test/helper.rb
+- test/test_app/config.ru
+- test/test_app/config/constants.yaml
+- test/test_app/controllers/parent_controller.rb
+- test/test_app/controllers/responses_controller.rb
+- test/test_app/loader.rb
+- test/test_restrack-balancer.rb
+- test/test_restrack-balancer_requests.rb