rwebspec 1.4.0.2 → 1.6

data/lib/rwebspec/load_test_helper.rb

@@ -0,0 +1,110 @@
+
+module RWebSpec
+  module LoadTestHelper
+
+    include RWebSpec::Utils
+    include RWebSpec::Assert
+
+    # only support firefox or Celerity
+    def open_browser(base_url, options)
+      options[:firefox] ||= (ENV['ILOAD2_PREVIEW'] == true)
+      RWebSpec::WebBrowser.new(base_url, nil, options)
+    end
+
+    # maybe attach_browser
+
+    # Does not provide real function, other than make enhancing test syntax
+    #
+    # Example:
+    #   allow { click_button('Register') }
+    def allow(&block)
+      yield
+    end
+    alias shall_allow  allow
+    alias allowing  allow
+
+    # 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
+
+    # Try the operation up to specified timeout (in seconds), and sleep given interval (in seconds).
+    # Error will be ignored until timeout
+    # Example
+    #    try { click_link('waiting')}
+    #    try(10, 2) { click_button('Search' } # try to click the 'Search' button upto 10 seconds, try every 2 seconds
+    #    try { click_button('Search' }
+    def try(timeout = @@default_timeout, polling_interval = @@default_polling_interval || 1, &block)
+      start_time = Time.now
+
+      last_error = nil
+      until (duration = Time.now - start_time) > timeout
+        begin
+          return if yield
+          last_error = nil
+        rescue => e
+          last_error = e
+        end
+        sleep polling_interval
+      end
+
+      raise "Timeout after #{duration.to_i} seconds with error: #{last_error}." if last_error
+      raise "Timeout after #{duration.to_i} seconds."
+    end
+    alias try_upto try
+
+    ##
+    #  Convert :first to 1, :second to 2, and so on...
+    def symbol_to_sequence(symb)
+      value = { :zero => 0,
+        :first => 1,
+        :second => 2,
+        :third => 3,
+        :fourth => 4,
+        :fifth => 5,
+        :sixth => 6,
+        :seventh => 7,
+        :eighth => 8,
+        :ninth => 9,
+      :tenth => 10 }[symb]
+      return value || symb.to_i
+    end
+
+    # monitor current execution using
+    # 
+    # Usage
+    #  log_time { browser.click_button('Confirm') }
+    def log_time(msg, &block)      
+      start_time = Time.now
+      yield        
+      Thread.current[:log] ||= []
+      Thread.current[:log] << [File.basename(__FILE__), msg, Time.now, Time.now - start_time]
+    end
+
+	def run_with_virtual_users(virtual_user_count = 2, &block)		
+	  	raise "too many virtual users" if virtual_user_count > 100 #TODO
+	  	if (virtual_user_count <= 1) 
+	  		yield	  	
+	  	else 
+		threads = [] 
+		virtual_user_count.times do |idx|
+  			threads[idx] = Thread.new do
+    			start_time = Time.now 
+    			yield
+    			puts "Thread[#{idx+1}] #{Time.now - start_time}s"
+  			end
+		end
+
+		threads.each {|t| t.join }
+		end
+	end
+
+  end
+end

data/lib/rwebspec/matchers/contains_text.rb

@@ -19,12 +19,12 @@ class ContainsText
 
   # error message for should
   def failure_message
-    "expected #{actual_text} not to contains #{@expected}, but it did't"
+    "expected '#{actual_text}' to contain '#{@expected}', but it did't"
   end
 
   # error message for should_not
   def negative_failure_message
-    "expected #{actual_text} not to contains #{@expected}, but it did"
+    "expected '#{actual_text}' not to contain '#{@expected}', but it did"
   end
 
 end

data/lib/rwebspec/test_utils.rb

@@ -3,6 +3,14 @@
 #* Distributed open-source, see full license in MIT-LICENSE
 #***********************************************************
 
+
+class Array
+
+  def average
+    inject(0.0) { |sum, e| sum + e } / length
+  end
+end
+
 # useful hekoer methods for testing
 #
 module RWebSpec
@@ -39,33 +47,34 @@ module RWebSpec
     #  %Z - Time zone name
     #  %% - Literal ``%'' character
 
-    def today(format = '%d/%m/%Y')
-      format_date(Time.now, format)
+    def today(format = nil)                
+      format_date(Time.now, date_format(format))
     end
     alias getToday_AU today
     alias getToday_US today
     alias getToday today
 
 
-    def days_before(days, format = '%d/%m/%Y')
-      nil if !(days.instance_of?(Fixnum))
-      format_date(Time.now - days * 24 * 3600, format)
+    def days_before(days, format = nil)        
+      return nil if !(days.instance_of?(Fixnum))
+      format_date(Time.now - days * 24 * 3600, date_format(format))
     end
 
-    def yesterday
-      days_before(1)
+    def yesterday(format = nil)
+      days_before(1, date_format(format))
     end
 
-    def days_from_now(days, format = '%d/%m/%Y')
-      nil if !(days.instance_of?(Fixnum))
-      format_date(Time.now + days * 24 * 3600, format)
+    def days_from_now(days, format = nil)
+      return nil if !(days.instance_of?(Fixnum))
+      format_date(Time.now + days * 24 * 3600, date_format(format))
     end
     alias days_after days_from_now
 
-    def tomorrow
-      days_from_now(1)
+    def tomorrow(format = nil)
+      days_from_now(1, date_format(format))
     end
 
+
     # return a random number >= min, but <= max
     def random_number(min, max)
       rand(max-min+1)+min
@@ -76,8 +85,11 @@ module RWebSpec
     end
 
     def random_char(lowercase = true)
-      sprintf("%c", random_number(97, 122)) if lowercase
-      sprintf("%c", random_number(65, 90)) unless lowercase
+      if lowercase
+        sprintf("%c", random_number(97, 122))
+      else
+        sprintf("%c", random_number(65, 90))
+      end
     end
 
     def random_digit()
@@ -116,7 +128,7 @@ module RWebSpec
     # Generate a given number of words. If a range is passed, it will generate
     # a random number of words within that range.
     def words(total)
-      (1..interpret_value(total)).map { WORDS.rand }.join(' ')
+      (1..interpret_value(total)).map { WORDS[random_number(0, total)] }.join(' ')
     end
 
     # Generate a given number of sentences. If a range is passed, it will generate
@@ -148,7 +160,7 @@ module RWebSpec
     private
 
     def time_in_range(range)
-      Time.at number_in_range(Range.new(range.first.to_i, range.last.to_i, range.exclude_end?))
+      Time.at number_in_range(Range.new(range.first.to_i, range.last.to_i, rangee.exclude_end?))
     end
 
     def date_in_range(range)
@@ -167,5 +179,34 @@ module RWebSpec
       date.strftime(date_format)
     end
 
+    def date_format(format_argument)
+      if format_argument.nil? then
+        get_locale_date_format(default_locale)        
+      elsif format_argument.class == Symbol then
+        get_locale_date_format(format_argument)
+      elsif format_argument.class == String then
+        format_argument
+      else
+        # invalid input, use default
+        get_locale_date_format(default_date_format)
+      end
+
+    end
+
+    def get_locale_date_format(locale)
+      case locale
+      when :us
+        "%m/%d/%Y"
+      when :au, :uk
+        "%d/%m/%Y"
+      else
+        "%Y-%m-%d"
+      end
+    end
+
+    def default_locale
+      return :au
+    end
+
   end
 end

data/lib/rwebspec/{itest_plugin.rb → testwise_plugin.rb}

@@ -1,79 +1,83 @@
-require 'socket'
-
-module RWebSpec
-  module ITestPlugin
-
-    def connect_to_itest(message_type, body)
-      begin
-        the_message = message_type + "|" + body
-        if @last_message == the_message then # ignore the message same as preivous one
-          return
-        end
-        itest_port = $ITEST2_TRACE_PORT || 7025
-        itest_socket = Socket.new(Socket::AF_INET,Socket::SOCK_STREAM,0)
-        itest_socket.connect(Socket.pack_sockaddr_in(itest_port, '127.0.0.1'))
-        itest_socket.puts(the_message)
-        @last_message = the_message
-        itest_socket.close
-      rescue => e
-      end
-    end
-    alias connect_to_itest2 connect_to_itest
-
-    def debug(message)
-      connect_to_itest(" DEBUG", message + "\r\n") if $RUN_IN_ITEST
-    end
-
-
-    # Support of iTest to ajust the intervals between keystroke/mouse operations
-    def operation_delay
-      begin
-        if $ITEST2_OPERATION_DELAY && $ITEST2_OPERATION_DELAY > 0 &&
-          $ITEST2_OPERATION_DELAY && $ITEST2_OPERATION_DELAY < 30000  then # max 30 seconds
-            sleep($ITEST2_OPERATION_DELAY / 1000)
-        end
-
-        while $ITEST2_PAUSE
-            debug("Paused, waiting ...")
-            sleep 1
-        end
-      rescue => e
-        puts "Error on delaying: #{e}"
-        # ignore
-      end
-    end
-
-    # find out the line (and file) the execution is on, and notify iTest via Socket
-    def dump_caller_stack
-      return unless $ITEST2_TRACE_EXECUTION
-      begin      
-        trace_lines = []
-		    trace_file = nil
-        found_first_spec_reference = false
-        caller.each_with_index do |position, idx|
-          next unless position =~ /\A(.*?):(\d+)/
-          trace_file = $1          
-		      if trace_file =~ /(_spec|_test|_rwebspec)\.rb\s*$/
-		        found_first_spec_reference = true
-            trace_lines << position
-		        break
-		      end
-          trace_lines << position
-          break if trace_file =~ /example\/example_methods\.rb$/ or trace_file =~ /example\/example_group_methods\.rb$/
-		      break if trace_lines.size > 10
-          # TODO: send multiple trace to be parse with pages.rb
-          # break if trace_file =~ /example\/example_methods\.rb$/ or trace_file =~ /example\/example_group_methods\.rb$/ or trace_file =~ /driver\.rb$/ or trace_file =~ /timeout\.rb$/ # don't include rspec or ruby trace
-        end
-
-        #  (trace_file.include?("_spec.rb") || trace_file.include?("_rwebspec.rb") || trace_file.include?("_test.rb") || trace_file.include?("_cmd.rb"))
-        if !trace_lines.empty?
-           connect_to_itest(" TRACE", trace_lines.reverse.join("|"))
-        end
-
-      rescue => e
-        puts "failed to capture log: #{e}"
-      end
-    end
-
-  end
+require 'socket'
+
+module RWebSpec
+  module TestWisePlugin
+
+    def debug(message)
+      connect_to_testwise(" DEBUG", message.to_s + "\r\n") if $RUN_IN_TESTWISE && message
+    end
+
+
+    # Support of iTest to ajust the intervals between keystroke/mouse operations
+    def operation_delay
+      begin
+        if $ITEST2_OPERATION_DELAY && $ITEST2_OPERATION_DELAY > 0 &&
+                $ITEST2_OPERATION_DELAY && $ITEST2_OPERATION_DELAY < 30000  then # max 30 seconds
+          sleep($ITEST2_OPERATION_DELAY / 1000)
+        end
+
+        while $ITEST2_PAUSE
+          debug("Paused, waiting ...")
+          sleep 1
+        end
+      rescue => e
+        puts "Error on delaying: #{e}"
+        # ignore
+      end
+    end
+
+    def notify_screenshot_location(image_file_path)
+      connect_to_testwise("  SHOT", image_file_path)
+    end
+
+    # find out the line (and file) the execution is on, and notify iTest via Socket
+    def dump_caller_stack
+      return unless $ITEST2_TRACE_EXECUTION
+      begin
+        trace_lines = []
+        trace_file = nil
+        found_first_spec_reference = false
+        caller.each_with_index do |position, idx|
+          next unless position =~ /\A(.*?):(\d+)/
+          trace_file = $1
+          if trace_file =~ /(_spec|_test|_rwebspec)\.rb\s*$/
+            found_first_spec_reference = true
+            trace_lines << position
+            break
+          end
+          trace_lines << position
+          break if trace_file =~ /example\/example_methods\.rb$/ or trace_file =~ /example\/example_group_methods\.rb$/
+          break if trace_lines.size > 10
+          # TODO: send multiple trace to be parse with pages.rb
+          # break if trace_file =~ /example\/example_methods\.rb$/ or trace_file =~ /example\/example_group_methods\.rb$/ or trace_file =~ /driver\.rb$/ or trace_file =~ /timeout\.rb$/ # don't include rspec or ruby trace
+        end
+
+        #  (trace_file.include?("_spec.rb") || trace_file.include?("_rwebspec.rb") || trace_file.include?("_test.rb") || trace_file.include?("_cmd.rb"))
+        if !trace_lines.empty?
+          connect_to_testwise(" TRACE", trace_lines.reverse.join("|"))
+        end
+
+      rescue => e
+        puts "failed to capture log: #{e}"
+      end
+    end
+
+
+    def connect_to_testwise (message_type, body)
+      begin
+        the_message = message_type + "|" + body
+        if @last_message == the_message then # ignore the message same as preivous one
+          return
+        end
+        itest_port = $ITEST2_TRACE_PORT || 7025
+        itest_socket = Socket.new(Socket::AF_INET, Socket::SOCK_STREAM, 0)
+        itest_socket.connect(Socket.pack_sockaddr_in(itest_port, '127.0.0.1'))
+        itest_socket.puts(the_message)
+        @last_message = the_message
+        itest_socket.close
+      rescue => e
+      end
+    end
+
+  end
 end

data/lib/rwebspec/web_browser.rb

@@ -5,10 +5,12 @@
 
 begin
   require 'watir'
-  require 'watir/ie'
   require 'watir/contrib/enabled_popup'
-  require 'watir/contrib/visible'
   require 'watir/close_all'
+  require 'watir/screen_capture' 
+  # NO need any more
+  # require 'watir/ie'
+  # require 'watir/contrib/visible'
   $watir_loaded = true
 rescue LoadError => e
   $watir_loaded = false
@@ -93,7 +95,7 @@ module RWebSpec
         firefox_jssh = Net::Telnet::new("Host" => "127.0.0.1", "Port" => 9997)
         FireWatir::Firefox.firefox_started = true
       rescue => e
-        # puts "debug: XXX #{e}"
+        puts "The firefox brower with JSSH is not available, #{e}"
         sleep 1
       end
       @browser = FireWatir::Firefox.start(base_url)
@@ -103,7 +105,6 @@ module RWebSpec
       default_celerity_options = { :proxy => nil,  :browser => :firefox, :resynchronize => true, :log_level => :off }
       options = default_celerity_options.merge options
       options.each { |k, v| options.delete(k) unless default_celerity_options.keys.include?(k)}
-      puts "Starting Celerity: #{options.inspect}"
       @browser = Celerity::Browser.new(options)
       @browser.goto(base_url)
     end
@@ -111,6 +112,12 @@ module RWebSpec
     def initialize_ie_browser(existing_browser, options)
       if existing_browser then
         @browser = existing_browser
+        if $ITEST2_EMULATE_TYPING && $ITEST2_TYPING_SPEED then
+          @browser.set_slow_speed if $ITEST2_TYPING_SPEED == 'slow'
+          @browser.set_fast_speed if $ITEST2_TYPING_SPEED == 'fast'
+        else
+          @browser.speed = :zippy
+        end
         return
       end
 
@@ -136,7 +143,7 @@ module RWebSpec
         Watir::IE.each do |browser_window|
           return WebBrowser.new(base_url, browser_window, options)
         end
-        puts "no browser instance found"
+        #puts "no browser instance found"
         WebBrowser.new(base_url, nil, options)
       else
         WebBrowser.new(base_url, nil, options)
@@ -331,42 +338,71 @@ module RWebSpec
 
     alias set_form_element enter_text_into_field_with_name
     alias enter_text enter_text_into_field_with_name
+    alias set_hidden_field set_form_element
 
     #links
-    def click_link_with_id(link_id)
-      wait_before_and_after { link(:id, link_id).click }
+    def click_link_with_id(link_id, opts = {})
+      if opts && opts[:index]
+        wait_before_and_after { link(:id => link_id, :index => opts[:index]).click }
+      else
+        wait_before_and_after { link(:id, link_id).click }
+      end 
     end
 
-    def click_link_with_text(text)
-      wait_before_and_after { link(:text, text).click }
+    def click_link_with_text(text, opts = {})
+      if opts && opts[:index]
+        wait_before_and_after { link(:text => text, :index => opts[:index]).click }
+      else
+        wait_before_and_after { link(:text, text).click }          
+      end 
     end
+    alias click_link click_link_with_text
 
+    
     # Click a button with give HTML id
     # Usage:
     #   click_button_with_id("btn_sumbit")
-    def click_button_with_id(id)
-      wait_before_and_after { button(:id, id).click }
+    def click_button_with_id(id, opts = {})
+      if opts && opts[:index]
+          wait_before_and_after { button(:id => id,  :index => opts[:index]).click  }
+      else
+          wait_before_and_after { button(:id, id).click }
+      end
     end
 
     # Click a button with give name
     # Usage:
     #   click_button_with_name("confirm")
-    def click_button_with_name(name)
-      wait_before_and_after { button(:name, name).click }
+    def click_button_with_name(name, opts={})
+      if opts && opts[:index]
+        wait_before_and_after { button(:name => name, :index => opts[:index]).click }
+      else
+        wait_before_and_after { button(:name, name).click }
+      end
     end
 
     # Click a button with caption
     # Usage:
     #   click_button_with_caption("Confirm payment")
-    def click_button_with_caption(caption)
-      wait_before_and_after { button(:caption, caption).click }
+    def click_button_with_caption(caption, opts={})
+        if opts && opts[:index]
+          wait_before_and_after { button(:caption => caption, :index => opts[:index]).click }
+        else
+          wait_before_and_after { button(:caption, caption).click }
+        end
     end
+    alias click_button click_button_with_caption
+    alias click_button_with_text click_button_with_caption
 
     # Click a button with value
     # Usage:
     #   click_button_with_value("Confirm payment")
-    def click_button_with_value(value)
-      wait_before_and_after { button(:value, value).click }
+    def click_button_with_value(value, opts={})
+        if opts && opts[:index]
+          wait_before_and_after { button(:value => value, :index => opts[:index]).click }
+        else
+          wait_before_and_after { button(:value, value).click }
+        end
     end
 
     # Select a dropdown list by name
@@ -426,6 +462,7 @@ module RWebSpec
     def click_radio_option(radio_group, radio_option)
       radio(:name, radio_group, radio_option).set
     end
+    alias click_radio_button click_radio_option
 
     # Clear a radio button
     #  Usage:
@@ -433,6 +470,7 @@ module RWebSpec
     def clear_radio_option(radio_group, radio_option)
       radio(:name, radio_group, radio_option).clear
     end
+    alias clear_radio_button clear_radio_option
 
     # Deprecated: using Watir style directly instead
     def element_by_id(elem_id)
@@ -557,6 +595,18 @@ module RWebSpec
     end
 
 
+    # Verify the next page following an operation.
+    #
+    # Typical usage:
+    #   browser.expect_page HomePage
+    def expect_page(page_clazz, argument = nil)
+      if argument
+        page_clazz.new(self, argument)
+      else
+        page_clazz.new(self)
+      end
+    end
+
     # is it running in MS Windows platforms?
     def self.is_windows?
       RUBY_PLATFORM.downcase.include?("mswin") or RUBY_PLATFORM.downcase.include?("mingw")

data/lib/rwebspec/web_page.rb

@@ -27,12 +27,12 @@ module RWebSpec
 
     # browser: passed to do assertion within the page
     # page_text: text used to identify the page, title will be the first candidate
-    attr_accessor :page_text
+    attr_accessor :page_specific_text
 
-    def initialize(the_browser, page_text = nil)
+    def initialize(the_browser, page_specific_text = nil)
       @web_browser = the_browser
       @web_tester = the_browser
-      @page_text = page_text
+      @page_specific_text = page_specific_text
       begin
         snapshot if $ITEST2_DUMP_PAGE
         delay = $ITEST2_PAGE_DELAY
@@ -53,11 +53,11 @@ module RWebSpec
     #   ....
     #   home_page.assert_on_page # will check the text 'Welcome to iTest2' still present on the page
     def assert_on_page()
-      assert_text_present(@page_text) if @page_text
+      assert_text_present(@page_specific_text) if @page_specific_text
     end
 
     def assert_not_on_page()
-      assert_text_not_present(@page_text) if @page_text
+      assert_text_not_present(@page_specific_text) if @page_specific_text
     end
 
     def dump(stream = nil)
@@ -90,7 +90,7 @@ module RWebSpec
       end
       return found
     end
-
+    
     # Will save current page source to a file
     #  home_page = HomePage.new("Welcome to iTest2")
     #  ...

data/lib/rwebspec.rb

@@ -13,19 +13,23 @@ end
 require 'active_support/core_ext'
 require 'spec'
 
-RWEBSPEC_VERSION = RWEBUNIT_VERSION = "1.4.0.2"
+unless defined? RWEBSPEC_VERSION
+  RWEBSPEC_VERSION = RWEBUNIT_VERSION = "1.6"
+end
 
 # Extra full path to load libraries
 require File.dirname(__FILE__) + "/rwebspec/using_pages"
 require File.dirname(__FILE__) + "/rwebspec/test_utils"
 require File.dirname(__FILE__) + "/rwebspec/web_page"
 require File.dirname(__FILE__) + "/rwebspec/assert"
-require File.dirname(__FILE__) + "/rwebspec/itest_plugin"
 require File.dirname(__FILE__) + "/rwebspec/web_browser"
 require File.dirname(__FILE__) + "/rwebspec/driver"
 require File.dirname(__FILE__) + "/rwebspec/test_script"
 require File.dirname(__FILE__) + "/rwebspec/context"
 require File.dirname(__FILE__) + "/rwebspec/rspec_helper"
+require File.dirname(__FILE__) + "/rwebspec/load_test_helper"
 require File.dirname(__FILE__) + "/rspec_extensions"
 require File.dirname(__FILE__) + "/watir_extensions"
 require File.dirname(__FILE__) + "/rwebspec/matchers/contains_text"
+require File.dirname(__FILE__) + "/rwebspec/testwise_plugin"
+