rwebunit 0.8.9 → 0.9.4

data/CHANGELOG

@@ -1,5 +1,31 @@
 CHANGELOG
 =========
+
+== 0.9.4
+ - change test_context => context, avoid confusing Ruby test
+ - refactored driver.rb 
+
+== 0.9.3
+ - add method failsafe {}
+ 
+== 0.9.2
+ - sleep 0.5 seconds after clicking popup window
+ - save current page
+ - (0.9.1.1) support rspec 1.1.4: at exit hook
+ 
+== 0.9.1 (2008-05-26)
+ - support storing page source during execution
+
+== 0.9 (2008-05-21)
+  - support new syntax
+       spec "" do
+		  scenario "1" do
+		  end
+		
+		  story "2" do
+		  end
+       end
+
 == 0.8.9
   - support Watir 1.5.4 zippy mode, set it as default
 

data/Rakefile

@@ -1,68 +1,68 @@
-require 'rubygems'
-require 'rake/testtask'
-require 'rake/rdoctask'
-
-Gem::manage_gems
-require 'rake/gempackagetask'
-
-$:.unshift(File.dirname(__FILE__) + "/lib")
-#require 'rwebunit'
-
-desc "Default task"
-task :default => [ :clean, :test, :doc, :gem]
-
-desc "Clean generated files"
-task :clean do
-  rm_rf 'pkg'
-  rm_rf 'doc'
-end
-
-# run the unit tests
-Rake::TestTask.new("test") { |t|
-  t.test_files = FileList['test/test*.rb']
-  t.verbose= true
-}
-
-# Generate the RDoc documentation
-Rake::RDocTask.new { |rdoc|
-  rdoc.rdoc_dir = 'doc'
-  rdoc.title = 'rWebUnit'
-  rdoc.template = "#{ENV['template']}.rb" if ENV['template']
-  rdoc.rdoc_files.include('README')
-  rdoc.rdoc_files.include('lib/rwebunit.rb')
-  rdoc.rdoc_files.include('lib/rwebunit/*.rb')
-}
-
-spec = Gem::Specification.new do |s|
-  s.platform= Gem::Platform::RUBY
-  s.name = "rwebunit"
-  s.version = "0.8.9"
-  s.summary = "An wrap of WATIR/FireWatir for functional testing of web applications"
-# s.description = ""
-
-  s.author  = "Zhimin Zhan"
-  s.email   = "zhimin@agileway.net"
-  s.homepage= "http://code.google.com/p/rwebunit/"
-#  s.rubyforge_project = ""
-
-  s.has_rdoc    = true
-  s.requirements << 'none'
-  s.require_path    = "lib"
-  s.autorequire     = "rwebunit"
-
-  s.files = [ "Rakefile", "README", "CHANGELOG", "MIT-LICENSE" ]
-#  s.files = s.files + Dir.glob( "bin/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
-  s.files = s.files + Dir.glob( "lib/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
-  s.files = s.files + Dir.glob( "test/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
-  s.files = s.files + Dir.glob( "sample/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
-  s.files = s.files + Dir.glob( "docs/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
-
-#  s.add_dependency("watir", ">= 1.5.3")
-#  s.add_dependency("firewatir", ">= 1.1")
-end
-
-Rake::GemPackageTask.new(spec) do |pkg|
-  pkg.need_zip = true
-end
-
-
+require 'rubygems'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+Gem::manage_gems
+require 'rake/gempackagetask'
+
+$:.unshift(File.dirname(__FILE__) + "/lib")
+#require 'rwebunit'
+
+desc "Default task"
+task :default => [ :clean, :test, :doc, :gem]
+
+desc "Clean generated files"
+task :clean do
+  rm_rf 'pkg'
+  rm_rf 'doc'
+end
+
+# run the unit tests
+Rake::TestTask.new("test") { |t|
+  t.test_files = FileList['test/test*.rb']
+  t.verbose= true
+}
+
+# Generate the RDoc documentation
+Rake::RDocTask.new { |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title = 'rWebUnit'
+  rdoc.template = "#{ENV['template']}.rb" if ENV['template']
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/rwebunit.rb')
+  rdoc.rdoc_files.include('lib/rwebunit/*.rb')
+}
+
+spec = Gem::Specification.new do |s|
+  s.platform= Gem::Platform::RUBY
+  s.name = "rwebunit"
+  s.version = "0.9.4"
+  s.summary = "An wrap of WATIR/FireWatir for functional testing of web applications"
+# s.description = ""
+
+  s.author  = "Zhimin Zhan"
+  s.email   = "zhimin@agileway.net"
+  s.homepage= "http://code.google.com/p/rwebunit/"
+  s.rubyforge_project = "rwebunit"
+
+  s.has_rdoc    = true
+  s.requirements << 'none'
+  s.require_path    = "lib"
+  s.autorequire     = "rwebunit"
+
+  s.files = [ "Rakefile", "README", "CHANGELOG", "MIT-LICENSE" ]
+#  s.files = s.files + Dir.glob( "bin/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.files = s.files + Dir.glob( "lib/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.files = s.files + Dir.glob( "test/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.files = s.files + Dir.glob( "sample/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.files = s.files + Dir.glob( "docs/**/*" ).delete_if { |item| item.include?( "\.svn" ) }
+  s.add_dependency(%q<rspec>, [">= 1.1.4"])
+#  s.add_dependency("watir", ">= 1.5.4")
+#  s.add_dependency("firewatir", ">= 1.1")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+end
+
+

data/lib/rspec_extensions.rb

@@ -0,0 +1,107 @@
+module Spec
+  module Extensions
+    module Main
+
+      alias :spec :describe
+      alias :specification :describe
+
+    end
+  end
+end
+
+
+module Spec
+  module Example
+    module ExampleGroupMethods
+
+      alias_method :scenario, :it
+      alias_method :story, :it
+    end
+  end
+end
+
+module Spec
+  module Runner
+    class SpecParser
+      def example_group_at_line(source, line_number)
+        find_above(source, line_number, /^\s*(context|describe|specification|spec)\s+(.*)\s+do/)
+      end
+
+      def example_at_line(source, line_number)
+        find_above(source, line_number, /^\s*(specify|it|story|scenario)\s+(.*)\s+do/)
+      end
+    end
+  end
+end
+
+module Spec
+    module Runner
+      class << self
+           def register_at_exit_hook # :nodoc:
+              #ignore at exit hook
+           end
+      end
+    end
+end
+
+module Spec
+  class Translator
+
+    def translate_line(line)
+      # Translate deprecated mock constraints
+      line.gsub!(/:any_args/, 'any_args')
+      line.gsub!(/:anything/, 'anything')
+      line.gsub!(/:boolean/, 'boolean')
+      line.gsub!(/:no_args/, 'no_args')
+      line.gsub!(/:numeric/, 'an_instance_of(Numeric)')
+      line.gsub!(/:string/, 'an_instance_of(String)')
+
+      return line if line =~ /(should_not|should)_receive/
+
+      line.gsub!(/(^\s*)context([\s*|\(]['|"|A-Z])/, '\1describe\2')
+      line.gsub!(/(^\s*)spec([\s*|\(]['|"|A-Z])/, '\1describe\2') #new
+      line.gsub!(/(^\s*)specification([\s*|\(]['|"|A-Z])/, '\1describe\2') #new
+      line.gsub!(/(^\s*)specify([\s*|\(]['|"|A-Z])/, '\1it\2')
+      line.gsub!(/(^\s*)scenario([\s*|\(]['|"|A-Z])/, '\1it\2')  #new
+      line.gsub!(/(^\s*)story([\s*|\(]['|"|A-Z])/, '\1it\2')  #new
+      line.gsub!(/(^\s*)context_setup(\s*[do|\{])/, '\1before(:all)\2')
+      line.gsub!(/(^\s*)context_teardown(\s*[do|\{])/, '\1after(:all)\2')
+      line.gsub!(/(^\s*)setup(\s*[do|\{])/, '\1before(:each)\2')
+      line.gsub!(/(^\s*)teardown(\s*[do|\{])/, '\1after(:each)\2')
+
+      if line =~ /(.*\.)(should_not|should)(?:_be)(?!_)(.*)/m
+        pre = $1
+        should = $2
+        post = $3
+        be_or_equal = post =~ /(<|>)/ ? "be" : "equal"
+
+        return "#{pre}#{should} #{be_or_equal}#{post}"
+      end
+
+      if line =~ /(.*\.)(should_not|should)_(?!not)\s*(.*)/m
+        pre = $1
+        should = $2
+        post = $3
+
+        post.gsub!(/^raise/, 'raise_error')
+        post.gsub!(/^throw/, 'throw_symbol')
+
+        unless standard_matcher?(post)
+          post = "be_#{post}"
+        end
+
+        # Add parenthesis
+        post.gsub!(/^(\w+)\s+([\w|\.|\,|\(.*\)|\'|\"|\:|@| ]+)(\})/, '\1(\2)\3') # inside a block
+        post.gsub!(/^(redirect_to)\s+(.*)/, '\1(\2)') # redirect_to, which often has http:
+        post.gsub!(/^(\w+)\s+([\w|\.|\,|\(.*\)|\{.*\}|\'|\"|\:|@| ]+)/, '\1(\2)')
+        post.gsub!(/(\s+\))/, ')')
+        post.gsub!(/\)\}/, ') }')
+        post.gsub!(/^(\w+)\s+(\/.*\/)/, '\1(\2)') #regexps
+        line = "#{pre}#{should} #{post}"
+      end
+
+      line
+    end
+  end
+end
+

data/lib/rwebunit/{test_context.rb → context.rb}

@@ -8,7 +8,7 @@ module RWebUnit
   ##
   #  Store test optionns
   #
-  class TestContext
+  class Context
     attr_accessor :base_url
 
     def initialize(base_url)

data/lib/rwebunit/driver.rb

@@ -1,424 +1,279 @@
-# The Mixin is normally included in the spec/tests and pages, provide
-# convenient methods to drive the browser.
-#
-# Instead of
-#    browser.click_button("submit")
-# You can just use
-#    click_button("submit")
-#
-
-module RWebUnit
-  module Driver
-
-    # Verify the next page following an operation.
-    #
-    # Typical usage:
-    #   login_page.click_login
-    #   expect_page HomePage
-    def expect_page(page_clazz)
-      page_clazz.new(@web_tester)
-    end
-
-    # Using Ruby block syntax to create interesting domain specific language,
-    # may be appeal to someone.
-
-    # Example:
-    #  on @page do |i|
-    #    i.enter_text('btn1')
-    #    i.click_button('btn1')
-    #  end
-    def on(page, &block)
-      yield page
-    end
-
-    def test_context
-      @web_tester.test_context
-    end
-
-    def begin_at(url)
-      @web_tester.begin_at(url)
-    end
-
-    def ie;
-      @web_tester.ie;
-    end
-
-    def close_browser
-      @web_tester.close_browser unless ENV['ITEST_LEAVE_BROWSER_OPEN_AFTER_RUN'] == "true"
-    end
-    alias close_ie close_browser
-
-    # browser navigation
-    def go_back;
-      @web_tester.go_back;
-    end
-    def go_forward;
-      @web_tester.go_forward;
-    end
-
-    def goto_page(page)
-      operation_delay
-      @web_tester.goto_page(page);
-    end
-    def refresh;
-      @web_tester.refresh;
-    end
-    alias refresh_page refresh
-
-    def attach_browser(how, what)
-      WebTester.attach_browser(how, what)
-    end
-
-    ##
-    #  Delegate to WebTester
-    #
-
-    # Depends on which object type, you can use following attribute
-    # More details: http://wiki.openqa.org/display/WTR/Methods+supported+by+Element
-    #
-    # :id 	 Used to find an element that has an "id=" attribute. Since each id should be unique, according to the XHTML specification, this is recommended as the most reliable method to find an object. *
-    # :name 	Used to find an element that has a "name=" attribute. This is useful for older versions of HTML, but "name" is deprecated in XHTML. *
-    # :value 	Used to find a text field with a given default value, or a button with a given caption, or a text field
-    # :text 	Used for links, spans, divs and other element that contain text.
-    # :index 	Used to find the nth element of the specified type on a page. For example, button(:index, 2) finds the second button. Current versions of WATIR use 1-based indexing, but future versions will use 0-based indexing.
-    # :class 	Used for an element that has a "class=" attribute.
-    # :title 	Used for an element that has a "title=" attribute.
-    # :xpath 	Finds the item using xpath query.
-    # :method 	Used only for forms, the method attribute of a form is either GET or POST.
-    # :action 	Used only for form elements, specifies the URL where the form is to be submitted.
-    # :href 	Used to identify a link by its "href=" attribute.
-    # :src 	Used to identify an image by its URL.
-    #
-
-    # area 	<area> tags
-    # button 	<input> tags with type=button, submit, image or reset
-    # check_box 	<input> tags with type=checkbox
-    # div 	<div> tags
-    # form 	<form> tags
-    # frame 	frames, including both the <frame> elements and the corresponding pages
-    # h1 - h6 	<h1>, <h2>, <h3>, <h4>, <h5>, <h6> tags
-    # hidden 	<input> tags with type=hidden
-    # image 	<img> tags
-    # label 	<label> tags (including "for" attribute)
-    # li 	<li> tags
-    # link 	<a> (anchor) tags
-    # map 	<map> tags
-    # radio 	<input> tags with the type=radio; known as radio buttons
-    # select_list 	<select> tags, known as drop-downs or drop-down lists
-    # span 	<span> tags
-    # table 	<table> tags, including row and cell methods for accessing nested elements
-    # text_field 	<input> tags with the type=text (single-line), type=textarea (multi-line), and type=password
-    # p 	<p> (paragraph) tags, because
-    def area(*args)
-      @web_tester.area(*args);
-    end
-    def button(*args)
-      @web_tester.button(*args);
-    end
-    def cell(*args)
-      @web_tester.cell(*args);
-    end
-    alias td cell
-    
-    def checkbox(*args)
-      @web_tester.checkbox(*args);
-    end
-    alias check_box checkbox  # seems watir doc is wrong, checkbox not check_box
-    
-    def div(*args)
-      @web_tester.div(*args);
-    end
-    def form(*args)
-      @web_tester.form(*args);
-    end
-    def frame(*args)
-      @web_tester.frame(*args);
-    end
-    def h1(*args)
-      @web_tester.h1(*args);
-    end
-    def h2(*args)
-      @web_tester.h2(*args);
-    end
-    def h3(*args)
-      @web_tester.h3(*args);
-    end
-    def h4(*args)
-      @web_tester.h4(*args);
-    end
-    def h5(*args)
-      @web_tester.h5(*args);
-    end
-    def h6(*args)
-      @web_tester.h6(*args);
-    end
-    def hidden(*args)
-      @web_tester.hidden(*args);
-    end
-    def image(*args)
-      @web_tester.image(*args);
-    end
-    def li(*args)
-      @web_tester.li(*args);
-    end
-    def link(*args)
-      @web_tester.link(*args);
-    end
-    def map(*args)
-      @web_tester.map(*args);
-    end
-    def pre(*args)
-      @web_tester.pre(*args);
-    end
-    def row(*args)
-      @web_tester.row(*args);
-    end
-    alias tr row
-    
-    def radio(*args)
-      @web_tester.radio(*args);
-    end
-    def select_list(*args)
-      @web_tester.select_list(*args);
-    end
-    def span(*args)
-      @web_tester.span(*args);
-    end
-    def table(*args)
-      @web_tester.table(*args);
-    end
-    def text_field(*args)
-      @web_tester.text_field(*args);
-    end
-
-    def paragraph(*args)
-      @web_tester.paragraph(*args);
-    end
-    def file_field(*args)
-      @web_tester.file_field(*args);
-    end
-    def label(*args)
-      @web_tester.label(*args);
-    end
-
-    def contains_text(text)
-      @web_tester.contains_text(text);
-    end
-
-
-    def images;
-      @web_tester.images;
-    end
-    def links;
-      @web_tester.links;
-    end
-    def buttons;
-      @web_tester.buttons;
-    end
-    def select_lists;
-      @web_tester.select_lists;
-    end
-    def checkboxes;
-      @web_tester.checkboxes;
-    end
-    def radios;
-      @web_tester.radios;
-    end
-    def text_fields;
-      @web_tester.text_fields;
-    end
-
-
-    # enter text into a text field
-    def enter_text(elementName, elementValue)
-      operation_delay
-      @web_tester.set_form_element(elementName, elementValue)
-    end
-    alias set_form_element enter_text
-
-
-    #links
-    def click_link_with_text(link_text)
-      operation_delay
-      @web_tester.click_link_with_text(link_text)
-    end
-    alias click_link click_link_with_text
-
-    def click_link_with_id(link_id)
-      operation_delay
-      @web_tester.click_link_with_id(link_id)
-    end
-
-    ##
-    # buttons
-
-    # submit the form using the first (index) submit button
-    def submit()
-      operation_delay
-      @web_tester.submit()
-    end
-
-    # click a form submit button with specified button id
-    def submit(button_id)
-      operation_delay
-      @web_tester.submit(button_id)
-    end
-
-    def click_button_with_id(button_id)
-      operation_delay
-      @web_tester.click_button_with_id(button_id)
-    end
-
-    def click_button_with_caption(caption)
-      operation_delay
-      @web_tester.click_button_with_caption(caption)
-    end
-    alias click_button_with_text click_button_with_caption
-    alias click_button click_button_with_caption
-
-    def click_button_with_image_src_contains(image_filename)
-      operation_delay
-      found = nil
-      raise "no buttons in this page" if buttons.length <= 0
-      buttons.each { |btn|
-        if btn && btn.src  && btn.src.include?(image_filename) then
-          found = btn
-          break
-        end
-      }
-      raise "not image button with src: #{image_filename} found" if found.nil?
-      found.click
-    end
-    alias click_button_with_image click_button_with_image_src_contains
-
-    def click_button_with_value(value)
-      operation_delay
-      @web_tester.click_button_with_value(value)
-    end
-
-    # Radios
-    def click_radio_option(name, value)
-      operation_delay
-      @web_tester.click_radio_option(name, value)
-    end
-    alias click_radio_button click_radio_option
-
-    def clear_radio_option(name, value)
-      operation_delay
-      @web_tester.clear_radio_option(name, value)
-    end
-    alias clear_radio_button clear_radio_option
-
-    # Filefield
-    def select_file_for_upload(file_field, file_path)
-      operation_delay
-      @web_tester.select_file_for_upload(file_field, file_path)
-    end
-
-    # Check one or more checkboxes with same name, can accept a string or an array of string as values checkbox, pass array as values will try to set mulitple checkboxes.
-    #
-    # page.check_checkbox('bad_ones', 'Chicken Little')
-    # page.check_checkbox('good_ones', ['Cars', 'Toy Story'])
-    def check_checkbox(name, value=nil)
-      operation_delay
-      @web_tester.check_checkbox(name, value)
-    end
-
-    # Uncheck one or more checkboxes with same name
-    def uncheck_checkbox(name, value=nil)
-      operation_delay
-      @web_tester.uncheck_checkbox(name, value)
-    end
-
-    # combo box
-    def select_option(selectName, option)
-      operation_delay
-      @web_tester.select_option(selectName, option)
-    end
-
-    def new_popup_window(options)
-      @web_tester.new_popup_window(options)
-    end
-
-    # Wait for specific seconds for an Ajax update finish.
-    # Trick: In your Rails application,
-    #     :loading 	=> "Element.show('search_indicator');
-    #     :complete	=> "Element.hide('search_indicator');
-    #
-    #   <%= image_tag("indicator.gif", :id => 'search_indicator', :style => 'display:none') %>
-    #
-    # Typical usage:
-    #    ajax_wait_for_element("search_indicator", 30)
-    #    ajax_wait_for_element("search_indicator", 30, "show")
-    #    ajax_wait_for_element("search_indicator", 30, "hide")
-    #    ajax_wait_for_element("search_indicator", 30, "show", 5) # check every 5 seconds
-    #
-    # Warning: this method has not been fully tested, if you are not using Rails, change your parameter accordingly.
-    #
-    def ajax_wait_for_element(element_id, seconds, status='show', check_interval=2)
-      count = 0
-      check_interval = 2 if check_interval < 1 or check_interval > seconds
-      while count < (seconds / check_interval) do
-        search_indicator = @web_tester.element_by_id(element_id)
-        search_indicator_outer_html = search_indicator.outerHtml if search_indicator
-        if status == 'hide'
-          return true if search_indicator_outer_html and !search_indicator_outer_html.include?('style="DISPLAY: none"')
-        else
-          return true if search_indicator_outer_html and search_indicator_outer_html.include?('style="DISPLAY: none"')
-        end
-        sleep check_interval if check_interval > 0 and check_interval < 5 * 60 # wait max 5 minutes
-        count += 1
-      end
-      return false
-    end
-
-    def wait_for_element(element_id, timeout = 30, interval = 0.5)
-      start_time = Time.now
-      until @web_tester.element_by_id(element_id) do
-        sleep(interval)
-        if (Time.now - start_time) > timeout
-          raise RuntimeError, "failed to find element: #{element_id} for max #{timeout}"
-        end
-      end
-    end
-
-    def element_text(elem_id)
-      @web_tester.element_value(elem_id)
-    end
-
-    # fail the test if user can perform the operation
-    def shall_not_allow
-      operation_performed_ok = false
-      begin
-        yield
-        operation_performed_ok  = true
-      rescue
-      end
-
-      raise "Operation shall not be allowed" if operation_performed_ok
-    end
-    alias do_not_allow shall_not_allow
-
-    # ---
-    # For debugging
-    # ---
-    def dump_response(stream = nil)
-      @web_tester.dump_response(stream)
-    end
-
-    def click_popup_window(button, waitTime= 9, user_input=nil )
-      @web_tester.start_clicker(button, waitTime, user_input)
-    end
-
-    def operation_delay
-      begin
-        if ENV['ITEST_OPERATION_DELAY']  && ENV['ITEST_OPERATION_DELAY'].to_i > 0 && ENV['ITEST_OPERATION_DELAY'].to_f < 30000  then # max 30 seconds
-          sleep(ENV['ITEST_OPERATION_DELAY'].to_f / 1000)
-        end
-      rescue => e
-        # ignore
-      end
-    end
-
-  end
-end
+# The Mixin is normally included in the spec/tests and pages, provide
+# convenient methods to drive the browser.
+#
+# Instead of
+#    browser.click_button("submit")
+# You can just use
+#    click_button("submit")
+#
+
+module RWebUnit
+  module Driver
+
+    # Verify the next page following an operation.
+    #
+    # Typical usage:
+    #   login_page.click_login
+    #   expect_page HomePage
+    def expect_page(page_clazz)
+      page_clazz.new(@web_tester)
+    end
+
+    # Using Ruby block syntax to create interesting domain specific language,
+    # may be appeal to someone.
+
+    # Example:
+    #  on @page do |i|
+    #    i.enter_text('btn1')
+    #    i.click_button('btn1')
+    #  end
+    def on(page, &block)
+      yield page
+    end
+
+    # fail the test if user can perform the operation
+    #
+    # Example:
+    #  shall_not_allow { 1/0 }
+    def shall_not_allow(&block)
+      operation_performed_ok = false
+      begin
+        yield
+        operation_performed_ok  = true
+      rescue
+      end
+      raise "Operation shall not be allowed" if operation_performed_ok
+    end
+    alias do_not_allow shall_not_allow
+
+    def allow(&block)
+      operation_performed_ok = false
+      begin
+        yield
+        operation_performed_ok  = true
+      rescue
+      end
+      operation_performed_ok
+    end
+
+    # try operation, ignore if errors occur
+    #
+    # Example:
+    #   failsafe { click_link("Logout") }  # try logout, but it still OK if not being able to (already logout))
+    def failsafe(&block)
+      begin
+        yield
+      rescue =>e
+      end
+    end
+    alias fail_safe failsafe
+
+    def context
+      @web_tester.context
+    end
+
+    def begin_at(url)
+      @web_tester.begin_at(url)
+    end
+
+    def ie
+      @web_tester.ie
+    end
+
+    def close_browser
+      @web_tester.close_browser unless ENV['ITEST_LEAVE_BROWSER_OPEN_AFTER_RUN'] == "true"
+    end
+    alias close_ie close_browser
+
+    [:go_back, :go_forward, :refresh].each do |method|
+      define_method(method) do
+        @web_tester.send(method)
+      end
+    end
+    alias refresh_page refresh
+
+    def goto_page(page)
+      operation_delay
+      @web_tester.goto_page(page);
+    end
+
+    def attach_browser(how, what)
+      WebTester.attach_browser(how, what)
+    end
+
+    ##
+    #  Delegate to WebTester
+    #
+
+    # Depends on which object type, you can use following attribute
+    # More details: http://wiki.openqa.org/display/WTR/Methods+supported+by+Element
+    #
+    # :id 	 Used to find an element that has an "id=" attribute. Since each id should be unique, according to the XHTML specification, this is recommended as the most reliable method to find an object. *
+    # :name 	Used to find an element that has a "name=" attribute. This is useful for older versions of HTML, but "name" is deprecated in XHTML. *
+    # :value 	Used to find a text field with a given default value, or a button with a given caption, or a text field
+    # :text 	Used for links, spans, divs and other element that contain text.
+    # :index 	Used to find the nth element of the specified type on a page. For example, button(:index, 2) finds the second button. Current versions of WATIR use 1-based indexing, but future versions will use 0-based indexing.
+    # :class 	Used for an element that has a "class=" attribute.
+    # :title 	Used for an element that has a "title=" attribute.
+    # :xpath 	Finds the item using xpath query.
+    # :method 	Used only for forms, the method attribute of a form is either GET or POST.
+    # :action 	Used only for form elements, specifies the URL where the form is to be submitted.
+    # :href 	Used to identify a link by its "href=" attribute.
+    # :src 	Used to identify an image by its URL.
+    #
+
+    # area 	<area> tags
+    # button 	<input> tags with type=button, submit, image or reset
+    # check_box 	<input> tags with type=checkbox
+    # div 	<div> tags
+    # form 	<form> tags
+    # frame 	frames, including both the <frame> elements and the corresponding pages
+    # h1 - h6 	<h1>, <h2>, <h3>, <h4>, <h5>, <h6> tags
+    # hidden 	<input> tags with type=hidden
+    # image 	<img> tags
+    # label 	<label> tags (including "for" attribute)
+    # li 	<li> tags
+    # link 	<a> (anchor) tags
+    # map 	<map> tags
+    # radio 	<input> tags with the type=radio; known as radio buttons
+    # select_list 	<select> tags, known as drop-downs or drop-down lists
+    # span 	<span> tags
+    # table 	<table> tags, including row and cell methods for accessing nested elements
+    # text_field 	<input> tags with the type=text (single-line), type=textarea (multi-line), and type=password
+    # p 	<p> (paragraph) tags, because
+    [:area, :button, :cell, :checkbox, :div, :form, :frame, :h1, :h2, :h3, :h4, :h5, :h6, :hidden, :image, :li, :link, :map, :pre, :row, :radio, :select_list, :span, :table, :text_field, :paragraph, :file_field, :label].each do |method|
+      define_method method do |*args|
+        @web_tester.send(method, *args)
+      end
+    end
+    alias td cell
+    alias check_box checkbox  # seems watir doc is wrong, checkbox not check_box
+    alias tr row
+
+    def contains_text(text)
+      @web_tester.contains_text(text);
+    end
+
+    [:images, :links, :buttons, :select_lists, :checkboxes, :radios, :text_fields].each do |method|
+      define_method method do
+        @web_tester.send(method)
+      end
+    end
+
+    # Check one or more checkboxes with same name, can accept a string or an array of string as values checkbox, pass array as values will try to set mulitple checkboxes.
+    #
+    # page.check_checkbox('bad_ones', 'Chicken Little')
+    # page.check_checkbox('good_ones', ['Cars', 'Toy Story'])
+
+    [:set_form_element, :click_link_with_text, :click_link_with_id, :submit, :click_button_with_id, :click_button_with_caption, :click_button_with_value, :click_radio_option, :clear_radio_option, :select_file_for_upload, :check_checkbox, :uncheck_checkbox, :select_option].each do |method|
+      define_method method do |*args|
+        @web_tester.send(method, *args)
+      end
+    end
+
+    alias enter_text set_form_element
+    alias click_link click_link_with_text
+    alias click_button_with_text click_button_with_caption
+    alias click_button click_button_with_caption
+    alias click_radio_button click_radio_option
+    alias clear_radio_button clear_radio_option
+
+    def click_button_with_image_src_contains(image_filename)
+      operation_delay
+      found = nil
+      raise "no buttons in this page" if buttons.length <= 0
+      buttons.each { |btn|
+        if btn && btn.src  && btn.src.include?(image_filename) then
+          found = btn
+          break
+        end
+      }
+      raise "not image button with src: #{image_filename} found" if found.nil?
+      found.click
+    end
+    alias click_button_with_image click_button_with_image_src_contains
+
+    def new_popup_window(options)
+      @web_tester.new_popup_window(options)
+    end
+
+    # Wait for specific seconds for an Ajax update finish.
+    # Trick: In your Rails application,
+    #     :loading 	=> "Element.show('search_indicator');
+    #     :complete	=> "Element.hide('search_indicator');
+    #
+    #   <%= image_tag("indicator.gif", :id => 'search_indicator', :style => 'display:none') %>
+    #
+    # Typical usage:
+    #    ajax_wait_for_element("search_indicator", 30)
+    #    ajax_wait_for_element("search_indicator", 30, "show")
+    #    ajax_wait_for_element("search_indicator", 30, "hide")
+    #    ajax_wait_for_element("search_indicator", 30, "show", 5) # check every 5 seconds
+    #
+    # Warning: this method has not been fully tested, if you are not using Rails, change your parameter accordingly.
+    #
+    def ajax_wait_for_element(element_id, seconds, status='show', check_interval=2)
+      count = 0
+      check_interval = 2 if check_interval < 1 or check_interval > seconds
+      while count < (seconds / check_interval) do
+        search_indicator = @web_tester.element_by_id(element_id)
+        search_indicator_outer_html = search_indicator.outerHtml if search_indicator
+        if status == 'hide'
+          return true if search_indicator_outer_html and !search_indicator_outer_html.include?('style="DISPLAY: none"')
+        else
+          return true if search_indicator_outer_html and search_indicator_outer_html.include?('style="DISPLAY: none"')
+        end
+        sleep check_interval if check_interval > 0 and check_interval < 5 * 60 # wait max 5 minutes
+        count += 1
+      end
+      return false
+    end
+
+    def wait_for_element(element_id, timeout = 30, interval = 0.5)
+      start_time = Time.now
+      until @web_tester.element_by_id(element_id) do
+        sleep(interval)
+        if (Time.now - start_time) > timeout
+          raise RuntimeError, "failed to find element: #{element_id} for max #{timeout}"
+        end
+      end
+    end
+
+	# Warning: this does not work well with Firefox yet.
+    def element_text(elem_id)
+      @web_tester.element_value(elem_id)
+    end
+
+
+    # ---
+    # For debugging
+    # ---
+    def dump_response(stream = nil)
+      @web_tester.dump_response(stream)
+    end
+
+    def save_current_page(to_dir = ENV['TEMP_DIR'] || "C:\\temp")
+      Dir.mkdir(to_dir) unless File.exists?(to_dir)
+      file_name = Time.now.strftime("%m%d%H%M%S") + ".html"
+      file = File.join(to_dir, file_name)
+      File.new(file, "w").puts page_source
+    end
+
+    def click_popup_window(button, wait_time= 9, user_input=nil )
+      @web_tester.start_clicker(button, wait_time, user_input)
+      sleep 0.5
+    end
+
+	# Support of iTest to ajust the intervals between keystroke/mouse operations
+    def operation_delay
+      begin
+        if ENV['ITEST_OPERATION_DELAY']  && ENV['ITEST_OPERATION_DELAY'].to_i > 0 && ENV['ITEST_OPERATION_DELAY'].to_f < 30000  then # max 30 seconds
+          sleep(ENV['ITEST_OPERATION_DELAY'].to_f / 1000)
+        end
+      rescue => e
+        # ignore
+      end
+    end
+
+  end
+end

data/lib/rwebunit/test_utils.rb

@@ -57,7 +57,6 @@ module RWebUnit
       sprintf("%c", random_number(97, 122)) if lowercase
       sprintf("%c", random_number(65, 90)) unless lowercase
     end
-    alias randomChar random_char
 
     def random_digit()
       sprintf("%c", random_number(48, 57))

data/lib/rwebunit/web_page.rb

@@ -4,6 +4,7 @@
 #***********************************************************
 require File.join(File.dirname(__FILE__), 'assert')
 require File.join(File.dirname(__FILE__), 'driver')
+require 'fileutils'
 
 module RWebUnit
 
@@ -23,7 +24,7 @@ module RWebUnit
 
     include RWebUnit::Assert
     include RWebUnit::Driver
-    
+
     # browser: passed to do assertion within the page
     # page_text: text used to identify the page, title will be the first candidate
     attr_accessor :browser, :page_text
@@ -32,10 +33,11 @@ module RWebUnit
       @web_tester = web_tester
       @page_text = page_text
       begin
+        snapshot if ENV['ITEST_DUMP_PAGE'] == 'true'
         delay = ENV['ITEST_PAGE_DELAY'].to_i
         sleep(delay)
       rescue => e
-      end      
+      end
       assert_on_page
     end
 
@@ -78,6 +80,20 @@ module RWebUnit
     end
     alias include contains?
 
+
+    def	snapshot
+      if ENV['ITEST_DUMP_DIR']
+        spec_run_id = ENV['ITEST_RUNNING_SPEC_ID'] || "unknown"
+        spec_run_dir_name = spec_run_id.to_s.rjust(4, "0") unless spec_run_id == "unknown"
+        spec_run_dir = File.join(ENV['ITEST_DUMP_DIR'], spec_run_dir_name)
+        Dir.mkdir(spec_run_dir) unless File.exists?(spec_run_dir)
+        file_name = Time.now.strftime("%m%d%H%M%S") + "_" + self.class.name.gsub("", "") + ".html"
+        file = File.join(ENV['ITEST_DUMP_DIR'], spec_run_dir_name, file_name)
+        page_source = browser.page_source
+        File.new(file, "w").puts source
+      end
+    end
+
   end
 
 end

data/lib/rwebunit/web_testcase.rb

@@ -26,7 +26,7 @@ module RWebUnit
     end
 
     def open_browser(baseUrl, relativeUrl)
-      test_context.base_url = baseUrl
+      context.base_url = baseUrl
       begin_at(relativeUrl)
     end
     alias open_ie open_browser

data/lib/rwebunit/web_tester.rb

@@ -13,9 +13,11 @@ rescue LoadError => e
 end
 
 begin
+  require 'rubygems'
   require "firewatir";
   $firewatir_loaded = true
 rescue LoadError => e
+  puts e
   $firewatir_loaded = false
 end
 
@@ -41,15 +43,15 @@ module RWebUnit
   #
   class WebTester
 
-    attr_accessor :test_context
+    attr_accessor :context
 
     def initialize(base_url = nil, options = {})
       default_options = {:speed => "zippy",
         :visible => true,
         :highlight_colour => 'yellow',
-      :close_others => true}
+        :close_others => true}
       options = default_options.merge options
-      @test_context = TestContext.new base_url if base_url
+      @context = Context.new base_url if base_url
 
       if (options[:firefox] &&  $firewatir_loaded) || ($firewatir_loaded and !$watir_loaded)
         @@browser = FireWatir::Firefox.start(base_url)
@@ -212,11 +214,11 @@ module RWebUnit
     end
 
     def base_url=(new_base_url)
-      if @test_context
-        @test_conext.base_url = new_base_url
+      if @context
+        @conext.base_url = new_base_url
         return
       end
-      @test_context = TestContext.new base_url
+      @context = Context.new base_url
     end
 
     def is_firefox?
@@ -248,8 +250,8 @@ module RWebUnit
     end
 
     def full_url(relative_url)
-      if @test_context && @test_context.base_url
-        @test_context.base_url + relative_url
+      if @context && @context.base_url
+        @context.base_url + relative_url
       else
         relative_url
       end

data/lib/rwebunit.rb

@@ -1,26 +1,28 @@
-#***********************************************************
-#* Copyright (c) 2006, Zhimin Zhan.
-#* Distributed open-source, see full license in MIT-LICENSE
-#***********************************************************
-
-# Load active_support, so that we can use 1.days.ago
-begin
-  require 'active_support/basic_object'
-  require 'active_support/duration'
-rescue LoadError => no_as1_err
-  # active_support 2.0 loaded error
-end
-require 'active_support/core_ext'
-
-# Extra full path to load libraries
-require File.dirname(__FILE__) + "/rwebunit/test_utils"
-require File.dirname(__FILE__) + "/rwebunit/web_page"
-require File.dirname(__FILE__) + "/rwebunit/assert"
-#This cause some unit test loaded, to use it, load specifiically
-#require File.dirname(__FILE__) + "/rwebunit/web_testcase"
-require File.dirname(__FILE__) + "/rwebunit/web_tester"
-require File.dirname(__FILE__) + "/rwebunit/test_context"
-require File.dirname(__FILE__) + "/rwebunit/driver"
-require File.dirname(__FILE__) + "/rwebunit/rspec_helper"
-
-
+#***********************************************************
+#* Copyright (c) 2006, Zhimin Zhan.
+#* Distributed open-source, see full license in MIT-LICENSE
+#***********************************************************
+
+# Load active_support, so that we can use 1.days.ago
+begin
+  require 'active_support/basic_object'
+  require 'active_support/duration'
+rescue LoadError => no_as1_err
+  # active_support 2.0 loaded error
+end
+require 'active_support/core_ext'
+
+require 'spec'
+
+# Extra full path to load libraries
+require File.dirname(__FILE__) + "/rwebunit/test_utils"
+require File.dirname(__FILE__) + "/rwebunit/web_page"
+require File.dirname(__FILE__) + "/rwebunit/assert"
+#This cause some unit test loaded, to use it, load specifiically
+#require File.dirname(__FILE__) + "/rwebunit/web_testcase"
+require File.dirname(__FILE__) + "/rwebunit/web_tester"
+require File.dirname(__FILE__) + "/rwebunit/context"
+require File.dirname(__FILE__) + "/rwebunit/driver"
+require File.dirname(__FILE__) + "/rwebunit/rspec_helper"
+require File.dirname(__FILE__) + "/rspec_extensions"
+#require File.dirname(__FILE__) + "/rwebunit/matchers/"

data/test/test_driver.rb

@@ -0,0 +1,39 @@
+$:.unshift File.join(File.dirname(__FILE__), "..", "lib/rwebunit")
+$:.unshift File.dirname(__FILE__)
+
+require "driver.rb"
+require "web_tester.rb"
+require 'test/unit'
+
+class TestDriver < Test::Unit::TestCase
+  include RWebUnit::Driver
+
+  def setup
+    @web_tester = "dummy"
+  end
+
+  def teardown
+  end
+
+  def test_fail_safe
+    fail_safe {raise "X"}
+  end
+
+  def test_expect_page
+    new_page = expect_page String
+    assert_equal("dummy", new_page)
+  end
+
+  def test_on
+    page = []
+    on(page) do |i|
+      i << "0"
+      i << "1"
+    end
+    assert_equal(["0", "1"], page)
+  end
+  
+  def test_shall_not_allow
+    shall_not_allow {1 / 0}
+  end
+end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: rwebunit
 version: !ruby/object:Gem::Version 
-  version: 0.8.9
+  version: 0.9.4
 platform: ruby
 authors: 
 - Zhimin Zhan
@@ -9,10 +9,19 @@ autorequire: rwebunit
 bindir: bin
 cert_chain: []
 
-date: 2008-05-01 00:00:00 +10:00
+date: 2008-08-20 00:00:00 +10:00
 default_executable: 
-dependencies: []
-
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.1.4
+    version: 
 description: 
 email: zhimin@agileway.net
 executables: []
@@ -26,16 +35,18 @@ files:
 - README
 - CHANGELOG
 - MIT-LICENSE
+- lib/rspec_extensions.rb
 - lib/rwebunit
 - lib/rwebunit/assert.rb
+- lib/rwebunit/context.rb
 - lib/rwebunit/driver.rb
 - lib/rwebunit/rspec_helper.rb
-- lib/rwebunit/test_context.rb
 - lib/rwebunit/test_utils.rb
 - lib/rwebunit/web_page.rb
 - lib/rwebunit/web_testcase.rb
 - lib/rwebunit/web_tester.rb
 - lib/rwebunit.rb
+- test/test_driver.rb
 - test/test_test_utils.rb
 - sample/kangxi_home_webtest.rb
 - sample/kangxi_httpcaller_webtest.rb
@@ -69,8 +80,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   version: 
 requirements: 
 - none
-rubyforge_project: 
-rubygems_version: 1.1.0
+rubyforge_project: rwebunit
+rubygems_version: 1.2.0
 signing_key: 
 specification_version: 2
 summary: An wrap of WATIR/FireWatir for functional testing of web applications