RubyGems - page-object - Versions diffs - 1.1.0 → 1.1.1 - Mend

page-object 1.1.0 → 1.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (63) hide show

checksums.yaml +4 -4
data/.coveralls.yml +1 -0
data/.gitignore +1 -0
data/.travis.yml +7 -2
data/ChangeLog +14 -1
data/Gemfile +4 -2
data/README.md +2 -0
data/Rakefile +5 -1
data/features/async.feature +3 -12
data/features/audio.feature +10 -14
data/features/element.feature +21 -0
data/features/gxt_table_extension.feature +1 -2
data/features/html/multi_elements.html +11 -10
data/features/html/static_elements.html +3 -16
data/features/html/widgets.html +20 -0
data/features/italic.feature +21 -0
data/features/multi_elements.feature +28 -22
data/features/sample-app/public/audio_video.html +23 -0
data/features/step_definitions/audio_steps.rb +6 -6
data/features/step_definitions/element_steps.rb +28 -0
data/features/step_definitions/gxt_table_steps.rb +1 -6
data/features/step_definitions/italic_steps.rb +12 -0
data/features/step_definitions/multi_elements_steps.rb +13 -0
data/features/step_definitions/page_traversal_steps.rb +4 -0
data/features/step_definitions/table_row_steps.rb +23 -0
data/features/step_definitions/video_steps.rb +3 -3
data/features/support/audio_video_page.rb +24 -0
data/features/support/page.rb +20 -20
data/features/support/url_helper.rb +4 -0
data/features/table_row.feature +43 -0
data/features/video.feature +1 -5
data/lib/page-object.rb +4 -0
data/lib/page-object/accessors.rb +88 -4
data/lib/page-object/elements.rb +2 -1
data/lib/page-object/elements/element.rb +5 -5
data/lib/page-object/elements/italic.rb +11 -0
data/lib/page-object/elements/ordered_list.rb +1 -1
data/lib/page-object/elements/unordered_list.rb +1 -1
data/lib/page-object/locator_generator.rb +2 -0
data/lib/page-object/platforms/selenium_webdriver/element.rb +37 -0
data/lib/page-object/platforms/selenium_webdriver/ordered_list.rb +10 -8
data/lib/page-object/platforms/selenium_webdriver/page_object.rb +51 -1
data/lib/page-object/platforms/selenium_webdriver/unordered_list.rb +7 -9
data/lib/page-object/platforms/watir_webdriver/element.rb +45 -1
data/lib/page-object/platforms/watir_webdriver/ordered_list.rb +9 -4
data/lib/page-object/platforms/watir_webdriver/page_object.rb +81 -50
data/lib/page-object/platforms/watir_webdriver/unordered_list.rb +11 -5
data/lib/page-object/version.rb +1 -1
data/lib/page-object/widgets.rb +1 -1
data/page-object.gemspec +1 -0
data/spec/page-object/element_locators_spec.rb +124 -80
data/spec/page-object/elements/element_spec.rb +83 -1
data/spec/page-object/elements/italic_spec.rb +29 -0
data/spec/page-object/elements/media_spec.rb +63 -0
data/spec/page-object/elements/ordered_list_spec.rb +6 -22
data/spec/page-object/elements/selenium_element_spec.rb +41 -0
data/spec/page-object/elements/unordered_list_spec.rb +4 -21
data/spec/page-object/elements/video_spec.rb +27 -0
data/spec/page-object/elements/watir_element_spec.rb +48 -0
data/spec/page-object/selenium_accessors_spec.rb +28 -9
data/spec/page-object/watir_accessors_spec.rb +57 -1
data/spec/spec_helper.rb +3 -6
metadata +39 -3

data/features/sample-app/public/audio_video.html ADDED

@@ -0,0 +1,23 @@
+<html>
+<head>
+    <title>Audio and Video</title>
+</head>
+  <body>
+    <h2>Audio & Video</h2>
+    <audio controls id="audio" name="audio" class="audio">
+      <source src="04-Death_Becomes_Fur.mp4"
+              type='audio/mp4'/>
+      <source src="04-Death_Becomes_Fur.oga"
+              type='audio/ogg; codecs=vorbis'/>
+      <p>Your user agent does not support the HTML5 Audio element.</p>
+    </audio>
+    <video width="320" height="240" controls="controls" id="video" name="video" class="video">
+      <source src="movie.mp4" type="video/mp4" />
+      <source src="movie.ogg" type="video/ogg" />
+      Your browser does not support the video tag.
+    </video>
+  </body>
+</head>

data/features/step_definitions/audio_steps.rb CHANGED

@@ -1,9 +1,13 @@
 When /^I search for the audio element by "([^\"]*)"$/ do |how|
-  @element = @page.send "audio_#{how}_element"
+  @element = @avpage.send "audio_#{how}_element"
 end
 When /^I search for the audio element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
-  @element = @page.send "audio_#{param1}_#{param2}_element"
+  @element = @avpage.send "audio_#{param1}_#{param2}_element"
+end
+When /^I retrieve the audio element from the page$/ do
+  @element = @avpage.audio_id_element
 end
 Then /^I should know the audio is not autoplay$/ do
@@ -18,10 +22,6 @@ Then /^I should know that the audio is paused$/ do
   @element.should be_paused
 end
-Then /^I should know that the duration is greater than (\d+) seconds$/ do |duration|
-  @element.duration.should > duration.to_f
-end
 Then /^I should know that its volume is (\d+)$/ do |volume|
   @element.volume.should == volume.to_i
 end

data/features/step_definitions/element_steps.rb CHANGED

@@ -264,3 +264,31 @@ Then(/^I should know the attribute "(.*?)" includes "(.+)"$/) do |attribute, inc
   @attr = @element.attribute(attribute)
   @attr.should include included
 end
+Then(/^I should be able to know its location$/) do
+  expect(@element.location.y).to be > 0
+  expect(@element.location.x).to be > 0
+end
+Then(/^I should be able to know its size$/) do
+  expect(@element.size.width).to be > 0
+  expect(@element.size.height).to be > 0
+end
+Then(/the element height is not 0/) do
+  (@element.height.is_a? Integer).should ==true
+  @element.height.should > 0
+end
+Then(/the element width is not 0/) do
+  (@element.width.is_a? Integer).should ==true
+  @element.width.should > 0
+end
+Then(/the element centre should be greater than element y position/) do
+  @element.centre['y'].should > @element.location.y
+end
+Then(/the element centre should be greater than element x position/) do
+  @element.centre['x'].should > @element.location.x
+end

data/features/step_definitions/gxt_table_steps.rb CHANGED

@@ -12,10 +12,6 @@ Given /^I am on the Gxt Examples page$/ do
   visit GxtSamplePageObject
 end
-When /^I have the Basic Grid opened$/ do
-  on(GxtSamplePageObject).basic_grid_element.click
-end
 When /^I have defined a GxtTable class extending Table$/ do
   class GxtTable < PageObject::Elements::Table
@@ -36,9 +32,8 @@ When /^I define a page-object using that widget$/ do
   class GxtSamplePageObject
     include PageObject
-    page_url "http://gxtexamplegallery.appspot.com/"
+    page_url UrlHelper.widgets
-    div(:basic_grid, :class => "label_basic_grid")
     gxt_table(:gxt_table, :class => "x-grid3")
   end unless class_exists? 'GxtSamplePageObject'
 end

data/features/step_definitions/italic_steps.rb ADDED

@@ -0,0 +1,12 @@
+When /^I get the italic text for the "([^\"]*)" element$/ do |el|
+  @i = @page.send "#{el}_id"
+end
+Then /^I should see "([^\"]*)" in italic$/ do |text|
+  @i.should == text
+end
+When /^I search italic text for the (\w+) by "([^"]*)"$/ do |text_decorator, type|
+  @i = @page.send "#{text_decorator}_#{type}"
+end

data/features/step_definitions/multi_elements_steps.rb CHANGED

@@ -32,6 +32,7 @@ class MultiElementsPage
   file_fields(:the_file_fields, :class => 'file_field_class')
   elements(:generic_label, :label, :class => 'label')
   b(:bs)
+  i(:is)
 end
@@ -539,3 +540,15 @@ end
 Then /^the text for b (\d+) should be "([^\"]*)"$/ do |b_num, text|
   @elements[b_num.to_i - 1].text.should == text
 end
+When /^I select the is$/ do
+  @elements = @page.i_elements
+end
+Then /^I should have (\d+) is$/ do |num_is|
+  @elements.size.should == num_is.to_i
+end
+Then /^the text for i (\d+) should be "([^\"]*)"$/ do |i_num, text|
+  @elements[i_num.to_i - 1].text.should == text
+end

data/features/step_definitions/page_traversal_steps.rb CHANGED

@@ -2,3 +2,7 @@ Given /^I am on the static elements page$/ do
   @page = Page.new(@browser)
   @page.navigate_to(UrlHelper.static_elements)
 end
+Given /^I am on the audio video page$/ do
+  @avpage = visit AudioVideoPage
+end

data/features/step_definitions/table_row_steps.rb ADDED

@@ -0,0 +1,23 @@
+When /^I search for the table row by "([^\"]*)"$/ do |how|
+  @row_data = @page.send "tr_#{how}"
+end
+When /^I retrieve a table row element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @row_data = @page.send "tr_#{param1}_#{param2}"
+end
+When /^I retrieve a table row element while the script is executing$/ do
+  @row_data = @page.row_element(:id => 'tr_id').text
+end
+Then /^I should see that the row exists$/ do
+  @page.tr_id?.should == true
+end
+When /^I retrieve the data from the table row/ do
+  @row_data = @page.tr_id
+end
+Then /^the row data should be '([^"]*)'$/ do |expected|
+  @row_data.should == expected
+end

data/features/step_definitions/video_steps.rb CHANGED

@@ -1,14 +1,14 @@
 When /^I retrieve the video element$/ do
-  @element = @page.video_id_element
+  @element = @avpage.video_id_element
 end
 When /^I search for the video element by "([^\"]*)"$/ do |how|
-  @element = @page.send "video_#{how}_element"
+  @element = @avpage.send "video_#{how}_element"
 end
 When /^I search for the video element by "([^\"]*)" and "([^\"]*)"$/ do |param1, param2|
-  @element = @page.send "video_#{param1}_#{param2}_element"
+  @element = @avpage.send "video_#{param1}_#{param2}_element"
 end
 Then /^I should know the video is not autoplay$/ do

data/features/support/audio_video_page.rb ADDED

@@ -0,0 +1,24 @@
+class AudioVideoPage
+  include PageObject
+  page_url "http://localhost:4567/audio_video.html"
+  audio(:audio_id, :id => 'audio')
+  audio(:audio_name, :name => 'audio')
+  audio(:audio_class, :class => 'audio')
+  audio(:audio_css, :css => '.audio')
+  audio(:audio_index, :index => 0)
+  audio(:audio_xpath, :xpath => '//audio')
+  audio(:audio_class_index, :class => 'audio', :index => 0)
+  audio(:audio_name_index, :name => 'audio', :index => 0)
+  video(:video_id, :id => 'video')
+  video(:video_name, :name => 'video')
+  video(:video_class, :class => 'video')
+  video(:video_css, :css => '.video')
+  video(:video_index, :index => 0)
+  video(:video_xpath, :xpath => '//video')
+  video(:video_class_index, :class => 'video', :index => 0)
+  video(:video_name_index, :name => 'video', :index => 0)
+end

data/features/support/page.rb CHANGED

@@ -109,7 +109,7 @@ class Page
   div(:div_title, :title => 'div_title')
   div(:div_class_index, :class => "div_class", :index => 0)
   div(:div_name_index, :name => "div_name", :index => 0)
   div(:div_data_entity, :data_entity => "test")
   span(:span_id, :id => 'span_id')
@@ -143,6 +143,15 @@ class Page
   cell(:cell_class_index, :class => "cell_class", :index => 0)
   cell(:cell_name_index, :name => "cell_name", :index => 0)
+  row(:tr_id, :id => 'tr_id')
+  row(:tr_class, :class => 'tr_class')
+  row(:tr_css, :css => '.tr_class')
+  row(:tr_index, :index => 1)
+  row(:tr_text, :text => 'Data1 Data2')
+  row(:tr_xpath, :xpath => '//table//tbody//tr[1]')
+  row(:tr_class_index, :class => "tr_class", :index => 0)
+  row(:tr_name_index, :name => "tr_name", :index => 0)
   button(:button_id, :id => 'button_id')
   button(:button_name, :name => 'button_name')
   button(:button_class, :class => 'button_class')
@@ -333,24 +342,6 @@ class Page
   canvas(:canvas_class_index, :class => 'canvas', :index => 0)
   canvas(:canvas_name_index, :name => 'canvas', :index => 0)
-  audio(:audio_id, :id => 'audio')
-  audio(:audio_name, :name => 'audio')
-  audio(:audio_class, :class => 'audio')
-  audio(:audio_css, :css => '.audio')
-  audio(:audio_index, :index => 0)
-  audio(:audio_xpath, :xpath => '//audio')
-  audio(:audio_class_index, :class => 'audio', :index => 0)
-  audio(:audio_name_index, :name => 'audio', :index => 0)
-  video(:video_id, :id => 'video')
-  video(:video_name, :name => 'video')
-  video(:video_class, :class => 'video')
-  video(:video_css, :css => '.video')
-  video(:video_index, :index => 0)
-  video(:video_xpath, :xpath => '//video')
-  video(:video_class_index, :class => 'video', :index => 0)
-  video(:video_name_index, :name => 'video', :index => 0)
   element(:article_id, :article, :id => 'article_id')
   element(:header_id, :header, :id => 'header_id')
   element(:footer_id, :footer, :id => 'footer_id')
@@ -358,7 +349,7 @@ class Page
   element(:details_id, :details, :id => 'details_id')
   figure(:figure_id, :id => 'figure_id')
   svg(:svg_id, :id => 'the_svg')
   b(:b_id, :id => 'b_id')
@@ -369,5 +360,14 @@ class Page
   b(:b_xpath, :xpath => '//b')
   b(:b_class_index, :class => 'b_class', :index => 0)
   b(:b_name_index, :name => 'b_name', :index => 0)
+  i(:i_id, :id => 'i_id')
+  i(:i_class, :class => 'i_class')
+  i(:i_css, :css => '.i_class')
+  i(:i_name, :name => 'i_name')
+  i(:i_index, :index => 0)
+  i(:i_xpath, :xpath => '//i')
+  i(:i_class_index, :class => 'i_class', :index => 0)
+  i(:i_name_index, :name => 'i_name', :index => 0)
 end

data/features/support/url_helper.rb CHANGED

@@ -53,5 +53,9 @@ module UrlHelper
     def double_click
       "#{files}/double_click.html"
     end
+    def widgets
+      "#{files}/widgets.html"
+    end
   end
 end

data/features/table_row.feature ADDED

@@ -0,0 +1,43 @@
+Feature: Table Row
+  Background:
+    Given I am on the static elements page
+  Scenario: Retrieving the text from a table row
+    When I retrieve the data from the table row
+    Then the row data should be 'Data1 Data2'
+  Scenario Outline: Locating table rows on the Page
+    When I search for the table row by "<search_by>"
+    Then the row data should be 'Data1 Data2'
+    Scenarios:
+      | search_by |
+      | id        |
+      | class     |
+      | xpath     |
+      | css       |
+  @watir_only
+  Scenario: Locating table rows on the Page by text
+    When I search for the table row by "text"
+    Then the row data should be 'Data1 Data2'
+  @watir_only
+  Scenario Outline: Locating table rows on the Page with watir
+    When I search for the table row by "<search_by>"
+    Then the row data should be 'Data1 Data2'
+    Scenarios:
+      | search_by |
+      | index     |
+  Scenario: Locating table row using multiple parameters
+    When I retrieve a table row element by "class" and "index"
+    Then the row data should be 'Data1 Data2'
+  Scenario: Finding a table row dynamically
+    When I retrieve a table row element while the script is executing
+    Then I should see that the row exists
+    And the row data should be 'Data1 Data2'

data/features/video.feature CHANGED

@@ -1,7 +1,7 @@
 Feature: Support for video element
   Background:
-    Given I am on the static elements page
+    Given I am on the audio video page
   Scenario: finding an video element
     When I retrieve the video element
@@ -42,10 +42,6 @@ Feature: Support for video element
     When I retrieve the video element
     Then I should know that the video is paused
-  Scenario: Should know its duration
-    When I retrieve the video element
-    Then I should know that the duration is greater than 12 seconds
   Scenario: Should know its volume
     When I retrieve the video element
     Then I should know that its volume is 1

data/lib/page-object.rb CHANGED

@@ -49,6 +49,10 @@ module PageObject
   include LoadsPlatform
   include ElementLocators
   include PagePopulator
+  extend Forwardable
+  # Forward visibility checks to root so page sections can be tested for existence.
+  def_delegators :root, :visible?, :present?, :exists?
   # @return [Watir::Browser or Selenium::WebDriver::Driver] the platform browser passed to the constructor
   attr_reader :browser

data/lib/page-object/accessors.rb CHANGED

@@ -207,7 +207,7 @@ module PageObject
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
-    def text_field(name, identifier={:index => 0}, &block)
+    def text_field(name, identifier={:index => 0}, &block)
       standard_methods(name, identifier, 'text_field_for', &block)
       define_method(name) do
         return platform.text_field_value_for identifier.clone unless block_given?
@@ -402,7 +402,7 @@ module PageObject
     end
     #
-    # adds four methods - one to select, another to return if a radio button
+    # adds four methods - one to select, another to return if a radio button
     # is selected, another method to return a PageObject::Elements::RadioButton
     # object representing the radio button element, and another to check
     # the radio button's existence.
@@ -637,6 +637,36 @@ module PageObject
     end
     alias_method :td, :cell
+    #
+    # adds three methods - one to retrieve the text from a table row,
+    # another to return the table row element, and another to check the row's
+    # existence.
+    #
+    # @example
+    #   row(:sums, :id => 'sum_row')
+    #   # will generate 'sums', 'sums_element', and 'sums?' methods
+    #
+    # @param [Symbol] the name used for the generated methods
+    # @param [Hash] identifier how we find a cell.  You can use a multiple parameters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :css => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :text => Watir only
+    #   * :xpath => Watir and Selenium
+    #   * :css => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def row(name, identifier={:index => 0}, &block)
+      standard_methods(name, identifier, 'row_for', &block)
+      define_method("#{name}") do
+        return platform.row_text_for identifier.clone unless block_given?
+        self.send("#{name}_element").text
+      end
+    end
     #
     # adds two methods - one to retrieve the image element, and another to
     # check the image's existence.
@@ -1145,6 +1175,34 @@ module PageObject
       end
     end
+    #
+    # adds three methods - one to retrieve the text of a i element, another to
+    # retrieve a i element, and another to check for it's existence.
+    #
+    # @example
+    #   i(:italic, :id => 'title')
+    #   # will generate 'italic', 'italic_element', and 'italic?' methods
+    #
+    # @param [Symbol] the name used for the generated methods
+    # @param [Hash] identifier how we find a i. You can use a multiple parameters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :css => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def i(name, identifier={:index => 0}, &block)
+      standard_methods(name, identifier,'i_for', &block)
+      define_method(name) do
+        return platform.i_text_for identifier.clone unless block_given?
+        self.send("#{name}_element").text
+      end
+    end
+    alias_method :icon, :i
     #
     # adds two methods - one to retrieve a svg, and another to check
     # the svg's existence.
@@ -1189,7 +1247,20 @@ module PageObject
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
-    def element(name, tag, identifier={:index => 0}, &block)
+    def element(name, tag=:element, identifier={ :index => 0 }, &block)
+      # default tag to :element
+      #
+      # element 'button', css: 'some css'
+      #
+      # is the same as
+      #
+      # element 'button', :element, css: 'some css'
+      #
+      if tag.is_a?(Hash)
+        identifier = tag
+        tag        = :element
+      end
       define_method("#{name}") do
         self.send("#{name}_element").text
       end
@@ -1222,7 +1293,20 @@ module PageObject
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
-    def elements(name, tag, identifier={:index => 0}, &block)
+    def elements(name, tag=:element, identifier={:index => 0}, &block)
+      # default tag to :element
+      #
+      # elements 'button', css: 'some css'
+      #
+      # is the same as
+      #
+      # elements 'button', :element, css: 'some css'
+      #
+      if tag.is_a?(Hash)
+        identifier = tag
+        tag        = :element
+      end
       define_method("#{name}_elements") do
         return call_block(&block) if block_given?
         platform.elements_for(tag, identifier.clone)