rwebspec 4.2.1 → 4.3.1

data/CHANGELOG

@@ -1,5 +1,8 @@
 CHANGELOG
 =========
+4.3
+[TODO] RWebSpec.framework = "Auto", Watir for IE, Selenium for others.
+
 4.2.1
 [Fixes] assert_not_exists for Selenium
 

data/Rakefile

@@ -78,7 +78,7 @@ end
 spec = Gem::Specification.new do |s|
   s.platform= Gem::Platform::RUBY
   s.name = "rwebspec"
-  s.version = "4.2.1"
+  s.version = "4.3.1"
   s.summary = "Web application functional specification in Ruby"
   s.description = "Executable functional specification for web applications in RSpec syntax with Watir or Selenium"
 

data/lib/rwebspec-common/{test_utils.rb → core.rb}

@@ -1,396 +1,492 @@
-#***********************************************************
-#* Copyright (c) 2006, Zhimin Zhan.
-#* Distributed open-source, see full license in MIT-LICENSE
-#***********************************************************
-
-# useful hekoer methods for testing
-#
-module RWebSpec
-  module Utils
-
-    # TODO: syntax
-
-    # Try the operation up to specified timeout (in seconds), and sleep given interval (in seconds).
-    # Error will be ignored until timeout
-    # Example
-    #    try_for { click_link('waiting')}
-    #    try_for(10, 2) { click_button('Search' } # try to click the 'Search' button upto 10 seconds, try every 2 seconds
-    #    try_for { click_button('Search' }
-    def try_for(timeout = $testwise_polling_timeout, polling_interval = $testwise_polling_interval || 1, &block)
-      start_time = Time.now
-
-      last_error = nil
-      until (duration = Time.now - start_time) > timeout
-        begin
-          yield
-          last_error = nil
-					return true 
-        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_for
-    alias try_up_to try_for
-    alias try_until try_for
-
-    def try(timeout = $testwise_polling_timeout, polling_interval = $testwise_polling_interval || 1, &block)
-      puts "Warning: method 'try' is deprecated (won't support in RWebSpec 3), use try_for instead."
-      try_for(timeout, polling_interval) {
-        yield
-      }
-    end
-    
-    
-    # Try the operation up to specified times, and sleep given interval (in seconds)
-    # Error will be ignored until timeout
-    # Example
-    #    repeat_try(3, 2) { click_button('Search' } # 3 times, 6 seconds in total
-    #    repeat_try { click_button('Search' } # using default 5 tries, 2 second interval
-    def repeat_try(num_tries = $testwise_polling_timeout || 30, interval = $testwise_polling_interval || 1, & block)
-      num_tries ||= 1
-      (num_tries - 1).times do |num|
-        begin
-          yield
-          return
-        rescue => e
-          # puts "debug: #{num} failed: #{e}"
-          sleep interval
-        end
-      end
-
-      # last try, throw error if still fails
-      begin
-        yield
-      rescue => e
-        raise e.to_s + " after trying #{num_tries} times every #{interval} seconds"
-      end
-      yield
-    end
-
-    
-    ##
-    #  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
-
-
-    #= Convenient functions
-    #
-
-    # 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
-
-    # 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
-
-    # default date format returned is 29/12/2007.
-    # if supplied parameter is not '%m/%d/%Y' -> 12/29/2007
-    # Otherwise, "2007-12-29", which is most approiate date format
-    #
-    #  %a - The abbreviated weekday name (``Sun'')
-    #  %A - The  full  weekday  name (``Sunday'')
-    #  %b - The abbreviated month name (``Jan'')
-    #  %B - The  full  month  name (``January'')
-    #  %c - The preferred local date and time representation
-    #  %d - Day of the month (01..31)
-    #  %H - Hour of the day, 24-hour clock (00..23)
-    #  %I - Hour of the day, 12-hour clock (01..12)
-    #  %j - Day of the year (001..366)
-    #  %m - Month of the year (01..12)
-    #  %M - Minute of the hour (00..59)
-    #  %p - Meridian indicator (``AM''  or  ``PM'')
-    #  %S - Second of the minute (00..60)
-    #  %U - Week  number  of the current year,
-    #          starting with the first Sunday as the first
-    #          day of the first week (00..53)
-    #  %W - Week  number  of the current year,
-    #          starting with the first Monday as the first
-    #          day of the first week (00..53)
-    #  %w - Day of the week (Sunday is 0, 0..6)
-    #  %x - Preferred representation for the date alone, no time
-    #  %X - Preferred representation for the time alone, no date
-    #  %y - Year without a century (00..99)
-    #  %Y - Year with century
-    #  %Z - Time zone name
-    #  %% - Literal ``%'' character
-
-    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 = nil)        
-      return nil if !(days.instance_of?(Fixnum))
-      format_date(Time.now - days * 24 * 3600, date_format(format))
-    end
-
-    def yesterday(format = nil)
-      days_before(1, date_format(format))
-    end
-
-    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(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
-    end
-
-    def random_boolean
-      return random_number(0, 1) == 1
-    end
-
-    def random_char(lowercase = true)
-      if lowercase
-        sprintf("%c", random_number(97, 122))
-      else
-        sprintf("%c", random_number(65, 90))
-      end
-    end
-
-    def random_digit()
-      sprintf("%c", random_number(48, 57))
-    end
-
-    def random_str(length, lowercase = true)
-      randomStr = ""
-      length.times {
-        randomStr += random_char(lowercase)
-      }
-      randomStr
-    end
-
-    # Return a random string in a rangeof pre-defined strings
-    def random_string_in(arr)
-      return nil if arr.empty?
-      index = random_number(0, arr.length-1)
-      arr[index]
-    end
-    alias random_string_in_collection random_string_in
-
-
-    WORDS = %w(alias consequatur aut perferendis sit voluptatem accusantium doloremque aperiam eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo aspernatur aut odit aut fugit sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt neque dolorem ipsum quia dolor sit amet consectetur adipisci velit sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem ut enim ad minima veniam quis nostrum exercitationem ullam corporis nemo enim ipsam voluptatem quia voluptas sit suscipit laboriosam nisi ut aliquid ex ea commodi consequatur quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae et iusto odio dignissimos ducimus qui blanditiis praesentium laudantium totam rem voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident sed ut perspiciatis unde omnis iste natus error similique sunt in culpa qui officia deserunt mollitia animi id est laborum et dolorum fuga et harum quidem rerum facilis est et expedita distinctio nam libero tempore cum soluta nobis est eligendi optio cumque nihil impedit quo porro quisquam est qui minus id quod maxime placeat facere possimus omnis voluptas assumenda est omnis dolor repellendus temporibus autem quibusdam et aut consequatur vel illum qui dolorem eum fugiat quo voluptas nulla pariatur at vero eos et accusamus officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae itaque earum rerum hic tenetur a sapiente delectus ut aut reiciendis voluptatibus maiores doloribus asperiores repellat)
-
-    # Pick a random value out of a given range.
-    def value_in_range(range)
-      case range.first
-      when Integer then number_in_range(range)
-      when Time then time_in_range(range)
-      when Date then date_in_range(range)
-      else range.to_a.rand
-      end
-    end
-
-    # 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)
-      if total.class == Range
-        (1..interpret_value(total)).map { WORDS[random_number(total.min, total.max)] }.join(' ')
-      else
-        (1..interpret_value(total)).map { WORDS[random_number(0, total)] }.join(' ')
-      end
-    end
-
-    # Generate a given number of sentences. If a range is passed, it will generate
-    # a random number of sentences within that range.
-    def sentences(total)
-      (1..interpret_value(total)).map do
-        words(5..20).capitalize
-      end.join('. ')
-    end
-
-    # Generate a given number of paragraphs. If a range is passed, it will generate
-    # a random number of paragraphs within that range.
-    def paragraphs(total)
-      (1..interpret_value(total)).map do
-        sentences(3..8).capitalize
-      end.join("\n\n")
-    end
-
-    # If an array or range is passed, a random value will be selected to match.
-    # All other values are simply returned.
-    def interpret_value(value)
-      case value
-      when Array then value.rand
-      when Range then value_in_range(value)
-      else value
-      end
-    end
-
-    private
-
-    def time_in_range(range)
-      Time.at number_in_range(Range.new(range.first.to_i, range.last.to_i, rangee.exclude_end?))
-    end
-
-    def date_in_range(range)
-      Date.jd number_in_range(Range.new(range.first.jd, range.last.jd, range.exclude_end?))
-    end
-
-    def number_in_range(range)
-      if range.exclude_end?
-        rand(range.last - range.first) + range.first
-      else
-        rand((range.last+1) - range.first) + range.first
-      end
-    end
-
-    def format_date(date, date_format = '%d/%m/%Y')
-      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
-
-
-    def average_of(array)
-      array.inject(0.0) { |sum, e| sum + e } / array.length
-    end
-
-    # NOTE might cause issues
-    # why it is removed total
-    def sum_of(array)
-      array.inject(0.0) { |sum, e| sum + e }
-    end
-
-		## Data Driven Tests
-		#
-		#  Processing each row in a CSV file, must have heading rows
-		# 
-		#  Usage:
-		# 
-		#   process_each_row_in_csv_file(@csv_file) { |row| 
-		#     goto_page("/")
-		#     enter_text("username", row[1])
-		#     enter_text("password", row[2])
-		#     click_button("Sign in")
-		#     page_text.should contain(row[3])
-		#     failsafe{ click_link("Sign off") }
-		#   }
-	  #
-		def process_each_row_in_csv_file(csv_file, &block)
-	    require 'faster_csv'
-	    connect_to_testwise("CSV_START",  csv_file) if $testwise_support
-	    has_error = false
-	    idx = 0
-	    FasterCSV.foreach(csv_file, :headers => :first_row, :encoding => 'u') do |row|
-				connect_to_testwise("CSV_ON_ROW",  idx.to_s)  if $testwise_support 
-				begin
-	        yield row
-					connect_to_testwise("CSV_ROW_PASS",  idx.to_s)  if $testwise_support
-				rescue => e
-					connect_to_testwise("CSV_ROW_FAIL",  idx.to_s)  if $testwise_support
-	        has_error = true
-	      ensure
-	        idx += 1
-				end
-	    end
-
-			connect_to_testwise("CSV_END",  "")  if $testwise_support
-			raise "Test failed on data" if has_error
-	  end
-
-
-  end
-end
+#***********************************************************
+#* Copyright (c) 2006, Zhimin Zhan.
+#* Distributed open-source, see full license in MIT-LICENSE
+#***********************************************************
+
+# useful hekoer methods for testing
+#
+module RWebSpec
+  module Core
+
+      # open a browser, and set base_url via hash, but does not acually
+      #
+      # example:
+      #   open_browser :base_url => http://localhost:8080, :browser => :ie
+      #
+      # There are 3 ways to set base url
+      #   1. pass as first argument
+      #   2. If running using TestWise, used as confiured
+      #   3. Use default value set
+      #
+      #
+      # New Options:
+      #    :browser => :ie | :firefox | :chrome
+    def open_browser(opts = {})
+      puts "[INFO] RWebSpec.Framework currently set to => #{RWebSpec.framework }"
+=begin      
+      if RWebSpec.framework =~ /watir/i
+        RWebSpec.load_watir
+        self.class.send(:include, RWebSpec::Driver)
+        load(File.dirname(__FILE__) + "/web_page.rb")
+        return open_browser_by_watir(opts)
+      end
+
+      if RWebSpec.framework =~ /selenium/i    
+        RWebSpec.load_selenium
+        self.class.send(:include, RWebSpec::Driver)
+        load(File.dirname(__FILE__) + "/web_page.rb")
+        return open_browser_by_selenium(opts)
+      end
+=end
+      puts "[INFO] No underlying framework is set, try to determine browser: #{opts.inspect}"
+      if opts.class == Hash
+        if opts[:browser] 
+          
+          if opts[:browser].to_s =~ /ie/i || opts[:browser].to_s =~ /internet\sexplorer/i
+            puts "[INFO] based on browser, set to Watir"
+            RWebSpec.framework = "Watir"
+            self.class.send(:include, RWebSpec::Driver)
+            load(File.dirname(__FILE__) + "/web_page.rb")
+            return open_browser_by_watir(opts)   
+          end
+          
+          puts "[INFO] based on browser, set to Selenium"          
+          # not IE, using selenium
+          RWebSpec.framework = "Selenium"
+          self.class.send(:include, RWebSpec::Driver)
+          load(File.dirname(__FILE__) + "/web_page.rb")
+          return open_browser_by_selenium(opts)   
+          
+        end
+      end
+
+      puts "[INFO] browser type not specified, decide framework based on platform"
+      if RUBY_PLATFORM =~ /mingw/
+        # if it is Windows, set to Watir
+        RWebSpec.framework = "Watir"
+        self.class.send(:include, RWebSpec::Driver)
+        puts "[INFO] Extends of RWebSpec::Driver"
+        load(File.dirname(__FILE__) + "/web_page.rb")
+        return open_browser_by_watir(opts) 
+      else
+        RWebSpec.framework = "Selenium"
+        self.class.send(:include, RWebSpec::Driver)
+        load(File.dirname(__FILE__) + "/web_page.rb")
+        # using extend somehow does not work for RSpec
+        # extend RWebSpec::Driver          
+
+        return open_browser_by_selenium(opts)   
+      end
+
+    end
+
+    def use_current_browser(how = :title, what = /.*/)
+      puts "[INFO] user current browser => #{RWebSpec.framework}"          
+      if RWebSpec.framework =~ /watir/i    
+        self.class.send(:include, RWebSpec::Driver)        
+        use_current_watir_browser(how, what)
+      elsif RWebSpec.framework =~ /selenium/i
+        self.class.send(:include, RWebSpec::Driver)        
+        use_current_selenium_browser(show, what)
+      else
+        # not specified, guess
+        if RUBY_PLATFORM =~ /mingw/i
+           RWebSpec.framework = "Watir"          
+           self.class.send(:include, RWebSpec::Driver)        
+           load(File.dirname(__FILE__) + "/web_page.rb")           
+           use_current_watir_browser(how, what)
+        else
+          RWebSpec.framework = "Selenium"                    
+          self.class.send(:include, RWebSpec::Driver)  
+          load(File.dirname(__FILE__) + "/web_page.rb")                
+          use_current_selenium_browser(show, what)   
+        end
+          
+      end
+    end
+    
+    
+    # Try the operation up to specified timeout (in seconds), and sleep given interval (in seconds).
+    # Error will be ignored until timeout
+    # Example
+    #    try_for { click_link('waiting')}
+    #    try_for(10, 2) { click_button('Search' } # try to click the 'Search' button upto 10 seconds, try every 2 seconds
+    #    try_for { click_button('Search' }
+    def try_for(timeout = $testwise_polling_timeout, polling_interval = $testwise_polling_interval || 1, &block)
+      start_time = Time.now
+
+      last_error = nil
+      until (duration = Time.now - start_time) > timeout
+        begin
+          yield
+          last_error = nil
+					return true 
+        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_for
+    alias try_up_to try_for
+    alias try_until try_for
+
+    def try(timeout = $testwise_polling_timeout, polling_interval = $testwise_polling_interval || 1, &block)
+      puts "Warning: method 'try' is deprecated (won't support in RWebSpec 3), use try_for instead."
+      try_for(timeout, polling_interval) {
+        yield
+      }
+    end
+    
+    
+    # Try the operation up to specified times, and sleep given interval (in seconds)
+    # Error will be ignored until timeout
+    # Example
+    #    repeat_try(3, 2) { click_button('Search' } # 3 times, 6 seconds in total
+    #    repeat_try { click_button('Search' } # using default 5 tries, 2 second interval
+    def repeat_try(num_tries = $testwise_polling_timeout || 30, interval = $testwise_polling_interval || 1, & block)
+      num_tries ||= 1
+      (num_tries - 1).times do |num|
+        begin
+          yield
+          return
+        rescue => e
+          # puts "debug: #{num} failed: #{e}"
+          sleep interval
+        end
+      end
+
+      # last try, throw error if still fails
+      begin
+        yield
+      rescue => e
+        raise e.to_s + " after trying #{num_tries} times every #{interval} seconds"
+      end
+      yield
+    end
+
+    
+    ##
+    #  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
+
+
+    #= Convenient functions
+    #
+
+    # 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
+
+    # 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
+
+    # default date format returned is 29/12/2007.
+    # if supplied parameter is not '%m/%d/%Y' -> 12/29/2007
+    # Otherwise, "2007-12-29", which is most approiate date format
+    #
+    #  %a - The abbreviated weekday name (``Sun'')
+    #  %A - The  full  weekday  name (``Sunday'')
+    #  %b - The abbreviated month name (``Jan'')
+    #  %B - The  full  month  name (``January'')
+    #  %c - The preferred local date and time representation
+    #  %d - Day of the month (01..31)
+    #  %H - Hour of the day, 24-hour clock (00..23)
+    #  %I - Hour of the day, 12-hour clock (01..12)
+    #  %j - Day of the year (001..366)
+    #  %m - Month of the year (01..12)
+    #  %M - Minute of the hour (00..59)
+    #  %p - Meridian indicator (``AM''  or  ``PM'')
+    #  %S - Second of the minute (00..60)
+    #  %U - Week  number  of the current year,
+    #          starting with the first Sunday as the first
+    #          day of the first week (00..53)
+    #  %W - Week  number  of the current year,
+    #          starting with the first Monday as the first
+    #          day of the first week (00..53)
+    #  %w - Day of the week (Sunday is 0, 0..6)
+    #  %x - Preferred representation for the date alone, no time
+    #  %X - Preferred representation for the time alone, no date
+    #  %y - Year without a century (00..99)
+    #  %Y - Year with century
+    #  %Z - Time zone name
+    #  %% - Literal ``%'' character
+
+    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 = nil)        
+      return nil if !(days.instance_of?(Fixnum))
+      format_date(Time.now - days * 24 * 3600, date_format(format))
+    end
+
+    def yesterday(format = nil)
+      days_before(1, date_format(format))
+    end
+
+    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(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
+    end
+
+    def random_boolean
+      return random_number(0, 1) == 1
+    end
+
+    def random_char(lowercase = true)
+      if lowercase
+        sprintf("%c", random_number(97, 122))
+      else
+        sprintf("%c", random_number(65, 90))
+      end
+    end
+
+    def random_digit()
+      sprintf("%c", random_number(48, 57))
+    end
+
+    def random_str(length, lowercase = true)
+      randomStr = ""
+      length.times {
+        randomStr += random_char(lowercase)
+      }
+      randomStr
+    end
+
+    # Return a random string in a rangeof pre-defined strings
+    def random_string_in(arr)
+      return nil if arr.empty?
+      index = random_number(0, arr.length-1)
+      arr[index]
+    end
+    alias random_string_in_collection random_string_in
+
+
+    WORDS = %w(alias consequatur aut perferendis sit voluptatem accusantium doloremque aperiam eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo aspernatur aut odit aut fugit sed quia consequuntur magni dolores eos qui ratione voluptatem sequi nesciunt neque dolorem ipsum quia dolor sit amet consectetur adipisci velit sed quia non numquam eius modi tempora incidunt ut labore et dolore magnam aliquam quaerat voluptatem ut enim ad minima veniam quis nostrum exercitationem ullam corporis nemo enim ipsam voluptatem quia voluptas sit suscipit laboriosam nisi ut aliquid ex ea commodi consequatur quis autem vel eum iure reprehenderit qui in ea voluptate velit esse quam nihil molestiae et iusto odio dignissimos ducimus qui blanditiis praesentium laudantium totam rem voluptatum deleniti atque corrupti quos dolores et quas molestias excepturi sint occaecati cupiditate non provident sed ut perspiciatis unde omnis iste natus error similique sunt in culpa qui officia deserunt mollitia animi id est laborum et dolorum fuga et harum quidem rerum facilis est et expedita distinctio nam libero tempore cum soluta nobis est eligendi optio cumque nihil impedit quo porro quisquam est qui minus id quod maxime placeat facere possimus omnis voluptas assumenda est omnis dolor repellendus temporibus autem quibusdam et aut consequatur vel illum qui dolorem eum fugiat quo voluptas nulla pariatur at vero eos et accusamus officiis debitis aut rerum necessitatibus saepe eveniet ut et voluptates repudiandae sint et molestiae non recusandae itaque earum rerum hic tenetur a sapiente delectus ut aut reiciendis voluptatibus maiores doloribus asperiores repellat)
+
+    # Pick a random value out of a given range.
+    def value_in_range(range)
+      case range.first
+      when Integer then number_in_range(range)
+      when Time then time_in_range(range)
+      when Date then date_in_range(range)
+      else range.to_a.rand
+      end
+    end
+
+    # 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)
+      if total.class == Range
+        (1..interpret_value(total)).map { WORDS[random_number(total.min, total.max)] }.join(' ')
+      else
+        (1..interpret_value(total)).map { WORDS[random_number(0, total)] }.join(' ')
+      end
+    end
+
+    # Generate a given number of sentences. If a range is passed, it will generate
+    # a random number of sentences within that range.
+    def sentences(total)
+      (1..interpret_value(total)).map do
+        words(5..20).capitalize
+      end.join('. ')
+    end
+
+    # Generate a given number of paragraphs. If a range is passed, it will generate
+    # a random number of paragraphs within that range.
+    def paragraphs(total)
+      (1..interpret_value(total)).map do
+        sentences(3..8).capitalize
+      end.join("\n\n")
+    end
+
+    # If an array or range is passed, a random value will be selected to match.
+    # All other values are simply returned.
+    def interpret_value(value)
+      case value
+      when Array then value.rand
+      when Range then value_in_range(value)
+      else value
+      end
+    end
+
+    private
+
+    def time_in_range(range)
+      Time.at number_in_range(Range.new(range.first.to_i, range.last.to_i, rangee.exclude_end?))
+    end
+
+    def date_in_range(range)
+      Date.jd number_in_range(Range.new(range.first.jd, range.last.jd, range.exclude_end?))
+    end
+
+    def number_in_range(range)
+      if range.exclude_end?
+        rand(range.last - range.first) + range.first
+      else
+        rand((range.last+1) - range.first) + range.first
+      end
+    end
+
+    def format_date(date, date_format = '%d/%m/%Y')
+      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
+
+
+    def average_of(array)
+      array.inject(0.0) { |sum, e| sum + e } / array.length
+    end
+
+    # NOTE might cause issues
+    # why it is removed total
+    def sum_of(array)
+      array.inject(0.0) { |sum, e| sum + e }
+    end
+
+		## Data Driven Tests
+		#
+		#  Processing each row in a CSV file, must have heading rows
+		# 
+		#  Usage:
+		# 
+		#   process_each_row_in_csv_file(@csv_file) { |row| 
+		#     goto_page("/")
+		#     enter_text("username", row[1])
+		#     enter_text("password", row[2])
+		#     click_button("Sign in")
+		#     page_text.should contain(row[3])
+		#     failsafe{ click_link("Sign off") }
+		#   }
+	  #
+		def process_each_row_in_csv_file(csv_file, &block)
+	    require 'faster_csv'
+	    connect_to_testwise("CSV_START",  csv_file) if $testwise_support
+	    has_error = false
+	    idx = 0
+	    FasterCSV.foreach(csv_file, :headers => :first_row, :encoding => 'u') do |row|
+				connect_to_testwise("CSV_ON_ROW",  idx.to_s)  if $testwise_support 
+				begin
+	        yield row
+					connect_to_testwise("CSV_ROW_PASS",  idx.to_s)  if $testwise_support
+				rescue => e
+					connect_to_testwise("CSV_ROW_FAIL",  idx.to_s)  if $testwise_support
+	        has_error = true
+	      ensure
+	        idx += 1
+				end
+	    end
+
+			connect_to_testwise("CSV_END",  "")  if $testwise_support
+			raise "Test failed on data" if has_error
+	  end
+
+
+  end
+end

data/lib/rwebspec-common/load_test_helper.rb

@@ -2,7 +2,7 @@
 module RWebSpec
   module LoadTestHelper
 
-    include RWebSpec::Utils
+    include RWebSpec::Core
     include RWebSpec::Assert
 
     MAX_VU = 1000

data/lib/rwebspec-common/rspec_helper.rb

@@ -17,8 +17,8 @@ end
 
 module RWebSpec
   module RSpecHelper
-    include RWebSpec::Driver
-    include RWebSpec::Utils
+
+    include RWebSpec::Core
     include RWebSpec::Assert
 
     # --

data/lib/rwebspec-common/test_script.rb

@@ -1,7 +1,7 @@
 module RWebSpec
   module TestScript
-    include RWebSpec::Driver
-    include RWebSpec::Utils
+    # include RWebSpec::Driver
+    include RWebSpec::Core
     include RWebSpec::Assert
     
   end

data/lib/rwebspec-common/web_page.rb

@@ -22,8 +22,12 @@ module RWebSpec
   class AbstractWebPage
 
     include RWebSpec::Assert
-    include RWebSpec::Driver
-    include RWebSpec::Utils
+    begin
+      include RWebSpec::Driver
+    rescue =>  e
+      puts "[WARN] Failed to load Driver, it will be reloaded. #{e.backtrace}"
+    end
+    include RWebSpec::Core
 
     # browser: passed to do assertion within the page
     # page_text: text used to identify the page, title will be the first candidate

data/lib/rwebspec-common/web_testcase.rb

@@ -14,7 +14,7 @@ module RWebSpec
   class WebTestCase < Test::Unit::TestCase
     include RWebSpec::Driver
     include RWebSpec::Assert
-    include RWebSpec::Utils
+    include RWebSpec::Core
 
     attr_reader :web_tester
 

data/lib/rwebspec-watir/driver.rb

@@ -29,7 +29,7 @@ module RWebSpec
     #   1. pass as first argument
     #   2. If running using TestWise, used as confiured
     #   3. Use default value set
-    def open_browser(options = {})
+    def open_browser_by_watir(options = {})
 
       begin
         support_unicode
@@ -83,7 +83,6 @@ module RWebSpec
       return @web_browser
     end
 
-    alias open_browser_with open_browser
 
     # return the underlying RWebSpec::Browser object
     def browser
@@ -214,9 +213,9 @@ module RWebSpec
 
     # Reuse current an opened browser window instead of opening a new one
     #	example:
-    #     use_current_browser(:title, /.*/) # use what ever browser window
-    #     use_current_browser(:title, "TestWise") # use browser window with title "TestWise"
-    def use_current_browser(how = :title, what = /.*/)
+    #     use_current_watir_browser(:title, /.*/) # use what ever browser window
+    #     use_current_watir_browser(:title, "TestWise") # use browser window with title "TestWise"    
+    def use_current_watir_browser(how = :title, what = /.*/)
       @web_browser = WebBrowser.attach_browser(how, what)
     end
 
@@ -785,7 +784,6 @@ module RWebSpec
       FileUtils.rm_f(screenshot_image_filepath) if File.exist?(screenshot_image_filepath)
     end
 
-    if RWebSpec.framework == "Watir"        
         begin       
           if is_firefox? then
             Win32::Screenshot::Take.of(:window, :title => /mozilla\sfirefox/i).write(screenshot_image_filepath)					
@@ -800,11 +798,7 @@ module RWebSpec
         rescue => e
           puts "error on taking screenshot: #{e}"
         end
-    else
-      # save screenshot with selenium
-      @web_browser.driver.save_screenshot(screenshot_image_filepath)
-      notify_screenshot_location(screenshot_image_filepath)
-    end  
+    
 
   end
 

data/lib/rwebspec-watir/web_browser.rb

@@ -2,6 +2,9 @@
 #* Copyright (c) 2006, Zhimin Zhan.
 #* Distributed open-source, see full license in MIT-LICENSE
 #***********************************************************
+
+=begin
+
 begin
   require 'watir'
   # require 'watir/contrib/enabled_popup'
@@ -20,6 +23,8 @@ if RUBY_PLATFORM =~ /mingw/
 	raise "You have must at least Watir installed" unless $watir_loaded
 end
 
+=end
+
 module RWebSpec
 
   ##

data/lib/rwebspec-webdriver/driver.rb

@@ -29,7 +29,7 @@ module RWebSpec
       #
       # New Options:
       #    :browser => :ie | :firefox | :chrome
-      def open_browser(options = {})
+      def open_browser_by_selenium(options = {})
         # puts "[DEBUG] [SeleniumDriver] Callling open_browser #{options.inspect}"
 
         begin
@@ -99,7 +99,6 @@ module RWebSpec
         return @web_browser
       end
 
-      alias open_browser_with open_browser
 
       # return the underlying RWebSpec::WebDriver::Browser object
       def browser
@@ -228,9 +227,9 @@ module RWebSpec
 
       # Reuse current an opened browser window instead of opening a new one
       #	example:
-      #     use_current_browser(:title, /.*/) # use what ever browser window
-      #     use_current_browser(:title, "TestWise") # use browser window with title "TestWise"
-      def use_current_browser(how = :title, what = /.*/)
+      #     use_current_selenium_browser(:title, /.*/) # use what ever browser window
+      #     use_current_selenium_browser(:title, "TestWise") # use browser window with title "TestWise"
+      def use_current_selenium_browser(how = :title, what = /.*/)
         @web_browser = $browser || WebBrowser.attach_browser(how, what)
       end
 
@@ -784,26 +783,9 @@ module RWebSpec
           FileUtils.rm_f(screenshot_image_filepath) if File.exist?(screenshot_image_filepath)
         end
 
-        if RWebSpec.framework == "Watir"        
-            begin       
-              if is_firefox? then
-                Win32::Screenshot::Take.of(:window, :title => /mozilla\sfirefox/i).write(screenshot_image_filepath)					
-    		      elsif ie
-                Win32::Screenshot::Take.of(:window, :title => /internet\sexplorer/i).write(screenshot_image_filepath)					
-              else
-                Win32::Screenshot::Take.of(:foreground).write(screenshot_image_filepath)
-              end
-              notify_screenshot_location(screenshot_image_filepath)
-    				rescue ::DL::DLTypeError => de
-    					puts "No screenshot libray found: #{de}"
-            rescue => e
-              puts "error on taking screenshot: #{e}"
-            end
-        else
           # save screenshot with selenium
           @web_browser.driver.save_screenshot(screenshot_image_filepath)
           notify_screenshot_location(screenshot_image_filepath)
-        end  
 
       end
       

data/lib/rwebspec-webdriver/web_browser.rb

@@ -3,11 +3,11 @@
 #* Distributed open-source, see full license in MIT-LICENSE
 #***********************************************************
 
-begin
-  require "selenium-webdriver"
-rescue LoadError => e
-  raise "You have must at least WebDriver installed"
-end
+# begin
+#   require "selenium-webdriver"
+# rescue LoadError => e
+#   raise "You have must at least WebDriver installed"
+# end
 
 require File.join(File.dirname(__FILE__), "element_locator.rb")
 

data/lib/rwebspec.rb

@@ -16,7 +16,7 @@ end
 require 'rspec'
 
 unless defined? RWEBSPEC_VERSION
-  RWEBSPEC_VERSION = RWEBUNIT_VERSION = "4.2.1"
+  RWEBSPEC_VERSION = RWEBUNIT_VERSION = "4.3.1"
 end
 
 $testwise_polling_interval = 1 # seconds
@@ -24,7 +24,7 @@ $testwise_polling_interval = 1 # seconds
 $testwise_polling_timeout = 30 # seconds
 
 
-if RUBY_PLATFORM =~ /mswin/ or RUBY_PLATFORM =~ /mingw/
+if RUBY_PLATFORM =~ /mingw/
  $screenshot_supported = false
  begin
    require 'win32/screenshot'
@@ -33,6 +33,13 @@ if RUBY_PLATFORM =~ /mswin/ or RUBY_PLATFORM =~ /mingw/
  end  
 end
 
+begin
+  require 'selenium-webdriver'
+rescue LoadError => e
+  $selenium_loaded = false
+end
+
+
 module RWebSpec
   class << self
     def version
@@ -41,7 +48,8 @@ module RWebSpec
 
     def framework
       @_framework ||= begin
-        ENV["RWEBSPEC_FRAMEWORK"] ||= (RUBY_PLATFORM =~ /mingw/ ? "Watir" : "Selenium-WebDriver")
+        ENV["RWEBSPEC_FRAMEWORK"] 
+        # ||= (RUBY_PLATFORM =~ /mingw/ ? "Watir" : "Selenium-WebDriver")
       end
       @_framework
     end
@@ -57,6 +65,8 @@ module RWebSpec
 
     def load_watir
       # puts "Loading Watir"
+      require 'watir'
+      require 'watir-classic/ie'
       load(File.dirname(__FILE__) + "/rwebspec-watir/web_browser.rb")
       load(File.dirname(__FILE__) + "/rwebspec-watir/driver.rb")
       require File.dirname(__FILE__) + "/extensions/watir_extensions"
@@ -64,6 +74,7 @@ module RWebSpec
     end
 
     def load_selenium
+      require 'selenium-webdriver'
       # puts "Loading Selenium"
       load(File.dirname(__FILE__) + "/rwebspec-webdriver/web_browser.rb")
       load(File.dirname(__FILE__) + "/rwebspec-webdriver/driver.rb")
@@ -74,7 +85,18 @@ module RWebSpec
       if @_framework.nil?
         framework
       end
-      RWebSpec.framework  == "Watir" ? load_watir : load_selenium
+
+      if RWebSpec.framework =~ /watir/i
+        load_watir
+        return
+      end
+
+      if RWebSpec.framework =~ /selenium/i
+         load_selenium
+         return
+      end
+
+      puts "[WARN] not framework loaded yet"
     end
 
   end
@@ -83,16 +105,17 @@ end
 # Watir 3 API Changes, no Watir/Container
 require File.dirname(__FILE__) + "/plugins/testwise_plugin.rb"
 
-RWebSpec.load_framework
+#RWebSpec.load_framework
 
 # Extra full path to load libraries
 require File.dirname(__FILE__) + "/rwebspec-common/using_pages"
-require File.dirname(__FILE__) + "/rwebspec-common/test_utils"
+require File.dirname(__FILE__) + "/rwebspec-common/core"
 require File.dirname(__FILE__) + "/rwebspec-common/web_page"
 require File.dirname(__FILE__) + "/rwebspec-common/assert"
-require File.dirname(__FILE__) + "/rwebspec-common/test_script"
 require File.dirname(__FILE__) + "/rwebspec-common/context"
-require File.dirname(__FILE__) + "/rwebspec-common/rspec_helper"
+require File.dirname(__FILE__) + "/rwebspec-common/test_script.rb"
+require File.dirname(__FILE__) + "/rwebspec-common/rspec_helper.rb"
+
 require File.dirname(__FILE__) + "/rwebspec-common/load_test_helper"
 require File.dirname(__FILE__) + "/rwebspec-common/matchers/contains_text"
 require File.dirname(__FILE__) + "/extensions/rspec_extensions"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: rwebspec
 version: !ruby/object:Gem::Version
-  version: 4.2.1
+  version: 4.3.1
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: rwebspec
 bindir: bin
 cert_chain: []
-date: 2013-06-29 00:00:00.000000000 Z
+date: 2013-07-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -126,13 +126,13 @@ files:
 - lib/rwebspec-common/assert.rb
 - lib/rwebspec-common/clickJSDialog.rb
 - lib/rwebspec-common/context.rb
+- lib/rwebspec-common/core.rb
 - lib/rwebspec-common/database_checker.rb
 - lib/rwebspec-common/load_test_helper.rb
 - lib/rwebspec-common/matchers/contains_text.rb
 - lib/rwebspec-common/popup.rb
 - lib/rwebspec-common/rspec_helper.rb
 - lib/rwebspec-common/test_script.rb
-- lib/rwebspec-common/test_utils.rb
 - lib/rwebspec-common/using_pages.rb
 - lib/rwebspec-common/web_page.rb
 - lib/rwebspec-common/web_testcase.rb