statt 0.0.1

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2009 davidtrogers
+
+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,33 @@
+= statt
+Statt is a selenium testing environment that can be used with Cucumber to construct requirements based tests that fully cover web based user interfaces containing javascript and ajax.  It will allow you to either create the selenium tests using cucumber directly, or will create the features from selenium IDE generated html files.  This will be valuable if someone else is creating your features for you, for example, a QA tester.  
+
+Roadmap
+
+Release 0.1
+- full selenium setup including locally spawned selenium server
+- cucumber integration
+- database setup using factory girl
+- full api for selenium methods (cucumber steps)
+
+Release 0.2
+- optimizations for speed
+- factory generation based on models
+- dynamic test data inserted into tests based on factory setup
+- model optimization hints
+- multiple instances running simultaneously for further speed improvements
+
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Commit, do not mess with rakefile, version, or history.
+  (if you want to have your own version, that is fine but
+   bump version in a commit by itself I can ignore when I pull)
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2009 davidtrogers. See LICENSE for details.

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/cloud.rb

@@ -0,0 +1,35 @@
+module SeleniumGrid
+  module AWS
+  
+    class Cloud
+      FILE = "cloud.yml"
+      attr_accessor :hub, :farms
+            
+      def self.load
+        begin
+          YAML.load(File.read(FILE))
+        rescue Errno::ENOENT
+          new
+        end
+      end
+
+      def self.update
+        cloud = self.load
+        yield cloud
+      ensure
+        cloud.write unless cloud.nil?
+      end
+      
+      def write 
+        File.open(FILE, "w") {|file| file.write(self.to_yaml)}
+      end
+      
+      def farms
+        @farms ||= []
+      end
+            
+    end
+
+  end
+end
+

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/ec2.rb

@@ -0,0 +1,7 @@
+require 'rubygems'
+require "yaml"
+require File.dirname(__FILE__) + '/cloud'
+require File.dirname(__FILE__) + '/ec2_client'
+require File.dirname(__FILE__) + '/server'
+require File.dirname(__FILE__) + '/hub'
+require File.dirname(__FILE__) + '/remote_command'

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/ec2_client.rb

@@ -0,0 +1,62 @@
+module SeleniumGrid
+  module AWS
+    module Ec2Client
+      
+      def describe(instance_id)
+        output = ec2_shell "ec2-describe-instances #{instance_id}"
+        output =~ /INSTANCE\s+(i-.*)$/
+        fields = $1.split(/\s+/)
+        if output =~ /running/
+          {:instance_id => fields[0],
+           :ami => fields[1],
+           :public_dns => fields[2],
+           :private_dns => fields[3],
+           :status => fields[4] }
+        else 
+          {:instance_id => fields[0],
+           :ami => fields[1],
+           :status => fields[2] }
+        end
+      end
+            
+      def launch(ami, options ={})
+        output = ec2_shell "ec2-run-instances #{ami} -k #{options[:keypair]}"
+        output =~ /INSTANCE\s+(i-\S+)\s+ami-/
+        if $1 != nil
+          $1
+        else
+          raise InstanceLaunchError, output
+        end
+      end
+
+      def shutdown(instance_id)
+        ec2_shell "ec2-terminate-instances #{instance_id}"
+      end
+
+      def version
+        ec2_shell "ec2-version"
+      end
+            
+      def authorize_port(port)
+        puts "Opening port #{port}..."        
+        ec2_shell "ec2-authorize default -p #{port}"
+      end
+            
+      def ec2_shell(command)
+        puts "[EC2] '#{command}'" if tracing?
+        output = `${EC2_HOME}/bin/#{command}`
+        puts "[EC2] #{output}" if tracing?
+        output
+      end
+
+      def tracing?
+        ENV['TRACE_EC2_COMMANDS']
+      end
+              
+    end
+  end
+  
+  class InstanceLaunchError < StandardError
+  end
+  
+end

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/hub.rb

@@ -0,0 +1,22 @@
+module SeleniumGrid
+  module AWS
+  
+    class Hub < Server
+      
+      def url
+        "http://#{public_dns}:4444"
+      end
+
+      def private_url
+        "http://#{private_dns}:4444"
+      end
+
+      def console_url
+        "#{url}/console"
+      end
+      
+    end
+    
+  end
+end
+

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/remote_command.rb

@@ -0,0 +1,47 @@
+module SeleniumGrid
+  module AWS
+    
+    class RemoteCommand
+      attr_accessor :options
+      
+      def initialize(command, options={})
+        @command, @options = command, options
+      end
+      
+      def execute
+        puts full_command
+        system full_command
+        raise "Error with #{full_command}" if 0 != $?        
+      end
+      
+      def full_command
+        cmd = "#{ssh_command} " 
+        cmd << "\"su -l #{options[:su]} -c " if options[:su]
+        cmd << "'#{remote_command}'"
+        cmd << '"' if options[:su]
+        cmd
+      end
+      
+      def ssh_command
+        shell_command = [ "ssh" ]
+        shell_command << "-i '#{options[:keypair]}'" if options[:keypair]
+        shell_command << "root@#{options[:host]}"
+        
+        shell_command.join " "
+      end
+
+      def remote_command
+        shell_command = []
+        shell_command << "PATH=#{options[:path]}:${PATH}; export PATH;" if options[:path]
+        shell_command << "DISPLAY=#{options[:display]}; export DISPLAY;" if options[:display]
+        shell_command << "cd '#{options[:pwd]}';" if options[:pwd]
+        shell_command << @command
+        
+        shell_command.join " "
+      end
+      
+    end  
+
+  end
+end
+

data/lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/server.rb

@@ -0,0 +1,56 @@
+module SeleniumGrid
+  module AWS
+  
+    class Server
+      extend Ec2Client
+      
+      attr_accessor :instance_id, :public_dns, :private_dns
+    
+      def initialize(instance_id)
+        self.instance_id = instance_id
+      end       
+
+      def self.boot(ami, options = {})
+        new launch(ami, options)
+      end
+
+      def self.boot_and_acquire_dns(ami, options)
+        server = boot(ami, options)
+        server.wait_for_dns
+      end
+
+      def wait_for_dns
+        puts "Fetching DNS Info..."
+        until dns_allocated?
+          sleep 2
+          putc "."
+          refresh_status
+        end
+        puts
+        self
+      end
+      
+      def dns_allocated?
+        public_dns != nil && public_dns != "" &&
+        private_dns != nil && private_dns != ""
+      end
+      
+      def refresh_status
+        info = self.class.describe instance_id
+        @public_dns = info[:public_dns]
+        @private_dns = info[:private_dns]
+      end
+
+      def shutdown
+        self.class.shutdown instance_id
+      end
+            
+      def run(command, options)
+        command = RemoteCommand.new command, options.merge(:host => public_dns)
+        command.execute
+      end         
+    end
+
+  end
+end
+

data/lib/selenium-grid/examples/ec2/test/unit/all_test.rb

@@ -0,0 +1,2 @@
+#!/usr/bin/env ruby
+Dir['**/*_test.rb'].each {|test_file| require test_file }

data/lib/selenium-grid/examples/ec2/test/unit/cloud_test.rb

@@ -0,0 +1,27 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+unit_tests do
+
+  test "hub is nil on a fresh cloud" do
+    assert_nil SeleniumGrid::AWS::Cloud.new.hub
+  end
+
+  test "hub return the latest assigned hub instance" do
+    cloud = SeleniumGrid::AWS::Cloud.new
+    cloud.hub = :old_hub
+    cloud.hub = :new_hub
+    assert_equal :new_hub, cloud.hub
+  end
+
+  test "remote_control_farms is empty on a fresh cloud" do
+    assert_equal [], SeleniumGrid::AWS::Cloud.new.farms
+  end
+
+  test "remote_control_farms returns all added farms" do
+    cloud = SeleniumGrid::AWS::Cloud.new
+    cloud.farms << :a_farm
+    cloud.farms << :another_farm
+    assert_equal [:a_farm, :another_farm], cloud.farms
+  end
+
+end

data/lib/selenium-grid/examples/ec2/test/unit/ec2_client_test.rb

@@ -0,0 +1,137 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+unit_tests do
+
+  test "run_instance launch a new AMI using ec2-run-instances script" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.expects(:ec2_shell).with("ec2-run-instances TheAMI -k TheKeyPair")
+    client.launch "TheAMI", :keypair => "TheKeyPair"
+  end
+
+  test "run_instance returns the instance id when launch is successful" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba			pending	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000
+    EOS
+    assert_equal "i-6fef1006", client.launch(:an_ami)
+  end
+
+  test "authorize launch ec2-authorize script for default group" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.expects(:ec2_shell).with("ec2-authorize default -p ThePort")
+    client.authorize_port "ThePort"
+  end
+
+  test "describe launch ec2-describe script for a particular AMI" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.expects(:ec2_shell).with("ec2-describe-instances TheAMI").returns("INSTANCE i-")
+    client.describe "TheAMI"
+  end
+
+  test "describe returns the instance id when running" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba	ec2-67-202-19-143.compute-1.amazonaws.com	domU-12-31-38-00-3D-E6.compute-1.internal	running	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000      
+    EOS
+    assert_equal "i-6fef1006", client.describe(:an_ami)[:instance_id]
+  end
+
+  test "describe returns the ami when running" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba	ec2-67-202-19-143.compute-1.amazonaws.com	domU-12-31-38-00-3D-E6.compute-1.internal	running	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000      
+    EOS
+    assert_equal "ami-d306e3ba", client.describe(:an_ami)[:ami]
+  end
+
+  test "describe returns the public_dns when running" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba	ec2-67-202-19-143.compute-1.amazonaws.com	domU-12-31-38-00-3D-E6.compute-1.internal	running	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000      
+    EOS
+    assert_equal "ec2-67-202-19-143.compute-1.amazonaws.com", 
+                 client.describe(:an_ami)[:public_dns]
+  end
+
+  test "describe returns the private_dns when running" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba	ec2-67-202-19-143.compute-1.amazonaws.com	domU-12-31-38-00-3D-E6.compute-1.internal	running	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000      
+    EOS
+    assert_equal "domU-12-31-38-00-3D-E6.compute-1.internal", 
+                 client.describe(:an_ami)[:private_dns]
+  end
+
+  test "describe returns the status when running" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba	ec2-67-202-19-143.compute-1.amazonaws.com	domU-12-31-38-00-3D-E6.compute-1.internal	running	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000      
+    EOS
+    assert_equal "running", client.describe(:an_ami)[:status]
+  end
+
+  test "describe returns the instance id when terminated" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba			terminated	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000
+    EOS
+    assert_equal "i-6fef1006", client.describe(:an_ami)[:instance_id]
+  end
+
+  test "describe returns the status when pending" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-40609729	069216575636	default
+      INSTANCE	i-afee11c6	ami-6801e401			pending	grid-keypair	0		m1.small	2008-02-17T22:33:38+0000
+    EOS
+    assert_equal "pending", client.describe(:an_ami)[:status]
+  end
+
+  test "describe returns a nil public dns the status when pending" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-40609729	069216575636	default
+      INSTANCE	i-afee11c6	ami-6801e401			pending	grid-keypair	0		m1.small	2008-02-17T22:33:38+0000
+    EOS
+    assert_nil client.describe(:an_ami)[:public_dns]
+  end
+
+  test "describe returns a nil private dns the status when pending" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-40609729	069216575636	default
+      INSTANCE	i-afee11c6	ami-6801e401			pending	grid-keypair	0		m1.small	2008-02-17T22:33:38+0000
+    EOS
+    assert_nil client.describe(:an_ami)[:private_dns]
+  end
+
+  test "describe returns the status when terminated" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.stubs(:ec2_shell).returns(<<-EOS)
+      RESERVATION	r-ee629587	069216575636	default
+      INSTANCE	i-6fef1006	ami-d306e3ba			terminated	grid-keypair	0		m1.small	2008-02-17T20:49:08+0000
+    EOS
+    assert_equal "terminated", client.describe(:an_ami)[:status]
+  end
+
+  test "shutdown terminates an instance" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.expects(:ec2_shell).with("ec2-terminate-instances The-Instance-ID")
+    client.shutdown("The-Instance-ID")
+  end
+
+  test "version returns EC2 version using defined keypair" do
+    client = Class.new.extend SeleniumGrid::AWS::Ec2Client
+    client.expects(:ec2_shell).with("ec2-version").returns(:ec2_version)
+    assert_equal :ec2_version, client.version
+  end
+
+# ec2-version -K "${EC2_PRIVATE_KEY}"
+end

data/lib/selenium-grid/examples/ec2/test/unit/hub_test.rb

@@ -0,0 +1,24 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+unit_tests do
+
+  test "url return the public url where the hub can be contacted" do
+    hub = SeleniumGrid::AWS::Hub.new nil
+    hub.public_dns = "public.dns"
+    assert_equal "http://public.dns:4444", hub.url
+  end
+
+  test "private_url return the private url where the hub can be contacted" do
+    hub = SeleniumGrid::AWS::Hub.new nil
+    hub.private_dns = "private.dns"
+    assert_equal "http://private.dns:4444", hub.private_url
+  end
+
+  test "console_url return the public url of the hub console" do
+    hub = SeleniumGrid::AWS::Hub.new nil
+    hub.public_dns = "public.dns"
+    assert_equal "http://public.dns:4444/console", hub.console_url
+  end
+
+
+end

data/lib/selenium-grid/examples/ec2/test/unit/remote_command_test.rb

@@ -0,0 +1,46 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+unit_tests do
+
+  test "ssh_command builds ssh based command targetting the host" do
+    command = SeleniumGrid::AWS::RemoteCommand.new "ls", :host => "the.host"
+    assert_equal "ssh root@the.host", command.ssh_command
+  end
+
+  test "ssh_command use custom key when keypair options is provided" do
+    command = SeleniumGrid::AWS::RemoteCommand.new "ls", 
+                :host => "the.host", :keypair => "/the/key.pair"
+    assert_equal "ssh -i '/the/key.pair' root@the.host", command.ssh_command
+  end
+
+  test "remote_command" do
+    command = SeleniumGrid::AWS::RemoteCommand.new "ls", :pwd => "/a/directory"
+    assert_equal "cd '/a/directory'; ls", command.remote_command
+  end
+
+  test "remote_command set path when path is provided as an option" do
+    command = SeleniumGrid::AWS::RemoteCommand.new "ls", :path => "/a/directory:and/another"
+    assert_equal "PATH=/a/directory:and/another:${PATH}; export PATH; ls", command.remote_command
+  end
+
+  test "remote_command set display when display is provided as an option" do
+    command = SeleniumGrid::AWS::RemoteCommand.new "ls", :display => ":0"
+    assert_equal "DISPLAY=:0; export DISPLAY; ls", command.remote_command
+  end
+
+  test "full_command execute the remote command using ssh_command" do
+    command = SeleniumGrid::AWS::RemoteCommand.new nil
+    command.stubs(:ssh_command).returns("the_ssh_command")
+    command.stubs(:remote_command).returns("the remote command")
+    assert_equal "the_ssh_command 'the remote command'", command.full_command
+  end
+
+  test "full_command wraps remote_command with 'su user -c' when su option is set" do
+    command = SeleniumGrid::AWS::RemoteCommand.new nil, :su => "a-user"
+    command.stubs(:ssh_command).returns("the_ssh_command")
+    command.stubs(:remote_command).returns("the remote command")
+    assert_equal "the_ssh_command \"su -l a-user -c 'the remote command'\"", 
+                 command.full_command
+  end
+  
+end

data/lib/selenium-grid/examples/ec2/test/unit/server_test.rb

@@ -0,0 +1,22 @@
+require File.dirname(__FILE__) + "/test_helper"
+
+unit_tests do
+
+  test "refresh_status updates public dns" do
+    server = SeleniumGrid::AWS::Server.new :an_instance_id
+    SeleniumGrid::AWS::Server.expects(:describe).with(:an_instance_id).
+                              returns(:public_dns => :new_public_dns)
+    server.refresh_status
+    assert_equal :new_public_dns, server.public_dns
+  end
+
+  test "refresh_status updates private dns" do
+    server = SeleniumGrid::AWS::Server.new :an_instance_id
+    SeleniumGrid::AWS::Server.expects(:describe).with(:an_instance_id).
+                              returns(:private_dns => :new_private_dns)
+    server.refresh_status
+    assert_equal :new_private_dns, server.private_dns
+  end
+
+  
+end

data/lib/selenium-grid/examples/ec2/test/unit/test_helper.rb

@@ -0,0 +1,4 @@
+require File.dirname(__FILE__) + "/../../lib/selenium_grid/aws/ec2"
+require "rubygems"
+require "dust"
+require "mocha"

data/lib/selenium-grid/examples/ruby/flickr_example.rb

@@ -0,0 +1,16 @@
+module FlickrExample
+  
+  def run_flickr_scenario(options)
+    browser.open "/"
+    page.location.should match(%r{http://images.google.com/})
+    page.type "q", options[:search_string]
+    page.click "btnG", :wait_for => :page
+    page.click "link=Advanced Image Search", :wait_for => :page
+    page.click "rimgtype4"
+    page.click "sf"
+    page.select "imgc", "full color"
+    page.click "btnG", :wait_for => :page
+    page.text?(options[:search_string].split(/ /).first).should be_true
+  end
+  
+end

data/lib/selenium-grid/examples/ruby/lib/array_extension.rb

@@ -0,0 +1,13 @@
+module ArrayExtension
+
+  def /(number_of_buckets)
+    buckets = (1..number_of_buckets).collect { [] }
+    while self.any? do
+      buckets.each do |bucket|
+        bucket << self.shift if self.any?
+      end
+    end
+    buckets
+  end
+
+end

data/lib/selenium-grid/examples/ruby/lib/multi_process_behaviour_runner.rb

@@ -0,0 +1,28 @@
+require File.expand_path(File.dirname(__FILE__) + '/array_extension')
+Array.send :include, ArrayExtension
+
+class MultiProcessSpecRunner
+
+  def initialize(max_concurrent_processes = 10)
+    @max_concurrent_processes = max_concurrent_processes
+  end
+  
+  def run(spec_files)
+    concurrent_processes = [ @max_concurrent_processes, spec_files.size ].min
+    spec_files_by_process = spec_files / concurrent_processes
+    concurrent_processes.times do |i|
+      cmd  = "spec #{spec_files_by_process[i].join(' ')}"
+      puts "Launching #{cmd}"
+      exec(cmd) if fork == nil
+    end
+    success = true
+    concurrent_processes.times do |i|
+      pid, status = Process.wait2
+      puts "Test process ##{i} with pid #{pid} completed with #{status}"
+      success &&= status.exitstatus.zero?
+    end
+    
+    raise "Build failed" unless success
+  end
+
+end

data/lib/selenium-grid/examples/ruby/paris_spec.rb

@@ -0,0 +1,34 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe "Paris" do
+  include FlickrExample
+  
+  it "Has museums" do
+    run_flickr_scenario :search_string => "Louvre"
+  end
+
+  it "Has bridges" do
+    run_flickr_scenario :search_string => "Pont Neuf"
+  end
+
+  it "Has magnific cathedrals" do
+    run_flickr_scenario :search_string => "Notre Dame de Paris"
+  end
+
+  it "Has magnificent Castles" do
+    run_flickr_scenario :search_string => "Versailles"
+  end
+
+  it "Has a gorgeous river" do
+    run_flickr_scenario :search_string => "Seine by Night"
+  end
+
+  it "Has weird towers" do
+    run_flickr_scenario :search_string => "Tour Eiffel"
+  end
+
+  it "Has avenues" do
+    run_flickr_scenario :search_string => "Avenue des Champs Elysees"
+  end
+
+end

data/lib/selenium-grid/examples/ruby/perigord_spec.rb

@@ -0,0 +1,22 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+describe "Perigord" do
+  include FlickrExample
+  
+  it "Has magnific cro-magnon paintings" do
+    run_flickr_scenario :search_string => "lascaux hall of the bull"
+  end
+
+  it "Has magnific cities" do
+    run_flickr_scenario :search_string => "Sarlat"
+  end
+
+  it "Has magnific cathedrals" do
+    run_flickr_scenario :search_string => "Cathedral in Périgueux"
+  end
+
+  it "Has great wines" do
+    run_flickr_scenario :search_string => "Montbazillac"
+  end
+
+end

data/lib/selenium-grid/examples/ruby/spec_helper.rb

@@ -0,0 +1,59 @@
+$:.unshift
+
+require "rubygems"
+gem "rspec", "=1.1.8"
+require 'spec/rake/spectask'
+
+require "rake"
+
+gem "selenium-client", "=1.2.7"
+require "selenium/rake/tasks"
+require "selenium/client"
+require "selenium/rspec/spec_helper"
+
+require File.expand_path(File.dirname(__FILE__) + "/flickr_example")
+
+Spec::Runner.configure do |config|
+
+  config.before(:each) do
+    create_selenium_driver
+    start_new_browser_session
+  end
+
+  # The system capture need to happen BEFORE the closing the Selenium session 
+  config.append_after(:each) do    
+    @selenium_driver.close_current_browser_session
+  end
+
+  def start_new_browser_session
+    @selenium_driver.start_new_browser_session
+    @selenium_driver.set_context "Starting example '#{self.description}'"
+  end
+
+  def selenium_driver
+    @selenium_driver
+  end
+
+  def browser
+    @selenium_driver
+  end
+
+  def page
+    @selenium_driver
+  end
+
+  def create_selenium_driver
+    remote_control_server = ENV['SELENIUM_RC_HOST'] || "localhost"
+    port = ENV['SELENIUM_RC_PORT'] || 4444
+    browser = ENV['SELENIUM_RC_BROWSER'] || "*firefox"
+    timeout = ENV['SELENIUM_RC_TIMEOUT'] || 200
+    application_host = ENV['SELENIUM_APPLICATION_HOST'] || "images.google.com"
+    application_port = ENV['SELENIUM_APPLICATION_PORT'] || "80"
+
+    @selenium_driver = Selenium::Client::Driver.new(
+        remote_control_server, port, browser,
+        "http://#{application_host}:#{application_port}", timeout)
+  end
+
+end
+

data/lib/selenium-grid/lib/ruby/file_extensions.rb

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

data/lib/selenium-grid/lib/ruby/java/classpath.rb

@@ -0,0 +1,28 @@
+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/selenium-grid/lib/ruby/java/vm.rb

@@ -0,0 +1,31 @@
+module Java
+
+  class VM
+
+    def run(classname, options)
+      command = [ "java" ]
+      command << "-cp \"#{options[:classpath]}\""
+      command << classname
+      command << jvm_properties(options[:properties])
+      command << options[:args].join(' ') if options[:args]
+      command << ">\"#{options[:log_file]}\" 2>&1" if options[:log_file]
+
+      if options[:background]
+        if PLATFORM['win32']
+          command.unshift("start")
+        else
+          command << "&"
+        end
+      end
+
+      sh command.join(' ')
+    end
+
+    def jvm_properties(property_hash)
+      return "" unless property_hash
+      property_hash.inject([]) {|memo, (name, value)| memo << "-D#{name}=#{value}" }.join(' ')
+    end
+
+  end
+
+end

data/lib/selenium-grid/lib/ruby/s_grid/hub.rb

@@ -0,0 +1,29 @@
+module SGrid
+
+  class Hub
+    
+    def initialize(options={})
+      @host = options[:host] || "localhost"
+      @port = (options[:port] || "4444").to_i
+    end
+    
+    def start(options={})
+      root = File.expand_path(File.dirname(__FILE__) + "/../../..")
+      classpath = Java::Classpath.new(root)
+      classpath = classpath << "." << "lib/selenium-grid-hub-standalone-*.jar"
+      Java::VM.new.run "com.thoughtworks.selenium.grid.hub.HubServer",
+                        options.merge(:classpath => classpath.definition)
+    end
+
+    def wait_until_up_and_running
+      TCPSocket.wait_for_service :host => @host, :port => @port
+    end
+
+    def shutdown
+      http = Net::HTTP.new(@host, @port)
+      http.post('/lifecycle-manager', "action=shutdown")
+    end
+    
+  end
+
+end

data/lib/selenium-grid/lib/ruby/s_grid/remote_control.rb

@@ -0,0 +1,40 @@
+module SGrid
+
+  class RemoteControl
+    
+    def initialize(options={})
+      @host = options[:host] || "localhost"
+      @port = (options[:port] || "4444").to_i
+      @hub_url = options[:hub_url] || "http://localhost:4444"
+      @shutdown_command = options[:shutdown_command] || "shutDownSeleniumServer"
+    end
+
+    def start(options={})
+        # Selenium Server must be first in classpath
+        root = File.expand_path(File.dirname(__FILE__) + "/../../..")
+        classpath = Java::Classpath.new(root)
+        classpath = classpath << "." << "vendor/selenium-server-*.jar" 
+        classpath = classpath << "lib/selenium-grid-remote-control-standalone-*.jar"
+        Java::VM.new.run "com.thoughtworks.selenium.grid.remotecontrol.SelfRegisteringRemoteControlLauncher",
+                         options.merge(:classpath => classpath.definition, 
+                                       :args => rc_args(options))
+    end
+
+    def shutdown
+      http = Net::HTTP.new(@host, @port)
+      http.post('/selenium-server/driver/', "cmd=#{@shutdown_command}")
+    end
+
+    def rc_args(options)
+      args = []
+      args << "-host" << @host
+      args << "-port" << @port
+      args << "-hubUrl" << @hub_url
+      args << %Q{-env "#{options[:environment] || ENV['ENVIRONMENT'] || '*firefox'}"} 
+      args << (options[:selenium_args] || ENV['SELENIUM_ARGS'] || "")
+      args
+    end
+
+  end
+
+end

data/lib/selenium-grid/lib/ruby/tcp_socket_extensions.rb

@@ -0,0 +1,24 @@
+require 'timeout'
+require 'socket'
+
+class TCPSocket
+  
+  def self.wait_for_service(options)
+    socket = nil
+    Timeout::timeout(options[:timeout] || 20) do
+      loop do
+        begin
+          socket = TCPSocket.new(options[:host], options[:port])
+          return
+        rescue Errno::ECONNREFUSED,
+               Errno::EBADF             # Windows
+          puts ".\n"
+          sleep 2
+        end
+      end
+    end
+  ensure
+    socket.close unless socket.nil?
+  end
+  
+end

data/lib/selenium-grid/sample-scripts/launch-remote-controls.rb

@@ -0,0 +1,20 @@
+#!/usr/bin/env ruby
+#
+# Launch a collection of remote controls
+#
+
+def launch_on_unix(title, command)
+  terminal = ENV['TERM'] || "xterm"
+    system "#{terminal} -t '#{title}' -e '#{command}'"
+end
+
+def launch_in_terminal(title, command)
+  launch_on_unix(title, command)
+end
+
+first_port = ARGV[0] || 5555
+last_port = ARGV[1] || 5555
+base_directory = File.expand_path(File.dirname(__FILE__))
+(first_port..last_port).each do |port|
+  launch_in_terminal "Remote Control #{port}", "ant -Dport=#{port} launch-remote-control"
+end

data/lib/statt.rb

@@ -0,0 +1,23 @@
+#!/usr/local/bin/ruby -w 
+
+module Statt
+  require "selenium"
+  require "selenium/server_manager"
+  require "selenium/selenium_server"
+  
+  require "net/http"
+  require "yaml"
+  require 'selenium-grid/lib/ruby/tcp_socket_extensions'
+  require 'selenium-grid/lib/ruby/file_extensions'
+  require 'selenium-grid/lib/ruby/java/classpath'
+  require 'selenium-grid/lib/ruby/java/vm'
+  require 'selenium-grid/lib/ruby/s_grid/hub'
+  require 'selenium-grid/lib/ruby/s_grid/remote_control'
+  
+  gem "selenium-client", ">=1.2.16"
+  require "selenium/client"
+  require 'nokogiri'
+
+  require 'statt/motor'
+  require 'statt/client'
+end

data/lib/statt/client.rb

@@ -0,0 +1,27 @@
+require "selenium"
+require "test/unit"
+require "selenium/server_manager"
+require "selenium/selenium_server"
+require "selenium/client/driver"
+
+module Statt
+  class Client
+    attr_reader :selenium_driver
+    def initialize
+      @selenium_driver = Selenium::Client::Driver.new \
+          :host => "localhost", 
+          :port => 4444, 
+          :browser => "*firefox", 
+          :url => "http://www.google.com", 
+          :timeout_in_second => 60
+    end
+    
+    def test
+      @selenium_driver.start_new_browser_session
+      @selenium_driver.open "/"
+      @selenium_driver.type "q", "Selenium seleniumhq"
+      @selenium_driver.click "btnG", :wait_for => :page_to_load
+      @selenium_driver.close_current_browser_session 
+    end
+  end
+end

data/lib/statt/motor.rb

@@ -0,0 +1,20 @@
+
+
+module Statt
+  class Motor < Selenium::ServerManager
+    
+    def initialize
+      @server = Selenium::SeleniumRCServer.new
+    end
+    
+    def manager
+      self
+    end
+    
+    def server
+      @server
+    end
+    
+
+  end
+end

data/spec/client_spec.rb

@@ -0,0 +1,19 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Client" do
+  
+  it "should initialize a client to communicate with the grid hub" do
+  end
+
+  it "should receive an optional parameter of host and port to determine the location of the hub " do
+  end
+  
+  it "should recieve an optional starting location though default to http://localhost:3000/" do
+  end
+  
+  it "should provide an api to communicate with the selenium grid" do
+  end
+
+  it "should " do
+  end
+end

data/spec/motor_spec.rb

@@ -0,0 +1,13 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Motor" do
+  it "should connect with a pre-existing selenium grid hub to run the tests" do  
+  end
+
+  it "should start a selenium grid hub if one is not specified" do
+  end
+  
+  it "should shutdown a selenium grid hub if told to, and if the hub is local" do
+  end
+
+end

data/spec/spec_helper.rb

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

data/spec/statt_spec.rb

@@ -0,0 +1,7 @@
+require File.expand_path(File.dirname(__FILE__) + '/spec_helper')
+
+describe "Statt" do
+  it "fails" do
+    fail "hey buddy, you should probably rename this file and start specing for real"
+  end
+end

metadata

@@ -0,0 +1,89 @@
+--- !ruby/object:Gem::Specification 
+name: statt
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- davidtrogers
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-21 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Testing web applications js and all
+email: david.t.rogers@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- LICENSE
+- README.rdoc
+files: 
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/cloud.rb
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/ec2.rb
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/ec2_client.rb
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/hub.rb
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/remote_command.rb
+- lib/selenium-grid/examples/ec2/lib/selenium_grid/aws/server.rb
+- lib/selenium-grid/examples/ec2/test/unit/all_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/cloud_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/ec2_client_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/hub_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/remote_command_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/server_test.rb
+- lib/selenium-grid/examples/ec2/test/unit/test_helper.rb
+- lib/selenium-grid/examples/ruby/flickr_example.rb
+- lib/selenium-grid/examples/ruby/lib/array_extension.rb
+- lib/selenium-grid/examples/ruby/lib/multi_process_behaviour_runner.rb
+- lib/selenium-grid/examples/ruby/paris_spec.rb
+- lib/selenium-grid/examples/ruby/perigord_spec.rb
+- lib/selenium-grid/examples/ruby/spec_helper.rb
+- lib/selenium-grid/lib/ruby/file_extensions.rb
+- lib/selenium-grid/lib/ruby/java/classpath.rb
+- lib/selenium-grid/lib/ruby/java/vm.rb
+- lib/selenium-grid/lib/ruby/s_grid/hub.rb
+- lib/selenium-grid/lib/ruby/s_grid/remote_control.rb
+- lib/selenium-grid/lib/ruby/tcp_socket_extensions.rb
+- lib/selenium-grid/sample-scripts/launch-remote-controls.rb
+- lib/statt.rb
+- lib/statt/client.rb
+- lib/statt/motor.rb
+- LICENSE
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/davidtrogers/statt
+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: Selenium Testing All The Time
+test_files: 
+- spec/client_spec.rb
+- spec/motor_spec.rb
+- spec/spec_helper.rb
+- spec/statt_spec.rb