selenium-grid 0.0.2

data/History.txt

@@ -0,0 +1,12 @@
+=== 0.0.2 / 2008-10-03
+
+* 1 major enhancement
+
+  * selenium-grid path fix
+
+=== 0.0.1 / 2008-10-01
+
+* 1 major enhancement
+
+  * Initial development
+

data/Manifest.txt

@@ -0,0 +1,35 @@
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/selenium-grid
+config/hoe.rb
+config/requirements.rb
+lib/extensions.rb
+lib/extensions/file.rb
+lib/extensions/rake.rb
+lib/extensions/string.rb
+lib/java.rb
+lib/java/classpath.rb
+lib/java/vm.rb
+lib/openqa/selenium-grid-hub-standalone-1.0.1.jar
+lib/openqa/selenium-grid-remote-control-standalone-1.0.1.jar
+lib/openqa/selenium-server-1.0-SNAPSHOT.jar
+lib/selenium-grid.rb
+lib/selenium-grid/hub.rb
+lib/selenium-grid/remote.rb
+lib/selenium-grid/version.rb
+lib/tasks/hoe.rake
+lib/tasks/hub.rake
+lib/tasks/rc.rake
+lib/tasks/rspec.rake
+spec/extensions/string_spec.rb
+spec/extensions_spec_suite.rb
+spec/java/vm_spec.rb
+spec/java_spec_suite.rb
+spec/selenium-grid/hub_spec.rb
+spec/selenium-grid/remote_spec.rb
+spec/selenium-grid_spec_suite.rb
+spec/spec.opts
+spec/spec_helper.rb
+spec/spec_suite.rb

data/README.txt

@@ -0,0 +1,32 @@
+= selenium-grid
+
+* http://github.com/pivotal/selenium-grid/
+
+== Selenium Grid Ruby
+
+Selenium Grid Ruby packages Selenium Grid as a RubyGem.
+
+== About Selenium Grid
+
+From the website (http://selenium-grid.openqa.org/):
+
+  Selenium Grid is a tool that dramatically speeds up functional testing of 
+  web-apps by leveraging your existing computing infrastructure. It allows you
+  to easily run multiple tests in parallel, on multiple machines, in an
+  heterogeneous enviroment.
+
+== Usage:
+
+  rake hub:start [options]
+  rake hub:stop
+  rake rc:start [options]
+  rake rc:stop [options]
+
+== Installation:
+
+* sudo gem install selenium-grid
+
+== Thanks:
+
+* Philippe Hanrigou (http://github.com/ph7/)
+* Brian Takita (http://github.com/btakita/)

data/Rakefile

@@ -0,0 +1,8 @@
+require 'config/requirements'
+require 'config/hoe'
+require 'rake'
+
+Dir['lib/tasks/**/*.rake'].each { |rake| load rake }
+
+Rake.application.clean(:default, :test, :test_deps)
+task :default => 'spec'

data/bin/selenium-grid

@@ -0,0 +1,112 @@
+#!/usr/bin/env ruby
+require 'rubygems'
+require 'optparse'
+require 'ostruct'
+require 'pp'
+require File.join(File.dirname(__FILE__), '..', 'config', 'requirements')
+
+include SeleniumGrid
+
+class SeleniumGridOptions
+  def initialize
+    @options = {}
+    @opts = initialize_options
+  end
+  
+  def parse(args)
+    begin
+      @opts.parse!(args)
+    rescue
+      summarize
+      exit
+    end
+    @options
+  end
+  
+  def summarize
+    puts @opts.banner
+    puts @opts.summarize
+    puts ""
+  end
+end
+
+class HubStartOptions < SeleniumGridOptions
+
+  protected
+  
+  def initialize_options
+    return OptionParser.new do |opts|
+      opts.banner = "hub:start"
+      
+      opts.on('-b', '--background', 'send the process to the background') do
+        @options[:background] = true
+      end
+    end
+  end
+end
+
+class RcStartOptions < SeleniumGridOptions
+  ENVIRONMENTS = %w(*chrome *firefox *safari *ie)
+
+  protected
+  
+  def initialize_options
+    return OptionParser.new do |opts|
+      opts.banner = "rc:start"
+      
+      opts.on('-b', '--background', 'send the process to the background') do
+        @options[:background] = true
+      end
+      opts.on('-e', '--environment <browser>', ENVIRONMENTS, "browser environment to launch", "\tbrowsers:\t#{ENVIRONMENTS.join(', ')}", "\tdefault:\t#{Remote::DEFAULT_BROWSER}") do |env|
+        @options[:env] = env
+      end
+      opts.on('-p', '--port <port>', "port to launch the remote control on", "\tdefault:\t#{Remote::DEFAULT_PORT}") do |port|
+        @options[:port] = port
+      end
+      opts.on('-h', '--host <name>', "hostname to launch the remote control on", "\tdefault:\t#{Remote::DEFAULT_HOST}") do |host|
+        @options[:host] = host
+      end
+      opts.on('-u', '--hub_url <url>', "hub url where the remote control points", "\tdefault:\t#{Remote::DEFAULT_HUB_URL}") do |hub_url|
+        @options[:hub_url] = hub_url
+      end
+      opts.on('-s', '--selenium_args "<args>"', "selenium arguments to pass through") do |selenium_args|
+        @options[:selenium_args] = selenium_args
+      end
+    end
+  end
+end
+
+class RcStopOptions < SeleniumGridOptions
+
+  protected
+  
+  def initialize_options
+    return OptionParser.new do |opts|
+      opts.banner = "rc:stop"
+      
+      opts.on('-p', '--port <port>', "port where the remote control is listening", "\tdefault:\t#{Remote::DEFAULT_PORT}") do |port|
+        @options[:port] = port
+      end
+    end
+  end
+end
+
+case ARGV.first
+  when 'hub:start':
+    options = HubStartOptions.new.parse(ARGV)
+    Hub.instance.start(options)
+  when 'hub:stop':
+    Hub.instance.stop
+  when 'rc:start':
+    options = RcStartOptions.new.parse(ARGV)
+    Remote.instance.start(options)
+  when 'rc:stop':
+    options = RcStopOptions.new.parse(ARGV)
+    Remote.instance.stop(options)
+  else
+    puts "Usage: selenium-grid <hub:start|hub:stop|rc:start|rc:stop> [options]"
+    puts ""
+    HubStartOptions.new.summarize
+    RcStartOptions.new.summarize
+    RcStopOptions.new.summarize
+end

data/config/hoe.rb

@@ -0,0 +1,66 @@
+AUTHOR = ['Ryan Dy', 'Corey Innis']
+EMAIL = "ops+rubyforge@pivotallabs.com"
+DESCRIPTION = "Selenium Grid Ruby packages Selenium Grid as a gem"
+GEM_NAME = 'selenium-grid'
+
+RUBYFORGE_PROJECT = 'selenium-grid'
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+DOWNLOAD_PATH = "http://rubyforge.org/projects/#{RUBYFORGE_PROJECT}"
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+RUBYFORGE_USERNAME = "unknown"
+def rubyforge_username
+  unless @config
+    begin
+      @config = YAML.load(File.read(File.expand_path(@config_file)))
+    rescue
+      puts <<-EOS
+ERROR: No rubyforge config file found: #{@config_file}"
+Run 'rubyforge setup' to prepare your env for access to Rubyforge
+ - See http://newgem.rubyforge.org/rubyforge.html for more details
+      EOS
+      exit
+    end
+  end
+  RUBYFORGE_USERNAME.replace @config["username"]
+end
+
+RDOC_OPTS = ['--quiet', '--title', 'selenium-grid documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject! { |x| Array(x).first == 'hoe' } 
+    @extra_deps
+  end 
+end
+
+# Generate all the Rake tasks
+# Run 'rake -T' to see list of generated tasks (from gem root directory)
+hoe = Hoe.new(GEM_NAME, SeleniumGrid::VERSION::STRING) do |p|
+  p.author = AUTHOR
+  p.email = EMAIL
+  p.description = DESCRIPTION
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT
+  p.test_globs = ["spec/**/*_spec.rb"]
+  p.clean_globs |= ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']
+  p.extra_deps = [
+                    ["rake", ">=0.8.1"],
+                    ["hoe", ">=1.7.0"],
+                    ["newgem", ">=0.23.1"],
+                    ["lsof", ">=0.3.0"]
+                  ]
+
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\\n\\n")
+end
+
+CHANGES = hoe.paragraphs_of('History.txt', 0..1).join("\\n\\n")
+PATH    = (RUBYFORGE_PROJECT == GEM_NAME) ? RUBYFORGE_PROJECT : "#{RUBYFORGE_PROJECT}/#{GEM_NAME}"
+hoe.remote_rdoc_dir = File.join(PATH.gsub(/^#{RUBYFORGE_PROJECT}\/?/,''), 'rdoc')

data/config/requirements.rb

@@ -0,0 +1,27 @@
+require 'fileutils'
+include FileUtils
+
+require 'rubygems'
+%w(rake hoe newgem lsof).each do |req_gem|
+  begin
+    require req_gem
+  rescue LoadError
+    puts "This Rakefile requires the '#{req_gem}' RubyGem."
+    puts "Installation: gem install #{req_gem} -y"
+    exit
+  end
+end
+
+$:.unshift(File.join(File.dirname(__FILE__), %w(.. lib)))
+
+def require_path(path_from_base)
+  basedir = File.join(File.dirname(__FILE__), '..')
+
+  Dir[File.join(basedir, path_from_base)].each do |file|
+    require file
+  end
+end
+
+require 'extensions'
+require 'java'
+require 'selenium-grid'

data/lib/extensions.rb

@@ -0,0 +1 @@
+require_path '/lib/extensions/**/*.rb'

data/lib/extensions/file.rb

@@ -0,0 +1,7 @@
+class File
+  def self.native_path(path)
+    expanded_path = File.expand_path(path)
+    expanded_path.gsub!('/', '\\') if RUBY_PLATFORM['win32']
+    expanded_path
+  end
+end

data/lib/extensions/rake.rb

@@ -0,0 +1,14 @@
+require "rake"
+
+module Rake
+  module TaskManager
+    def task_hash
+      @tasks
+    end
+    
+    def clean(*names)
+      names.each { |name| self.task_hash.delete(name.to_s) }
+    end
+  end
+end
+

data/lib/extensions/string.rb

@@ -0,0 +1,18 @@
+class String
+  
+  def camelize(first_letter_in_uppercase = true)
+    first_letter_in_uppercase = false if first_letter_in_uppercase == :lower
+    if first_letter_in_uppercase
+      self.gsub(/\/(.?)/) { "::#{$1.upcase}" }.gsub(/(?:^|_)(.)/) { $1.upcase }
+    else
+      self.first + self.camelize[1..-1]
+    end
+  end
+
+  protected
+  
+  def first
+    self[0, 1]
+  end
+
+end

data/lib/java.rb

@@ -0,0 +1 @@
+require_path '/lib/java/**/*.rb'

data/lib/java/classpath.rb

@@ -0,0 +1,26 @@
+require_path "/lib/extensions/file.rb"
+
+module Java
+  class Classpath
+    require 'pathname'
+
+    def initialize(root_dir)
+      @root = root_dir
+      @locations = []
+      self
+    end
+
+    def <<(paths)
+      @locations = (@locations << Dir[@root + '/' + paths]).flatten
+      self
+    end
+
+    def definition
+      @locations.map {|path| File.native_path(path)}.join(self.separator)
+    end
+
+    def separator
+     PLATFORM['win32'] ? ";" : ":"
+    end
+  end
+end

data/lib/java/vm.rb

@@ -0,0 +1,60 @@
+require_path "/lib/extensions/file.rb"
+
+module Java
+  class VM
+    def run(classname, options = {})
+      command = [ "java" ]
+      include_classpath(command, options)
+      command << classname
+      include_settings(command, options)
+      include_arguments(command, options)
+      include_background(command, options)
+      include_log(command, options)
+
+      sh command.compact.join(' ')
+    end
+    
+    private
+    
+    def include_arguments(command, options)
+      if options[:arguments]
+        command << options[:arguments].collect do |key, value|
+          if key == :selenium_args
+            value.to_s
+          else  
+            "-#{key.to_s.camelize(:lower)} #{value}".sort.join(' ')
+          end
+        end
+      end
+    end
+    
+    def include_background(command, options)
+      if options[:background]
+        if RUBY_PLATFORM['win32']
+          command.unshift('start')
+        else
+          command << '&'
+        end
+      end
+    end
+    
+    def include_classpath(command, options)
+      if options[:classpath]
+        command << "-cp '#{options[:classpath]}'"
+      end
+    end
+    
+    def include_log(command, options)
+      if options[:log]
+        command << "> '#{options[:log]}' 2>&1"
+        mkdir_p File.dirname(options[:log])
+      end
+    end
+    
+    def include_settings(command, options)
+      if options[:settings]
+        command << options[:settings].collect { |key, value| "-D#{key}=#{value}" }.join(' ')
+      end
+    end
+  end
+end

data/lib/selenium-grid.rb

@@ -0,0 +1 @@
+require_path '/lib/selenium-grid/**/*.rb'

data/lib/selenium-grid/hub.rb

@@ -0,0 +1,28 @@
+require 'singleton'
+
+module SeleniumGrid
+  class Hub
+    include Singleton
+
+    HUB_PORT=4444
+
+    def start(overrides = {})
+      classpath = Java::Classpath.new(File.join(File.dirname(__FILE__), %w(.. ..)))
+      classpath = classpath << "." << "lib/openqa/selenium-grid-hub-standalone-*.jar"
+
+      requirements = {
+        :classpath => classpath.definition,
+        :log => File.join(File.dirname(__FILE__), "..", "..", "log", "hub.log")
+      }
+      options = {
+        :background => ENV['BACKGROUND'] || false,
+      }.merge(overrides).merge(requirements)
+
+      Java::VM.new.run "com.thoughtworks.selenium.grid.hub.HubServer", options
+    end
+
+    def stop
+      Lsof.kill(HUB_PORT)
+    end
+  end
+end

data/lib/selenium-grid/remote.rb

@@ -0,0 +1,46 @@
+require 'singleton'
+
+module SeleniumGrid
+  class Remote
+    include Singleton
+    
+    DEFAULT_BROWSER = "*chrome"
+    DEFAULT_PORT = 5555
+    DEFAULT_HOST = "localhost"
+    DEFAULT_HUB_URL = "http://#{DEFAULT_HOST}:#{Hub::HUB_PORT}",
+  
+    def start(overrides = {})
+      classpath = Java::Classpath.new(File.join(File.dirname(__FILE__), %w(.. ..)))
+      classpath =  classpath << "." << "lib/openqa/selenium-server-*.jar" << "lib/openqa/selenium-grid-remote-control-standalone-*.jar"
+      args = arguments(overrides.reject { |key, value| key == :background })
+      
+      options = {
+       :classpath => classpath.definition,
+       :log => File.join(File.dirname(__FILE__), "..", "..", "log", "rc-#{args[:port]}.log"),
+       :arguments => args,
+       :background => overrides[:background] || ENV['BACKGROUND'] || false,
+      }
+
+      Java::VM.new.run "com.thoughtworks.selenium.grid.remotecontrol.SelfRegisteringRemoteControlLauncher", options
+    end
+      
+    def stop(overrides = {})
+      options = {
+        :port => ENV['PORT'] || DEFAULT_PORT
+      }.merge(overrides)
+      Lsof.kill(options[:port].to_i)
+    end
+
+    def arguments(overrides = {})
+      options = {
+        :host => ENV['HOST'] || DEFAULT_HOST,
+        :port => ENV['PORT'] || DEFAULT_PORT,
+        :hub_url => ENV['HUB_URL'] || DEFAULT_HUB_URL,
+        :env => ENV['ENV'] || DEFAULT_BROWSER,
+        :selenium_args => ENV['SELENIUM_ARGS'] || ""
+      }.merge(overrides)
+      options[:env] = "'#{options[:env].gsub(/["']/, '')}'"
+      options
+    end
+  end
+end

data/lib/selenium-grid/version.rb

@@ -0,0 +1,8 @@
+module SeleniumGrid #:nodoc:
+  module VERSION #:nodoc:
+    MAJOR = 0
+    MINOR = 0
+    TINY  = 2
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+end

data/lib/tasks/hoe.rake

@@ -0,0 +1,6 @@
+require "rake"
+
+desc "Update the manifest."
+task(:update_manifest) do
+  system("rake check_manifest | patch ; cat Manifest.txt > Manifest.tmp ; cat Manifest.tmp | sed /^doc/d | sed /^log/d | sed /^pkg/d | sed /.*\.gemspec/d> Manifest.txt ; rm Manifest.tmp")
+end

data/lib/tasks/hub.rake

@@ -0,0 +1,15 @@
+require 'rake'
+
+namespace :hub do
+  include SeleniumGrid
+
+  desc "Launch Hub."
+  task(:start) do
+    Hub.instance.start
+  end
+
+  desc "Stop Hub."
+  task(:stop) do
+    Hub.instance.stop
+  end
+end

data/lib/tasks/rc.rake

@@ -0,0 +1,15 @@
+require 'rake'
+
+namespace :rc do
+  include SeleniumGrid
+
+  desc "Launch Remote Control. Usage rake rc:start [PORT=#{Remote::DEFAULT_PORT}]"
+  task(:start) do
+    Remote.instance.start
+  end
+
+  desc "Stop Remote Control. Usage rake rc:stop [PORT=#{Remote::DEFAULT_PORT}]"
+  task(:stop) do
+    Remote.instance.stop
+  end
+end

data/lib/tasks/rspec.rake

@@ -0,0 +1,20 @@
+require "rake"
+
+desc "Runs the RSpec suite"
+task :spec => 'spec:all'
+
+namespace :spec do
+  desc "Runs the RSpec suite"
+  task :all do
+    require_path '/spec/spec_suite.rb'
+    SpecSuite.send('all')
+  end
+  
+  %W(extensions java selenium-grid).each do |suite_name|
+    desc "Runs the #{suite_name} spec suite"
+    task suite_name.to_sym do
+      require_path '/spec/spec_suite.rb'
+      SpecSuite.send(suite_name.gsub('-', "_"))
+    end
+  end
+end

data/spec/extensions/string_spec.rb

@@ -0,0 +1,45 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe String do
+  describe "#camelize" do
+    context "when passed a string with no underscores" do
+      context "with no options" do
+        it "returns the string as camelcase with the first character converted to uppercase" do
+          "runonstring".camelize.should == "Runonstring"
+        end
+      end
+      
+      context "with the :upper option" do
+        it "returns the string as camelcase with the first character converted to uppercase" do
+          "runonstring".camelize(:upper).should == "Runonstring"
+        end
+      end
+      
+      context "with the :lower option" do
+        it "returns the original string" do
+          "runonstring".camelize(:lower).should == "runonstring"
+        end
+      end
+    end
+    
+    context "when passed a string with underscores" do
+      context "with no options" do
+        it "returns the string as camelcase" do
+          "underscored_string".camelize.should == "UnderscoredString"
+        end
+      end
+      
+      context "with the :upper option" do
+        it "returns the string as camelcase" do
+          "underscored_string".camelize(:upper).should == "UnderscoredString"
+        end
+      end
+      
+      context "with the :lower option" do
+        it "returns the string as camelcase" do
+          "underscored_string".camelize(:lower).should == "underscoredString"
+        end
+      end
+    end
+  end
+end

data/spec/extensions_spec_suite.rb

@@ -0,0 +1,13 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/spec_suite"
+require "#{dir}/spec_helper"
+
+class ExtensionsSpecSuite < SpecSuite
+  def files
+    Dir["#{dir}/extensions/**/*_spec.rb"]
+  end
+end
+
+if $0 == __FILE__
+  ExtensionsSpecSuite.new.run
+end

data/spec/java/vm_spec.rb

@@ -0,0 +1,75 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module Java
+  describe VM do
+    describe "#run" do
+      attr_reader :vm
+      before do
+        @vm = VM.new
+      end
+      
+      context "when passed a classname" do
+        it "shells out to java with the classname as the sole argument" do
+          mock(vm).sh('java test.ClassName')
+          vm.run "test.ClassName"
+        end
+      end
+      
+      context "when passed a classname and options" do
+        context "when the options include :arguments" do
+          it "shells out to java with the arguments" do
+            mock(vm).sh('java test.ClassName -one uno -two dos')
+            vm.run "test.ClassName", { :arguments => { :one => 'uno', :two => 'dos' } }
+          end
+          
+          it "converts argument keys to camelCase" do
+            mock(vm).sh('java test.ClassName -oneTwo after')
+            vm.run "test.ClassName", { :arguments => { :one_two => 'after' } }
+          end
+
+          it "passes selenium_args to java as the value only" do
+            mock(vm).sh("java test.ClassName foo")
+            vm.run "test.ClassName", { :arguments => { :selenium_args => "foo"} }
+          end
+        end
+
+        context "when the options include :background" do
+          it "shells out to java and sends the process to the background" do
+            mock(vm).sh('java test.ClassName &')
+            vm.run "test.ClassName", { :background => true }
+          end
+        end
+
+        context "when the options include :classpath" do
+          it "shells out to java with the classpath" do
+            mock(vm).sh("java -cp 'lib/one.jar:lib/two.jar' test.ClassName")
+            vm.run "test.ClassName", { :classpath => 'lib/one.jar:lib/two.jar' }
+          end
+        end
+
+        context "when the options include :log" do
+          before do
+            mock(vm).mkdir_p("/var/log")
+          end
+
+          it "shells out to java and redirects output to the specified log file" do
+            mock(vm).sh("java test.ClassName > '/var/log/test.log' 2>&1")
+            vm.run "test.ClassName", { :log => '/var/log/test.log' }
+          end
+          
+          it "creates the log directory" do
+            mock(vm).sh("java test.ClassName > '/var/log/test.log' 2>&1")
+            vm.run "test.ClassName", { :log => '/var/log/test.log' }
+          end
+        end
+
+        context "when the options include :settings for the JVM" do
+          it "shells out to java with the settings flags" do
+            mock(vm).sh("java test.ClassName -Done=uno")
+            vm.run "test.ClassName", { :settings => { :one, 'uno' } }
+          end
+        end
+      end
+    end
+  end
+end

data/spec/java_spec_suite.rb

@@ -0,0 +1,13 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/spec_suite"
+require "#{dir}/spec_helper"
+
+class JavaSpecSuite < SpecSuite
+  def files
+    Dir["#{dir}/java/**/*_spec.rb"]
+  end
+end
+
+if $0 == __FILE__
+  JavaSpecSuite.new.run
+end

data/spec/selenium-grid/hub_spec.rb

@@ -0,0 +1,67 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module SeleniumGrid
+  describe Hub do
+    attr_reader :hub
+
+    before do
+      @hub = Hub.instance
+    end
+  
+    describe "#start" do
+      describe "the call to Java::VM#run" do
+        it "includes the expected parameters" do
+          mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+            class_name.should == "com.thoughtworks.selenium.grid.hub.HubServer"
+            options.should include(:classpath)
+            options.should include(:log)
+            options.should include(:background)
+          end
+          hub.start
+        end
+        
+        context "when called without options or environment settings" do
+          it "includes the default parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should be_false
+            end
+            hub.start
+          end
+        end
+
+        context "when called with environment settings" do
+          before do
+            ENV['BACKGROUND'] = "true"
+          end
+          
+          after do
+            ENV.delete('BACKGROUND')
+          end
+          
+          it "includes the environment settings as parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should == "true"
+            end
+            hub.start
+          end
+        end
+
+        context "when called with options" do
+          it "includes the options as parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should be_true
+            end
+            hub.start(:background => true)
+          end
+        end
+      end
+    end
+
+    describe "#stop" do
+      it "calls Lsof.kill" do
+        mock(Lsof).kill(Hub::HUB_PORT)
+        hub.stop
+      end
+    end
+  end
+end

data/spec/selenium-grid/remote_spec.rb

@@ -0,0 +1,143 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+module SeleniumGrid
+  describe Remote do
+    attr_reader :remote
+
+    before do
+      @remote = Remote.instance
+    end
+
+    after do
+      %w(port host hub_url env selenium_args background).each do |env|
+        ENV.delete(env.upcase)
+      end
+    end
+
+    describe "#start" do
+      describe "the call to Java::VM#run" do
+        it "includes the expected parameters" do
+          mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+            class_name.should == "com.thoughtworks.selenium.grid.remotecontrol.SelfRegisteringRemoteControlLauncher"
+            options.should include(:classpath)
+            options.should include(:arguments)
+            options.should include(:log)
+            options.should include(:background)
+          end
+          remote.start
+        end
+
+        context "when called without options or environment settings" do
+          it "includes the default parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should be_false
+              options[:arguments][:host].should == Remote::DEFAULT_HOST
+              options[:arguments][:port].should == Remote::DEFAULT_PORT
+              options[:arguments][:hub_url].should == Remote::DEFAULT_HUB_URL
+              options[:arguments][:env].should == "'#{Remote::DEFAULT_BROWSER}'"
+              options[:arguments][:selenium_args].should == ""
+            end
+            remote.start
+          end
+        end
+
+        context "when called with environment settings" do
+          before do
+            ENV['BACKGROUND'] = 'true'
+            ENV['PORT'] = "1234"
+          end
+
+          it "includes the environment settings as parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should == "true"
+              options[:arguments][:port].should == "1234"
+            end
+            remote.start
+          end
+        end
+
+        context "when called with options" do
+          it "includes the options as parameters" do
+            mock.instance_of(Java::VM).run(anything, anything) do |class_name, options|
+              options[:background].should be_true
+              options[:arguments][:port].should == 1234
+            end
+            remote.start(:background => true, :port => 1234)
+          end
+        end
+      end
+    end
+
+    describe "#stop" do
+      describe "the call to Lsof.kill" do
+        context "when called without options of environment settings" do
+          it "uses the defaults" do
+            mock(Lsof).kill(Remote::DEFAULT_PORT)
+            remote.stop
+          end
+        end
+        
+        context "when called with environment settings" do
+          before do
+            ENV['PORT'] = "1234"
+          end
+          
+          it "uses the environment settings" do
+            mock(Lsof).kill(ENV['PORT'].to_i)
+            remote.stop 
+          end
+        end
+        
+        context "when called with options" do
+          it "uses the options" do
+            mock(Lsof).kill(1234)
+            remote.stop(:port => 1234)
+          end
+        end
+      end
+    end
+  
+    describe "#args" do
+      attr_reader :args, :defaults
+      before do
+        @defaults = {
+          :host => Remote::DEFAULT_HOST,
+          :port => Remote::DEFAULT_PORT,
+          :hub_url => Remote::DEFAULT_HUB_URL,
+          :env => "'*chrome'",
+          :selenium_args => ''
+        }
+      end
+
+      context "when ENV does not contain any relevant options" do
+        before do
+          @args = remote.arguments
+        end
+      
+        it "returns a hash of default arguments" do
+          args.should == defaults
+        end
+      end
+    
+      {
+        :host => 'foobar',
+        :port => 6000,
+        :hub_url => 'http://foobar:7777',
+        :env => "'*safari'",
+        :selenium_args => 'foo'
+      }.each do |key, override|
+        arg_name = key.to_s.upcase
+        context "when ENV includes #{arg_name}" do
+          before do
+            ENV[arg_name] = override.to_s
+            @args = remote.arguments()
+          end
+      
+          it "returns a hash with defaults and #{arg_name}" do
+            args.should == defaults.merge(key => override.to_s)
+          end
+        end
+      end
+    end
+  end
+end

data/spec/selenium-grid_spec_suite.rb

@@ -0,0 +1,13 @@
+dir = File.dirname(__FILE__)
+require "#{dir}/spec_suite"
+require "#{dir}/spec_helper"
+
+class SeleniumGridSpecSuite < SpecSuite
+  def files
+    Dir["#{dir}/selenium-grid/**/*_spec.rb"]
+  end
+end
+
+if $0 == __FILE__
+  SeleniumGridSpecSuite.new.run
+end

data/spec/spec.opts

@@ -0,0 +1,6 @@
+--colour
+--format
+profile
+--loadby
+mtime
+--backtrace

data/spec/spec_helper.rb

@@ -0,0 +1,9 @@
+dir = File.dirname(__FILE__)
+
+require 'rubygems'
+require 'spec'
+require File.join(dir, %w(.. config requirements))
+
+Spec::Runner.configure do |config|
+  config.mock_with :rr
+end

data/spec/spec_suite.rb

@@ -0,0 +1,49 @@
+class SpecSuite
+  class << self
+    SUITE_NAMES = %w(extensions java selenium-grid)
+
+    def all
+      SUITE_NAMES.each do |suite_name|
+        send(suite_name.gsub('-', '_'))
+      end
+    end
+
+    SUITE_NAMES.each do |suite_name|
+      self.send(:define_method, suite_name.gsub('-', '_')) do
+        raise "Failure" unless system(%Q|ruby #{dir}/#{suite_name}_spec_suite.rb|)
+      end
+    end
+    
+    def dir
+      @dir ||= File.dirname(__FILE__)
+    end
+  end
+  
+  def run
+    spec_opts = "#{dir}/spec.opts"
+    ARGV.concat ["--options", spec_opts] if File.exists? spec_opts
+
+    header
+    files.each do |file|
+      require file
+    end
+    
+    ::Spec::Runner::CommandLine.run
+  end
+  
+  def header
+    puts "\nRunning #{self.class}"
+  end
+
+  def files
+    raise NotImplementedError
+  end
+  
+  def dir
+    @dir ||= File.dirname(__FILE__)
+  end
+end
+
+if $0 == __FILE__
+  SpecSuite.all
+end

metadata

@@ -0,0 +1,133 @@
+--- !ruby/object:Gem::Specification 
+name: selenium-grid
+version: !ruby/object:Gem::Version 
+  version: 0.0.2
+platform: ruby
+authors: 
+- Ryan Dy
+- Corey Innis
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-10-06 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rake
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.8.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: newgem
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.23.1
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: lsof
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 0.3.0
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.7.0
+    version: 
+description: Selenium Grid Ruby packages Selenium Grid as a gem
+email: ops+rubyforge@pivotallabs.com
+executables: 
+- selenium-grid
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- bin/selenium-grid
+- config/hoe.rb
+- config/requirements.rb
+- lib/extensions.rb
+- lib/extensions/file.rb
+- lib/extensions/rake.rb
+- lib/extensions/string.rb
+- lib/java.rb
+- lib/java/classpath.rb
+- lib/java/vm.rb
+- lib/openqa/selenium-grid-hub-standalone-1.0.1.jar
+- lib/openqa/selenium-grid-remote-control-standalone-1.0.1.jar
+- lib/openqa/selenium-server-1.0-SNAPSHOT.jar
+- lib/selenium-grid.rb
+- lib/selenium-grid/hub.rb
+- lib/selenium-grid/remote.rb
+- lib/selenium-grid/version.rb
+- lib/tasks/hoe.rake
+- lib/tasks/hub.rake
+- lib/tasks/rc.rake
+- lib/tasks/rspec.rake
+- spec/extensions/string_spec.rb
+- spec/extensions_spec_suite.rb
+- spec/java/vm_spec.rb
+- spec/java_spec_suite.rb
+- spec/selenium-grid/hub_spec.rb
+- spec/selenium-grid/remote_spec.rb
+- spec/selenium-grid_spec_suite.rb
+- spec/spec.opts
+- spec/spec_helper.rb
+- spec/spec_suite.rb
+has_rdoc: true
+homepage: http://selenium-grid.rubyforge.org
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+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: selenium-grid
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Selenium Grid Ruby packages Selenium Grid as a gem
+test_files: 
+- spec/extensions/string_spec.rb
+- spec/java/vm_spec.rb
+- spec/selenium-grid/hub_spec.rb
+- spec/selenium-grid/remote_spec.rb