rwebunit 0.7.2 → 0.8.9

data/lib/rwebunit/rspec_helper.rb

@@ -1,5 +1,17 @@
 require 'uri'
 
+# ZZ patches to RSpec 1.1.2
+#  - add to_s method to example_group
+module Spec
+  module Example
+    class ExampleGroup
+      def to_s
+        @_defined_description
+      end
+    end
+  end
+end
+
 # example
 #   should link_by_text(text, options).size > 0
 
@@ -13,41 +25,37 @@ module RWebUnit
       @web_tester
     end
 
-	def open_browser_preconfigured(options = {})
-		open_browser(ENV['ITEST_PROJECT_BASE_URL'], options)
-	end
-	
     # open a browser, and set base_url via hash, but does not acually
     #
     # example:
     #   open_browser :base_url => http://localhost:8080
-    def open_browser(base_url = nil, options = {})      
-      raise "base_url must be set" if base_url .nil?
+    def open_browser(base_url = nil, options = {})
+      base_url ||= ENV['ITEST_PROJECT_BASE_URL']
+      raise "base_url must be set" if base_url.nil?
       
-       default_options = {:speed => "fast",
+      default_options = {:speed => "fast",
         :visible => true,
         :highlight_colour => 'yellow',
         :close_others => true,
         :start_new => false, 	# start a new browser always
         :go => true}
-      
-      options = default_options.merge options 
-	options[:firefox] = true if "Firefox" == ENV['ITEST_BROWSER']
+
+      options = default_options.merge options
+      options[:firefox] = true if "Firefox" == ENV['ITEST_BROWSER']
+      (ENV['ITEST_HIDE_BROWSER'] == "true") ? $HIDE_IE = true : $HIDE_IE = false
 
       uri = URI.parse(base_url)
       uri_base = "#{uri.scheme}://#{uri.host}:#{uri.port}"
-      if options[:start_new]
+      if options[:start_new] || @web_tester.nil?
         @web_tester = WebTester.new(uri_base, options)
-      else
-        @web_tester ||= WebTester.new(uri_base, options)
       end
-	
-	  if options[:go]
-      (uri.path.length == 0) ?  begin_at("/") :  begin_at(uri.path)
+
+      if options[:go]
+        (uri.path.length == 0) ?  begin_at("/") :  begin_at(uri.path)
       end
       return @web_tester
     end
-	alias open_browser_with open_browser
+    alias open_browser_with open_browser
 
     # --
     #  Content
@@ -97,12 +105,24 @@ module RWebUnit
     # default options: exact => true
     def links_by_text(link_text, options = {})
       options.merge!({:exact=> true})
-      links.select { |link|
-        options[:exact] ? link.text == link_text :  link.text.include?(link_text)
+      matching_links = []
+      links.each { |link|
+        matching_links << link if (options[:exact] ? link.text == link_text :  link.text.include?(link_text))
       }
+      return matching_links
     end
     alias links_with_text links_by_text
 
+    def save_page(file_name = nil)
+      @web_tester.save_page(file_name)
+    end
+    
+    def save_content_to_file(content, file_name = nil)      
+      file_name ||= Time.now.strftime("%Y%m%d%H%M%S") + ".html"
+      puts "about to save page: #{File.expand_path(file_name)}"
+      File.open(file_name, "w").puts content
+    end
+
   end
 
 end

data/lib/rwebunit/web_page.rb

@@ -31,6 +31,11 @@ module RWebUnit
     def initialize(web_tester, page_text=nil)
       @web_tester = web_tester
       @page_text = page_text
+      begin
+        delay = ENV['ITEST_PAGE_DELAY'].to_i
+        sleep(delay)
+      rescue => e
+      end      
       assert_on_page
     end
 

data/lib/rwebunit/web_tester.rb

@@ -21,6 +21,19 @@ end
 
 raise "You have must at least Watir or Firewatir installed" unless $watir_loaded || $firewatir_loaded
 
+# Patch: fix typo in Watir 1.5.3
+module Watir
+  class IE
+    def self.close_all_but(except=nil)
+      Watir::IE.each do |ie|
+        ie.close_modal
+        ie.close unless except and except.hwnd == ie.hwnd
+      end
+      sleep 1.0 # replace with polling for window count to be zero?
+    end
+  end
+end
+
 module RWebUnit
 
   ##
@@ -31,7 +44,7 @@ module RWebUnit
     attr_accessor :test_context
 
     def initialize(base_url = nil, options = {})
-      default_options = {:speed => "fast",
+      default_options = {:speed => "zippy",
         :visible => true,
         :highlight_colour => 'yellow',
       :close_others => true}
@@ -40,54 +53,121 @@ module RWebUnit
 
       if (options[:firefox] &&  $firewatir_loaded) || ($firewatir_loaded and !$watir_loaded)
         @@browser = FireWatir::Firefox.start(base_url)
-      elsif $watir_loaded 
+      elsif $watir_loaded
         @@browser = Watir::IE.new
-        if options[:speed] == 'slow' then @@browser.set_slow_speed  else @@browser.set_fast_speed end
+
+        if ENV['ITEST_EMULATE_TYPING'] == "true" &&  ENV['ITEST_TYPING_SPEED'] then
+          @@browser.set_slow_speed if ENV['ITEST_TYPING_SPEED'] == 'slow'
+          @@browser.set_fast_speed if ENV['ITEST_TYPING_SPEED'] == 'fast'
+        else
+          @@browser.speed = :zippy
+        end
         @@browser.activeObjectHighLightColor = options[:highlight_colour]
-        @@browser.visible = options[:visible]
+        @@browser.visible = options[:visible] unless $HIDE_IE
         @@browser.close_others if options[:close_others]
-      else 
+      else
         raise "rWebUnit initialiazation error, most likely Watir or Firewatir not present"
       end
+
     end
 
     ##
     #  Delegate to Watir
     #
-    def area(*args); @@browser.area(*args); end
-    def button(*args);  @@browser.button(*args); end
-    def cell(*args); @@browser.cell(*args); end
+    def area(*args)
+      @@browser.area(*args)
+    end
+    def button(*args)
+      @@browser.button(*args);
+    end
+    def cell(*args)
+      @@browser.cell(*args);
+    end
     alias td cell
-    def checkbox(*args);  @@browser.checkbox(*args); end
-    alias check_box checkbox	# seems watir doc is wrong, checkbox not check_box
-    def div(*args); @@browser.div(*args); end
-    def form(*args);  @@browser.form(*args); end
-    def frame(*args);  @@browser.frame(*args); end
-    def h1(*args); @@browser.h1(*args); end
-    def h2(*args); @@browser.h2(*args); end
-    def h3(*args); @@browser.h3(*args); end
-    def h4(*args); @@browser.h4(*args); end
-    def h5(*args); @@browser.h5(*args); end
-    def h6(*args); @@browser.h6(*args); end
-    def hidden(*args); @@browser.hidden(*args); end
-    def image(*args);  @@browser.image(*args); end
-    def li(*args);  @@browser.li(*args); end
-    def link(*args);  @@browser.link(*args); end
-    def map(*args);  @@browser.map(*args); end
-    def pre(*args);  @@browser.pre(*args); end
-    def radio(*args);  @@browser.radio(*args); end
-    def row(*args);  @@browser.row(*args); end
+    def checkbox(*args)
+      @@browser.checkbox(*args);
+    end
+    alias check_box checkbox  # seems watir doc is wrong, checkbox not check_box
+    def div(*args)
+      @@browser.div(*args);
+    end
+    def form(*args)
+      @@browser.form(*args);
+    end
+    def frame(*args)
+      @@browser.frame(*args);
+    end
+    def h1(*args)
+      @@browser.h1(*args);
+    end
+    def h2(*args)
+      @@browser.h2(*args);
+    end
+    def h3(*args)
+      @@browser.h3(*args);
+    end
+    def h4(*args)
+      @@browser.h4(*args);
+    end
+    def h5(*args)
+      @@browser.h5(*args);
+    end
+    def h6(*args)
+      @@browser.h6(*args);
+    end
+    def hidden(*args)
+      @@browser.hidden(*args);
+    end
+    def image(*args)
+      @@browser.image(*args);
+    end
+    def li(*args)
+      @@browser.li(*args);
+    end
+    def link(*args)
+      @@browser.link(*args);
+    end
+    def map(*args)
+      @@browser.map(*args);
+    end
+    def pre(*args)
+      @@browser.pre(*args);
+    end
+    def radio(*args)
+      @@browser.radio(*args);
+    end
+    def row(*args)
+      @@browser.row(*args);
+    end
     alias tr row
-    def select_list(*args);  @@browser.select_list(*args); end
-    def span(*args); @@browser.span(*args); end
-    def table(*args); @@browser.table(*args); end
-    def text_field(*args);  @@browser.text_field(*args); end
+    def select_list(*args)
+      @@browser.select_list(*args);
+    end
 
-    def paragraph(*args);  @@browser.paragraph(*args); end
-    def file_field(*args);  @@browser.file_field(*args); end
-    def label(*args); @@browser.span(*args); end
+    def span(*args)
+      @@browser.span(*args);
+    end
 
-    def contains_text(text); @@browser.contains_text(text); end
+    def table(*args)
+      @@browser.table(*args);
+    end
+    def text_field(*args)
+      @@browser.text_field(*args);
+    end
+
+    def paragraph(*args)
+      @@browser.paragraph(*args);
+    end
+    def file_field(*args)
+      @@browser.file_field(*args);
+    end
+    def label(*args)
+      @@browser.label(*args);
+    end
+
+    def contains_text(text)
+      @@browser.contains_text(text);
+    end
 
     def page_source
       @@browser.html()
@@ -103,15 +183,33 @@ module RWebUnit
       end
     end
 
-    def links; @@browser.links; end
-    def buttons; @@browser.buttons; end
-    def select_lists; @@browser.select_lists; end
-    def checkboxes; @@browser.checkboxes; end
-    def radios; @@browser.radios; end
-    def text_fields; @@browser.text_fields; end
+    def images
+      @@browser.images
+    end
+
+    def links
+      @@browser.links;
+    end
+    def buttons
+      @@browser.buttons;
+    end
+    def select_lists
+      @@browser.select_lists;
+    end
+    def checkboxes
+      @@browser.checkboxes;
+    end
+    def radios
+      @@browser.radios;
+    end
+    def text_fields
+      @@browser.text_fields;
+    end
 
     # current url
-    def url; @@browser.url; end
+    def url
+      @@browser.url
+    end
 
     def base_url=(new_base_url)
       if @test_context
@@ -186,26 +284,42 @@ module RWebUnit
     end
 
 
-    def go_back;  @@browser.back; end
-    def go_forward; @@browser.forward; end
-    def goto_page(page); @@browser.goto full_url(page); end
-    def refresh; @@browser.refresh; end
+    def go_back;
+      @@browser.back;
+    end
+    def go_forward;
+      @@browser.forward;
+    end
+    def goto_page(page)
+      @@browser.goto full_url(page);
+    end
+    def refresh;
+      @@browser.refresh;
+    end
 
-    def focus; @@browser.focus; end
-    def close_others; @@browser.close_others; end
+    def focus;
+      @@browser.focus;
+    end
+    def close_others;
+      @@browser.close_others;
+    end
 
     # text fields
     def enter_text_into_field_with_name(name, text)
-      wait_before_and_after { text_field(:name, name).set(text) }
+      if is_firefox?
+        wait_before_and_after { text_field(:name, name).value = text }
+        sleep 0.5
+      else
+        wait_before_and_after { text_field(:name, name).set(text) }
+      end
     end
     alias set_form_element enter_text_into_field_with_name
     alias enter_text enter_text_into_field_with_name
 
     #links
-    def click_link(link_id)
+    def click_link_with_id(link_id)
       wait_before_and_after { link(:id, link_id).click }
     end
-    alias click_link_with_id click_link
 
     def click_link_with_text(text)
       wait_before_and_after { link(:text, text).click }
@@ -217,7 +331,6 @@ module RWebUnit
     def click_button_with_id(id)
       wait_before_and_after { button(:id, id).click }
     end
-    alias click_button click_button_with_id
 
     def click_button_with_name(name)
       wait_before_and_after { button(:name, name).click }
@@ -283,7 +396,11 @@ module RWebUnit
     end
 
     def element_by_id(elem_id)
-      elem = @@browser.document.getElementById(elem_id)
+      if is_firefox?
+        elem =  label(:id, elem_id)  || button(:id, elem_id) || span(:id, elem_id) || hidden(:id, elem_id) || link(:id, elem_id) || radio(:id, elem_id)
+      else
+        elem = @@browser.document.getElementById(elem_id)
+      end
     end
 
     def element_value(elementId)
@@ -306,12 +423,15 @@ module RWebUnit
       file_field(:name, file_field).set(file_path)
     end
 
-    def start_window(url = nil); @@browser.start_window(url); end
+    def start_window(url = nil)
+      @@browser.start_window(url);
+    end
+
     def self.attach_browser(how, what)
-      if is_firefox? then
-        raise "not implemented yet"
-      else
+      if @@browser && @@browser.class == Watir::IE
         Watir::IE.attach(how, what)
+      else
+        raise "not implemented yet"
       end
     end
 
@@ -323,7 +443,13 @@ module RWebUnit
       if is_firefox?
         raise "not implemented"
       else
-        Watir::IE.attach(:url, options[:url])
+        if options[:url]
+          Watir::IE.attach(:url, options[:url])
+        elsif options[:title]
+          Watir::IE.attach(:title, options[:title])
+        else
+          raise 'Please specify title or url of new pop up window'
+        end
       end
     end
 
@@ -342,7 +468,7 @@ module RWebUnit
     #
     # http://wiki.openqa.org/display/WTR/FAQ#FAQ-HowdoIattachtoapopupwindow%3F
     #
-    def start_clicker( button , waitTime= 9, user_input=nil)
+    def start_clicker( button, waitTime= 9, user_input=nil)
       # get a handle if one exists
       hwnd = @@browser.enabled_popup(waitTime)
       if (hwnd)  # yes there is a popup
@@ -371,6 +497,12 @@ module RWebUnit
       @@browser
     end
 
+    def save_page(file_name = nil)
+      file_name ||= Time.now.strftime("%Y%m%d%H%M%S") + ".html"
+      puts "about to save page: #{File.expand_path(file_name)}"
+      File.open(file_name, "w").puts page_source
+    end
+
   end
 
 end