symbiont 0.1.4 → 0.1.5

data/HISTORY.md

@@ -1,6 +1,12 @@
 Change Log and History
 ======================
 
+Version 0.1.5 / 2012-09-12
+--------------------------
+
+This release offers just a few enhancements to using select lists and tables, particularly in terms of iterating through both and getting information.
+
+
 Version 0.1.4 / 2012-08-06
 --------------------------
 

data/app/app.rb

@@ -42,6 +42,21 @@ module Symbiont
       erb :test_events
     end
     
+    get '/test_login' do
+      @title = "Simple Login Demonstration"
+      erb :test_login
+    end
+    
+    get '/test_login_error' do
+      @title = "Test Login - Error Page"
+      erb :test_login_error
+    end
+    
+    post '/test_login_success' do
+      @title = "Test Login - Success Page"
+      erb :test_login_success
+    end
+    
     get '/test_database' do
       @title = "Sample Database Application"
       erb :test_database
@@ -164,4 +179,4 @@ module Symbiont
   end # class: TestApp
 end # module: Symbiont
 
-Symbiont::TestApp.run!
+Symbiont::TestApp.run!

data/app/views/index.erb

@@ -4,4 +4,5 @@
 <li><a id="test_page" href="test_page">Simple Object Page</a></li>
 <li><a id="test_events" href="test_events">Simple Events Page</a></li>
 <li><a id="test_database" href="test_database">Simple Database Application</a></li>
+<li><a id="test_login" href="test_login">Simple Login Demonstration</a></li>
 </ul>

data/app/views/test_database.erb

@@ -1,4 +1,4 @@
-<h1>Sample Database Application</h1>
+<h1>Simple Database Application</h1>
 
 <iframe style="float: left;" id="loginSection" name="loginSection" src="login_page" width="500" height="300">
 </iframe>

data/app/views/test_login.erb

@@ -0,0 +1,53 @@
+<style>
+body {
+    font-family: sans-serif;
+    color: black;
+    background: #DDDDDD;
+    text-align: center;
+}
+#login {
+    width: 30em;
+    height: 15em;
+    margin: 1em auto;
+    background: white;
+    border: 1px solid gray;
+    padding: 10px 30px;
+    text-align: left;
+}
+</style>
+
+<h1>Simple Login Demonstration</h1>
+
+<div id='login'>
+<h2>Login Page</h2>
+<p>Enter your user name and password and click the login button.</p>
+<form name='login_form' action="/test_login_success" method="post" onsubmit="return login()">
+    <table>
+        <tr>
+            <td>User Name:</td>
+            <td><input id="username" name="username_field" size="30" type="text" /></td>
+        </tr>
+        <tr>
+            <td>Password:</td>
+            <td><input id="password" name="password_field" size="30" type="password" /></td>
+        </tr>
+        <tr>
+            <td>&nbsp;</td>
+            <td><input name="login_button" type="submit" value="LOGIN" /></td>
+        </tr>
+    </table>
+</form>
+</div>
+
+<script type="text/javascript">
+    function login() { 
+        if (document.login_form.username_field.value == 'demo' &&
+            document.login_form.password_field.value == 'testing') {
+            return true
+        }
+        else {
+            window.location="test_login_error"
+            return false
+        }
+    }
+</script>

data/app/views/test_login_error.erb

@@ -0,0 +1,22 @@
+<style>
+body {
+    font-family: sans-serif;
+    color: black;
+    background: #DDDDDD;
+    text-align: center;
+}
+#login {
+    width: 30em;
+    height: 15em;
+    margin: 1em auto;
+    background: white;
+    border: 1px solid gray;
+    padding: 10px 30px;
+    text-align: left;
+}
+</style>
+
+<div id='login'>
+<h1>Error Page</h1>
+<p>Login failed. Invalid user name and/or password.</p>
+</div>

data/app/views/test_login_success.erb

@@ -0,0 +1,22 @@
+<style>
+body {
+    font-family: sans-serif;
+    color: black;
+    background: #DDDDDD;
+    text-align: center;
+}
+#login {
+    width: 30em;
+    height: 15em;
+    margin: 1em auto;
+    background: white;
+    border: 1px solid gray;
+    padding: 10px 30px;
+    text-align: left;
+}
+</style>
+
+<div id='login'>
+<h1>Welcome Page</h1>
+<p>Login succeeded. Now you can <a href="test_login">logout</a>.</p>
+</div>

data/cucumber.yml

@@ -1,4 +1,6 @@
 <% browser = "BROWSER=firefox" %>
 <% std_opts = "--tags ~@wip --color --format pretty --no-source" %>
+<% rpt_opts = "--format html --out output/specs-report.html" %>
 
 default: <%= browser %> <%= std_opts %> -r specs specs
+report: <%= browser %> <%= std_opts %> <%= rpt_opts %> -r specs specs

data/lib/symbiont/version.rb

@@ -1,3 +1,3 @@
 module Symbiont
-  VERSION = "0.1.4"
+  VERSION = "0.1.5"
 end

data/lib/symbiont/web_objects/_common.rb

@@ -35,6 +35,10 @@ module Symbiont
         @web_object.click
       end
       
+      def clear
+        @web_object.clear
+      end
+      
       def attribute(name)
         @web_object.attribute_value(name)
       end

data/lib/symbiont/web_objects/option.rb

@@ -0,0 +1,10 @@
+module Symbiont
+  module WebObjects
+    class Option < WebObject
+      
+    end # class: Option
+    
+    ::Symbiont::WebObjects.class_for_tag[:option] = ::Symbiont::WebObjects::Option
+    
+  end # module: WebObjects
+end # module: Symbiont

data/lib/symbiont/web_objects/select_list.rb

@@ -2,7 +2,69 @@ module Symbiont
   module WebObjects
     
     class SelectList < WebObject
+      # This method is used to return an Option object based on the index provided.
+      # @return [Symbiont::WebObjects::Option]
+      def [](idx)
+        Object::Symbiont::WebObjects::Option.new(options[idx])
+      end
       
+      # This method returns an array of Option objects that are contained within
+      # a select list object.
+      # @return [array of Symbiont::WebObjects::Option]
+      def options
+        web_objects = []
+        options = @web_object.wd.find_elements(:xpath, option_xpath)
+        options.each do |opt|
+          web_objects << Object::Symbiont::WebObjects::Option.new(opt)
+        end
+        web_objects
+      end
+      
+      # Selects an option from the select list.
+      def select(value)
+        @web_object.select(value)
+      end
+      
+      # Selects the option whose value attribute matches the provided string.
+      def select_value(value)
+        @web_object.select_value(value)
+      end
+      
+      # This method returns an array of strings that contain the text of the
+      # currently selected options in a select list.
+      # @return [Array<String>]
+      def selected_options
+        @web_object.selected_options.map { |e| e.text }.compact
+      end
+      
+      # This method returns an array of strings that contain the values of the
+      # currently selected options in a select list.
+      # @return [Array<String>]
+      def selected_values
+        @web_object.selected_options.map { |e| e.value }.compact
+      end
+      
+      # This method returns true if any of the text or the lable of any option
+      # that is selected matches the provided value.
+      # @param [String, Regexp] value A value to check for
+      # @return [Boolean]
+      def selected?(value)
+        @web_object.selected? value
+      end
+      
+      # This method checks to see if the select list has one or more options
+      # where the text or the label matches the provided value.
+      # @param [String, Regexp] value A value to check for.
+      # @return [Boolean]
+      def include?(value)
+        @web_object.include? value
+      end
+      
+      protected
+      
+      def option_xpath
+        ".//child::option"
+      end
     end # class: SelectList
     
     ::Symbiont::WebObjects.class_for_tag[:select] = ::Symbiont::WebObjects::SelectList

data/lib/symbiont/web_objects/table.rb

@@ -10,6 +10,7 @@ module Symbiont
       # @return [Symbiont::WebObjects::TableRow]
       def [](index)
         index = find_by_title(index) if index.kind_of?(String)
+        return nil unless index
         Object::Symbiont::WebObjects::TableRow.new(@web_object[index])
       end
       

data/lib/symbiont/web_objects/table_row.rb

@@ -10,6 +10,7 @@ module Symbiont
       # @return [Symbiont::WebObjects::TableCell]
       def [](index)
         index = find_by_title(index) if index.kind_of?(String)
+        return nil unless index
         Object::Symbiont::WebObjects::TableCell.new(@web_object[index])
       end
       
@@ -37,8 +38,9 @@ module Symbiont
       
       def find_by_title(column_text)
         table = @web_object.parent
+        table = table.parent if table.tag_name == 'tbody'
         first_row = table[0]
-        first_row.cells.find_index {|column| column.text == column_text}
+        first_row.cells.find_index {|column| column.text.include? column_text}
       end
       
     end # class: TableRow

data/spec/symbiont/web_object_spec.rb

@@ -67,6 +67,11 @@ describe "Web Objects" do
     watir_definition.click
   end
   
+  it "should allow a clear event on a web object" do
+    watir_browser.should_receive(:clear)
+    watir_definition.clear
+  end
+  
   it "should wait for a web object to be actionable" do
     watir_browser.should_receive(:wait_until_present).twice.with(5)
     watir_definition.when_actionable(5)

data/spec/symbiont/web_objects/option_spec.rb

@@ -0,0 +1,9 @@
+require 'spec_helper'
+
+describe Symbiont::WebObjects::Option do
+  describe "implementation" do
+    it "should register with an option tag" do
+      ::Symbiont::WebObjects.get_class_for(:option).should == ::Symbiont::WebObjects::Option
+    end
+  end
+end

data/spec/symbiont/web_objects/select_list_spec.rb

@@ -4,6 +4,15 @@ describe Symbiont::WebObjects::SelectList do
   describe "implementation" do
     let(:select_list_object) { double('select_list_object') }
     let(:select_list) { Symbiont::WebObjects::SelectList }
+    let(:select_list_actual) { Symbiont::WebObjects::SelectList.new(select_list_object) }
+    let(:list_opts) { [select_list_object, select_list_object] }
+    
+    before(:each) do
+      select_list_object.stub(:find_elements).and_return(select_list_object)
+      select_list_object.stub(:wd).and_return(select_list_object)
+      select_list_object.stub(:include?)
+    end
+    
     it "should reference standard usable selectors" do
       [:class, :id, :name, :index, :xpath].each do |s|
         locator = select_list.provide_locator_for s => 'value'
@@ -14,5 +23,47 @@ describe Symbiont::WebObjects::SelectList do
     it "should register with a select list tag" do
       ::Symbiont::WebObjects.get_class_for(:select).should == ::Symbiont::WebObjects::SelectList
     end
+    
+    it "should return an option when indexed" do
+      select_list_object.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(list_opts)
+      select_list_actual[0].should be_instance_of Symbiont::WebObjects::Option
+    end
+    
+    it "should return an array of options" do
+      select_list_object.should_receive(:find_elements).with(:xpath, ".//child::option").and_return(list_opts)
+      select_list_actual.options.size.should == 2
+    end
+    
+    it "should return an array of selected options" do
+      select_list_object.stub(:selected_options).and_return(list_opts)
+      select_list_object.stub(:text).and_return(select_list_object)
+      select_list_actual.selected_options.should == list_opts
+    end
+    
+    it "should determine if an option is selected" do
+      select_list_object.stub(:selected?).with('testing').and_return(true)
+      select_list_actual.selected?('testing')
+    end
+    
+    it "should determine if an option is available" do
+      select_list_object.stub(:include?).with('testing').and_return(true)
+      select_list_actual.include?('testing')
+    end
+    
+    it "should get the values for any selected options" do
+      select_list_object.stub(:selected_options).and_return(list_opts)
+      select_list_object.stub(:value).and_return(select_list_object)
+      select_list_actual.selected_values.should == list_opts
+    end
+    
+    it "should be able to select an item by value" do
+      select_list_object.should_receive(:select_value).and_return(true)
+      select_list_actual.select_value('testing')
+    end
+    
+    it "should be able to select an item by option" do
+      select_list_object.should_receive(:select).and_return(true)
+      select_list_actual.select('testing')
+    end
   end
 end

data/spec/symbiont/web_objects/table_row_spec.rb

@@ -33,6 +33,7 @@ describe Symbiont::WebObjects::TableRow do
         table_row = Symbiont::WebObjects::TableRow.new(table_row_object)
         table_row_object.should_receive(:[]).with("column_text").and_return(table_row_object)
         table_row_object.should_receive(:[]).with(0).and_return(table_row_object)
+        table_row_object.should_receive(:tag_name)
         table_row_object.should_receive(:parent).and_return(table_row_object)
         table_row_object.should_receive(:cells).and_return(table_row_object)
         table_row_object.should_receive(:find_index).and_return("column_text")

data/spec/symbiont/web_objects/table_spec.rb

@@ -3,6 +3,19 @@ require 'spec_helper'
 describe Symbiont::WebObjects::Table do
   describe "implementation" do
     let(:table_object) { double('table_object') }
+    let(:table_row_object) { double('table_row_object') }
+    let(:table) { Symbiont::WebObjects::Table }
+    
+    it "should reference standard usable selectors" do
+      [:class, :id, :name, :index, :xpath].each do |s|
+        locator = table.provide_locator_for s => 'value'
+        locator.keys.first.should == s
+      end
+    end
+    
+    it "should register with a table tag" do
+      ::Symbiont::WebObjects.get_class_for(:table).should == ::Symbiont::WebObjects::Table
+    end
     
     context "on the watir platform" do
       let(:watir_table) { Symbiont::WebObjects::Table.new(table_object) }
@@ -43,10 +56,6 @@ describe Symbiont::WebObjects::Table do
         watir_table.each { |e| count += 1 }
         count.should == 2
       end
-      
-      it "should register with a table tag" do
-        ::Symbiont::WebObjects.get_class_for(:table).should == ::Symbiont::WebObjects::Table
-      end
     end
   end
 end

data/specs/definitions/pages.rb

@@ -51,6 +51,8 @@ class SimpleObjectPage
   text_field :bookPubID, id: "bookPubID"
   text_field :fake_text_field, id: "fake_text_field"
   
+  select_list :subatomicParticles, id: "subatomicID"
+  
   select_list :physicsConceptsID, id: "physicsConceptsID"
   select_list :physicsConceptsName, name: "physicsConceptsName"
   select_list :physicsConceptsClass, class: "physicsConceptsClass"

data/specs/select_list.feature

@@ -6,12 +6,24 @@ Feature: Ability to Support Select List Web Objects
     And the physics concepts select list should be visible
     And the physics concepts select list should be enabled
     And the physics concepts select list should be a select list object
-
+    And the physics concepts select list should include "Bose-Einstein Condensates"
+  
   Scenario: Select item in select list and get current selection from it
     When "Tachyonic Antitravel" is selected from physics concepts on the object test page
     Then the physics concepts select list should have the second option selected
     And the physics concepts select list should be displaying "Tachyonic Antitravel"
-    
+  
+  Scenario: Select item in select list by value
+    When "option3" is selected from the physics concepts list
+    Then the physics concepts select list should be displaying "Bose-Einstein Condensates"
+    And the selected option on the physics concepts select list should have a value of "option3"
+  
+  Scenario: Selecting multiple items from a list and clearing the list
+    When "Photon" and "Quark" are selected from the subatomic particles select list
+    Then the subatomic particles list should be displaying "Photon" and "Quark"
+    When the select list is cleared
+    Then the select list should have no selected options
+  
   Scenario: Handling a non-existent select list
     When on the object test page
     Then the fake select list should not exist

data/specs/support/test_steps/action_steps_select_lists.rb

@@ -3,6 +3,21 @@ When (/^"([^"]*)" is selected from physics concepts on the object test page$/) d
   @page.physicsConceptsID = text
 end
 
+When (/^"(.*?)" is selected from the physics concepts list$/) do |text|
+  step %{on the object test page}
+  @page.physicsConceptsID_object.select_value(text)
+end
+
+When (/^"(.*?)" and "(.*?)" are selected from the subatomic particles select list$/) do |first, second|
+  step %{on the object test page}
+  @page.subatomicParticles_object.select(first)
+  @page.subatomicParticles_object.select(second)
+end
+
+When (/^the select list is cleared$/) do
+  @page.subatomicParticles_object.clear
+end
+
 When (/^the physics concepts on the object test page is selected by "([^"]*)"$/) do |locator|
   option = "Tachyonic Antitravel"
   @page = SimpleObjectPage.new(@browser, true)
@@ -39,6 +54,8 @@ end
 
 Then (/^the physics concepts select list should be displaying "([^"]*)"$/) do |text|
   @page.physicsConceptsID.should == text
+  @page.physicsConceptsID_object.selected?(text)
+  @page.physicsConceptsID_object.selected?(text).should be_true
 end
 
 Then (/^the fake select list should not exist$/) do
@@ -70,3 +87,20 @@ end
 Then (/^the sith power select list should not be enabled$/) do
   @page.sithPowerID_enabled?.should == false
 end
+
+Then (/^the physics concepts select list should include "(.*?)"$/) do |text|
+  @page.physicsConceptsID_object.should include text
+  @page.physicsConceptsID_object.include?(text)
+end
+
+Then (/^the selected option on the physics concepts select list should have a value of "(.*?)"$/) do |text|
+  @page.physicsConceptsID_object.selected_values[0].should == text
+end
+
+Then (/^the subatomic particles list should be displaying "(.*?)" and "(.*?)"$/) do |first, second|
+  @page.subatomicParticles_object.selected_options.should == [second, first]
+end
+
+Then (/^the select list should have no selected options$/) do
+  @page.subatomicParticles_object.selected_options.should be_empty
+end

data/specs/support/test_steps/action_steps_tables.rb

@@ -42,7 +42,8 @@ Then (/^the savings value cell for February should be "([^"]*)"$/) do |text|
 end
 
 Then (/^the data for row "([^"]*)" should be "([^"]*)", "([^"]*)", and "([^"]*)"$/) do |row, col1, col2, col3|
-  table_row = @object[row.to_i - 1]
+  row = (row.to_i - 1) if row.to_i > 0
+  table_row = @object[row]
   table_row[0].text.should == col1
   table_row[1].text.should == col2
   table_row[2].text.should == col3
@@ -71,3 +72,11 @@ end
 Then (/^the symbol for carbon should be "([^"]*)"$/) do |text|
   @page.atomicTable_object["Carbon"]["Symbol"].text.should == text
 end
+
+Then (/^the data for row "(.*?)" should be unavailable$/) do |row|
+  @object[row].should be_nil
+end
+
+Then (/^the data for column "(.*?)" and row "(.*?)" should be unavailable$/) do |column, row|
+  @object[row][column].should be_nil
+end

data/specs/table.feature

@@ -29,3 +29,11 @@ Feature: Ability to Support Table Web Objects
   Scenario: Get information from a table by named column and row
     When getting information from the atomic elements table
     Then the symbol for carbon should be "C"
+    
+  Scenario: Get information from a table with invalid row information
+    When getting information from the atomic elements table
+    Then the data for row "testing" should be unavailable
+    
+  Scenario: Get information from a table with invalid column information
+    When getting information from the atomic elements table
+    Then the data for column "QA" and row "Element" should be unavailable

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: symbiont
 version: !ruby/object:Gem::Version
-  version: 0.1.4
+  version: 0.1.5
   prerelease: 
 platform: ruby
 authors:
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-08-06 00:00:00.000000000 Z
+date: 2012-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rspec
@@ -130,6 +130,9 @@ files:
 - app/views/success_2.erb
 - app/views/test_database.erb
 - app/views/test_events.erb
+- app/views/test_login.erb
+- app/views/test_login_error.erb
+- app/views/test_login_success.erb
 - app/views/test_page.erb
 - cucumber.yml
 - lib/symbiont.rb
@@ -150,6 +153,7 @@ files:
 - lib/symbiont/web_objects/checkbox.rb
 - lib/symbiont/web_objects/div.rb
 - lib/symbiont/web_objects/link.rb
+- lib/symbiont/web_objects/option.rb
 - lib/symbiont/web_objects/radio.rb
 - lib/symbiont/web_objects/select_list.rb
 - lib/symbiont/web_objects/span.rb
@@ -181,6 +185,7 @@ files:
 - spec/symbiont/web_objects/checkbox_spec.rb
 - spec/symbiont/web_objects/div_spec.rb
 - spec/symbiont/web_objects/link_spec.rb
+- spec/symbiont/web_objects/option_spec.rb
 - spec/symbiont/web_objects/radio_spec.rb
 - spec/symbiont/web_objects/select_list_spec.rb
 - spec/symbiont/web_objects/span_spec.rb