statt 0.0.2 → 0.0.3

data/README.rdoc

@@ -1,21 +1,20 @@
 = 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.  
+Statt is Selenium Testing All The Time.  It's being built as a replacement for Webrat using Selenium servers organized in a grid, to speed up testing with multiple servers.  
 
-Roadmap
+== Progress
 
-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)
+So far, as of version 0.0.3:
+- You can spawn a Hub, which stands in for the Remote Control server in a grid setup. This can only be started locally to minimize network latency contributing to slowing down the tests.
+- You can spawn one to as many RC servers you need to do the job.  In the future, you'll be able to specify the location of servers that are non-local, though you'll have to start them up yourself.  
 
-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
+== TODO 
 
+- setting up the api for the selenium client, with the goal of replacing Webrat steps.
+- algorithm for dealing with features that modify the database to ensure a clean state for tests that need it.
+- cucumber integration (setup, teardown, tagging, database concurrency)
+- minimize gem size (~7.8MB)
+- wiki on how to set things up (Cucumber, DatabaseCleaner, Machinist).
+- optimizations for speed.
 
 == Note on Patches/Pull Requests
  

data/lib/statt/motor.rb

@@ -1,36 +1,82 @@
 #!/usr/local/bin/ruby -w 
 
-# require "selenium"
-require "test/unit"
-# require "selenium/server_manager"
-# require "selenium/selenium_server"
 require "selenium/client/driver"
 
 module Statt
   class Motor
-    attr_accessor :rc, :hub
+    attr_accessor :rc
     
     def initialize(options={})
+      
       options = { :hub_host => "localhost", 
-                  :hub_port => 4444 }.merge(options)
-                  :rc_options => [{:host => "localhost", :port => 5555 }]
+                  :hub_port => 4444,
+                  :rc_options => {:host => "localhost", :port => 5555 } }.merge(options)
+      
       hub_options = { :host => options[:hub_host], 
                       :port => options[:hub_port] }
-      @hub = SGrid::Hub.new(hub_options)
-      rc_options = options[:rc_options] 
-      if options[:rc_options].is_a?(Hash)
-        @rc = SGrid::RemoteControl.new(rc_option)
-      elsif options[:rc_options].is_a?(Array)
-        rc_options.each do |rc_option|
-          @rc = SGrid::RemoteControl.new(rc_option)
+  
+      # Start up Hub server in its own thread.
+      @hub_thread = Thread.new do 
+        Thread.current[:hub] = SGrid::Hub.new(hub_options)
+        Thread.current[:hub].start
+        self.pass
+      end
+      
+      @hub_thread[:hub].wait_until_up_and_running
+      
+      # Start up the RC Servers, each within their own thread.
+      @rc_threads = []
+      @rc_threads << Thread.new do
+        rc_options = options[:rc_options] 
+        if options[:rc_options].is_a?(Hash)
+          Thread.current[:server] = SGrid::RemoteControl.new(rc_options)
+          Thread.current[:server].start if rc_options[:host] == "localhost"
+        elsif options[:rc_options].is_a?(Array)
+          rc_options.each do |rc_option|
+            Thread.current[:server] = SGrid::RemoteControl.new(rc_option)
+            Thread.current[:server].start if rc_option[:host] == "localhost"
+          end
+        else
+          raise Exception, "there was a problem starting the rc server(s)", caller
         end
+        self.pass
       end
+      
     end
-    
-    def manager
-      self
+
+    def stop
+      Thread.new { shutdown_hub }
+      Thread.new { shutdown_rcs }
+      puts "Shutting down all servers "
     end
 
+    def shutdown_hub
+      @hub_thread[:hub].shutdown
+      puts "."
+    end
+    
+    def shutdown_rcs
+      @rc_threads.each do |thr|
+        thr[:server].shutdown
+        puts "."
+      end
+    end
+    
+    # def start_hub
+    # end
+    # 
+    # def start_rcs
+    # end
+    
+    private
+    
+    def hub
+      @hub_thread[:hub]
+    end
+    
+    def rc_servers
+      @rc_threads.map {|thr| thr[:server] }
+    end
     
   end
 end

data/spec/spec_helper.rb

@@ -1,3 +1,20 @@
+require 'rubygems'
+
+
+# --- Instructions ---
+# - Sort through your spec_helper file. Place as much environment loading 
+#   code that you don't normally modify during development in the 
+#   Spork.prefork block.
+# - Place the rest under Spork.each_run block
+# - Any code that is left outside of the blocks will be ran during preforking
+#   and during each_run!
+# - These instructions should self-destruct in 10 seconds.  If they don't,
+#   feel free to delete them.
+#
+
+
+
+
 $LOAD_PATH.unshift(File.dirname(__FILE__))
 $LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
 require 'statt'

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: statt
 version: !ruby/object:Gem::Version 
-  version: 0.0.2
+  version: 0.0.3
 platform: ruby
 authors: 
 - davidtrogers
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-10-23 00:00:00 -04:00
+date: 2009-10-24 00:00:00 -04:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency