rwebspec 1.4.0.2 → 1.6

data/CHANGELOG

@@ -1,5 +1,42 @@
 CHANGELOG
 =========
+ 1.6 
+   Include ScreenCapture
+
+ 1.5.4
+   Add syntax click_link("Duplicate Link", :index => 2) # second link
+
+ 1.5.3 (2010-01-06)
+  rename itest_plugin -> testwise_plugin
+  remove dependency on test-unit
+
+ 1.5.2
+  add contains matcher to driver and page
+  in page, page_text renamed to page_specific_text
+  more unit tests
+
+ 1.5.1 
+   [Load Test helper
+   assert_text_present changed to check text view of web pages
+   detect ILOAD2 environment to determin to preivew load test or not
+
+ 1.5
+   [New] Supports Watir 1.6.5 
+   [Fixes] Array@sum conflicts with ActiveSupport
+   [New] New database_checker
+   [Other] load_table define class under ITEST::Module
+
+ 1.4.2
+   [New] average, sum for array objects, such as [1,2,3,4].average
+   [New] support date format with today(:us), yesterday("%d/%m/%Y")
+   [TODO] click security alerts
+
+ 1.4.1
+   [New] Added LoadTestHelper
+   [New] add expect_page to web_browser
+   [Fix] nil error in random_str (test_utils.rb) 
+   [New] Add alias methods for select_list (alias)
+
  1.4.0.2
    Fixed: reuse browser does not work
    Add gem dependency (Watir/Firewatir) depends on platforms

data/Rakefile

@@ -12,6 +12,9 @@ $:.unshift(File.dirname(__FILE__) + "/lib")
 desc "Default task"
 task :default => [ :clean, :spec, :rdoc, :chm, :gem]
 
+desc "Continous build"
+task :build => [:clean, :spec]
+
 desc "Clean generated files"
 task :clean do
   rm_rf 'pkg'
@@ -69,7 +72,7 @@ end
 spec = Gem::Specification.new do |s|
   s.platform= Gem::Platform::RUBY
   s.name = "rwebspec"
-  s.version = "1.4.0.2"
+  s.version = "1.6"
   s.summary = "Executable functional specification for web applications in RSpec syntax and Watir"
   # s.description = ""
 
@@ -89,14 +92,8 @@ spec = Gem::Specification.new do |s|
   s.files = s.files + Dir.glob( "sample/**/*")
   s.files = s.files + Dir.glob( "docs/**/*" )
   s.add_dependency(%q<rspec>, ["= 1.1.12"])
-  if RUBY_PLATFORM.downcase.include?("mswin") or RUBY_PLATFORM.downcase.include?("mingw")
-    s.add_dependency("watir", ">= 1.6.2")
-  else
-    s.add_dependency("firewatir", ">= 1.6.2")
-  end
-    
-  s.add_dependency("commonwatir", ">= 1.6.2")
-  s.add_dependency("test-unit", ">= 2.0.2")
+
+  s.add_dependency("commonwatir", ">= 1.6.5")
 end
 
 Rake::GemPackageTask.new(spec) do |pkg|

data/lib/rwebspec/assert.rb

@@ -2,41 +2,53 @@ require 'test/unit/assertions'
 
 module RWebSpec
   module Assert
-
     include Test::Unit::Assertions
-    
+
     def assert_not(condition, msg = "")
-      assert(!condition, msg)
+      perform_assertion { assert(!condition, msg) }
     end
-    
+
     def assert_nil(actual, msg="")
-      assert(actual.nil?, msg)
+      perform_assertion { assert(actual.nil?, msg) }
     end
 
     def assert_not_nil(actual, msg="")
-      assert(!actual.nil?, msg)
+      perform_assertion { assert(!actual.nil?, msg) }
     end
 
     def fail(message)
-      assert(false, message)
+      perform_assertion { assert(false, message) }
     end
 
     # assertions
     def assert_title_equals(title)
       assert_equals(title, @web_browser.page_title)
     end
+
     alias assert_title assert_title_equals
 
     # Assert text present in page source (html)
-    #   assert_text_present("<h1>iTest2</h1>")
+    #   assert_text_in_page_source("<b>iTest2</b>  Cool") # <b>iTest2</b>  Cool
+    def assert_text_in_page_source(text)
+      perform_assertion { assert((@web_browser.page_source.include? text), 'expected html: ' + text + ' not found') }
+    end
+
+    # Assert text not present in page source (html)
+    #   assert_text_not_in_page_source("<b>iTest2</b>  Cool") # <b>iTest2</b>  Cool
+    def assert_text_not_in_page_source(text)
+      perform_assertion { assert(!(@web_browser.page_source.include? text), 'expected html: ' + text + ' found') }
+    end
+
+    # Assert text present in page source (html)
+    #   assert_text_present("iTest2 Cool") # <b>iTest2</b>  Cool
     def assert_text_present(text)
-      assert((@web_browser.page_source.include? text), 'expected text: ' + text + ' not found')
+      perform_assertion { assert((@web_browser.text.include? text), 'expected text: ' + text + ' not found') }
     end
 
     # Assert text not present in page source (html)
-    #   assert_text_not_present("<h1>iTest2</h1>")
+    #   assert_text_not_present("iTest2 Cool") # <b>iTest2</b>  Cool
     def assert_text_not_present(text)
-      assert(!(@web_browser.page_source.include? text), 'expected text: ' + text + ' found')
+      perform_assertion { assert(!(@web_browser.text.include? text), 'expected text: ' + text + ' found') }
     end
 
 
@@ -58,7 +70,7 @@ module RWebSpec
 
     def assert_link_not_present_with_exact(link_text)
       @web_browser.links.each { |link|
-        assert(link_text != link.text, "unexpected link (exact): #{link_text} found")
+        perform_assertion { assert(link_text != link.text, "unexpected link (exact): #{link_text} found") }
       }
     end
 
@@ -76,7 +88,7 @@ module RWebSpec
 
     def assert_link_not_present_with_text(link_text)
       @web_browser.links.each { |link|
-        assert(!link.text.include?(link_text), "unexpected link containing: #{link_text} found")
+        perform_assertion { assert(!link.text.include?(link_text), "unexpected link containing: #{link_text} found") }
       }
     end
 
@@ -86,20 +98,22 @@ module RWebSpec
     def assert_checkbox_not_selected(checkbox_name)
       @web_browser.checkboxes.each { |checkbox|
         if (checkbox.name == checkbox_name) then
-          assert(!checkbox.isSet?, "Checkbox #{checkbox_name} is checked unexpectly")
+          perform_assertion {  assert(!checkbox.isSet?, "Checkbox #{checkbox_name} is checked unexpectly") }
         end
       }
     end
-	alias assert_checkbox_not_checked assert_checkbox_not_selected
+
+    alias assert_checkbox_not_checked assert_checkbox_not_selected
 
     def assert_checkbox_selected(checkbox_name)
       @web_browser.checkboxes.each { |checkbox|
         if (checkbox.name == checkbox_name) then
-          assert(checkbox.isSet?, "Checkbox #{checkbox_name} not checked")
+          perform_assertion { assert(checkbox.isSet?, "Checkbox #{checkbox_name} not checked") }
         end
       }
     end
-	alias assert_checkbox_checked assert_checkbox_selected
+
+    alias assert_checkbox_checked assert_checkbox_selected
 
     ##
     # select
@@ -107,20 +121,22 @@ module RWebSpec
       @web_browser.select_lists.each { |select|
         continue unless select.name == select_name
         select.o.each do |option| # items in the list
-          assert(!(option.value == option_value), "unexpected select option: #{option_value} for #{select_name} found")
+          perform_assertion {  assert(!(option.value == option_value), "unexpected select option: #{option_value} for #{select_name} found") }
         end
       }
     end
+
     alias assert_select_value_not_present assert_option_value_not_present
 
     def assert_option_not_present(select_name, option_label)
       @web_browser.select_lists.each { |select|
         next unless select.name == select_name
         select.o.each do |option| # items in the list
-          assert(!(option.text == option_label), "unexpected select option: #{option_label} for #{select_name} found")
+          perform_assertion {  assert(!(option.text == option_label), "unexpected select option: #{option_label} for #{select_name} found") }
         end
       }
     end
+
     alias assert_select_label_not_present assert_option_not_present
 
     def assert_option_value_present(select_name, option_value)
@@ -130,9 +146,11 @@ module RWebSpec
           return if option.value == option_value
         end
       }
-      assert(false, "can't find the combob box with value: #{option_value}")
+      fail("can't find the combo box with value: #{option_value}")
     end
+
     alias assert_select_value_present assert_option_value_present
+    alias assert_menu_value_present assert_option_value_present
 
     def assert_option_present(select_name, option_label)
       @web_browser.select_lists.each { |select|
@@ -141,30 +159,36 @@ module RWebSpec
           return if option.text == option_label
         end
       }
-      assert(false, "can't find the combob box: #{select_name} with value: #{option_label}")
+      fail("can't find the combob box: #{select_name} with value: #{option_label}")
     end
+
     alias assert_select_label_present assert_option_present
+    alias assert_menu_label_present assert_option_present
 
     def assert_option_equals(select_name, option_label)
       @web_browser.select_lists.each { |select|
         next unless select.name == select_name
         select.o.each do |option| # items in the list
           if (option.text == option_label) then
-            assert_equal(select.value, option.value, "Select #{select_name}'s value is not equal to expected option label: '#{option_label}'")
+            perform_assertion { assert_equal(select.value, option.value, "Select #{select_name}'s value is not equal to expected option label: '#{option_label}'") }
           end
         end
       }
     end
+
     alias assert_select_label assert_option_equals
+    alias assert_menu_label assert_option_equals
 
     def assert_option_value_equals(select_name, option_value)
       @web_browser.select_lists.each { |select|
         next unless select.name == select_name
-        assert_equal(select.value, option_value, "Select #{select_name}'s value is not equal to expected: '#{option_value}'")
+        perform_assertion {  assert_equal(select.value, option_value, "Select #{select_name}'s value is not equal to expected: '#{option_value}'") }
       }
     end
+
     alias assert_select_value assert_option_value_equals
-    
+    alias assert_menu_value assert_option_value_equals
+
     ##
     # radio
 
@@ -172,11 +196,11 @@ module RWebSpec
     def assert_radio_option_not_present(radio_group, radio_option)
       @web_browser.radios.each { |radio|
         if (radio.name == radio_group) then
-          assert(!(radio_option == radio.value), "unexpected radio option: " + radio_option  + " found")
+          perform_assertion {  assert(!(radio_option == radio.value), "unexpected radio option: " + radio_option  + " found") }
         end
       }
     end
-	
+
     def assert_radio_option_present(radio_group, radio_option)
       @web_browser.radios.each { |radio|
         return if (radio.name == radio_group) and (radio_option == radio.value)
@@ -187,34 +211,36 @@ module RWebSpec
     def assert_radio_option_selected(radio_group, radio_option)
       @web_browser.radios.each { |radio|
         if (radio.name == radio_group and radio_option == radio.value) then
-          assert(radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] not checked")
+          perform_assertion { assert(radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] not checked") }
         end
       }
     end
-	alias assert_radio_button_checked assert_radio_option_selected
-	alias assert_radio_option_checked assert_radio_option_selected
-	
+
+    alias assert_radio_button_checked assert_radio_option_selected
+    alias assert_radio_option_checked assert_radio_option_selected
+
     def assert_radio_option_not_selected(radio_group, radio_option)
       @web_browser.radios.each { |radio|
         if (radio.name == radio_group and radio_option == radio.value) then
-          assert(!radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] checked unexpected")
+          perform_assertion {  assert(!radio.isSet?, "Radio button #{radio_group}-[#{radio_option}] checked unexpected") }
         end
       }
     end
+
     alias assert_radio_button_not_checked assert_radio_option_not_selected
     alias assert_radio_option_not_checked assert_radio_option_not_selected
-	
+
     ##
     # Button
     def assert_button_not_present(button_id)
       @web_browser.buttons.each { |button|
-        assert(button.id != button_id, "unexpected button id: #{button_id} found")
+        perform_assertion { assert(button.id != button_id, "unexpected button id: #{button_id} found") }
       }
     end
 
     def assert_button_not_present_with_text(text)
       @web_browser.buttons.each { |button|
-        assert(button.value != text, "unexpected button id: #{text} found")
+        perform_assertion { assert(button.value != text, "unexpected button id: #{text} found") }
       }
     end
 
@@ -222,44 +248,37 @@ module RWebSpec
       @web_browser.buttons.each { |button|
         return if button_id == button.id
       }
-      assert(false, "can't find the button with id: #{button_id}")
+      fail("can't find the button with id: #{button_id}")
     end
 
     def assert_button_present_with_text(button_text)
       @web_browser.buttons.each { |button|
         return if button_text == button.value
       }
-      assert(false, "can't find the button with text: #{button_text}")
+      fail("can't find the button with text: #{button_text}")
     end
 
 
     def assert_equals(expected, actual, msg=nil)
-      assert(expected == actual, (msg.nil?) ? "Expected: #{expected} diff from actual: #{actual}" : msg)
+      perform_assertion { assert(expected == actual, (msg.nil?) ? "Expected: #{expected} diff from actual: #{actual}" : msg) }
     end
 
 
-
     # Check a HTML element exists or not
     # Example:
     #  assert_exists("label", "receipt_date")
     #  assert_exists(:span, :receipt_date)
-    def assert_exists(tag, element_id) {}
-      begin
-        assert eval("#{tag}(:id, '#{element_id.to_s}').exists?")
-      rescue => e
-        raise "Element '#{tag}' with id: '#{element_id}' not found, #{e}"
-      end
+    def assert_exists(tag, element_id)
+      perform_assertion { assert(eval("#{tag}(:id, '#{element_id.to_s}').exists?"), "Element '#{tag}' with id: '#{element_id}' not found") }
     end
+
     alias assert_exists? assert_exists
     alias assert_element_exists assert_exists
 
-    def assert_not_exists(tag, element_id) {}
-      begin
-        assert_not eval("#{tag}(:id, '#{element_id.to_s}').exists?")
-        raise "Unexpected element'#{tag}' + with id: '#{element_id}' found"
-      rescue => e
-      end
+    def assert_not_exists(tag, element_id)
+      perform_assertion {  assert_not(eval("#{tag}(:id, '#{element_id.to_s}').exists?"), "Unexpected element'#{tag}' + with id: '#{element_id}' found")}
     end
+
     alias assert_not_exists? assert_not_exists
     alias assert_element_not_exists? assert_not_exists
 
@@ -268,23 +287,16 @@ module RWebSpec
     #   assert_visible(:div, "public_notice")
     #   assert_visible(:span, "public_span")
     def assert_visible(tag, element_id)
-      begin
-        assert(eval("#{tag}(:id, '#{element_id.to_s}').visible?"))
-      rescue => e
-        raise "Element '#{tag}' with id: '#{element_id}' not visible, #{e}"
-      end
+      perform_assertion { assert(eval("#{tag}(:id, '#{element_id.to_s}').visible?"), "Element '#{tag}' with id: '#{element_id}' not visible") }
     end
 
     # Assert tag with element id is hidden?, example 
     #   assert_hidden(:div, "secret")
     #   assert_hidden(:span, "secret_span")
     def assert_hidden(tag, element_id)
-      begin
-        assert(!eval("#{tag}(:id, '#{element_id.to_s}').visible?"))
-      rescue => e
-        raise "Element '#{tag}' with id: '#{element_id}' is visible, #{e}"
-      end
+      perform_assertion { assert(!eval("#{tag}(:id, '#{element_id.to_s}').visible?"), "Element '#{tag}' with id: '#{element_id}' is visible") }
     end
+
     alias assert_not_visible assert_hidden
 
 
@@ -312,13 +324,15 @@ module RWebSpec
     #  assert_text_present_in_table("t1", ">A<")  # => true
     #  assert_text_present_in_table("t1", ">A<", :just_plain_text => true)  # => false        
     def assert_text_present_in_table(table_id, text, options = { :just_plain_text => false })
-      assert(table_source(table_id, options).include?(text),  "the text #{text} not found in table #{table_id}")
+      perform_assertion { assert(table_source(table_id, options).include?(text), "the text #{text} not found in table #{table_id}") }
     end
+
     alias assert_text_in_table assert_text_present_in_table
 
     def assert_text_not_present_in_table(table_id, text, options = { :just_plain_text => false })
-      assert_not(table_source(table_id, options).include?(text),  "the text #{text} not found in table #{table_id}")
+      perform_assertion { assert_not(table_source(table_id, options).include?(text), "the text #{text} not found in table #{table_id}") }
     end
+
     alias assert_text_not_in_table assert_text_not_present_in_table
 
     # Assert a text field (with given name) has the value
@@ -328,17 +342,17 @@ module RWebSpec
     # assert_text_field_value("text1", "text already there") => true
     #
     def assert_text_field_value(textfield_name, text)
-      assert_equal(text, text_field(:name, textfield_name).value)
+      perform_assertion { assert_equal(text, text_field(:name, textfield_name).value) }
     end
 
-    
+
     #-- Not tested
     # -----
-    
+
     def assert_text_in_element(element_id, text)
       elem = element_by_id(element_id)
       assert_not_nil(elem.innerText, "element #{element_id} has no text")
-      assert(elem.innerText.include?(text), "the text #{text} not found in element #{element_id}")
+      perform_assertion { assert(elem.innerText.include?(text), "the text #{text} not found in element #{element_id}") }
     end
 
     # Use 
@@ -348,14 +362,25 @@ module RWebSpec
     #    def assert_position_in_list(list_element_id)
     #      raise "not implemented"
     #    end
-    
+
     private
     def table_source(table_id, options)
-   	  elem_table = table(:id, table_id.to_s)
-      elem_table_text = elem_table.text 
+      elem_table = table(:id, table_id.to_s)
+      elem_table_text = elem_table.text
       elem_table_html = is_firefox? ? elem_table.innerHTML : elem_table.html
       table_source = options[:just_plain_text] ? elem_table_text : elem_table_html
     end
-    
+
+
+    def perform_assertion(&block)
+      begin
+        yield
+      rescue StandardError => e
+        # puts "[DEBUG] Assertion error: #{e}"
+        take_screenshot
+        raise e
+      end
+    end
+
   end
 end

data/lib/rwebspec/database_checker.rb

@@ -0,0 +1,74 @@
+require 'active_record' # change rwebspec/database
+
+module RWebSpec
+  module DatabaseChecker
+
+    # Example
+    #   connect_to_database mysql_db(:host => "localhost", :database => "lavabuild_local", :user => "root", :password => ""), true
+    def mysql_db(settings)
+      options = {:adapter => "mysql"}
+      options.merge!(settings)
+    end
+
+    # connect_to_database sqlite3_db(:database => File.join(File.dirname(__FILE__), "testdata", "sample.sqlite3")), true
+    def sqlite3_db(settings)
+      options = {:adapter => "sqlite3"}
+      options.merge!(settings)
+    end
+
+    def sqlserver_db(settings)
+      options = {:adapter => "sqlserver"}
+      options[:username] ||= settings[:user]
+      options.merge!(settings)
+    end
+
+    def sqlserver_db_dbi(options)
+      options[:user] ||= options[:username]
+      options[:username] ||= options[:user]
+      conn_str = "DBI:ADO:Provider=SQLOLEDB;Data Source=#{options[:host]};Initial Catalog=#{options[:database]};User ID=\"#{options[:user]}\";password=\"#{options[:password]}\" "
+      dbh = DBI.connect(conn_str)
+    end
+
+    def clear_database_connection
+      begin
+        ActiveRecord::Base.remove_connection
+      rescue => e
+        puts "failed o clear database connection: #{e}"
+      end
+    end
+
+    # Connect to databse, example
+    #   mysql_db(:host => "localhost", :database => "lavabuild_local", :user => "root", :password => "")
+    def connect_to_database(db_settings, force = false)
+      # only setup database connection once
+      if force
+        ActiveRecord::Base.establish_connection(db_settings)
+      else
+        begin
+          ActiveRecord::Base.connection
+        rescue => e
+          require 'pp'
+          pp db_settings
+          puts "failed to connect: #{e}"
+          ActiveRecord::Base.establish_connection(db_settings)
+        end
+      end
+    end
+
+    def load_table(table_name)
+      begin
+        ActiveRecord::Base.connection
+      rescue =>e
+        raise "No database connection setup yet, use connect_to_database() method"
+      end
+      class_name = table_name.classify
+      # define the class, so can use ActiveRecord in
+      # such as
+      #   Perosn.count.should == 2
+      def_class = "class ::#{class_name} < ActiveRecord::Base; end"
+      eval def_class
+      return def_class
+    end
+
+  end
+end