watirgrid 0.0.1

data/.document

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

data/.gitignore

@@ -0,0 +1,21 @@
+## MAC OS
+.DS_Store
+
+## TEXTMATE
+*.tmproj
+tmtags
+
+## EMACS
+*~
+\#*
+.\#*
+
+## VIM
+*.swp
+
+## PROJECT::GENERAL
+coverage
+rdoc
+pkg
+
+## PROJECT::SPECIFIC

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 Tim Koopmans
+
+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/NOTES.txt

@@ -0,0 +1,14 @@
+= Release Notes
+== 0.0.1
+Added access control lists for the controller and provider. This lets the user specify ACLs by way of simple white/blacklist security similar to that used by the Unix /etc/hosts.allow and /etc/hosts.deny files. The ACL constructor takes an array of strings. The first string of a pair is always “allow” or “deny”, and it’s followed by the address or addresses to allow or deny access.
+
+e.g. ./provider.rb -a deny,all,allow,127.0.0.1
+This would deny all access to this provider by default and allow access only from the localhost (127.0.0.1). This is the default setting if no ACLs are specified from the command line. This would affect all connectivity from the controller to the providers.
+
+e.g. ./controller.rb -a deny,all,allow,192.168.1.*
+This would deny all access to the controller by default with access allowed from any host in the 192.168.1.* subnet. This would affect all connectivity from the providers to the controller.
+
+---
+
+Added startup bin scripts for the provider and controller. Ruby Gems will automatically deploy these on installation.
+

data/README.rdoc

@@ -0,0 +1,56 @@
+= watirgrid
+
+WatirGrid allows for distributed testing across a grid network using Watir.
+
+Basic instructions are:
+
+Pick a server to host the 'controller' for the ring server and execute the following:
+  $ controller -l INFO
+
+This should find your external facing IP and start the corresponding DRb and Ring Servers:
+  DRb server started on : druby://192.168.1.105:11235
+  Ring server started on: druby://192.168.1.105:12358
+
+On each client PC, host the 'provider' for the distributed (DRb) Watir objects
+  $  provider -l INFO
+
+This should find the recently started Ring Server and register a tuple for the Watir object:
+  DRb server started on : druby://192.168.1.105:64864
+  New tuple registered  : druby://192.168.1.105:12358
+
+You will now be able to execute commands across remote browsers on your grid network.
+
+Check the watirgid_spec.rb for some examples ...
+
+e.g.
+  browsers = Watir::Grid.new(:ring_server_port => 12351)
+	browsers.start(:quantity => 2, :read_all => true)
+	browsers.size.should == 2
+	browsers.each do |browser, browser_id|
+    browser.goto("http://www.google.com")
+    browser.text_field(:name, 'q').set("watirgrid")
+    browser.button(:name, "btnI").click
+  end
+
+For more help see:
+  $  controller -h
+  Usage: controller [options]
+  Specific options:
+    -d, --drb-server-port PORT       Specify DRb Server port to listen on
+    -r, --ring-server-port PORT      Specify Ring Server port to listen on
+    -l, --log-level LEVEL            Specify log level {DEBUG|INFO|ERROR}
+    -h, --help                       Show this message
+    
+  $  ./provider -h
+  Usage: provider [options]
+  Specific options:
+    -r, --ring-server-port PORT      Specify Ring Server port to broadcast on
+    -b, --browser-type TYPE          Specify browser type to register {ie|firefox|safari}
+    -l, --log-level LEVEL            Specify log level {DEBUG|INFO|ERROR}
+    -h, --help                       Show this message
+  
+I'll update the wiki soon'ish!
+
+== Copyright
+
+Copyright (c) 2009 Tim Koopmans. See LICENSE for details.

data/Rakefile

@@ -0,0 +1,44 @@
+require 'rubygems'
+require 'rake'
+
+begin
+  require 'jeweler'
+  Jeweler::Tasks.new do |gem|
+    gem.name = "watirgrid"
+    gem.summary = %Q{WatirGrid: Web Application Testing in Ruby across a grid network.}
+    gem.description = %Q{WatirGrid allows for distributed testing across a grid network using Watir.}
+    gem.email = "tim.koops@gmail.com"
+    gem.homepage = "http://github.com/90kts/watirgrid"
+    gem.authors = ["Tim Koopmans"]
+    gem.add_development_dependency "rspec", ">= 1.2.9"
+    gem.version = "0.0.1"
+    # gem is a Gem::Specification... see http://www.rubygems.org/read/chapter/20 for additional settings
+  end
+rescue LoadError
+  puts "Jeweler (or a dependency) not available. Install it with: sudo gem install jeweler"
+end
+
+require 'spec/rake/spectask'
+Spec::Rake::SpecTask.new(:spec) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+Spec::Rake::SpecTask.new(:rcov) do |spec|
+  spec.libs << 'lib' << 'spec'
+  spec.pattern = 'spec/**/*_spec.rb'
+  spec.rcov = true
+end
+
+task :spec => :check_dependencies
+
+task :default => :spec
+
+require 'rake/rdoctask'
+Rake::RDocTask.new do |rdoc|
+  version = File.exist?('VERSION') ? File.read('VERSION') : ""
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title = "watirgrid #{version}"
+  rdoc.rdoc_files.include('README*')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/TODO.txt

@@ -0,0 +1,16 @@
+== Docs
+better instructions in general
+
+== Providers
+Remote registration of providers
+Re-write tuple space during tear down
+Response times
+Network breakdown times
+
+== Protocol
+Support for tcp or http?
+
+== Tests
+How many providers is suitable with druby
+Comparison in performance with proxied objects (DRbUndumped) vs. copied objects
+

data/bin/controller

@@ -0,0 +1,49 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'controller'
+require 'provider'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: controller [options]"
+  opts.separator ""
+  opts.separator "Specific options:"
+  opts.on("-d PORT", "--drb-server-port", Integer, 
+    "Specify DRb Server port to listen on") do |d|
+      options[:drb_server_port] = d
+  end              
+  opts.on("-r PORT", "--ring-server-port", Integer, 
+    "Specify Ring Server port to listen on") do |r|
+      options[:ring_server_port] = r 
+  end
+  opts.on("-a ACLS", "--access-control-list", Array,
+    "Specify a comma separated Access Control List") do |a|
+      options[:acls] = a
+  end
+  opts.on("-l LEVEL", "--log-level", String, 
+    "Specify log level {DEBUG|INFO|ERROR}") do |l|
+      case l
+      when 'DEBUG'
+        options[:loglevel] = Logger::DEBUG
+      when 'INFO'
+        options[:loglevel] = Logger::INFO 
+      when 'ERROR'
+        options[:loglevel] = Logger::ERROR
+      else
+        options[:loglevel] = Logger::ERROR
+      end
+  end
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end          
+  end.parse!
+
+controller = Controller.new(
+  :drb_server_port  => options[:drb_server_port]  || 11235, 
+  :ring_server_port => options[:ring_server_port] || 12358,
+  :acls => options[:acls] || %w{ deny all allow 127.0.0.1 },
+  :loglevel => options[:loglevel]
+)
+controller.start
+DRb.thread.join

data/bin/provider

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'controller'
+require 'provider'
+
+options = {}
+OptionParser.new do |opts|
+  opts.banner = "Usage: provider [options]"
+  opts.separator ""
+  opts.separator "Specific options:"
+  opts.on("-r PORT", "--ring-server-port", Integer, 
+  "Specify Ring Server port to broadcast on") do |r|
+    options[:ring_server_port] = r 
+  end
+  opts.on("-b TYPE", "--browser-type", String, 
+  "Specify browser type to register {ie|firefox|safari}") do |b|
+    options[:browser_type] = b 
+  end
+  opts.on("-a ACLS", "--access-control-list", Array,
+    "Specify a comma separated Access Control List") do |a|
+      options[:acls] = a
+  end
+  opts.on("-l LEVEL", "--log-level", String, 
+  "Specify log level {DEBUG|INFO|ERROR}") do |l|
+    case l
+    when 'DEBUG'
+      options[:loglevel] = Logger::DEBUG
+    when 'INFO'
+      options[:loglevel] = Logger::INFO 
+    when 'ERROR'
+      options[:loglevel] = Logger::ERROR
+    else
+      options[:loglevel] = Logger::ERROR
+    end
+  end
+  opts.on_tail("-h", "--help", "Show this message") do
+    puts opts
+    exit
+  end          
+end.parse!
+
+provider = Provider.new(
+  :ring_server_port => options[:ring_server_port] || 12358,
+  :browser_type => options[:browser_type] || nil,
+  :acls => options[:acls] || %w{ deny all allow 127.0.0.1 },
+  :loglevel => options[:loglevel])
+provider.start
+DRb.thread.join

data/lib/controller.rb

@@ -0,0 +1,101 @@
+#!/usr/bin/env ruby 
+# controller.rb
+# Rinda Ring Server Controlller
+
+require 'rubygems'
+require 'rinda/tuplespace'
+require 'rinda/ring'
+require 'logger'
+require 'optparse'
+require 'drb/acl'
+
+module Rinda
+
+  ##
+  # Extend Rinda::RingServer to allow a hostname/ipaddress
+  # to be passed in as parameter arguments. Also pass back
+  # attribute for ring server uri.
+  #
+  class RingServer
+    attr_accessor :uri
+
+    def initialize(ts, host='', port=Ring_PORT)
+      @uri = "druby://#{host}:#{port}"
+      @ts = ts
+      @soc = UDPSocket.open
+      @soc.bind(host, port)
+      @w_service = write_service
+      @r_service = reply_service
+    end
+  end
+end
+
+class Controller
+
+  attr_accessor :drb_server_uri, :ring_server_uri
+
+  def initialize(params = {})    
+    @host = params[:interface]  || external_interface
+    @drb_server_port  = params[:drb_server_port]  || 0
+    @ring_server_port = params[:ring_server_port] || Rinda::Ring_PORT
+    @acls = params[:acls]
+
+    logfile = params[:logfile] || STDOUT
+    @log  = Logger.new(logfile, 'daily')
+    @log.level = params[:loglevel] || Logger::INFO
+    @log.datetime_format = "%Y-%m-%d %H:%M:%S "    
+
+    @log.debug("DRB Server Port #{@drb_server_port}\nRing Server Port #{@ring_server_port}")
+  end
+
+  ##
+  # Start a new tuplespace on the ring server
+  def start  
+    # create a parent Tuple Space
+    tuple_space = Rinda::TupleSpace.new
+
+    # Setup the security--remember to call before DRb.start_service()
+    DRb.install_acl(ACL.new(@acls))
+
+    # start the DRb Server
+    drb_server = DRb.start_service("druby://#{@host}:#{@drb_server_port}", tuple_space)  
+
+    # obtain DRb Server uri
+    @drb_server_uri = drb_server.uri
+    @log.info("DRb server started on : #{@drb_server_uri}")
+
+    # start the Ring Server
+    ring_server = Rinda::RingServer.new(tuple_space, @host, @ring_server_port)
+
+    # obtain Ring Server uri
+    @ring_server_uri = ring_server.uri  
+    @log.info("Ring server started on: #{@ring_server_uri}")
+
+    # abort all threads on an exception
+    Thread.abort_on_exception = true
+
+    # wait for explicit stop via ctrl-c
+    DRb.thread.join if __FILE__ == $0   
+  end
+
+  ##
+  # Stop the controller by shutting down the DRb service
+  def stop    
+    DRb.stop_service
+    @log.info("DRb server stopped on: #{@drb_server_uri}")    
+  end
+
+  private
+
+  ##
+  # Get the external facing interface for this server  
+  def external_interface    
+    begin
+      UDPSocket.open {|s| s.connect('watir.com', 1); s.addr.last }      
+    rescue
+      '127.0.0.1'
+    end
+  end
+
+end
+

data/lib/provider.rb

@@ -0,0 +1,156 @@
+#!/usr/bin/env ruby 
+# provider.rb
+# Rinda Ring Provider
+
+require 'rubygems'
+require 'rinda/ring'
+require 'rinda/tuplespace'
+require 'logger'
+require 'optparse'
+require 'drb/acl'
+
+begin
+    require 'watir'
+rescue LoadError
+end
+
+begin
+    require 'safariwatir'
+rescue LoadError
+end
+
+begin
+    require 'firewatir'
+    include FireWatir
+rescue LoadError
+end
+
+module Watir
+  
+  ##
+  # Extend Watir with a Provider class
+  # to determine which browser type is supported by the 
+  # remote DRb process. This returns the DRb front object.
+  class Provider
+
+    include DRbUndumped # all objects will be proxied, not copied
+
+    attr_reader :browser
+
+    def initialize(browser = nil)
+      browser = (browser || 'tmp').downcase.to_sym  
+      case browser
+        when :safari
+          @browser = Watir::Safari
+        when :firefox
+          @browser = FireWatir::Firefox 
+        when :ie
+          @browser = Watir::IE
+        else
+          @browser = find_supported_browser
+      end    
+    end
+
+    def find_supported_browser
+      if Watir::Safari then return Watir::Safari end
+      if Watir::IE then return Watir::IE end
+      if FireWatir::Firefox then return FireWatir::Firefox end
+    end
+
+    def new_browser   
+      if @browser.nil?
+        find_supported_browser.new
+      else
+        @browser.new
+      end 
+    end 
+
+  end
+
+end
+
+class Provider
+
+  attr_accessor :drb_server_uri, :ring_server_uri
+
+  def initialize(params = {})   
+    @host = params[:interface]  || external_interface
+    @drb_server_port  = params[:drb_server_port]  || 0
+    @ring_server_port = params[:ring_server_port] || Rinda::Ring_PORT
+
+    @renewer = params[:renewer] || Rinda::SimpleRenewer.new
+    @browser_type = params[:browser_type] || nil
+
+    logfile = params[:logfile] || STDOUT
+    @log  = Logger.new(logfile, 'daily')
+    @log.level = params[:loglevel] || Logger::INFO
+    @log.datetime_format = "%Y-%m-%d %H:%M:%S "   
+
+    @log.debug("DRB Server Port #{@drb_server_port}\nRing Server Port #{@ring_server_port}")
+  end  
+
+  ##
+  # Start providing watir objects on the ring server  
+  def start
+    # create a DRb 'front' object
+    watir_provider = Watir::Provider.new(@browser_type)
+    architecture = Config::CONFIG['arch']
+    hostname = ENV['SERVER_NAME'] || %x{hostname}.strip
+
+    # Setup the security--remember to call before DRb.start_service()
+    DRb.install_acl(ACL.new(@acls))
+
+    # start the DRb Server
+    drb_server = DRb.start_service("druby://#{@host}:#{@drb_server_port}")  
+
+    # obtain DRb Server uri
+    @drb_server_uri = drb_server.uri
+    @log.info("DRb server started on : #{@drb_server_uri}")
+
+    # create a service tuple
+    @tuple = [
+                :name, 
+                :WatirProvider, 
+                watir_provider, 
+                'A watir provider', 
+                hostname,
+                architecture,
+                @browser_type
+              ]   
+
+    # locate the Rinda Ring Server via a UDP broadcast
+    ring_server = Rinda::RingFinger.new(@host, @ring_server_port)
+    ring_server = ring_server.lookup_ring_any
+    @log.info("Ring server found on : druby://#{@host}:#{@ring_server_port}")
+
+    # advertise this service on the primary remote tuple space
+    ring_server.write(@tuple, @renewer)
+
+    # log DRb server uri
+    @log.info("New tuple registered  : druby://#{@host}:#{@ring_server_port}")
+
+    # wait for explicit stop via ctrl-c
+    DRb.thread.join if __FILE__ == $0  
+  end
+
+  ##
+  # Stop the provider by shutting down the DRb service
+  def stop    
+    DRb.stop_service
+    @log.info("DRb server stopped on : #{@drb_server_uri}")    
+  end
+
+  private
+
+  ##
+  # Get the external facing interface for this server  
+  def external_interface    
+    begin
+      UDPSocket.open {|s| s.connect('watir.com', 1); s.addr.last }      
+    rescue
+      '127.0.0.1'
+    end
+  end
+
+end
+

data/lib/watirgrid.rb

@@ -0,0 +1,123 @@
+require 'rubygems'
+require 'controller'
+require 'provider'
+
+module Watir
+
+  ##
+  # Extend Watir with a Grid class which 
+  # implements a grid of browsers by connecting to a tuplespace
+  # and instatiating remote browser objects on nominated providers.
+  class Grid
+
+    attr_accessor :drb_server_uri, :ring_server, :browsers
+
+    def initialize(params = {})   
+      @host = params[:interface]  || external_interface
+      @drb_server_port  = params[:drb_server_port]  || 0
+      @ring_server_port = params[:ring_server_port] || Rinda::Ring_PORT
+      @renewer = params[:renewer] || Rinda::SimpleRenewer.new
+
+      @quantity = params[:quantity]
+
+      logfile = params[:logfile] || STDOUT
+      @log  = Logger.new(logfile, 'daily')
+      @log.level = params[:loglevel] || Logger::ERROR
+      @log.datetime_format = "%Y-%m-%d %H:%M:%S "   
+    end
+
+    ##
+    # Start required services
+    def start(params = {})
+      start_drb_server
+      find_ring_server
+      get_tuples(params)
+    end
+
+    ##
+    # Yield a browser object when iterating over the grid of browsers
+    def each
+      threads = []
+      id = 0
+      @browsers.each do |browser|
+        threads << Thread.new do 
+          id += 1
+          yield(browser, id)
+        end
+      end
+      threads.each {|thread| thread.join}
+    end
+
+    ##
+    # Return the size (quantity) of browsers started on the grid
+    def size
+      @browsers.size
+    end
+
+    private
+
+    ##
+    # Get the external facing interface for this server  
+    def external_interface    
+      begin
+        UDPSocket.open {|s| s.connect('watir.com', 1); s.addr.last }      
+      rescue
+        '127.0.0.1'
+      end
+    end
+
+    ##
+    # Start the DRb Server
+    def start_drb_server
+      drb_server = DRb.start_service("druby://#{@host}:#{@drb_server_port}")  
+      @drb_server_uri = drb_server.uri
+      @log.info("DRb server started on : #{@drb_server_uri}")
+    end
+
+    ##
+    # Locate the Rinda Ring Server via a UDP broadcast
+    def find_ring_server
+      @ring_server = Rinda::RingFinger.new(@host, @ring_server_port)
+      @ring_server = @ring_server.lookup_ring_any
+      @log.info("Ring server found on : druby://#{@host}:#{@ring_server_port}")
+    end
+
+    ##
+    # Get all tuple spaces on ringserver
+    def get_tuples(params = {})
+      quantity = params[:quantity] || -1
+      architecture = params[:architecture] || nil
+      browser_type = params[:browser_type] || nil
+      
+      @browsers = []
+      services = @ring_server.read_all([
+        :name,
+        nil, # watir provider
+        nil, # browser front object
+        nil, # provider description
+        nil, # hostname
+        architecture,
+        browser_type])
+
+      @log.info("Found #{services.size} services.")
+      if services.size > 0 then
+        services[1..quantity].each do |service|
+          hostname = service[4]
+          if params[:hostnames] then
+            if params[:hostnames][hostname] then
+              @browsers << service[2].new_browser
+              @ring_server.take(service)if params[:take_all] == true
+            end
+          else
+            @browsers << service[2].new_browser
+            @ring_server.take(service)if params[:take_all] == true
+          end
+        end
+      else
+        @browsers
+      end
+    end
+  end
+
+end
+

data/spec/grid_spec.rb

@@ -0,0 +1,121 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe 'WatirGrid' do
+  before(:all) do
+    controller = Controller.new(:ring_server_port => 12351,
+      :loglevel => Logger::ERROR)
+    controller.start
+    1.upto(5) do 
+      provider = Provider.new(:ring_server_port => 12351, 
+        :loglevel => Logger::ERROR, :browser_type => 'safari')
+      provider.start
+    end
+  end
+
+  it 'should return how many browsers are available in the tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:read_all => true)
+    browsers.size.should == 4
+  end
+
+  it 'should read any 2 browsers in the tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 2, :read_all => true)
+    browsers.size.should == 2
+    browsers.each do |browser, browser_id|
+      browser.goto(
+        "http://localhost:4567/load/#{browser_id}/#{browser.object_id}")
+    end
+  end
+
+  it 'should take any 1 browser in the tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1, :take_all => true)
+    browsers.size.should == 1 
+  end
+
+  it 'should take all browsers remaining in tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:take_all => true)
+    browsers.size.should == 3
+  end
+
+  it 'should find no more browsers in the tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:read_all => true)
+    browsers.size.should == 0
+  end
+
+  it 'should register 3 new browsers in the tuplespace' do
+    1.upto(3) do 
+      provider = Provider.new(:ring_server_port => 12351, 
+        :loglevel => Logger::ERROR, :browser_type => 'safari')
+      provider.start
+    end
+  end
+
+  it 'should take any 1 browser based on browser type' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1,
+      :take_all => true, :browser_type => 'safari')
+    browsers.size.should == 1
+  end
+
+  it 'should fail to find any browsers based on a specific browser type' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1,
+      :take_all => true, :browser_type => 'firefox')
+    browsers.size.should == 0
+  end
+
+  it 'should fail to find any browsers based on a unknown browser type' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1,
+      :take_all => true, :browser_type => 'penguin')
+    browsers.size.should == 0
+  end
+
+  it 'should take any 1 browser based on specific architecture type' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1, 
+      :take_all => true, :architecture => 'universal-darwin10.0')
+    browsers.size.should == 1
+  end
+
+  it 'should fail to find any browsers based on unknown architecture type' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1, 
+      :take_all => true, :architecture => 'geos-1992')
+    browsers.size.should == 0
+  end
+
+  it 'should take any 1 browser based on specific hostname' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1,
+      :take_all => true, :hostnames => { 
+        "90kts.local" => "127.0.0.1"})
+    browsers.size.should == 1
+  end
+
+  it 'should fail to find any browsers based on unknown hostname' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:quantity => 1,
+      :take_all => true, :hostnames => { 
+        "tokyo" => "127.0.0.1"})
+    browsers.size.should == 0
+  end
+
+  it 'should find no more browsers in the tuplespace' do
+    browsers = Watir::Grid.new(:ring_server_port => 12351)
+    browsers.start(:read_all => true)
+    browsers.size.should == 0
+  end
+
+  it 'should register a new browser on a remote provider' do
+    pending('provision of remote registration') do
+      browsers.size.should == 0
+    end
+  end
+
+end
+

data/spec/spec.opts

@@ -0,0 +1 @@
+--color

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__))
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'watirgrid'
+require 'spec'
+require 'spec/autorun'
+
+Spec::Runner.configure do |config|
+  
+end

data/spec/stub.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require 'sinatra'
+
+get '/load/:browser_id/:browser_object_id' do
+  params[:browser_object_id]
+end
+

data/spec/watirgrid_spec.rb

@@ -0,0 +1,42 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe Controller do
+  it 'should start a DRb and Ring Server when specifying NO interface or port' do
+    controller = Controller.new
+    controller.start
+    controller.drb_server_uri.should =~ /druby/
+    controller.stop
+  end
+
+  it 'should start a DRb and Ring Server on a specified interface' do
+    controller = Controller.new(:interface => '127.0.0.1')
+    controller.start
+    controller.drb_server_uri.should =~ /druby/
+    controller.stop
+  end
+
+  it 'should start a DRb and Ring Server on specified ports' do
+    controller = Controller.new(:drb_server_port => 11235, 
+      :ring_server_port => 12358)
+    controller.start
+    controller.drb_server_uri.should =~ /druby/
+    controller.stop
+  end
+end
+
+describe Provider do
+  before(:all) do
+    @controller = Controller.new(:ring_server_port => 12350)
+    @controller.start
+  end
+
+  it 'should register a new provider on a specified port' do
+    provider = Provider.new(:ring_server_port => 12350)
+    provider.start
+  end
+
+  after(:all) do
+    @controller.stop
+  end
+end
+

data/watirgrid.gemspec

@@ -0,0 +1,59 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{watirgrid}
+  s.version = ""
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Tim Koopmans"]
+  s.date = %q{2009-11-05}
+  s.description = %q{WatirGrid allows for distributed testing across a grid network using Watir.}
+  s.email = %q{tim.koops@gmail.com}
+  s.extra_rdoc_files = [
+    "LICENSE",
+     "README.rdoc"
+  ]
+  s.files = [
+    ".document",
+     ".gitignore",
+     "LICENSE",
+     "README.rdoc",
+     "Rakefile",
+     "lib/controller.rb",
+     "lib/extend.rb",
+     "lib/provider.rb",
+     "lib/watirgrid.rb",
+     "spec/spec.opts",
+     "spec/spec_helper.rb",
+     "spec/tuple_spec.rb",
+     "spec/watirgrid_spec.rb",
+     "watirgrid.gemspec"
+  ]
+  s.homepage = %q{http://github.com/90kts/watirgrid}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{WatirGrid: Web Application Testing in Ruby across a grid network.}
+  s.test_files = [
+    "spec/spec_helper.rb",
+     "spec/tuple_spec.rb",
+     "spec/watirgrid_spec.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_development_dependency(%q<rspec>, [">= 1.2.9"])
+    else
+      s.add_dependency(%q<rspec>, [">= 1.2.9"])
+    end
+  else
+    s.add_dependency(%q<rspec>, [">= 1.2.9"])
+  end
+end
+

metadata

@@ -0,0 +1,86 @@
+--- !ruby/object:Gem::Specification 
+name: watirgrid
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Tim Koopmans
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-11-16 00:00:00 +11:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: WatirGrid allows for distributed testing across a grid network using Watir.
+email: tim.koops@gmail.com
+executables: 
+- controller
+- provider
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- .document
+- .gitignore
+- LICENSE
+- NOTES.txt
+- README.rdoc
+- Rakefile
+- TODO.txt
+- bin/controller
+- bin/provider
+- lib/controller.rb
+- lib/provider.rb
+- lib/watirgrid.rb
+- spec/grid_spec.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/stub.rb
+- spec/watirgrid_spec.rb
+- watirgrid.gemspec
+has_rdoc: true
+homepage: http://github.com/90kts/watirgrid
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: "WatirGrid: Web Application Testing in Ruby across a grid network."
+test_files: 
+- spec/grid_spec.rb
+- spec/spec_helper.rb
+- spec/stub.rb
+- spec/watirgrid_spec.rb