scudco-spec_ui 0.2.5

data/History.txt

@@ -0,0 +1,10 @@
+== 0.2.4 (In SVN)
+* Made the formatter compatible with the RSpec 1.0.8 Formatter constructor
+* Examples are using Spec::Distributed's Rinda runners
+* Moved project from RSpec's subversion
+
+== 0.2.3
+* Made setup much easier
+
+== 0.2.2
+* Applied [#7685] Spec::Ui feedback and patch (Patch from Alvin Schur)

data/Manifest.txt

@@ -0,0 +1,29 @@
+TODO
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+examples/selenium/README.txt
+examples/selenium/Rakefile
+examples/selenium/spec/selenium/find_rspecs_homepage_spec.rb
+examples/selenium/spec/spec_helper.rb
+examples/watir/README.txt
+examples/watir/Rakefile
+examples/watir/spec/spec_helper.rb
+examples/watir/spec/watir/find_rspecs_homepage_spec.rb
+lib/spec/ui.rb
+lib/spec/ui/formatter.rb
+lib/spec/ui/images/rmagick_not_installed.png
+lib/spec/ui/images/win32screenshot_not_installed.png
+lib/spec/ui/images/wrong_win32screenshot.png
+lib/spec/ui/screenshot_saver.rb
+lib/spec/ui/selenium.rb
+lib/spec/ui/selenium/driver_ext.rb
+lib/spec/ui/version.rb
+lib/spec/ui/watir.rb
+lib/spec/ui/watir/browser.rb
+lib/spec/ui/watir/matchers.rb
+lib/spec/ui/watir/watir_behaviour.rb
+spec/spec.opts
+spec/spec/ui/watir/matchers_spec.rb
+spec/spec_helper.rb

data/README.txt

@@ -0,0 +1,12 @@
+Spec::Ui
+========
+
+Spec::Ui is an add-on to RSpec that lets you use a UI-testing framework
+such as Selenium or Watir/Safariwatir from RSpec. Spec::Ui also makes it
+easy to create HTML reports with screenshots as described in this blogpost:
+
+http://blog.aslakhellesoy.com/articles/2006/12/02/getting-screenshots-from-watir
+
+As much as possible of the supporting code has been factored out to separate files
+under Spec::Ui, and the distribution contains examples with a spec_helper and a Rakefile
+that you can copy into your own project and tweak if needed.

data/Rakefile

@@ -0,0 +1,133 @@
+require 'rubygems'
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'rake/contrib/rubyforgepublisher'
+require 'fileutils'
+require 'hoe'
+require 'spec/rake/spectask'
+
+include FileUtils
+require File.join(File.dirname(__FILE__), 'lib', 'spec', 'ui', 'version')
+
+AUTHOR = 'Aslak Hellesoy'
+EMAIL = 'aslak.hellesoy@gmail.com'
+DESCRIPTION = "Run RSpec with UI testing tools"
+GEM_NAME = 'spec_ui' # what ppl will type to install your gem
+
+@config_file = "~/.rubyforge/user-config.yml"
+@config = nil
+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 ||= @config["username"]
+end
+
+RUBYFORGE_PROJECT = 'rspec-ext' # The unix name for your project
+HOMEPATH = "http://#{RUBYFORGE_PROJECT}.rubyforge.org"
+
+
+#REV = YAML.load(`svn info`)['Revision'] rescue nil
+REV=nil
+VERS = Spec::Ui::VERSION::STRING + (REV ? ".#{REV}" : "")
+CLEAN.include ['**/.*.sw?', '*.gem', '.config', '**/.DS_Store']
+RDOC_OPTS = ['--quiet', '--title', 'Spec::Ui documentation',
+    "--opname", "index.html",
+    "--line-numbers", 
+    "--main", "README",
+    "--inline-source"]
+
+class Hoe
+  def extra_deps 
+    @extra_deps.reject { |x| Array(x).first == 'hoe' } 
+  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, VERS) do |p|
+  p.author = AUTHOR 
+  p.description = DESCRIPTION
+  p.email = EMAIL
+  p.summary = DESCRIPTION
+  p.url = HOMEPATH
+  p.rubyforge_name = RUBYFORGE_PROJECT if RUBYFORGE_PROJECT
+  p.test_globs = ["test/**/test_*.rb"]
+  p.clean_globs |= CLEAN  #An array of file patterns to delete on clean.
+  
+  # == Optional
+  p.changes = p.paragraphs_of("History.txt", 0..1).join("\n\n")
+  p.extra_deps = [['rspec', '>= 1.0.8']]     # An array of rubygem dependencies [name, version], e.g. [ ['active_support', '>= 1.3.1'] ]
+  #p.spec_extras = {}    # A hash of extra values to set in the gemspec.
+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')
+
+desc 'Generate website files'
+task :website_generate do
+  Dir['website/**/*.txt'].each do |txt|
+    sh %{ ruby scripts/txt2html #{txt} > #{txt.gsub(/txt$/,'html')} }
+  end
+end
+
+desc 'Upload website files to rubyforge'
+task :website_upload do
+  host = "#{rubyforge_username}@rubyforge.org"
+  remote_dir = "/var/www/gforge-projects/#{PATH}/"
+  local_dir = 'website'
+  sh %{rsync -aCv #{local_dir}/ #{host}:#{remote_dir}}
+end
+
+desc 'Generate and upload website files'
+task :website => [:website_generate, :website_upload, :publish_docs]
+
+desc 'Release the website and new gem version'
+task :deploy => [:check_version, :website, :release] do
+  puts "Remember to create SVN tag:"
+  puts "svn copy svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/trunk " +
+    "svn+ssh://#{rubyforge_username}@rubyforge.org/var/svn/#{PATH}/tags/REL-#{VERS} "
+  puts "Suggested comment:"
+  puts "Tagging release #{CHANGES}"
+end
+
+desc 'Runs tasks website_generate and install_gem as a local deployment of the gem'
+task :local_deploy => [:website_generate, :install_gem]
+
+task :check_version do
+  unless ENV['VERSION']
+    puts 'Must pass a VERSION=x.y.z release version'
+    exit
+  end
+  unless ENV['VERSION'] == VERS
+    puts "Please update your version.rb to match the release version, currently #{VERS}"
+    exit
+  end
+end
+
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_opts = ['--options', "spec/spec.opts"]
+  t.spec_files = FileList['spec/**/*_spec.rb']
+end
+
+# Hoe insists on setting task :default => :test
+# !@#$ no easy way to empty the default list of prerequisites
+Rake::Task['default'].send :instance_variable_set, "@prerequisites", FileList[]
+desc "Default task is to run specs"
+task :default => :spec
+

data/TODO

@@ -0,0 +1,8 @@
+== Formatter
+ * Get screenshots working without command line utilities?
+
+== WATIR
+ * Fix matchers
+
+== Selenium
+ * ???

data/examples/selenium/README.txt

@@ -0,0 +1,32 @@
+= Using Selenium with spec/ui =
+
+The files in this directory are examples illustrating how to use Selenium
+with spec/ui. Prerequisites:
+
+* Install Java 1.4 or later
+* Download SeleniumRC 0.9.0 or later (http://www.openqa.org/selenium-rc/)
+* Copy selenium-server.jar into the spec directory.
+* Copy selenium.rb into the spec directory.
+
+After this is installed, open two shells in this directory.
+
+In the first one, run:
+
+  java -jar spec/selenium-server.jar
+
+In the second one, run:
+
+  rake spec:selenium
+  
+= Note for OS X users =
+
+== Firefox 2.0.0.1 ==
+If you experience that the selenium server is just hanging, read this:
+http://forums.openqa.org/message.jspa?messageID=16541
+
+You may have better luck with one of the snapshot jars found under
+http://maven.openqa.org/org/openqa/selenium/server/selenium-server
+
+== Safari ==
+You may have to set up Safari's proxy settings manually:
+http://forums.openqa.org/thread.jspa?messageID=20570&#20570

data/examples/selenium/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+gem 'rspec', '>=1.0.8'
+gem 'spec_distributed', '>=0.0.3'
+require 'spec/rake/spectask'
+
+desc "Run Selenium Specs"
+Spec::Rake::SpecTask.new('spec:selenium') do |t|
+  t.spec_files = FileList['spec/selenium/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui', 
+    '--format', 'Spec::Ui::ScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end
+
+# IMPORTANT: If you use the master/slave mode you really ought to
+# run everything on different machines.
+
+desc "Run Selenium Specs as Spec::Distributed slave"
+Spec::Rake::SpecTask.new('spec:selenium:slave') do |t|
+  t.spec_files = FileList['spec/selenium/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui,spec/distributed', 
+    '--format', 'Spec::Ui::SlaveScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress',
+    '--runner', 'Spec::Distributed::RindaSlaveRunner'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end
+
+desc "Run Selenium Specs as Spec::Distributed master"
+Spec::Rake::SpecTask.new('spec:selenium:master') do |t|
+  t.spec_files = FileList['spec/selenium/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui,spec/distributed', 
+    '--format', 'Spec::Ui::MasterScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress',
+    '--runner', 'Spec::Distributed::RindaMasterRunner'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end

data/examples/selenium/spec/selenium/find_rspecs_homepage_spec.rb

@@ -0,0 +1,37 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Google's search page I" do
+
+  before(:each) do
+    # The @browser is initialised in spec_helper.rb
+    @browser.open('http://www.google.no')
+  end
+
+  it "should find rspec's home page when I search for rspec" do
+    @browser.type "name=q", "rspec"
+    @browser.click_and_wait "name=btnG"
+    @browser.is_text_present("rspec.rubyforge.org").should be_true
+  end
+
+end
+
+describe "Google's search page II" do
+
+  before(:each) do
+    # The @browser is initialised in spec_helper.rb
+    @browser.open('http://www.google.no')
+  end
+
+  it "should find rspec's home page when I search for 'better than fudge' (will probably fail)" do
+    @browser.type "name=q", "better than fudge"
+    @browser.click_and_wait "name=btnG"
+    @browser.is_text_present("rspec.rubyforge.org").should be_true
+  end
+
+  it "should not find Ali G when I search for rspec" do
+    @browser.type "name=q", "rspec"
+    @browser.click_and_wait "name=btnG"
+    @browser.is_text_present("Ali G").should be_false
+  end
+
+end

data/examples/selenium/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+# You don't need to tweak the $LOAD_PATH if you have Spec::Ui installed as gems
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../../lib')
+
+require 'rubygems'
+require 'spec'
+require 'spec/ui'
+require File.dirname(__FILE__) + '/selenium'
+require 'spec/ui/selenium'
+
+Spec::Runner.configure do |config|
+  config.before(:all) do
+    @browser = Selenium::SeleniumDriver.new("localhost", 4444, "*firefox", "http://www.google.no", 10000)
+    @browser.start
+  end
+  
+  config.after(:each) do
+    Spec::Ui::ScreenshotFormatter.instance.take_screenshot_of(@browser)
+  end
+
+  config.after(:all) do
+    @browser.kill! rescue nil
+  end
+end
+  

data/examples/watir/README.txt

@@ -0,0 +1,12 @@
+= Using Watir with spec/ui =
+
+The files in this directory are examples illustrating how to use Watir
+with spec/ui. Prerequisites:
+
+* See the general prerequisites in the toplevel README
+* gem install watir -y # If you're on Windows
+* gem install safariwatir -y # If you're on OS X
+
+After this is installed, run the watir specs:
+
+  rake spec:watir

data/examples/watir/Rakefile

@@ -0,0 +1,45 @@
+require 'rubygems'
+gem 'rspec', '>=1.0.8'
+gem 'spec_distributed', '>=0.0.3'
+require 'spec/rake/spectask'
+
+desc "Run Watir Specs"
+Spec::Rake::SpecTask.new('spec:watir') do |t|
+  t.spec_files = FileList['spec/watir/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui', 
+    '--format', 'Spec::Ui::ScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end
+
+# IMPORTANT: If you use the master/slave mode you really ought to
+# run everything on different machines.
+
+desc "Run Watir Specs as Spec::Distributed slave"
+Spec::Rake::SpecTask.new('spec:watir:slave') do |t|
+  t.spec_files = FileList['spec/watir/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui,spec/distributed', 
+    '--format', 'Spec::Ui::SlaveScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress',
+    '--runner', 'Spec::Distributed::RindaSlaveRunner'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end
+
+desc "Run Watir Specs as Spec::Distributed master"
+Spec::Rake::SpecTask.new('spec:watir:master') do |t|
+  t.spec_files = FileList['spec/watir/**/*.rb']
+  t.spec_opts = [
+    '--color', '--diff',
+    '--require', 'rubygems,spec/ui,spec/distributed', 
+    '--format', 'Spec::Ui::MasterScreenshotFormatter:doc/report/index.html',
+    '--format', 'progress',
+    '--runner', 'Spec::Distributed::RindaMasterRunner'
+  ]
+  t.libs = ["../../lib"] # This line is not necessary if you have Spec::Ui installed as a gem
+end

data/examples/watir/spec/spec_helper.rb

@@ -0,0 +1,34 @@
+# You don't need to tweak the $LOAD_PATH if you have Spec::Ui installed as gems
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../../../lib')
+
+require 'rubygems'
+require 'spec'
+require 'spec/ui'
+require 'spec/ui/watir'
+
+if RUBY_PLATFORM =~ /darwin/
+  require 'safariwatir'
+  Watir::Browser = Watir::Safari
+elsif RUBY_PLATFORM =~ /linux/
+  require 'firewatir'
+  Watir = FireWatir
+  Watir::Browser = FireWatir::Firefox
+else
+  require 'watir'
+  Watir::Browser = Watir::IE
+end
+
+Spec::Runner.configure do |config|
+  config.before(:all) do
+    @browser = Watir::Browser.new
+  end
+
+  config.after(:each) do
+    Spec::Ui::ScreenshotFormatter.instance.take_screenshot_of(@browser)
+  end
+
+  config.after(:all) do
+    @browser.close
+    sleep 5.5 # WTF apple throws an OS 609 Error unless we sleep for some arbitrary(okay maybe not) time
+  end
+end

data/examples/watir/spec/watir/find_rspecs_homepage_spec.rb

@@ -0,0 +1,35 @@
+require File.dirname(__FILE__) + '/../spec_helper'
+
+describe "Google's search page I" do
+  before(:each) do
+    # The @browser is initialised in spec_helper.rb
+    @browser.goto('http://www.google.com')
+  end
+
+  it "should find rspec's home page when I search for rspec" do
+    @browser.text_field(:name, "q").set("rspec")
+    @browser.button(:name, "btnG").click
+    @browser.should have_link(:url, "http://rspec.rubyforge.org/")
+  end
+end
+
+describe "Google's search page II" do
+  before(:each) do
+    # The @browser is initialised in spec_helper.rb
+    @browser.goto('http://www.google.com')
+  end
+
+  it "should find rspec's home page when I search for 'better than fudge' (this is supposed to fail)" do
+    @browser.text_field(:name, "q").set("better than fudge")
+    @browser.button(:name, "btnG").click
+    @browser.should have_link(:url, "http://rspec.rubyforge.org/")
+  end
+
+  it "should not find Ali G when I search for respec" do
+    @browser.text_field(:name, "q").set("respec")
+    @browser.button(:name, "btnG").click
+    @browser.should_not have_text("Ali G")
+  end
+  
+  it "should do something we haven't done yet"
+end

data/lib/spec/ui/formatter.rb

@@ -0,0 +1,168 @@
+require 'spec/runner/formatter/html_formatter'
+require 'spec/ui/screenshot_saver'
+require 'stringio'
+
+module Spec
+  module Ui
+    class ScreenshotFormatter < Spec::Runner::Formatter::HtmlFormatter
+      class << self
+        attr_accessor :instance
+      end
+
+      include ScreenshotSaver
+
+      def initialize(options, where)
+        if where.is_a?(String)
+          @root = File.dirname(where)
+          ensure_dir(where)
+          super
+        else
+          raise "#{self.class} must write to a file, so that we know where to store screenshots"
+        end
+        raise "Only one instance of #{self.class} is allowed" unless self.class.instance.nil?
+        ScreenshotFormatter.instance = self
+      end
+      
+      # Takes screenshot and snapshot of the +browser+'s html.
+      # This method calls #screenshot! so that method should not be called
+      # when this method is used.
+      # This method *must* be called in an after(:each) block.
+      def take_screenshot_of(browser)
+        save_html(browser)
+        screenshot
+      end
+      
+      # Takes a screenshot of the current window and saves it to disk. 
+      # Use this method when you don't have a browser object.
+      def screenshot
+        ensure_dir!(absolute_png_path)
+        save_screenshot(absolute_png_path)
+      end
+      
+      # Writes the HTML from +browser+ to disk
+      def save_html(browser)
+        ensure_dir!(absolute_html_path)
+        File.open(absolute_html_path, "w") {|io| io.write(browser.html)}
+      end
+      
+      def ensure_dir(file)
+        dir = File.dirname(file)
+        FileUtils.mkdir_p(dir) unless File.directory?(dir)
+      end
+
+      def ensure_dir!(file)
+        dir = File.dirname(file)
+        FileUtils.mkdir_p(dir)
+      end
+
+      def absolute_png_path
+        File.join(@root, relative_png_path)
+      end
+
+      def relative_png_path
+        "images/#{example_number}.png"
+      end
+
+      def absolute_html_path
+        File.join(@root, relative_html_path)
+      end
+
+      def relative_html_path
+        "html/#{example_number}.html"
+      end
+
+      def global_scripts
+        super + <<-EOF
+function showImage(e) {
+  w = window.open();
+  w.location = e.childNodes[0].src
+}
+
+// Lifted from Ruby RDoc
+function toggleSource( id ) {
+  var elem
+  var link
+
+  if( document.getElementById )
+  {
+    elem = document.getElementById( id )
+    link = document.getElementById( "l_" + id )
+  }
+  else if ( document.all )
+  {
+    elem = eval( "document.all." + id )
+    link = eval( "document.all.l_" + id )
+  }
+  else
+    return false;
+
+  if( elem.style.display == "block" )
+  {
+    elem.style.display = "none"
+    link.innerHTML = "show snapshot"
+  }
+  else
+  {
+    elem.style.display = "block"
+    link.innerHTML = "hide snapshot"
+  }
+}
+EOF
+      end
+
+      def global_styles
+        super + <<-EOF
+div.rspec-report textarea {
+  width: 100%;
+}
+
+div.rspec-report div.dyn-source {
+  background:#FFFFEE none repeat scroll 0%;
+  border:1px dotted black;
+  color:#000000;
+  display:none;
+  margin:0.5em 2em;
+  padding:0.5em;
+}
+EOF
+      end
+
+      def extra_failure_content(failure)
+        result = super(failure)
+        if File.exist?(absolute_png_path)
+          result += img_div 
+        end
+        if File.exist?(absolute_html_path)
+          source_id = "#{example_number}_source"
+          result += "        <div>[<a id=\"l_#{source_id}\" href=\"javascript:toggleSource('#{source_id}')\">show snapshot</a>]</div>\n"
+          result += "        <div id=\"#{source_id}\" class=\"dyn-source\"><iframe src=\"#{relative_html_path}\" width=\"100%\" height=\"300px\"></iframe></div>\n"
+        end
+        result
+      end
+ 
+      def img_div
+        "        <div><a href=\"#{relative_png_path}\"><img width=\"25%\" height=\"25%\" src=\"#{relative_png_path}\" /></a></div>\n"
+      end
+    end
+    
+    # This formatter produces the same HTML as ScreenshotFormatter, except that
+    # it doesn't save screenshot PNGs and browser snapshot HTML source to disk. 
+    # It is meant to be used from a Spec::Distributed master
+    class MasterScreenshotFormatter < ScreenshotFormatter
+      def screenshot
+      end
+      
+      def save_html(browser)
+      end
+    end
+    
+    # This formatter writes PNG and browser snapshot HTML to disk, just like its superclass,
+    # but it doesn't write the HTML report itself.
+    # It is meant to be used from Spec::Distributed slaves
+    class SlaveScreenshotFormatter < ScreenshotFormatter
+      def initialize(where)
+        super(where, StringIO.new)
+      end
+    end
+  end
+end

data/lib/spec/ui/screenshot_saver.rb

@@ -0,0 +1,63 @@
+require 'fileutils'
+
+module Spec
+  module Ui
+    module ScreenshotSaver
+      if RUBY_PLATFORM =~ /darwin/
+        def save_screenshot(png_path)
+          # How do we capture the current window??
+          `screencapture #{png_path}`
+        end
+      elsif RUBY_PLATFORM =~ /linux/
+        def save_screenshot(png_path)
+          # How do we capture the current window??
+          `scrot #{png_path}`
+        end
+      else # Win32
+        begin
+          # TODO: Move all this code to win32screenshot
+          require 'rubygems'
+          require 'RMagick'
+          gem 'win32screenshot', '>=0.0.2'
+          require 'win32screenshot'
+          def save_screenshot(png_path)
+            width, height, bmp = ::Win32::Screenshot.foreground
+            begin
+              img = Magick::Image.from_blob(bmp)[0]
+              img.write(png_path)
+              nil
+            rescue Magick::ImageMagickError => e
+              if e.message =~ /Insufficient image data in file/
+                e.message << <<-EOM
+This is a bug in win32screenshot - it fails to take screenshots of "small" windows. Try this workaround:
+
+1) Close all instances of the app you're trying to take a screenshot of (e.g. Internet Explorer)
+2) Open the app
+3) Resize the window so it occupies the entire screen (without maximizing it!)
+4) Exit the app. Windows will now remember its size the next time it starts.
+
+This *may* make this error go away
+EOM
+              end
+              raise e
+            end
+          end
+        rescue Gem::LoadError => e
+          def save_screenshot(png_path)
+            FileUtils.cp(File.dirname(__FILE__) + '/images/wrong_win32screenshot.png', png_path)
+          end
+        rescue LoadError => e
+          if(e.message =~ /win32screenshot/)
+            def save_screenshot(png_path)
+              FileUtils.cp(File.dirname(__FILE__) + '/images/win32screenshot_not_installed.png', png_path)
+            end
+          else
+            def save_screenshot(png_path)
+              FileUtils.cp(File.dirname(__FILE__) + '/images/rmagick_not_installed.png', png_path)
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/lib/spec/ui/selenium/driver_ext.rb

@@ -0,0 +1,21 @@
+module Selenium
+  class SeleniumDriver
+    def click_and_wait(locator, timeout="5000")
+      click(locator)
+      wait_for_page_to_load(timeout)
+    end
+
+    def open_and_wait(url, timeout="5000")
+      open(url)
+      wait_for_page_to_load(timeout)
+    end
+
+    def html
+      get_html_source
+    end
+    
+    def kill!
+      stop
+    end
+  end
+end

data/lib/spec/ui/selenium.rb

@@ -0,0 +1 @@
+require 'spec/ui/selenium/driver_ext'

data/lib/spec/ui/version.rb

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

data/lib/spec/ui/watir/matchers.rb

@@ -0,0 +1,97 @@
+# Matchers for Watir::IE/Watir::Safari instances
+module Spec::Matchers::Watir
+  class ContentMatcher # :nodoc
+    def initialize(kind, text_or_regexp)
+      @kind, @text_or_regexp = kind, text_or_regexp
+    end
+    
+    def matches?(container)
+      @container = container
+      @content = container.__send__(@kind)
+      if @text_or_regexp.is_a?(Regexp)
+        !!@content =~ @text_or_regexp
+      else
+        !!@content.index(@text_or_regexp.to_s)
+      end
+    end
+    
+    def failure_message
+      "Expected #{@container.class} to have #{@kind} matching #{@text_or_regexp}, but it was not found in:\n#{@content}"
+    end
+
+    def negative_failure_message
+      "Expected #{@container.class} to not have #{@kind} matching #{@text_or_regexp}, but it was found in:\n#{@content}"
+    end
+  end
+
+  # RSpec matcher that passes if @container#text matches +text_or_regexp+ (String or Regexp) 
+  def have_text(text_or_regexp)
+    ContentMatcher.new(:text, text_or_regexp)
+  end
+
+  # RSpec matcher that passes if @container#html matches +text_or_regexp+ (String or Regexp) 
+  def have_html(text_or_regexp)
+    ContentMatcher.new(:html, text_or_regexp)
+  end
+
+  class ElementMatcher # :nodoc
+    def initialize(kind, *args)
+      @kind, @args = kind, args
+    end
+    
+    def matches?(container)
+      @container = container
+      begin
+        element = @container.__send__(@kind, *@args)
+        if element.respond_to?(:assert_exists)
+          # IE
+          element.assert_exists
+          true
+        else
+          # Safari
+          element.exists?
+        end
+      rescue ::Watir::Exception::UnknownObjectException => e
+        false
+      end
+    end
+    
+    def failure_message
+      "Expected #{@container.class} to have #{@kind}(#{arg_string}), but it was not found"
+    end
+
+    def negative_failure_message
+      "Expected #{@container.class} to not have #{@kind}(#{arg_string}), but it was found"
+    end
+    
+    def arg_string
+      @args.map{|a| a.inspect}.join(", ")
+    end
+  end
+
+  # All the xxx(what, how) methods in Watir
+  [
+    :button, 
+    :cell, 
+    :checkbox, 
+    :div, 
+    :file_field, 
+    :form, 
+    :hidden, 
+    :image, 
+    :label,
+    :link,
+    :p, 
+    :radio, 
+    :row, 
+    :select_list,
+    :span,
+    :table,
+    :text_field
+  ].each do |kind|
+    # RSpec matcher that passes if container##{kind}(*args) returns an existing #{kind} element.
+    define_method("have_#{kind}".to_sym) do |*args|
+      ElementMatcher.new(kind, *args)
+    end
+  end
+end

data/lib/spec/ui/watir.rb

@@ -0,0 +1,5 @@
+require 'spec/ui/watir/matchers'
+
+Spec::Runner.configure do |config|
+  include Spec::Matchers::Watir
+end

data/lib/spec/ui.rb

@@ -0,0 +1,2 @@
+require 'spec/ui/formatter'
+require 'spec/ui/version'

data/spec/spec/ui/watir/matchers_spec.rb

@@ -0,0 +1,40 @@
+require File.dirname(__FILE__) + '/../../../spec_helper'
+require 'spec/ui/watir/matchers'
+
+class BrowserStub
+  def label(*args)
+    LabelStub.new(*args)
+  end
+end
+
+class LabelStub
+  def initialize(how, what)
+    @how, @what = how, what
+  end
+  
+  def exists?
+    @what
+  end
+end
+
+describe "Browser" do
+  include Spec::Matchers::Watir
+
+  before do
+    @b = BrowserStub.new
+  end
+  
+  it "should support should have_label" do
+    lambda do
+      @b.should have_label(:foo, false)
+    end.should raise_error(Spec::Expectations::ExpectationNotMetError, 
+      'Expected BrowserStub to have label(:foo, false), but it was not found')
+  end
+
+  it "should support should_not have_label" do
+    lambda do
+      @b.should_not have_label(:foo, true)
+    end.should raise_error(Spec::Expectations::ExpectationNotMetError, 
+      'Expected BrowserStub to not have label(:foo, true), but it was found')
+  end
+end

data/spec/spec.opts

@@ -0,0 +1,2 @@
+--colour
+--diff

data/spec/spec_helper.rb

@@ -0,0 +1,2 @@
+$LOAD_PATH.unshift(File.dirname(__FILE__) + '/../lib')
+require 'spec/ui'

metadata

@@ -0,0 +1,103 @@
+--- !ruby/object:Gem::Specification 
+name: scudco-spec_ui
+version: !ruby/object:Gem::Version 
+  version: 0.2.5
+platform: ruby
+authors: 
+- Aslak Hellesoy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-11-11 00:00:00 -08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.0.8
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: hoe
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.8.2
+    version: 
+description: Run RSpec with UI testing tools
+email: aslak.hellesoy@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- History.txt
+- Manifest.txt
+- README.txt
+- examples/selenium/README.txt
+- examples/watir/README.txt
+files: 
+- TODO
+- History.txt
+- Manifest.txt
+- README.txt
+- Rakefile
+- examples/selenium/README.txt
+- examples/selenium/Rakefile
+- examples/selenium/spec/selenium/find_rspecs_homepage_spec.rb
+- examples/selenium/spec/spec_helper.rb
+- examples/watir/README.txt
+- examples/watir/Rakefile
+- examples/watir/spec/spec_helper.rb
+- examples/watir/spec/watir/find_rspecs_homepage_spec.rb
+- lib/spec/ui.rb
+- lib/spec/ui/formatter.rb
+- lib/spec/ui/images/rmagick_not_installed.png
+- lib/spec/ui/images/win32screenshot_not_installed.png
+- lib/spec/ui/images/wrong_win32screenshot.png
+- lib/spec/ui/screenshot_saver.rb
+- lib/spec/ui/selenium.rb
+- lib/spec/ui/selenium/driver_ext.rb
+- lib/spec/ui/version.rb
+- lib/spec/ui/watir.rb
+- lib/spec/ui/watir/browser.rb
+- lib/spec/ui/watir/matchers.rb
+- lib/spec/ui/watir/watir_behaviour.rb
+- spec/spec.opts
+- spec/spec/ui/watir/matchers_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://rspec-ext.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: rspec-ext
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Run RSpec with UI testing tools
+test_files: []
+