page-object 0.0.5 → 0.1

data/ChangeLog

@@ -1,3 +1,48 @@
+=== Version 0.1 / 2011-07-01
+* Enhancements
+  * Support for using multiple identifiers when locating the following element:
+    * Link
+    * TextField
+    * HiddenField
+    * TextArea
+    * SelectList
+    * CheckBox
+    * RadioButton
+    * Button
+    * Div
+    * Span
+    * Table
+    * TableCell
+    * Image
+    * Form
+    * ListItem
+    * UnorderedList
+    * OrderedList
+  * Selenium support for using index for the following elements:
+    * Link
+    * TextField
+    * HiddenField
+    * TextArea
+    * SelectList
+    * CheckBox
+    * RadioButton
+    * Button
+    * Div
+    * Span
+    * Table
+    * Image
+    * Form
+    * ListItem
+    * UnorderedList
+    * OrderedList
+  * Support name for identification across all elements in Watir
+  * Added [] method to SelectList to index Options
+  * Added options method to Select List
+  * Added support for the following elements
+    * Option
+  * Updated to use selenium-webdriver 0.2.2
+  * Updated to use watir-webdriver 0.2.5
+
 === Version 0.0.5 / 2011-06-15
 * Enhancements
   * Added rows method to Table to return number or rows
@@ -57,4 +102,4 @@
   * Support for the following page level functions
     * text
     * html
-    * title
+    * title

data/README.md

@@ -68,6 +68,8 @@ The rdocs for this project can be found at [rubydoc.info](http://rubydoc.info/gi
 
 If you wish to view the current tracker board you can view it on [Pivotal Tracker](https://www.pivotaltracker.com/projects/289099)
 
+To see the changes from release to release please look at the [ChangeLog](https://raw.github.com/cheezy/page-object/master/ChangeLog)
+
 To read about the motivation for this gem please read this [blog entry](http://www.cheezyworld.com/2010/11/19/ui-tests-introducing-a-simple-dsl/)
 
 ## Known Issues

data/cucumber.yml

@@ -1,7 +1,7 @@
 default: DRIVER=WATIR --no-source --color --format pretty --tags ~@selenium_only
 watir: DRIVER=WATIR --no-source --color --format pretty --tags ~@selenium_only
 selenium: DRIVER=SELENIUM --no-source --color --format pretty --tags ~@watir_only
-watir_focus: DRIVER=WATIR --no-source --color --format pretty --tags @focus
-selenium_focus: DRIVER=SELENIUM --no-source --color --format pretty --tags @focus
+watir_focus: DRIVER=WATIR --no-source --color --format pretty --tags @focus --tags ~@selenium_only
+selenium_focus: DRIVER=SELENIUM --no-source --color --format pretty --tags @focus --tags ~@watir_only
 autotest: DRIVER=WATIR --no-source --color --format pretty --tags ~@selenium_only
 

data/features/button.feature

@@ -25,13 +25,22 @@ Feature: Button
     | class     |
     | name      |
     | xpath     |  
+    | index     |
 
   @watir_only
-  Scenario Outline: Locating check boxes on Watir only
+  Scenario Outline: Locating buttons on Watir only
     When I search for the button by "<search_by>"
     Then I should be able to click the button
 
   Scenarios:
     | search_by |
-    | index     |
     | text      |
+
+  Scenario Outline: Locating button using multiple parameters
+    When I search for the button by "<param1>" and "<param2>"
+    Then I should be able to click the button
+
+  Scenarios:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/check_box.feature

@@ -22,15 +22,17 @@ Feature: Check Box
     | class     |
     | name      |
     | xpath     |  
+    | index     |
 
-  @watir_only
-  Scenario Outline: Locating check boxes on Watir only
-    When I search for the check box by "<search_by>"
+  Scenario Outline: Locating check boxes using multiple parameters
+    When I search for the check box by "<param1>" and "<param2>"
     Then I should be able to check the check box
 
   Scenarios:
-    | search_by |
-    | index     |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
+
    
   Scenario: Retrieve a CheckBox
     When I retrieve a check box element

data/features/div.feature

@@ -24,22 +24,14 @@ Feature: Div
     | id        |
     | class     |
     | xpath     |  
-
-  @watir_only
-  Scenario Outline: Locating divs on Watir only
-    When I search for the div by "<search_by>"
-    Then the text should be "page-object rocks!"
-
-  Scenarios:
-    | search_by |
     | index     |
-    
-    
-  @selenium_only
-  Scenario Outline: Locating divs on Selenium only
-    When I search for the div by "<search_by>"
+    | name      |
+
+  Scenario Outline: Locating divs using multiple parameters
+    When I search for the div by "<param1>" and "<param2>"
     Then the text should be "page-object rocks!"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/{element.feature → element_attributes.feature}

@@ -1,4 +1,4 @@
-Feature: Elements
+Feature: Attributes on Elements
 
   Background:
     Given I am on the static elements page

data/features/form.feature

@@ -16,13 +16,14 @@ Feature: Form
     | id        |
     | class     |
     | xpath     |  
+    | index     |
 
-  @watir_only
-  Scenario Outline: Locating a form on the page watir only
-    When I locate the form by "<search_by>"
+  Scenario Outline: Locating table using multiple parameters
+    When I locate the form using "<param1>" and "<param2>"
     Then I should be able to submit the form
-  
+
   Scenarios:
-    | search_by |
-    | index     |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
 

data/features/hidden_field.feature

@@ -19,6 +19,7 @@ Feature: Hidden Fields
     | xpath     |  
     | css       |
     | tag_name  |
+    | index     |
 
   @watir_only
   Scenario Outline: Locating hidden fields on Watir only
@@ -27,6 +28,13 @@ Feature: Hidden Fields
 
   Scenarios:
     | search_by |
-    | index     |
     | text      |
 
+  Scenario Outline: Locating a hidden field using multiple parameters
+    When I search for the hidden field by "<param1>" and "<param2>"
+    Then hidden field element should contains "12345"
+
+  Scenarios:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/html/static_elements.html

@@ -79,7 +79,12 @@
       <li>Number Two</li>
       <li>Number Three</li>
     </ol>
-      
+
+    <h3>Links for multi select</h3>
+    <a href="success.html">Hello</a>
+    <a href="success.html">Hello</a>
+    <a href="success.html">Hello</a>
+    
   </body>
 </html>
 

data/features/image.feature

@@ -19,14 +19,14 @@ Feature: Image
       | class     |
       | name      |
       | xpath     |  
-
-    @watir_only
-    Scenario Outline: Locating an image on the page with Watir
-      When I get the image element by "<search_by>"
-      Then the image should be "106" pixels wide
-      And the image should be "106" pixels tall
-
-    Scenarios:
-      | search_by |
       | index     |
 
+  Scenario Outline: Locating an image using multiple parameters
+    When I get the image element by "<param1>" and "<param2>"
+    Then the image should be "106" pixels wide
+    And the image should be "106" pixels tall
+
+  Scenarios:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/link.feature

@@ -22,6 +22,7 @@ Feature: Links
     | link      |
     | link_text |
     | text      |
+    | index     |
 
   @watir_only
   Scenario Outline: Locating links on Watir only
@@ -31,8 +32,14 @@ Feature: Links
   Scenarios:
     | search_by |
     | href      |
-    | index     |
     
+  Scenario: Support for multiple parameters
+    When I select a link labeled "Hello" and index "0"
+    Then the page should contain the text "Success"
+    Given I am on the static elements page
+    When I select a link labeled "Hello" and index "1"
+    Then the page should contain the text "Success"
+
   Scenario: Retrieve a Link
     When I retrieve a link element
     Then I should know it exists

data/features/list_item.feature

@@ -16,21 +16,14 @@ Feature: List item
     | id        |
     | class     |
     | xpath     |  
-
-  @watir_only
-  Scenario Outline: Locating list items on Watir only
-    When I search for the list item by "<search_by>"
-    Then the text should be "Item One"
-
-  Scenarios:
-    | search_by |
     | index     |
+    | name      |
 
-  @selenium_only
-  Scenario Outline: Locating list items on Watir only
-    When I search for the list item by "<search_by>"
+  Scenario Outline: Locating list items using multiple parameters
+    When I search for the list item by "<param1>" and "<param2>"
     Then the text should be "Item One"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/ordered_list.feature

@@ -5,12 +5,12 @@ Feature: Ordered list
   
   Scenario: Getting the first element from the ordered list
     When I get the first item from the ordered list
-    Then the list item's text should be "Number One"
+    Then the list items text should be "Number One"
 
   Scenario Outline: Locating ordered lists on the page
     When I search for the ordered list by "<search_by>"
     And I get the first item from the list
-    Then the list item's text should be "Number One"
+    Then the list items text should be "Number One"
     And the list should contain 3 items
     And each item should contain "Number"
   
@@ -19,23 +19,15 @@ Feature: Ordered list
     | id        |
     | class     |
     | xpath     |  
-
-  @watir_only
-  Scenario Outline: Locating ordered lists in Watir only
-    When I search for the ordered list by "<search_by>"
-    And I get the first item from the list
-    Then the list item's text should be "Number One"
-
-  Scenarios:
-    | search_by |
     | index     |
+    | name      |
 
-  @selenium_only
-  Scenario Outline: Locating ordered lists in Selenium only
-    When I search for the ordered list by "<search_by>"
+  Scenario Outline: Locating ordered lists using multiple parameters
+    When I search for the ordered list by "<param1>" and "<param2>"
     And I get the first item from the list
-    Then the list item's text should be "Number One"
+    Then the list items text should be "Number One"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/radio_button.feature

@@ -23,16 +23,17 @@ Feature: Radio Buttons
       | class     |
       | name      |
       | xpath     |  
+      | index     |
 
-  @watir_only
-  Scenario Outline: Locating radio buttons on Watir only
-    When I search for the radio button by "<search_by>"
+  Scenario Outline: Locating radio buttons using multiple parameters
+    When I search for the radio button by "<param1>" and "<param2>"
     And I select the radio button
     Then the "Milk" radio button should be selected
 
-    Scenarios:
-      | search_by |
-      | index     |
+  Scenarios:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
 
   Scenario: Retrieve a radio button
     When I retrieve a radio button

data/features/select_list.feature

@@ -21,18 +21,20 @@ Feature: Select List
       | class     |
       | name      |
       | xpath     |  
+      | index     |
 
-  @watir_only
-  Scenario Outline: Locating select lists on Watir only
-    When I search for the select list by "<search_by>"
+  Scenario Outline: Locating a hidden field using multiple parameters
+    When I search for the select list by "<param1>" and "<param2>"
     Then I should be able to select "Test 2"
     And the value for the selected item should be "option2"
 
-    Scenarios:
-      | search_by |
-      | index     |
+  Scenarios:
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |
 
-  Scenario: Retrieve a select list
-    When I retrieve a select list
-    Then I should know it exists
-    And I should know it is visible
+  Scenario: Iterating through the options in the select list
+    When I search for the select list by "id"
+    Then option "1" should contain "Test 1"
+    And option "2" should contain "Test 2"
+    And each option should contain "Test"

data/features/span.feature

@@ -16,22 +16,14 @@ Feature: Span
     | id        |
     | class     |
     | xpath     |  
-
-  @watir_only
-  Scenario Outline: Locating span on Watir only
-    When I search for the span by "<search_by>"
-    Then the text should be "My alert"
-
-  Scenarios:
-    | search_by |
     | index     |
-    
-    
-  @selenium_only
-  Scenario Outline: Locating span on Selenium only
-    When I search for the span by "<search_by>"
+    | name      |
+
+  Scenario Outline: Locating span using multiple parameters
+    When I search for the span by "<param1>" and "<param2>"
     Then the text should be "My alert"
 
   Scenarios:
-    | search_by |
-    | name      |
+    | param1  | param2  |
+    | class   | index   |
+    | name    | index   |

data/features/step_definitions/accessor_steps.rb

@@ -10,23 +10,31 @@ When /^I search for the text field by "([^\"]*)"$/ do |how|
   @how = how
 end
 
+When /^I search for the text field by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
 Then /^I should be able to type "([^\"]*)" into the field$/ do |value|
   @page.send "text_field_#{@how}=".to_sym, value
 end
 
-When /^I type "([^"]*)" into the text area$/ do |text|
+When /^I type "([^\"]*)" into the text area$/ do |text|
   @page.text_area_id = text
 end
 
-Then /^the text area should contain "([^"]*)"$/ do |expected_text|
+Then /^the text area should contain "([^\"]*)"$/ do |expected_text|
   @page.text_area_id.should == expected_text
 end
 
-When /^I search for the text area by "([^"]*)"$/ do |how|
+When /^I search for the text area by "([^\"]*)"$/ do |how|
   @how = how
 end
 
-Then /^I should be able to type "([^"]*)" into the area$/ do |value|
+When /^I search for the text area by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
+Then /^I should be able to type "([^\"]*)" into the area$/ do |value|
   @page.send "text_area_#{@how}=".to_sym, value
 end
 
@@ -54,6 +62,10 @@ When /^I search for the select list by "([^\"]*)"$/ do |how|
   @how = how
 end
 
+When /^I search for the select list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
 Then /^I should be able to select "([^\"]*)"$/ do |value|
   @page.send "sel_list_#{@how}=".to_sym, value
 end
@@ -83,6 +95,10 @@ When /^I search for the check box by "([^\"]*)"$/ do |how|
   @how = how
 end
 
+When /^I search for the check box by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
 Then /^I should be able to check the check box$/ do
   @page.send "check_cb_#{@how}".to_sym
 end
@@ -99,6 +115,10 @@ When /^I search for the radio button by "([^\"]*)"$/ do |how|
   @how = how
 end
 
+When /^I search for the radio button by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
 When /^I select the radio button$/ do 
   @page.send "select_milk_#{@how}".to_sym
 end
@@ -107,22 +127,29 @@ When /^I get the text from the div$/ do
   @text = @page.div_id
 end
 
-Then /^the text should be "([^"]*)"$/ do |expected_text|
+Then /^the text should be "([^\"]*)"$/ do |expected_text|
   @text.should == expected_text
 end
 
-When /^I search for the div by "([^"]*)"$/ do |how|
+When /^I search for the div by "([^\"]*)"$/ do |how|
   @text = @page.send "div_#{how}".to_sym
 end
 
+When /^I search for the div by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "div_#{param1}_#{param2}".to_sym
+end
+
 When /^I get the text from the span$/ do
   @text = @page.span_id
 end
 
-When /^I search for the span by "([^"]*)"$/ do |how|
+When /^I search for the span by "([^\"]*)"$/ do |how|
   @text = @page.send "span_#{how}".to_sym
 end
 
+When /^I search for the span by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "span_#{param1}_#{param2}".to_sym
+end
 
 When /^I click the button$/ do
   @page.button_id
@@ -133,82 +160,115 @@ Then /^I should be on the success page$/ do
   @page.title.should == 'Success'
 end
 
-When /^I search for the button by "([^"]*)"$/ do |how|
+When /^I search for the button by "([^\"]*)"$/ do |how|
   @how = how
 end
 
+When /^I search for the button by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @how = "#{param1}_#{param2}"
+end
+
 Then /^I should be able to click the button$/ do
   @page.send "button_#{@how}"
 end
 
-When /^I search for the table cell by "([^"]*)"$/ do |how|
+When /^I search for the table cell by "([^\"]*)"$/ do |how|
   @cell_data = @page.send "cell_#{how}"
 end
 
-When /^I retrieve a table element by "([^"]*)"$/ do |how|
+When /^I retrieve a table cell element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @cell_data = @page.send "cell_#{param1}_#{param2}"
+end
+
+When /^I retrieve a table element by "([^\"]*)"$/ do |how|
   @element = @page.send "table_#{how}_table"
 end
 
+When /^I retrieve a table element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "table_#{param1}_#{param2}_table"
+end
+
 When /^I get the image element$/ do
   @element = @page.image_id_image
 end
 
-Then /^the image should be "([^"]*)" pixels wide$/ do |width|
+Then /^the image should be "([^\"]*)" pixels wide$/ do |width|
   @element.width.should == width.to_i
 end
 
-Then /^the image should be "([^"]*)" pixels tall$/ do |height|
+Then /^the image should be "([^\"]*)" pixels tall$/ do |height|
   @element.height.should == height.to_i
 end
 
-When /^I get the image element by "([^"]*)"$/ do |how|
+When /^I get the image element by "([^\"]*)"$/ do |how|
   @element = @page.send "image_#{how}_image"
 end
 
+When /^I get the image element by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "image_#{param1}_#{param2}_image"
+end
+
 When /^I retrieve the hidden field element$/ do
   @element = @page.hidden_field_id_hidden_field
 end
 
-Then /^I should see the hidden field contains "([^"]*)"$/ do |text|
+Then /^I should see the hidden field contains "([^\"]*)"$/ do |text|
   @page.hidden_field_id.should == text
 end
 
-When /^I search for the hidden field by "([^"]*)"$/ do |how|
+When /^I search for the hidden field by "([^\"]*)"$/ do |how|
     @element = @page.send "hidden_field_#{how}_hidden_field"
 end
 
-Then /^hidden field element should contains "([^"]*)"$/ do |text|
+Then /^hidden field element should contains "([^\"]*)"$/ do |text|
   @element.value.should == text
 end
 
+When /^I search for the hidden field by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "hidden_field_#{param1}_#{param2}_hidden_field"
+end
+
 Then /^I should be able to submit the form$/ do
   @element.submit
 end
 
-When /^I locate the form by "([^"]*)"$/ do |how|
+When /^I locate the form by "([^\"]*)"$/ do |how|
   @element = @page.send "form_#{how}_form"
 end
 
+When /^I locate the form using "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @element = @page.send "form_#{param1}_#{param2}_form"
+end
+
 When /^I get the text from the list item$/ do
   @text = @page.li_id
 end
 
-When /^I search for the list item by "([^"]*)"$/ do |how|
+When /^I search for the list item by "([^\"]*)"$/ do |how|
   @text = @page.send "li_#{how}"
 end
 
+When /^I search for the list item by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @text = @page.send "li_#{param1}_#{param2}"
+end
+
 When /^I get the first item from the unordered list$/ do
   @element = @page.ul_id_unordered_list[0]
 end
 
-Then /^the list item's text should be "([^"]*)"$/ do |expected_text|
+Then /^the list items text should be "([^\"]*)"$/ do |expected_text|
   @element.text.should == expected_text
 end
 
-When /^I search for the unordered list by "([^"]*)"$/ do |how|
+When /^I search for the unordered list by "([^\"]*)"$/ do |how|
   @list = @page.send "ul_#{how}_unordered_list"
 end
 
+When /^I search for the unordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @list = @page.send "ul_#{param1}_#{param2}_unordered_list"
+end
+
+
 When /^I get the first item from the list$/ do
   @element = @list[0]
 end
@@ -217,25 +277,29 @@ When /^I get the first item from the ordered list$/ do
   @element = @page.ol_id_ordered_list[0]
 end
 
-When /^I search for the ordered list by "([^"]*)"$/ do |how|
+When /^I search for the ordered list by "([^\"]*)"$/ do |how|
   @list = @page.send "ol_#{how}_ordered_list"
 end
 
-Then /^the table should have "([^"]*)" rows$/ do |rows|
+When /^I search for the ordered list by "([^"]*)" and "([^"]*)"$/ do |param1, param2|
+  @list = @page.send "ol_#{param1}_#{param2}_ordered_list"
+end
+
+Then /^the table should have "([^\"]*)" rows$/ do |rows|
   @element.rows.should == rows.to_i
 end
 
-Then /^each row should contain "([^"]*)"$/ do |text|
+Then /^each row should contain "([^\"]*)"$/ do |text|
   @element.each do |row|
     row.text.should include text
   end
 end
 
-Then /^row "([^"]*)" should have "([^"]*)" columns$/ do |row, cols|
+Then /^row "([^\"]*)" should have "([^\"]*)" columns$/ do |row, cols|
   @element[row.to_i - 1].columns.should == cols.to_i
 end
 
-Then /^each column should contain "([^"]*)"$/ do |text|
+Then /^each column should contain "([^\"]*)"$/ do |text|
   row = @element[0]
   row.each do |column|
     column.text.should include text
@@ -246,6 +310,17 @@ Then /^the list should contain (\d+) items$/ do |items|
   @list.items.should == items.to_i
 end
 
-Then /^each item should contain "([^"]*)"$/ do |text|
+Then /^each item should contain "([^\"]*)"$/ do |text|
   @list.each { |item| item.text.should include text }
 end
+
+Then /^option "([^\"]*)" should contain "([^\"]*)"$/ do |opt_num, text|
+  @element = @page.send "sel_list_#{@how}_select_list".to_sym
+  @element[opt_num.to_i - 1].text.should == text
+end
+
+Then /^each option should contain "([^\"]*)"$/ do |text|
+  @element.options.each do |option|
+    option.text.should include text
+  end
+end