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

page-object 0.5.3 → 0.5.4

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