rwebspec-webdriver 0.1.1 → 0.1.2

data/lib/rwebspec-webdriver/web_page.rb

@@ -0,0 +1,110 @@
+#***********************************************************
+#* Copyright (c) 2006, Zhimin Zhan.
+#* Distributed open-source, see full license in MIT-LICENSE
+#***********************************************************
+require File.join(File.dirname(__FILE__), 'assert')
+require File.join(File.dirname(__FILE__), 'driver')
+require 'fileutils'
+
+module RWebSpec
+  module WebDriver
+
+    # WebPage (children of AbstractWebPage) encapsulates a real web page.
+    # For example,
+    #  beginAt("/home")
+    #  @web_browser.clickLinkWithText("/login")
+    #  @web_browser.setFormElement("username", "sa")
+    # Can be rewritten to
+    #  begin_at("/home")
+    #  home_page = HomePage.new
+    #  login_page = home_page.clickLoginLink
+    #  login_page.enterUserName("sa")
+    #
+    # So you only need change in LoingPage class if UI changes, which happen quite often.
+    class AbstractWebPage
+
+      include RWebSpec::WebDriver::Assert
+      include RWebSpec::WebDriver::Driver
+
+      # browser: passed to do assertion within the page
+      # page_text: text used to identify the page, title will be the first candidate
+      attr_accessor :page_specific_text
+
+      def initialize(the_browser, page_specific_text = nil)
+        @web_browser = the_browser
+        @web_tester = the_browser
+        @page_specific_text = page_specific_text
+        begin
+          snapshot if $ITEST2_DUMP_PAGE
+          delay = $ITEST2_PAGE_DELAY
+          sleep(delay)
+        rescue => e
+        end
+        assert_on_page
+      end
+
+      # return the browser instance in page objects
+      def browser
+        @web_browser
+      end
+
+      # Assert is on current page
+      # Example
+      #   home_page = HomePage.new("Welcome to iTest2")
+      #   ....
+      #   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_specific_text) if @page_specific_text
+      end
+
+      def assert_not_on_page()
+        assert_text_not_present(@page_specific_text) if @page_specific_text
+      end
+
+      def dump(stream = nil)
+        @web_browser.dump_response(stream)
+      end
+
+      # Page source (html)
+      def source
+        @web_browser.page_source
+      end
+      alias html source
+
+      # return current page title
+      def title
+        @web_browser.page_title
+      end
+
+      # return current page text
+      def text
+        @web_browser.text
+      end
+
+      def url
+        @web_browser.url
+      end
+
+      # TO validate
+      def contains?(ary)
+        return true if ary.nil?
+        the_page_source = source
+        found = false
+        ary.each_line do |str|
+          found ||= the_page_source.include?(str)
+        end
+        return found
+      end
+
+      # Will save current page source to a file
+      #  home_page = HomePage.new("Welcome to iTest2")
+      #  ...
+      #  home_page.snapshot() # => save to 20090830100102_HomePage.html
+      def	snapshot(replace_css = false)
+        save_current_page(:filename => Time.now.strftime("%m%d%H%M%S") + "_" + self.class.name.gsub(" ", "") + ".html" )
+      end
+
+    end
+
+  end
+end

data/lib/rwebspec-webdriver/web_testcase.rb

@@ -0,0 +1,40 @@
+#***********************************************************
+#* Copyright (c) 2006, Zhimin Zhan.
+#* Distributed open-source, see full license in MIT-LICENSE
+#***********************************************************
+
+# Deprecated, use RSpec syntax instead
+
+require 'test/unit'
+require File.join(File.dirname(__FILE__), 'assert')
+require File.join(File.dirname(__FILE__), 'driver')
+
+module RWebSpec
+  module WebDriver
+
+    class WebTestCase < Test::Unit::TestCase
+      include RWebSpec::WebDriver::Driver
+      include RWebSpec::WebDriver::Assert
+      include RWebSpec::WebDriver::Utils
+
+      attr_reader :web_tester
+
+      def initialize(name=nil)
+        super(name) if name
+        @web_browser = WebBrowser.new
+      end
+
+      def default_test
+        super unless (self.class == WebTestCase)
+      end
+
+      def open_browser(baseUrl, relativeUrl)
+        context.base_url = baseUrl
+        begin_at(relativeUrl)
+      end
+      alias open_ie open_browser
+
+    end
+
+  end
+end

data/lib/rwebspec-webdriver.rb

@@ -31,22 +31,22 @@ if  RUBY_PLATFORM =~ /mswin/ or RUBY_PLATFORM =~ /mingw/
 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/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__) + "/rwebspec-webdriver/using_pages"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/test_utils"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/web_page"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/assert"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/web_browser"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/driver"
+# require File.dirname(__FILE__) + "/rwebspec-webdriver/test_script"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/context"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/rspec_helper"
+# require File.dirname(__FILE__) + "/rwebspec-webdriver/load_test_helper"
 require File.dirname(__FILE__) + "/rspec_extensions"
 require File.dirname(__FILE__) + "/webdriver_extensions"
 if  RUBY_PLATFORM =~ /mswin/ or RUBY_PLATFORM =~ /mingw/
   require File.dirname(__FILE__) + "/window_script_extensions.rb"
 end
 
-require File.dirname(__FILE__) + "/rwebspec/matchers/contains_text"
-require File.dirname(__FILE__) + "/rwebspec/testwise_plugin"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/matchers/contains_text"
+require File.dirname(__FILE__) + "/rwebspec-webdriver/testwise_plugin"
 

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: rwebspec-webdriver
 version: !ruby/object:Gem::Version 
-  hash: 25
+  hash: 31
   prerelease: 
   segments: 
   - 0
   - 1
-  - 1
-  version: 0.1.1
+  - 2
+  version: 0.1.2
 platform: ruby
 authors: 
 - Zhimin Zhan
@@ -15,7 +15,7 @@ autorequire: rwebspec-webdriver
 bindir: bin
 cert_chain: []
 
-date: 2011-07-12 00:00:00 +10:00
+date: 2011-07-13 00:00:00 +10:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -80,23 +80,23 @@ files:
 - CHANGELOG
 - MIT-LICENSE
 - lib/rspec_extensions.rb
-- lib/rwebspec/assert.rb
-- lib/rwebspec/clickJSDialog.rb
-- lib/rwebspec/context.rb
-- lib/rwebspec/database_checker.rb
-- lib/rwebspec/driver.rb
-- lib/rwebspec/element_locator.rb
-- lib/rwebspec/load_test_helper.rb
-- lib/rwebspec/matchers/contains_text.rb
-- lib/rwebspec/popup.rb
-- lib/rwebspec/rspec_helper.rb
-- lib/rwebspec/test_script.rb
-- lib/rwebspec/test_utils.rb
-- lib/rwebspec/testwise_plugin.rb
-- lib/rwebspec/using_pages.rb
-- lib/rwebspec/web_browser.rb
-- lib/rwebspec/web_page.rb
-- lib/rwebspec/web_testcase.rb
+- lib/rwebspec-webdriver/assert.rb
+- lib/rwebspec-webdriver/clickJSDialog.rb
+- lib/rwebspec-webdriver/context.rb
+- lib/rwebspec-webdriver/database_checker.rb
+- lib/rwebspec-webdriver/driver.rb
+- lib/rwebspec-webdriver/element_locator.rb
+- lib/rwebspec-webdriver/load_test_helper.rb
+- lib/rwebspec-webdriver/matchers/contains_text.rb
+- lib/rwebspec-webdriver/popup.rb
+- lib/rwebspec-webdriver/rspec_helper.rb
+- lib/rwebspec-webdriver/test_script.rb
+- lib/rwebspec-webdriver/test_utils.rb
+- lib/rwebspec-webdriver/testwise_plugin.rb
+- lib/rwebspec-webdriver/using_pages.rb
+- lib/rwebspec-webdriver/web_browser.rb
+- lib/rwebspec-webdriver/web_page.rb
+- lib/rwebspec-webdriver/web_testcase.rb
 - lib/rwebspec-webdriver.rb
 - lib/webdriver_extensions.rb
 - lib/window_script_extensions.rb
@@ -129,7 +129,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
       version: "0"
 requirements: 
 - none
-rubyforge_project: rwebspec-webdrive
+rubyforge_project: rwebspec-webdriver
 rubygems_version: 1.4.2
 signing_key: 
 specification_version: 3

data/lib/rwebspec/assert.rb

@@ -1,443 +0,0 @@
-require 'test/unit/assertions'
-
-# http://selenium.googlecode.com/svn/trunk/docs/api/rb/Selenium/WebDriver/SearchContext.html#find_element-instance_method
-
-module RWebSpec
-  module Assert
-    include Test::Unit::Assertions
-
-    def assert_not(condition, msg = "")
-      perform_assertion { assert(!condition, msg) }
-    end
-
-    def assert_nil(actual, msg="")
-      perform_assertion { assert(actual.nil?, msg) }
-    end
-
-    def assert_not_nil(actual, msg="")
-      perform_assertion { assert(!actual.nil?, msg) }
-    end
-
-    def fail(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_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)
-      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("iTest2 Cool") # <b>iTest2</b>  Cool
-    def assert_text_not_present(text)
-      perform_assertion { assert(!(@web_browser.text.include? text), 'expected text: ' + text + ' found') }
-    end
-
-
-    ##
-    # Link
-    # @NOTE: this is different from Watir version
-
-    # Assert a link containing specified text in the page
-    #  
-    #  <a href="">Click Me</a>
-    #  assert_link_present_with_text("Click ") # => 
-    #
-    def assert_link_present_with_text(link_text, opts = {})
-      begin
-        if opts && opts[:partial]
-          elem = @web_browser.find_element(:partial_link_text, link_text)
-        else
-          elem = @web_browser.find_element(:link_text, link_text)
-        end
-      rescue => e
-        puts "Failed to find the link text :#{e}"
-      end
-
-      if elem
-        return true
-      else
-        fail("can't find the link with text: #{link_text}")
-      end
-    end
-
-    def assert_link_not_present_with_text(link_text, opts = {})
-      begin
-        if opts && opts[:partial]
-          elem = @web_browser.find_element(:partial_link_text, link_text)
-        else
-          elem = @web_browser.find_element(:link_text, link_text)
-        end
-      rescue => e
-        puts "Failed to find the link text :#{e}"
-      end
-      if elem
-        fail("unexpected link (exact): #{link_text} found")
-      else
-        return true
-      end
-    end
-
-
-    ##
-    # Checkbox
-    def assert_checkbox_not_selected(checkbox_name)
-      elem = find_element(:name, checkbox_name)
-      fail "Checkbox with name:#{checkbox_name} not found" unless elem.tag_name == "input"
-      assert !elem.selected?
-    end
-
-    alias assert_checkbox_not_checked assert_checkbox_not_selected
-
-    def assert_checkbox_selected(checkbox_name)
-      elem = find_element(:name, checkbox_name)
-      fail "Checkbox with name:#{checkbox_name} not found" unless elem.tag_name == "input"
-      assert elem.selected?
-    end
-
-    alias assert_checkbox_checked assert_checkbox_selected
-
-    ##
-    # select
-    def assert_option_value_not_present(select_name, option_value)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      option_values = options.collect { |x| x.attribute('value') }
-      if option_values.include?(option_value)
-        fail "Unexpected select option value #{option_value}"
-      else
-        return true
-      end
-    end
-
-    alias assert_select_value_not_present assert_option_value_not_present
-
-    def assert_option_not_present(select_name, option_label)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      option_labels= options.collect { |x| x.attribute('value') }
-      if option_labels.include?(option_label)
-        fail "Unexpected select option label #{option_label}"
-      else
-        return true
-      end
-    end
-
-    alias assert_select_label_not_present assert_option_not_present
-
-    def assert_option_value_present(select_name, option_value)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      option_values = options.collect { |x| x.attribute('value') }
-      if option_values.include?(option_value)
-        return true
-      else
-        fail "Unexpected select option value #{option_value}"
-      end
-    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)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      option_labels = options.collect { |x| x.text }
-      if option_labels.include?(option_label)
-        return true
-      else
-        fail "Unexpected select option label #{option_label}"
-      end
-    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)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      selected_label_list = []
-      options.each do |op|
-        selected_label_list << op.text if op.selected?
-      end
-      assert selected_label_list.join(",").to_s == option_label
-    end
-
-    alias assert_select_label assert_option_equals
-    alias assert_menu_label assert_option_equals
-
-    def assert_option_value_equals(select_name, option_value)
-      select_element = find_element(:name, select_name)
-      options = select_element.find_elements(:xpath, ".//option")
-      selected_value_list = []
-      options.each do |op|
-        selected_value_list << op.attribute('value') if op.selected?
-      end
-      assert selected_value_list.join(",").to_s == option_value
-    end
-
-    alias assert_select_value assert_option_value_equals
-    alias assert_menu_value assert_option_value_equals
-
-    ##
-    # radio
-
-    # radio_group is the name field, radio options 'value' field
-    def assert_radio_option_not_present(radio_group, radio_option)
-      begin
-        elem = find_element(:xpath, "//input[@type='radio' and @name='#{radio_group}' and @value='#{radio_option}']")
-      rescue => e
-      end
-
-      if elem
-        fail("unexpected radio option: " + radio_option + " found")
-      else
-        return true
-      end
-    end
-
-    def assert_radio_option_present(radio_group, radio_option)
-      elem = find_element(:xpath, "//input[@type='radio' and @name='#{radio_group}' and @value='#{radio_option}']")
-      if elem
-        return true
-      else
-        fail("can't find the radio option : '#{radio_option}'")
-      end
-    end
-
-    def assert_radio_option_selected(radio_group, radio_option)
-      elem = find_element(:xpath, "//input[@type='radio' and @name='#{radio_group}' and @value='#{radio_option}']")
-      assert elem.selected?
-    end
-
-    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)
-      elem = find_element(:xpath, "//input[@type='radio' and @name='#{radio_group}' and @value='#{radio_option}']")
-      assert !elem.selected?
-    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_present(button_id)
-      find_element(:id, button_id)
-    end
-
-    def assert_button_not_present(button_id)
-      elem = safe_find_element_by_id(button_id)
-      if elem && elem.tag_name == "button" then
-        fail("Unexpected button with this id: #{button_id}")
-      end
-      return true
-    end
-
-    def assert_button_present_with_text(button_text)
-      input_buttons = find_elements(:xpath, "//input[@type = 'button' or @type = 'submit']")
-      input_button_values = input_buttons.collect { |x| x.attribute('value') }
-      if input_button_values.include?(button_text)
-        return true
-      else
-        #TODO check for just <button tag
-        fail("can't find the button with text: #{button_text}")
-      end
-    end
-
-    def assert_button_not_present_with_text(button_text)
-      input_buttons = find_elements(:xpath, "//input[@type = 'button' or @type = 'submit']")
-      input_button_values = input_buttons.collect { |x| x.attribute('value') }
-      if input_button_values.include?(button_text)
-        fail("can't find the button with text: #{button_text}")
-      else
-        #TODO check for just <button tag
-        return true
-      end
-    end
-
-    ## General
-    #
-
-    def assert_equals(expected, actual, msg=nil)
-      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)
-      elem = find_element(:id, element_id)
-      if elem
-        return true
-      else
-        fail("Element '#{tag}' with id: '#{element_id}' not found")
-      end
-    end
-
-    alias assert_exists? assert_exists
-    alias assert_element_exists assert_exists
-
-    def assert_not_exists(tag, element_id)
-      elem = find_element(:id, element_id)
-      if elem
-        fail("#{tag} with #{element_id} not expected there, but exists")
-      else
-        return true
-      end
-    end
-
-    alias assert_not_exists? assert_not_exists
-    alias assert_element_not_exists? assert_not_exists
-
-
-    # Assert tag with element id is visible?, eg. 
-    #   assert_visible(:div, "public_notice")
-    #   assert_visible(:span, "public_span")
-    def assert_visible(tag, element_id)
-      element = find_element(:id, element_id)
-      perform_assertion { assert(element.displayed?, "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)
-      element = find_element(:id, element_id)
-      perform_assertion { assert(!element.displayed?, "Element '#{tag}' with id: '#{element_id}' is visible") }
-    end
-
-    alias assert_not_visible assert_hidden
-
-    def assert_disabled(tag, element_id)
-      element = find_element(:id, element_id)
-      assert !element.enabled?
-    end
-
-    def assert_enabled(tag, element_id)
-      element = find_element(:id, element_id)
-      puts "XXX :#{element.tag_name}"
-      assert element.enabled?
-    end
-
-
-    # Assert given text appear inside a table (inside <table> tag like below) 
-    #
-    # <table id="t1">
-    #
-    # <tbody>
-    #   <tr id="row_1">
-    #     <td id="cell_1_1">A</td>
-    #     <td id="cell_1_2">B</td>
-    #   </tr>
-    #   <tr id="row_2">
-    #     <td id="cell_2_1">a</td>
-    #     <td id="cell_2_2">b</td>
-    #   </tr>
-    # </tbody>
-    #
-    # </table>
-    #
-    # The plain text view of above table
-    #  A B a b
-    # 
-    # Examples
-    #  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})
-      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})
-      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
-    #
-    # <input id="tid" name="text1" value="text already there" type="text">
-    # 
-    # assert_text_field_value("text1", "text already there") => true
-    #
-    def assert_text_field_value(textfield_name, text)
-      perform_assertion { assert_equal(text, text_field(:name, textfield_name).attribute('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")
-      perform_assertion { assert(elem.innerText.include?(text), "the text #{text} not found in element #{element_id}") }
-    end
-
-    # Use 
-    #
-
-    #TODO for drag-n-drop, check the postion in list
-    #    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_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
-        return true
-      rescue StandardError => e
-        # puts "[DEBUG] Assertion error: #{e}"
-        take_screenshot
-        raise e
-      end
-    end
-
-    #
-    def safe_find_element_by_id(an_id)
-      begin
-        find_element(:id, an_id)
-      rescue => e
-        puts "Not found, but not throwing an error"
-        nil
-      end
-    end
-
-
-  end
-end