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

page-object 1.1.0 → 1.1.1

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)