RubyGems - page-object - Versions diffs - 0.5.3 → 0.5.4 - Mend

page-object 0.5.3 → 0.5.4

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 (41) hide show

data/ChangeLog +10 -1
data/features/async.feature +11 -4
data/features/file_field.feature +30 -0
data/features/form.feature +1 -0
data/features/html/async.html +21 -0
data/features/html/nested_elements.html +3 -1
data/features/html/static_elements.html +4 -2
data/features/image.feature +2 -0
data/features/nested_elements.feature +4 -0
data/features/step_definitions/async_steps.rb +31 -0
data/features/step_definitions/file_field_steps.rb +19 -0
data/features/step_definitions/nested_elements_steps.rb +16 -7
data/features/support/page.rb +13 -0
data/features/support/url_helper.rb +4 -0
data/features/text_field.feature +3 -2
data/lib/page-object/accessors.rb +35 -1
data/lib/page-object/element_locators.rb +19 -1
data/lib/page-object/elements.rb +1 -0
data/lib/page-object/elements/element.rb +20 -0
data/lib/page-object/elements/file_field.rb +35 -0
data/lib/page-object/elements/form.rb +8 -0
data/lib/page-object/elements/image.rb +8 -0
data/lib/page-object/elements/text_field.rb +2 -2
data/lib/page-object/nested_elements.rb +4 -0
data/lib/page-object/page_populator.rb +2 -2
data/lib/page-object/platforms/selenium_webdriver/check_box.rb +2 -2
data/lib/page-object/platforms/selenium_webdriver/element.rb +19 -14
data/lib/page-object/platforms/selenium_webdriver/file_field.rb +16 -0
data/lib/page-object/platforms/selenium_webdriver/page_object.rb +30 -2
data/lib/page-object/platforms/watir_webdriver/element.rb +19 -14
data/lib/page-object/platforms/watir_webdriver/file_field.rb +16 -0
data/lib/page-object/platforms/watir_webdriver/page_object.rb +22 -1
data/lib/page-object/version.rb +1 -1
data/spec/page-object/accessors_spec.rb +45 -0
data/spec/page-object/element_locators_spec.rb +7 -1
data/spec/page-object/elements/element_spec.rb +1 -10
data/spec/page-object/elements/file_field_spec.rb +35 -0
data/spec/page-object/elements/image_spec.rb +3 -3
data/spec/page-object/elements/text_field_spec.rb +3 -3
data/spec/page-object/page_populator_spec.rb +6 -0
metadata +23 -12

data/ChangeLog CHANGED Viewed

@@ -1,4 +1,13 @@
-=== Version 0.5.3
+=== Version 0.5.4 / 2011-12-18
+* Enhancements
+  * Added deprecation warning to the method_missing method on Element.  This ability will be removed in 0.6
+  * Added full support for file_field element
+  * Added ability to find TextField by :title
+  * Added ability to find Form by :action
+  * Added ability to find Image by :alt
+  * Added ability to find Image by :src
+=== Version 0.5.3 / 2011-12-11
 * Enhancements
   * Added new module PagePopulator with single method populate_page_with
   * Updated to use selenium-webdriver 2.15.0

data/features/async.feature CHANGED Viewed

@@ -1,11 +1,18 @@
 Feature: Handling Asynch calls
-  Background:
-    Given I am on the static elements page
   Scenario: Link element methods
+    Given I am on the static elements page
     When I retrieve a link element
     Then I should be able to wait until it is present
     And I should be able to wait until it is visible
     And I should be able to wait until it is not visible
-    And I should be able to wait until a block returns true
+    And I should be able to wait until a block returns true
+  Scenario: Click a button when it is visible
+    Given I am on the async elements page
+    When I make the button invisible
+    Then I should be able to click it when it becomses visible
+  Scenario: Wait until something is not visible
+    Given I am on the async elements page
+    Then I should be able to wait until the button becomes invisible

data/features/file_field.feature ADDED Viewed

@@ -0,0 +1,30 @@
+Feature: File Field
+  Background:
+    Given I am on the static elements page
+  Scenario: Setting the value on the file field
+    When I set the file field to the step definition file
+    Then its' value should equal that file
+  Scenario Outline: Locating file fields on the Page
+    When I search for the file field by "<search_by>"
+    Then I should be able to set the file field
+  Examples:
+    | search_by |
+    | id        |
+    | class     |
+    | name      |
+    | xpath     |
+    | title     |
+    | index     |
+  Scenario Outline: Locating file fields using multiple parameters
+    When I search for the file field by "<param1>" and "<param2>"
+    Then I should be able to set the file field
+  Examples:
+  | param1 | param2 |
+  | class  | index  |
+  | name   | index  |

data/features/form.feature CHANGED Viewed

@@ -17,6 +17,7 @@ Feature: Form
     | class     |
     | xpath     |
     | index     |
+    | action    |
   Scenario Outline: Locating table using multiple parameters
     When I locate the form using "<param1>" and "<param2>"

data/features/html/async.html ADDED Viewed

@@ -0,0 +1,21 @@
+<html>
+  <head>
+    <title>Async Page</title>
+    <script type="text/javascript">
+      function unhide() {
+        document.getElementById("target").style.display="block";
+      }
+      function hide() {
+        document.getElementById("target").style.display="none";
+      }
+    </script>
+  </head>
+  <body>
+    <input type="button" id="target" value="Target"/>
+    <input type="button" onclick="setTimeout(function() {hide();}, 2000);" value="Hide Button"/>
+    <input type="button" onclick="setTimeout(function() {unhide();}, 2000);" value="Unhide Button"/>
+  </body>
+</html>

data/features/html/nested_elements.html CHANGED Viewed

@@ -17,7 +17,9 @@
     <option value="option2">Test 2</option>
     </select>
     <input type="checkbox" value="0"/>
-    <input type="radio" value="Milk">
+    <input type="radio" value="Milk"/>
+    <input type="file"/>
     <div>
         page-object rocks!
     </div>

data/features/html/static_elements.html CHANGED Viewed

@@ -6,7 +6,7 @@
     <p id='p_id' name='p_name' class='p_class'>Static Elements Page</p>
     <input id="text_field_id" name="text_field_name" class="text_field_class"
-           size="40" type="text"/>
+           title="text_field_title" size="40" type="text"/>
     <input id="hidden_field_id" name="hidden_field_name" class="hidden_field_class"
            size="40" type="hidden" value="12345"/>
@@ -52,11 +52,13 @@
         <input value="Disabled" disabled="true" type ="submit"/>
     </form>
-    <img src="images/circle.png" id="image_id" name="image_name" class="image_class">
+    <img src="images/circle.png" id="image_id" name="image_name" class="image_class", alt="image_alt">
     <form id="form_id" class="form_class" name="form_name" action="/">
     </form>
+    <input type="file" name="file_field_name" id="file_field_id" class="file_field_class" title="file_field_title" />
     <ul id="ul_id" name="ul_name" class="ul_class">
         <li id="li_id" name="li_name" class="li_class">Item One</li>
         <li>Item Two</li>

data/features/image.feature CHANGED Viewed

@@ -20,6 +20,8 @@ Feature: Image
     | name      |
     | xpath     |
     | index     |
+    | alt       |
+    | src       |
   Scenario Outline: Locating an image using multiple parameters
     When I get the image element by "<param1>" and "<param2>"

data/features/nested_elements.feature CHANGED Viewed

@@ -26,6 +26,10 @@ Feature: Nested Elements
   Scenario: Finding a select list within a div
     When I search for a select list located in a div
     Then I should be able to select "Test 2" in the nested select list
+  Scenario: Finding a file field within a div
+    When I search for a file field located in a div
+    Then I should be able to set the nested file field
   Scenario: Finding a checkbox within a div
     When I search for a checkbox located in a div

data/features/step_definitions/async_steps.rb CHANGED Viewed

@@ -29,3 +29,34 @@ Then /^I should be able to wait until a block returns true$/ do
     @element.visible?
   end
 end
+class AsyncPage
+  include PageObject
+  button(:target, :value => 'Target')
+  button(:hide, :value => 'Hide Button')
+  button(:unhide, :value => 'Unhide Button')
+end
+Given /^I am on the async elements page$/ do
+  @page = AsyncPage.new(@browser)
+  @page.navigate_to(UrlHelper.async)
+end
+When /^I make the button invisible$/ do
+  @page.hide
+  sleep 2
+end
+Then /^I should be able to click it when it becomses visible$/ do
+  @page.unhide
+  @page.target_element.when_visible do
+    @page.target
+  end
+end
+Then /^I should be able to wait until the button becomes invisible$/ do
+  @page.hide
+  @page.target_element.when_not_visible do
+    @page.target_element.attribute("block").should == "none"
+  end
+end

data/features/step_definitions/file_field_steps.rb ADDED Viewed

@@ -0,0 +1,19 @@
+When /^I set the file field to the step definition file$/ do
+  @page.file_field_id = __FILE__
+end
+Then /^its\' value should equal that file$/ do
+  @page.file_field_id_element.value.should == __FILE__
+end
+When /^I search for the file field by "([^\"]*)"$/ do |how|
+  @how = how
+end
+When /^I search for the file field by "([^\"]*)" and "([^\"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+Then /^I should be able to set the file field$/ do
+  @page.send "file_field_#{@how}=", __FILE__
+end

data/features/step_definitions/nested_elements_steps.rb CHANGED Viewed

@@ -26,6 +26,7 @@ class NestedElementsPage
   h5(:nested_h5) { |page| page.outer_div_element.h5_element }
   h6(:nested_h6) { |page| page.outer_div_element.h6_element }
   paragraph(:nested_paragraph) { |page| page.outer_div_element.paragraph_element }
+  file_field(:nested_file_field) { |page| page.outer_div_element.file_field_element }
 end
 Given /^I am on the nested elements page$/ do
@@ -127,7 +128,7 @@ When /^I search the second table cell located in a table in a div$/ do
   @cell = @page.nested_cell_element
 end
-Then /^the nested table cell should contain "([^"]*)"$/ do |value|
+Then /^the nested table cell should contain "([^\"]*)"$/ do |value|
   @cell.text.should == value
 end
@@ -135,11 +136,11 @@ When /^I search for an image located in a div$/ do
   @image = @page.nested_image_element
 end
-Then /^the nested image should be "([^"]*)" pixels wide$/ do |width|
+Then /^the nested image should be "([^\"]*)" pixels wide$/ do |width|
   @image.width.should == width.to_i
 end
-Then /^the nested image should be "([^"]*)" pixels tall$/ do |height|
+Then /^the nested image should be "([^\"]*)" pixels tall$/ do |height|
   @image.height.should == height.to_i
 end
@@ -155,7 +156,7 @@ When /^I search for an ordered list located in a div$/ do
   @list = @page.nested_ordered_list_element
 end
-Then /^the first nested list items text should be "([^"]*)"$/ do |value|
+Then /^the first nested list items text should be "([^\"]*)"$/ do |value|
   @list[0].text.should == value
 end
@@ -167,7 +168,7 @@ When /^I search for a list item nested in an ordered list in a div$/ do
   @li = @page.nested_list_item_element
 end
-Then /^I should see the nested list items text should be "([^"]*)"$/ do |value|
+Then /^I should see the nested list items text should be "([^\"]*)"$/ do |value|
   @li.text.should == value
 end
@@ -175,7 +176,7 @@ When /^I search for a h(\d+) located in a div$/ do |num|
   @header = @page.send "nested_h#{num}_element"
 end
-Then /^I should see the nested h(\d+)s text should be "([^"]*)"$/ do |num, value|
+Then /^I should see the nested h(\d+)s text should be "([^\"]*)"$/ do |num, value|
   @header.text.should == value
 end
@@ -183,6 +184,14 @@ When /^I search for a paragraph located in a div$/ do
   @para = @page.nested_paragraph_element
 end
-Then /^I should see the nested paragraphs text should be "([^"]*)"$/ do |value|
+Then /^I should see the nested paragraphs text should be "([^\"]*)"$/ do |value|
   @para.text.should == value
 end
+When /^I search for a file field located in a div$/ do
+  @ff = @page.nested_file_field_element
+end
+Then /^I should be able to set the nested file field$/ do
+  @ff.value = __FILE__
+end

data/features/support/page.rb CHANGED Viewed

@@ -14,6 +14,7 @@ class Page
   text_field(:text_field_index, :index => 0)
   text_field(:text_field_text, :text => "")
   text_field(:text_field_value, :value => "")
+  text_field(:text_field_title, :title => 'text_field_title')
   text_field(:text_field_class_index, :class => "text_field_class", :index => 0)
   text_field(:text_field_name_index, :name => "text_field_name", :index => 0)
@@ -145,6 +146,8 @@ class Page
   image(:image_class, :class => 'image_class')
   image(:image_index, :index => 0)
   image(:image_xpath, :xpath => '//img')
+  image(:image_alt, :alt => 'image_alt')
+  image(:image_src, :src => 'images/circle.png')
   image(:image_class_index, :class => "image_class", :index => 0)
   image(:image_name_index, :name => "image_name", :index => 0)
@@ -153,6 +156,7 @@ class Page
   form(:form_class, :class => 'form_class')
   form(:form_index, :index => 0)
   form(:form_xpath, :xpath => '//form')
+  form(:form_action, :action => "success.html")
   form(:form_class_index, :class => "form_class", :index => 0)
   form(:form_name_index, :name => "form_name", :index => 0)
@@ -239,6 +243,15 @@ class Page
   button(:alert_button, :id => 'alert_button')
   button(:confirm_button, :id => 'confirm_button')
   button(:prompt_button, :id => 'prompt_button')
+  file_field(:file_field_id, :id => 'file_field_id')
+  file_field(:file_field_name, :name => 'file_field_name')
+  file_field(:file_field_class, :class => 'file_field_class')
+  file_field(:file_field_index, :index => 0)
+  file_field(:file_field_title, :title => 'file_field_title')
+  file_field(:file_field_class_index, :class => 'file_field_class', :index => 0)
+  file_field(:file_field_name_index, :name => 'file_field_name', :index => 0)
+  file_field(:file_field_xpath, :xpath => "//input[@type='file']")
   link(:open_window, :text => 'New Window')
 end

data/features/support/url_helper.rb CHANGED Viewed

@@ -32,5 +32,9 @@ module UrlHelper
     def modal
       "#{files}/modal.html"
     end
+    def async
+      "#{files}/async.html"
+    end
   end
 end

data/features/text_field.feature CHANGED Viewed

@@ -14,7 +14,7 @@ Feature: Text Fields
     When I search for the text field by "<search_by>"
     Then I should be able to type "I found it" into the field
-  Scenarios:
+  Examples:
     | search_by |
     | id        |
     | class     |
@@ -23,12 +23,13 @@ Feature: Text Fields
     | css       |
     | tag_name  |
     | index     |
+    | title     |
   Scenario Outline: Locating a text field using multiple parameters
     When I search for the text field by "<param1>" and "<param2>"
     Then I should be able to type "I found it" into the field
-  Scenarios:
+  Examples:
     | param1 | param2 |
     | class  | index  |
     | name   | index  |

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

@@ -63,6 +63,7 @@ module PageObject
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :text => Watir only
+    #   * :title => Watir and Selenium
     #   * :value => Watir only
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
@@ -73,7 +74,7 @@ module PageObject
         self.send("#{name}_element").value
       end
       define_method("#{name}=") do |value|
-        return platform.text_field_value_set(identifier.clone, value) unless block_given?
+         return platform.text_field_value_set(identifier.clone, value) unless block_given?
         self.send("#{name}_element").value = value
       end
       define_method("#{name}_element") do
@@ -466,10 +467,12 @@ module PageObject
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find an image.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :alt => Watir and Selenium
     #   * :class => Watir and Selenium
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
     #   * :name => Watir and Selenium
+    #   * :src => Watir and Selenium
     #   * :xpath => Watir and Selenium
     # @param optional block to be invoked when element method is called
     #
@@ -491,6 +494,7 @@ module PageObject
     # @param [String] the name used for the generated methods
     # @param [Hash] identifier how we find a form.  You can use a multiple paramaters
     #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :action => Watir and Selenium
     #   * :class => Watir and Selenium
     #   * :id => Watir and Selenium
     #   * :index => Watir and Selenium
@@ -787,5 +791,35 @@ module PageObject
       end
       alias_method "#{name}_paragraph".to_sym, "#{name}_element".to_sym
     end
+    #
+    # adds a method to set the file for a file field and to retrieve
+    # the file field element
+    #
+    # @example
+    #   file_field(:the_file, :id => 'file_to_upload')
+    #   # will generate a 'the_file=' and 'the_file_element' method
+    #
+    # @param [String] the name used for the generated methods
+    # @param [Hash] identifier how we find a file_field.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :title => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    # @param optional block to be invoked when element method is called
+    #
+    def file_field(name, identifier=nil, &block)
+      define_method("#{name}=") do |value|
+        return platform.file_field_value_set(identifier.clone, value) unless block_given?
+        self.send("#{name}_element").value = value
+      end
+      define_method("#{name}_element") do
+        return call_block(&block) if block_given?
+        platform.file_field_for(identifier.clone)
+      end
+    end
   end
 end

data/lib/page-object/element_locators.rb CHANGED Viewed

@@ -13,6 +13,8 @@ module PageObject
     #   * :text => Watir only
     #   * :value => Watir and Selenium
     #   * :xpath => Watir and Selenium
+    #   * :src => Watir and Selenium (image button only)
+    #   * :alt => Watir and Selenium (image button only)
     #
     def button_element(identifier)
       platform.button_for(identifier.clone)
@@ -30,6 +32,7 @@ module PageObject
     #   * :name => Watir and Selenium
     #   * :tag_name => Watir and Selenium
     #   * :text => Watir only
+    #   * :title => Watir and Selenium
     #   * :value => Watir only
     #   * :xpath => Watir and Selenium
     #
@@ -377,6 +380,21 @@ module PageObject
     #
     def paragraph_element(identifier)
       platform.paragraph_for(identifier.clone)
+    end
+        #
+    # Finds a paragraph
+    #
+    # @param [Hash] identifier how we find a paragraph.  You can use a multiple paramaters
+    #   by combining of any of the following except xpath.  The valid keys are:
+    #   * :class => Watir and Selenium
+    #   * :id => Watir and Selenium
+    #   * :index => Watir and Selenium
+    #   * :name => Watir and Selenium
+    #   * :title => Watir and Selenium
+    #   * :xpath => Watir and Selenium
+    def file_field_element(identifier)
+      platform.file_field_for(identifier.clone)
     end
   end
-end
+end

data/lib/page-object/elements.rb CHANGED Viewed

@@ -20,3 +20,4 @@ require 'page-object/elements/ordered_list'
 require 'page-object/elements/option'
 require 'page-object/elements/heading'
 require 'page-object/elements/paragraph'
+require 'page-object/elements/file_field'

data/lib/page-object/elements/element.rb CHANGED Viewed

@@ -23,6 +23,20 @@ module PageObject
       def click
         @element.click
       end
+      #
+      # double click the element
+      #
+      def double_click
+        @element.double_click
+      end
+      #
+      # return true if the element is enabled
+      #
+      def enabled?
+        @element.enabled?
+      end
       #
       # get the value of the given CSS property
@@ -67,6 +81,12 @@ module PageObject
       # delegate calls to driver element
       def method_missing(*args, &block)
         m = args.shift
+        puts "*** DEPRECATION WARNING"
+        puts "*** You are calling a method named #{m}."
+        puts "*** This method does not exist in page-object so it is being passed to the driver."
+        puts "*** This feature will be removed in the near future."
+        puts "*** Please change your code to call the correct page-object method."
+        puts "*** If you are using functionality that does not exist in page-object please request it be added."
         begin
           element.send m, *args, &block
         rescue Exception => e

data/lib/page-object/elements/file_field.rb ADDED Viewed

@@ -0,0 +1,35 @@
+module PageObject
+  module Elements
+    class FileField < Element
+      def initialize(element, platform)
+        @element = element
+        include_platform_for platform
+      end
+      protected
+      def self.watir_finders
+        super + [:title]
+      end
+      def self.selenium_finders
+        super + [:title]
+      end
+      def include_platform_for platform
+        super
+        if platform[:platform] == :watir_webdriver
+          require 'page-object/platforms/watir_webdriver/file_field'
+          self.class.send :include, PageObject::Platforms::WatirWebDriver::FileField
+        elsif platform[:platform] == :selenium_webdriver
+          require 'page-object/platforms/selenium_webdriver/file_field'
+          self.class.send :include, PageObject::Platforms::SeleniumWebDriver::FileField
+        else
+          raise ArgumentError, "expect platform to be :watir_webdriver or :selenium_webdriver"
+        end
+      end
+    end
+  end
+end

data/lib/page-object/elements/form.rb CHANGED Viewed

@@ -9,6 +9,14 @@ module PageObject
       protected
+      def self.watir_finders
+        super + [:action]
+      end
+      def self.selenium_finders
+        super + [:action]
+      end
       def include_platform_for platform
         super
         if platform[:platform] == :watir_webdriver

data/lib/page-object/elements/image.rb CHANGED Viewed

@@ -8,6 +8,14 @@ module PageObject
       protected
+      def self.watir_finders
+        super + [:alt, :src]
+      end
+      def self.selenium_finders
+        super + [:alt, :src]
+      end
       def include_platform_for platform
         super
         if platform[:platform] == :watir_webdriver

data/lib/page-object/elements/text_field.rb CHANGED Viewed

@@ -11,7 +11,7 @@ module PageObject
       protected
       def self.watir_finders
-        super + [:tag_name]
+        super + [:tag_name, :title]
       end
       def self.watir_mapping
@@ -19,7 +19,7 @@ module PageObject
       end
       def self.selenium_finders
-        super + [:css]
+        super + [:css, :title]
       end
       def self.selenium_mapping

data/lib/page-object/nested_elements.rb CHANGED Viewed

@@ -96,5 +96,9 @@ module PageObject
     def paragraph_element(identifier={:index => 0})
       @platform.paragraph_for(identifier)
     end
+    def file_field_element(identifier={:index => 0})
+      @platform.file_field_for(identifier)
+    end
   end
 end

data/lib/page-object/page_populator.rb CHANGED Viewed

@@ -3,7 +3,7 @@ module PageObject
     #
     # This method will populate all matched page TextFields,
-    # TextAreas, SelectLists, Checkboxes, and Radio Buttons from the
+    # TextAreas, SelectLists, FileFields, Checkboxes, and Radio Buttons from the
     # Hash passed as an argument.  The way it find an element is by
     # matching the Hash key to the name you provided when declaring
     # the element on your page.
@@ -26,7 +26,7 @@ module PageObject
     #
     # @param [Hash] the data to use to populate this page.  The key
     # can be either a string or a symbol.  The value must be a string
-    # for TextField, TextArea, and SelectList and must be true or
+    # for TextField, TextArea, SelectList, and FileField and must be true or
     # false for a Checkbox or RadioButton.
     #
     def populate_page_with(data)

data/lib/page-object/platforms/selenium_webdriver/check_box.rb CHANGED Viewed

@@ -7,14 +7,14 @@ module PageObject
         # check the checkbox
         #
         def check
-          element.click unless selected?
+          element.click unless element.selected?
         end
         #
         # uncheck the checkbox
         #
         def uncheck
-          element.click if selected?
+          element.click if element.selected?
         end
         #

data/lib/page-object/platforms/selenium_webdriver/element.rb CHANGED Viewed

@@ -55,22 +55,27 @@ module PageObject
         end
         #
-        # Get the value of a the given attribute of the element. Will return the current value, even if
-        # this has been modified after the page has been loaded. More exactly, this method will return
-        # the value of the given attribute, unless that attribute is not present, in which case the
-        # value of the property with the same name is returned. If neither value is set, nil is
-        # returned. The "style" attribute is converted as best can be to a text representation with a
-        # trailing semi-colon. The following are deemed to be "boolean" attributes, and will
-        # return either "true" or "false":
-        #
-        # async, autofocus, autoplay, checked, compact, complete, controls, declare, defaultchecked,
-        # defaultselected, defer, disabled, draggable, ended, formnovalidate, hidden, indeterminate,
-        # iscontenteditable, ismap, itemscope, loop, multiple, muted, nohref, noresize, noshade, novalidate,
-        # nowrap, open, paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+        # Get the value of a the given attribute of the element.  Will
+        # return the current value, even if this has been modified
+        # after the page has been loaded. More exactly, this method
+        # will  return the value of the given attribute, unless that
+        # attribute is not present, in which case the value of the
+        # property with the same name is returned. If neither value is
+        # set, nil is returned. The "style" attribute is converted as
+        # best can be to a text representation with a trailing
+        # semi-colon. The following are deemed to be "boolean"
+        # attributes, and will return either "true" or "false":
+        #
+        # async, autofocus, autoplay, checked, compact, complete,
+        # controls, declare, defaultchecked, defaultselected, defer,
+        # disabled, draggable, ended, formnovalidate, hidden, indeterminate,
+        # iscontenteditable, ismap, itemscope, loop, multiple, muted,
+        # nohref, noresize, noshade, novalidate, nowrap, open, paused,
+        # pubdate, readonly, required, reversed, scoped, seamless, seeking,
         # selected, spellcheck, truespeed, willvalidate
         #
-        # Finally, the following commonly mis-capitalized attribute/property names are evaluated as
-        # expected:
+        # Finally, the following commonly mis-capitalized
+        # attribute/property names are evaluated as expected:
         #
         # class, readonly
         #

data/lib/page-object/platforms/selenium_webdriver/file_field.rb ADDED Viewed

@@ -0,0 +1,16 @@
+module PageObject
+  module Platforms
+    module SeleniumWebDriver
+      module FileField
+        #
+        # Set the value of the FileField
+        #
+        def value=(new_value)
+          element.send_keys(new_value)
+        end
+      end
+    end
+  end
+end

data/lib/page-object/platforms/selenium_webdriver/page_object.rb CHANGED Viewed

@@ -739,7 +739,7 @@ module PageObject
           how, what, frame_identifiers = parse_identifiers(identifier, Elements::Paragraph, 'p')
           switch_to_frame(frame_identifiers)
           value = @browser.find_element(how, what).text
-          @browser.switch_to.default_content
+          @browser.switch_to.default_content unless frame_identifiers.nil?
           value
         end
@@ -753,7 +753,30 @@ module PageObject
           element = @browser.find_element(how, what)
           @browser.switch_to.default_content unless frame_identifiers.nil?
           ::PageObject::Elements::Paragraph.new(element, :platform => :selenium_webdriver)
-        end
+        end
+        #
+        # platform method to set the file on a file_field element
+        # See PageObject::Accessors#file_field
+        #
+        def file_field_value_set(identifier, value)
+          how, what, frame_identifiers = parse_identifiers(identifier, Elements::FileField, 'input', :type => 'file')
+          switch_to_frame(frame_identifiers)
+          @browser.find_element(how, what).send_keys(value)
+          @browser.switch_to.default_content unless frame_identifiers.nil?
+        end
+        #
+        # platform method to retrieve a file_field element
+        # See PageObject::Accessors#file_field
+        #
+        def file_field_for(identifier)
+          how, what, frame_identifiers = parse_identifiers(identifier, Elements::FileField, 'input', :type => 'file')
+          switch_to_frame(frame_identifiers)
+          element = @browser.find_element(how, what)
+          @browser.switch_to.default_content unless frame_identifiers.nil?
+          ::PageObject::Elements::FileField.new(element, :platform => :selenium_webdriver)
+        end
         private
@@ -783,7 +806,12 @@ module PageObject
           return false if identifier[:value] and tag == 'input' and additional[:type] == 'submit'
           return false if identifier[:src] and tag == 'input' and additional[:type] == 'submit'
           return false if identifier[:alt] and tag == 'input' and additional[:type] == 'submit'
+          return false if identifier[:title] and tag == 'input' and additional[:type] == 'text'
           return false if identifier[:value] and tag == 'input' and additional[:type] == 'radio'
+          return false if identifier[:title] and tag == 'input' and additional[:type] == 'file'
+          return false if identifier[:action] and tag == 'form'
+          return false if identifier[:alt] and tag == 'img'
+          return false if identifier[:src] and tag == 'img'
           true
         end

data/lib/page-object/platforms/watir_webdriver/element.rb CHANGED Viewed

@@ -55,22 +55,27 @@ module PageObject
         end
         #
-        # Get the value of a the given attribute of the element. Will return the current value, even if
-        # this has been modified after the page has been loaded. More exactly, this method will return
-        # the value of the given attribute, unless that attribute is not present, in which case the
-        # value of the property with the same name is returned. If neither value is set, nil is
-        # returned. The "style" attribute is converted as best can be to a text representation with a
-        # trailing semi-colon. The following are deemed to be "boolean" attributes, and will
-        # return either "true" or "false":
-        #
-        # async, autofocus, autoplay, checked, compact, complete, controls, declare, defaultchecked,
-        # defaultselected, defer, disabled, draggable, ended, formnovalidate, hidden, indeterminate,
-        # iscontenteditable, ismap, itemscope, loop, multiple, muted, nohref, noresize, noshade, novalidate,
-        # nowrap, open, paused, pubdate, readonly, required, reversed, scoped, seamless, seeking,
+        # Get the value of a the given attribute of the element.  Will
+        # return the current value, even if this has been modified
+        # after the page has been loaded. More exactly, this method
+        # will  return the value of the given attribute, unless that
+        # attribute is not present, in which case the value of the
+        # property with the same name is returned. If neither value is
+        # set, nil is returned. The "style" attribute is converted as
+        # best can be to a text representation with a trailing
+        # semi-colon. The following are deemed to be "boolean"
+        # attributes, and will return either "true" or "false":
+        #
+        # async, autofocus, autoplay, checked, compact, complete,
+        # controls, declare, defaultchecked, defaultselected, defer,
+        # disabled, draggable, ended, formnovalidate, hidden, indeterminate,
+        # iscontenteditable, ismap, itemscope, loop, multiple, muted,
+        # nohref, noresize, noshade, novalidate, nowrap, open, paused,
+        # pubdate, readonly, required, reversed, scoped, seamless, seeking,
         # selected, spellcheck, truespeed, willvalidate
         #
-        # Finally, the following commonly mis-capitalized attribute/property names are evaluated as
-        # expected:
+        # Finally, the following commonly mis-capitalized
+        # attribute/property names are evaluated as expected:
         #
         # class, readonly
         #

data/lib/page-object/platforms/watir_webdriver/file_field.rb ADDED Viewed

@@ -0,0 +1,16 @@
+module PageObject
+  module Platforms
+    module WatirWebDriver
+      module FileField
+        #
+        # Set the value of the Fileield
+        #
+        def value=(new_value)
+          element.set(new_value)
+        end
+      end
+    end
+  end
+end

data/lib/page-object/platforms/watir_webdriver/page_object.rb CHANGED Viewed

@@ -704,7 +704,28 @@ module PageObject
           element = @browser.instance_eval "#{nested_frames(frame_identifiers)}p(identifier)"
           switch_to_default_content(frame_identifiers)
           ::PageObject::Elements::Paragraph.new(element, :platform => :watir_webdriver)
-        end
+        end
+        #
+        # platform method to set the file on a file_field element
+        # See PageObject::Accessors#file_field
+        #
+        def file_field_value_set(identifier, value)
+          identifier, frame_identifiers = parse_identifiers(identifier, Elements::FileField)
+          @browser.instance_eval "#{nested_frames(frame_identifiers)}file_field(identifier).set(value)"
+          switch_to_default_content(frame_identifiers)
+        end
+        #
+        # platform method to retrieve a file_field element
+        # See PageObject::Accessors#file_field
+        #
+        def file_field_for(identifier)
+          identifier, frame_identifiers = parse_identifiers(identifier, Elements::FileField)
+          element = @browser.instance_eval "#{nested_frames(frame_identifiers)}file_field(identifier)"
+          switch_to_default_content(frame_identifiers)
+          ::PageObject::Elements::FileField.new(element, :platform => :watir_webdriver)
+        end
         private

data/lib/page-object/version.rb CHANGED Viewed

@@ -1,4 +1,4 @@
 module PageObject
   # @private
-  VERSION = "0.5.3"
+  VERSION = "0.5.4"
 end

data/spec/page-object/accessors_spec.rb CHANGED Viewed

@@ -28,6 +28,7 @@ class AccessorsTestPageObject
   h5(:heading5, :id => 'main_heading')
   h6(:heading6, :id => 'main_heading')
   paragraph(:first_para, :id => 'first')
+  file_field(:upload_me, :id => 'the_file')
 end
 class BlockPageObject
@@ -107,6 +108,9 @@ class BlockPageObject
   paragraph :first_para do |element|
     "p"
   end
+  file_field :a_file do |element|
+    "file_field"
+  end
 end
 describe PageObject::Accessors do
@@ -1176,4 +1180,45 @@ describe PageObject::Accessors do
       end
     end
   end
+  describe "file_field accessors" do
+    context "when called on a page object" do
+      it "should generate accessor methods" do
+        watir_page_object.should respond_to(:upload_me=)
+        watir_page_object.should respond_to(:upload_me_element)
+      end
+      it "should call a block on the element method when present" do
+        block_page_object.a_file_element.should == "file_field"
+      end
+    end
+    context "watir implementation" do
+      it "should set the file name" do
+        watir_browser.should_receive(:file_field).and_return(watir_browser)
+        watir_browser.should_receive(:set).with('some_file')
+        watir_page_object.upload_me = 'some_file'
+      end
+      it "should retrieve a text field element" do
+        watir_browser.should_receive(:file_field).and_return(watir_browser)
+        element = watir_page_object.upload_me_element
+        element.should be_instance_of PageObject::Elements::FileField
+      end
+    end
+    context "selenium implementation" do
+      it "should set the file name" do
+        selenium_browser.should_receive(:find_element).and_return(selenium_browser)
+        selenium_browser.should_receive(:send_keys).with('some_file')
+        selenium_page_object.upload_me = 'some_file'
+      end
+      it "should retrieve a file_field element" do
+        selenium_browser.should_receive(:find_element).and_return(selenium_browser)
+        element = selenium_page_object.upload_me_element
+        element.should be_instance_of PageObject::Elements::FileField
+      end
+    end
+  end
 end

data/spec/page-object/element_locators_spec.rb CHANGED Viewed

@@ -152,4 +152,10 @@ describe PageObject::ElementLocators do
     element = watir_page_object.paragraph_element(:id => 'blah')
     element.should be_instance_of PageObject::Elements::Paragraph
   end
-end
+  it "should find a file field element" do
+    watir_browser.should_receive(:file_field).with(:id => 'blah').and_return(watir_browser)
+    element = watir_page_object.file_field_element(:id => 'blah')
+    element.should be_instance_of PageObject::Elements::FileField
+  end
+end

data/spec/page-object/elements/element_spec.rb CHANGED Viewed

@@ -4,15 +4,6 @@ require 'page-object/elements'
 describe "Element class methods" do
-  context "when handling unknown requests" do
-    it "should delegate to the driver element" do
-      watir_driver = double('watir')
-      watir_element = PageObject::Elements::Element.new(watir_driver, :platform => :watir_webdriver)
-      watir_driver.should_receive(:do_this)
-      watir_element.do_this
-    end
-  end
   context "when building the identifiers for Watir" do
     it "should build xpath when finding elements by name where not supported" do
       ['table', 'span', 'div', 'td', 'li', 'ol', 'ul'].each do |tag|
@@ -85,4 +76,4 @@ describe "Element class methods" do
       end
     end
   end
-end
+end

data/spec/page-object/elements/file_field_spec.rb ADDED Viewed

@@ -0,0 +1,35 @@
+require 'spec_helper'
+require 'page-object/elements'
+describe PageObject::Elements::FileField do
+  describe "when mapping how to find an element" do
+    let(:filefield) { PageObject::Elements::FileField }
+    it "should map watir types to same" do
+      [:class, :id, :index, :name, :xpath, :title].each do |t|
+        identifier = filefield.watir_identifier_for t => 'value'
+        identifier.keys.first.should == t
+      end
+    end
+    it "should map selenium types to same" do
+      [:class, :id, :index, :name, :xpath, :title].each do |t|
+        key, value = filefield.selenium_identifier_for t => 'value'
+        key.should == t
+      end
+    end
+  end
+  describe "interface" do
+    let(:filefield) { double('file_field') }
+    context "for selenium" do
+      it "should set its' value" do
+        selenium_file_field = PageObject::Elements::FileField.new(filefield, :platform => :selenium_webdriver)
+        filefield.should_receive(:send_keys).with('a file')
+        selenium_file_field.value = 'a file'
+      end
+    end
+  end
+end

data/spec/page-object/elements/image_spec.rb CHANGED Viewed

@@ -6,14 +6,14 @@ describe PageObject::Elements::Image do
   describe "when mapping how to find an element" do
     it "should map watir types to same" do
-      [:class, :id, :index, :name, :xpath].each do |t|
+      [:class, :id, :index, :name, :xpath, :alt, :src].each do |t|
         identifier = image.watir_identifier_for t => 'value'
         identifier.keys.first.should == t
       end
     end
     it "should map selenium types to same" do
-      [:class, :id, :index, :name, :xpath].each do |t|
+      [:class, :id, :index, :name, :xpath, :alt, :src].each do |t|
         key, value = image.selenium_identifier_for t => 'value'
         key.should == t
       end
@@ -59,4 +59,4 @@ describe PageObject::Elements::Image do
       end
     end
   end
-end
+end

data/spec/page-object/elements/text_field_spec.rb CHANGED Viewed

@@ -7,7 +7,7 @@ describe PageObject::Elements::TextField do
     let(:textfield) { PageObject::Elements::TextField }
     it "should map watir types to same" do
-      [:class, :id, :index, :name, :tag_name, :xpath].each do |t|
+      [:class, :id, :index, :name, :tag_name, :title, :xpath].each do |t|
         identifier = textfield.watir_identifier_for t => 'value'
         identifier.keys.first.should == t
       end
@@ -19,7 +19,7 @@ describe PageObject::Elements::TextField do
     end
     it "should map selenium types to same" do
-      [:class, :css, :id, :name, :xpath, :index].each do |t|
+      [:class, :css, :id, :name, :title, :xpath, :index].each do |t|
         key, value = textfield.selenium_identifier_for t => 'value'
         key.should == t
       end
@@ -42,4 +42,4 @@ describe PageObject::Elements::TextField do
       end
     end
   end
-end
+end

data/spec/page-object/page_populator_spec.rb CHANGED Viewed

@@ -6,6 +6,7 @@ class PageObjectTestPageObject
   text_field(:tf, :id => 'id')
   text_area(:ta, :id => 'id')
   select_list(:sl, :id => 'id')
+  file_field(:ff, :id => 'id')
   checkbox(:cb, :id => 'id')
   radio_button(:rb, :id => 'id')
 end
@@ -34,6 +35,11 @@ describe PageObject::PagePopulator  do
     page_object.populate_page_with('sa' => 'value')
   end
+  it "should set a value in a file field" do
+    page_object.should_receive(:ff=).with('value')
+    page_object.populate_page_with('ff' => 'value')
+  end
   it "should check a checkbox to true is specified" do
     page_object.should_receive(:check_cb)
     page_object.populate_page_with('cb' => true)

metadata CHANGED Viewed

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: page-object
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
   prerelease:
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2011-12-11 00:00:00.000000000 Z
+date: 2011-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &70269994307840 !ruby/object:Gem::Requirement
+  requirement: &70274033036520 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.4.1
   type: :runtime
   prerelease: false
-  version_requirements: *70269994307840
+  version_requirements: *70274033036520
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
-  requirement: &70269994307020 !ruby/object:Gem::Requirement
+  requirement: &70274033035700 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 2.15.0
   type: :runtime
   prerelease: false
-  version_requirements: *70269994307020
+  version_requirements: *70274033035700
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &70269994305640 !ruby/object:Gem::Requirement
+  requirement: &70274033031880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 2.6.0
   type: :development
   prerelease: false
-  version_requirements: *70269994305640
+  version_requirements: *70274033031880
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &70269994302500 !ruby/object:Gem::Requirement
+  requirement: &70274033031160 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 1.1.0
   type: :development
   prerelease: false
-  version_requirements: *70269994302500
+  version_requirements: *70274033031160
 - !ruby/object:Gem::Dependency
   name: yard
-  requirement: &70269994301820 !ruby/object:Gem::Requirement
+  requirement: &70274033030460 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: 0.7.2
   type: :development
   prerelease: false
-  version_requirements: *70269994301820
+  version_requirements: *70274033030460
 description: Page Object DSL that works with both Watir and Selenium
 email:
 - jeff.morgan@leandog.com
@@ -88,10 +88,12 @@ files:
 - features/check_box.feature
 - features/div.feature
 - features/element.feature
+- features/file_field.feature
 - features/form.feature
 - features/frames.feature
 - features/headings.feature
 - features/hidden_field.feature
+- features/html/async.html
 - features/html/frame_1.html
 - features/html/frame_2.html
 - features/html/frame_3.html
@@ -126,6 +128,7 @@ files:
 - features/step_definitions/check_box_steps.rb
 - features/step_definitions/div_steps.rb
 - features/step_definitions/element_steps.rb
+- features/step_definitions/file_field_steps.rb
 - features/step_definitions/form_steps.rb
 - features/step_definitions/frames_steps.rb
 - features/step_definitions/headings_steps.rb
@@ -164,6 +167,7 @@ files:
 - lib/page-object/elements/check_box.rb
 - lib/page-object/elements/div.rb
 - lib/page-object/elements/element.rb
+- lib/page-object/elements/file_field.rb
 - lib/page-object/elements/form.rb
 - lib/page-object/elements/heading.rb
 - lib/page-object/elements/hidden_field.rb
@@ -191,6 +195,7 @@ files:
 - lib/page-object/platforms/selenium_webdriver/button.rb
 - lib/page-object/platforms/selenium_webdriver/check_box.rb
 - lib/page-object/platforms/selenium_webdriver/element.rb
+- lib/page-object/platforms/selenium_webdriver/file_field.rb
 - lib/page-object/platforms/selenium_webdriver/form.rb
 - lib/page-object/platforms/selenium_webdriver/image.rb
 - lib/page-object/platforms/selenium_webdriver/link.rb
@@ -206,6 +211,7 @@ files:
 - lib/page-object/platforms/watir_webdriver.rb
 - lib/page-object/platforms/watir_webdriver/check_box.rb
 - lib/page-object/platforms/watir_webdriver/element.rb
+- lib/page-object/platforms/watir_webdriver/file_field.rb
 - lib/page-object/platforms/watir_webdriver/form.rb
 - lib/page-object/platforms/watir_webdriver/image.rb
 - lib/page-object/platforms/watir_webdriver/ordered_list.rb
@@ -225,6 +231,7 @@ files:
 - spec/page-object/elements/check_box_spec.rb
 - spec/page-object/elements/div_spec.rb
 - spec/page-object/elements/element_spec.rb
+- spec/page-object/elements/file_field_spec.rb
 - spec/page-object/elements/form_spec.rb
 - spec/page-object/elements/heading_spec.rb
 - spec/page-object/elements/hidden_field_spec.rb
@@ -281,10 +288,12 @@ test_files:
 - features/check_box.feature
 - features/div.feature
 - features/element.feature
+- features/file_field.feature
 - features/form.feature
 - features/frames.feature
 - features/headings.feature
 - features/hidden_field.feature
+- features/html/async.html
 - features/html/frame_1.html
 - features/html/frame_2.html
 - features/html/frame_3.html
@@ -319,6 +328,7 @@ test_files:
 - features/step_definitions/check_box_steps.rb
 - features/step_definitions/div_steps.rb
 - features/step_definitions/element_steps.rb
+- features/step_definitions/file_field_steps.rb
 - features/step_definitions/form_steps.rb
 - features/step_definitions/frames_steps.rb
 - features/step_definitions/headings_steps.rb
@@ -354,6 +364,7 @@ test_files:
 - spec/page-object/elements/check_box_spec.rb
 - spec/page-object/elements/div_spec.rb
 - spec/page-object/elements/element_spec.rb
+- spec/page-object/elements/file_field_spec.rb
 - spec/page-object/elements/form_spec.rb
 - spec/page-object/elements/heading_spec.rb
 - spec/page-object/elements/hidden_field_spec.rb