spectest 0.0.3 → 0.0.4

data/HISTORY.md

@@ -1,6 +1,18 @@
 Change Log and History
 ======================
 
+## Version 0.0.4 / 2011-11-15
+
+This updated added the ability to support frames and iframes. This functionality still has to be vetted. This update also extended the web objects mechanism to be platform specific so that each platform can perform certain checks or queries on web objects.
+
+* Web Objects Supported:
+  * Frames
+  * iFrames
+
+* Web Object Queries Supported:
+  * Check if visible
+  * Check if exists
+
 
 ## Version 0.0.3 / 2011-11-14
 

data/lib/spectest.rb

@@ -3,6 +3,7 @@ require "spectest/logger"
 require "spectest/matchers"
 require "spectest/platforms"
 require "spectest/generators"
+require "spectest/enclosers"
 
 module SpecTest
   include Matchers
@@ -17,10 +18,11 @@ module SpecTest
   end
 
   # This makes sure that any page classes that include SpecTest will be
-  # given access to the generator methods based on web objects that are
-  # declared in the page class.
+  # given access to the generator and encloser methods based on web
+  # objects that are declared in the page class.
   def self.included(caller)
     caller.extend SpecTest::Generators
+    caller.extend SpecTest::Enclosers
   end
 
   def initialize(browser, visit=nil)
@@ -51,6 +53,20 @@ module SpecTest
     @platform.text
   end
 
+  # Used to identify a web object as existing within an enclosing object
+  # like a frame or an iframe. There is a duplicate method in enclosers.rb.
+  # This method needs to be here so that test steps can be placed in an
+  # enclosed context.
+  #
+  # @param [String] identifier how an encloser will be referred to
+  # @param encloser a parent encloser that is passed from a previous call
+  # @param [optional] block that contains calls to web objects within the encloser
+  def is_enclosed_by(identifier, encloser=nil, &block)
+    encloser = [] if encloser.nil?
+    encloser << identifier
+    block.call(encloser)
+  end
+
   private
 
   def establish_platform_driver_for(browser)

data/lib/spectest/enclosers.rb

@@ -0,0 +1,19 @@
+module SpecTest
+  module Enclosers
+
+    # Used to identify a web object as existing within an enclosing object
+    # like a frame or an iframe. There is a duplicate method in spectest.rb.
+    # This method needs to be here so that page objects can declare web
+    # objects to be in an enclosed context.
+    #
+    # @param [String] identifier how an encloser will be referred to
+    # @param encloser a parent encloser that is passed from a previous call
+    # @param [optional] block that contains calls to web objects within the encloser
+    def is_enclosed_by(identifier, encloser=nil, &block)
+      encloser = [] if encloser.nil?
+      encloser << identifier
+      block.call(encloser)
+    end
+    
+  end
+end

data/lib/spectest/generators.rb

@@ -74,5 +74,6 @@ module SpecTest
 
       alias_method "#{identifier}_button".to_sym, "#{identifier}_object".to_sym
     end
+
   end
 end

data/lib/spectest/platform_selenium/platform_object.rb

@@ -29,65 +29,80 @@ module SpecTest
         # Link objects are of type: SpecTest::WebObjects::Link
         # See SpecTest::Generators#link
         def get_link_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::Link, 'a')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::Link, 'a')
+          switch_to_encloser(enclosers)
           web_object = @browser.find_element(key, value)
+          @browser.switch_to.default_content unless enclosers.nil?
           WebObjects::Link.new(web_object, :platform => :selenium_webdriver)
         end
 
         # Platform method to click a link object.
         # See SpecTest::Generators#link
         def click_link_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::Link, 'a')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::Link, 'a')
+          switch_to_encloser(enclosers)
           @browser.find_element(key, value).click
+          @browser.switch_to.default_content unless enclosers.nil?
         end
 
         # Platform method to return a text field object.
         # Text field objects are of type: SpecTest::WebObjects::TextField
         # See SpecTest::Generators#text_field
         def get_text_field_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          switch_to_encloser(enclosers)
           web_object = @browser.find_element(key, value)
+          @browser.switch_to.default_content unless enclosers.nil?
           WebObjects::TextField.new(web_object, :platform => :selenium_webdriver)
         end
 
         # Platform method to get the value in a text field object.
         # See SpecTest::Generators#text_field
         def get_text_field_value_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          switch_to_encloser(enclosers)
           value = @browser.find_element(key, value).attribute('value')
+          @browser.switch_to.default_content unless enclosers.nil?
           value
         end
 
         # Platform method to set a value in a text field object.
         # See SpecTest::Generators#text_field
         def set_text_field_value_for(locator, text)
-          key, value = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::TextField, 'input', :type => 'text')
+          switch_to_encloser(enclosers)
           @browser.find_element(key, value).clear
           @browser.find_element(key, value).send_keys(text)
+          @browser.switch_to.default_content unless enclosers.nil?
         end
 
         # Platform method to return a button object.
         # Button objects are of type: SpecTest::WebObjects::Button
         # See SpecTest::Generators#button
         def get_button_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::Button, 'input', :type => 'submit')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::Button, 'input', :type => 'submit')
+          switch_to_encloser(enclosers)
           web_object = @browser.find_element(key, value)
+          @browser.switch_to.default_content unless enclosers.nil?
           WebObjects::Button.new(web_object, :platform => :selenium_webdriver)
         end
 
         # Platform method to click a button object.
         # See SpecTest::Generators#button
         def click_button_for(locator)
-          key, value = get_platform_locator_for(locator, WebObjects::Button, 'input', :type => 'submit')
+          key, value, enclosers = get_platform_locator_for(locator, WebObjects::Button, 'input', :type => 'submit')
+          switch_to_encloser(enclosers)
           @browser.find_element(key, value).click
+          @browser.switch_to.default_content unless enclosers.nil?
         end
         
         protected
 
         def get_platform_locator_for(locator, web_object, tag=nil, qualifier=nil)
+          enclosers = locator.delete(:frame)
           locator = qualify_with_tagname_for locator, tag, qualifier if tag
           key, value = web_object.have_selenium_find_object_with locator
-          return key, value
+          return key, value, enclosers
         end
 
         def qualify_with_tagname_for(locator, tag, qualifier=nil)
@@ -110,9 +125,19 @@ module SpecTest
           return false if locator[:value] and tag == 'input' and qualifier[:type] == 'radio'
           true
         end
-      end
-    end
-  end
-end
+
+        def switch_to_encloser(enclosers)
+          unless enclosers.nil?
+            enclosers.each do |encloser_locator|
+              value = encloser_locator.values.first
+              @browser.switch_to.frame(value)
+            end
+          end
+        end
+        
+      end # class PlatformObject
+    end # module SeleniumWebDriver
+  end # module Platforms
+end # module SpecTest
 
 Dir["#{File.dirname(__FILE__)}/../web_objects/**/*.rb"].each { |file| require file }

data/lib/spectest/platform_selenium/web_objects/all.rb

@@ -0,0 +1,17 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+      module WebObject
+
+        def visible?
+          @web_object.displayed?
+        end
+
+        def exists?
+          nil != @web_object
+        end
+
+      end # module WebObject
+    end # module SeleniumWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/platform_selenium/web_objects/button.rb

@@ -0,0 +1,13 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+      module Button
+
+        def text
+          raise "Returning text from a button element in Selenium is not possible."
+        end
+
+      end # module Button
+    end # module SeleniumWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/platform_selenium/web_objects/link.rb

@@ -0,0 +1,13 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+      module Link
+
+        def value
+          raise "Returning value from a link element in Selenium is not possible."
+        end
+
+      end # module Link
+    end # module SeleniumWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/platform_selenium/web_objects/text_field.rb

@@ -0,0 +1,14 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+      module TextField
+
+        def value=(this)
+          @web_object.clear
+          @web_object.send_keys(this)
+        end
+
+      end # module TextField
+    end # module SeleniumWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/platform_watir/platform_object.rb

@@ -31,64 +31,74 @@ module SpecTest
         # Link objects are of type: SpecTest::WebObjects::Link
         # See SpecTest::Generators#link
         def get_link_for(locator)
-          locator = get_platform_locator_for(locator, WebObjects::Link)
-          web_object = @browser.instance_eval "link(locator)"
+          locator, enclosers = get_platform_locator_for(locator, WebObjects::Link)
+          web_object = @browser.instance_eval "#{nested_by(enclosers)}link(locator)"
+          switch_to_default(enclosers)
           WebObjects::Link.new(web_object, :platform => :watir_webdriver)
         end
 
         # Platform method to click a link object.
         # See SpecTest::Generators#link
         def click_link_for(locator)
-          locator = get_platform_locator_for(locator, WebObjects::Link)
-          @browser.instance_eval "link(locator).click if locator"
+          locator, enclosers = get_platform_locator_for(locator, WebObjects::Link)
+          @browser.instance_eval "#{nested_by(enclosers)}link(locator).click if locator"
+          switch_to_default(enclosers)
         end
 
         # Platform method to return a text field object.
         # Text field objects are of type: SpecTest::WebObjects::TextField
         # See SpecTest::Generators#text_field
         def get_text_field_for(locator)
-          identifier = get_platform_locator_for(locator, WebObjects::TextField)
-          web_object = @browser.instance_eval "text_field(locator)"
+          identifier, enclosers = get_platform_locator_for(locator, WebObjects::TextField)
+          web_object = @browser.instance_eval "#{nested_by(enclosers)}text_field(locator)"
+          switch_to_default(enclosers)
           WebObjects::TextField.new(web_object, :platform => :watir_webdriver)
         end
 
         # Platform method to get the value in a text field object.
         # See SpecTest::Generators#text_field
         def get_text_field_value_for(locator)
-          identifier = get_platform_locator_for(locator, WebObjects::TextField)
-          value = @browser.instance_eval "text_field(locator).value"
+          identifier, enclosers = get_platform_locator_for(locator, WebObjects::TextField)
+          value = @browser.instance_eval "#{nested_by(enclosers)}text_field(locator).value"
+          switch_to_default(enclosers)
           value
         end
 
         # Platform method to set a value in a text field object.
         # See SpecTest::Generators#text_field
         def set_text_field_value_for(locator, text)
-          identifier = get_platform_locator_for(locator, WebObjects::TextField)
-          @browser.instance_eval "text_field(locator).set(text)"
+          identifier, enclosers = get_platform_locator_for(locator, WebObjects::TextField)
+          SpecTest::trace("set_text_field_value_for: #{identifier}, #{enclosers}")
+          @browser.instance_eval "#{nested_by(enclosers)}text_field(locator).set(text)"
+          switch_to_default(enclosers)
         end
 
         # Platform method to return a button object.
         # Button objects are of type: SpecTest::WebObjects::Button
         # See SpecTest::Generators#button
         def get_button_for(locator)
-          identifier = get_platform_locator_for(locator, WebObjects::Button)
-          web_object = @browser.instance_eval "button(locator)"
+          identifier, enclosers = get_platform_locator_for(locator, WebObjects::Button)
+          web_object = @browser.instance_eval "#{nested_by(enclosers)}button(locator)"
+          switch_to_default(enclosers)
           WebObjects::Button.new(web_object, :platform => :watir_webdriver)
         end
 
         # Platform method to click a button object.
         # See SpecTest::Generators#button
         def click_button_for(locator)
-          identifier = get_platform_locator_for(locator, WebObjects::Button)
-          @browser.instance_eval "button(locator).click"
+          identifier, enclosers = get_platform_locator_for(locator, WebObjects::Button)
+          @browser.instance_eval "#{nested_by(enclosers)}button(locator).click"
+          switch_to_default(enclosers)
         end
 
         protected
 
         def get_platform_locator_for(locator, web_object, tag=nil)
+          enclosers = locator.delete(:frame)
+          SpecTest::trace("get_platform_locator_for (enclosers): #{enclosers}")
           locator = qualify_with_tagname_for locator, tag if tag
           locator = web_object.have_watir_find_object_with locator
-          return locator
+          return locator, enclosers
         end
         
         def qualify_with_tagname_for(locator, tag)
@@ -96,9 +106,33 @@ module SpecTest
           locator[:tag_name] = tag if locator[:name]
           locator
         end
-      end
-    end
-  end
-end
 
-Dir["#{File.dirname(__FILE__)}/../web_objects/**/*.rb"].each { |file| require file }
+        def nested_by(enclosers)
+          return if enclosers.nil?
+
+          encloser_locator = ''
+
+          enclosers.each do |id|
+            value = id.values.first
+            encloser_locator += "frame(:#{id.keys.first} => #{value})." if value.to_s.is_integer?
+            encloser_locator += "frame(:#{id.keys.first} => '#{value}')." unless value.to_s.is_integer?
+          end
+          encloser_locator
+        end
+
+        def switch_to_default(enclosers)
+          @browser.wd.switch_to.default_content unless enclosers.nil?
+        end
+
+      end # class PlatformObject
+    end # module WatirWebDriver
+  end # module Platforms
+end # module SpecTest
+
+Dir["#{File.dirname(__FILE__)}/../web_objects/**/*.rb"].each { |file| require file }
+
+class String
+  def is_integer?
+    true if Integer(self) rescue false
+  end
+end

data/lib/spectest/platform_watir/web_objects/all.rb

@@ -0,0 +1,17 @@
+module SpecTest
+  module Platforms
+    module WatirWebDriver
+      module WebObject
+        
+        def visible?
+          @web_object.present?
+        end
+
+        def exists?
+          @web_object.exists?
+        end
+
+      end # module WebObject
+    end # module WatirWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/platform_watir/web_objects/text_field.rb

@@ -0,0 +1,13 @@
+module SpecTest
+  module Platforms
+    module WatirWebDriver
+      module TextField
+
+        def value=(this)
+          @web_object.set(this)
+        end
+
+      end # module TextField
+    end # module WatirWebDriver
+  end # module Platforms
+end # module SpecTest

data/lib/spectest/version.rb

@@ -1,3 +1,3 @@
 module SpecTest
-  VERSION = "0.0.3"
+  VERSION = "0.0.4"
 end

data/lib/spectest/web_objects/all.rb

@@ -1,6 +1,12 @@
 module SpecTest
   module WebObjects
     class WebObject
+
+      def initialize(web_object, platform)
+        @web_object = web_object
+        mixin_web_objects_for platform
+      end
+
       def self.have_watir_find_object_with(locator)
         locator_list = {}
 
@@ -48,6 +54,23 @@ module SpecTest
       def self.mappings_for_selenium
         {}
       end
-    end
-  end
-end
+
+      def mixin_web_objects_for(platform)
+        if platform[:platform] == :watir_webdriver
+          require "spectest/platform_watir/web_objects/all"
+          require "spectest/platform_watir/platform_object"
+          self.class.send :include, SpecTest::Platforms::WatirWebDriver::WebObject
+          @platform = SpecTest::Platforms::WatirWebDriver::PlatformObject.new(@web_object)
+        elsif platform[:platform] == :selenium_webdriver
+          require "spectest/platform_selenium/web_objects/all"
+          require "spectest/platform_selenium/platform_object"
+          self.class.send :include, SpecTest::Platforms::SeleniumWebDriver::WebObject
+          @platform = SpecTest::Platforms::SeleniumWebDriver::PlatformObject.new(@web_object)
+        else
+          raise ArgumentError, "Unable to mixin web objects for the specified platform."
+        end
+      end
+
+    end # class WebObject
+  end # module WebObjects
+end # module SpecTest

data/lib/spectest/web_objects/button.rb

@@ -2,6 +2,11 @@ module SpecTest
   module WebObjects
     class Button < WebObject
 
+      def initialize(web_object, platform)
+        @web_object = web_object
+        mixin_web_objects_for platform
+      end
+
       protected
 
       def self.locators_for_watir
@@ -11,7 +16,15 @@ module SpecTest
       def self.locators_for_selenium
         super + [:value]
       end
-      
-    end
-  end
-end
+
+      def mixin_web_objects_for(platform)
+        super
+        if platform[:platform] == :selenium_webdriver
+          require "spectest/platform_selenium/web_objects/button"
+          self.class.send :include, SpecTest::Platforms::SeleniumWebDriver::Button
+        end
+      end
+
+    end # class Button
+  end # module WebObjects
+end # module SpecTest

data/lib/spectest/web_objects/link.rb

@@ -2,6 +2,11 @@ module SpecTest
   module WebObjects
     class Link < WebObject
 
+      def initialize(web_object, platform)
+        @web_object = web_object
+        mixin_web_objects_for platform
+      end
+
       protected
 
       def self.locators_for_watir
@@ -19,6 +24,15 @@ module SpecTest
       def self.mappings_for_selenium
         super.merge(:text => :link_text)
       end
-    end
-  end
-end
+
+      def mixin_web_objects_for(platform)
+        super
+        if platform[:platform] == :selenium_webdriver
+          require "spectest/platform_selenium/web_objects/link"
+          self.class.send :include, SpecTest::Platforms::SeleniumWebDriver::Link
+        end
+      end
+      
+    end # class Link
+  end # module WebObjects
+end # module SpecTest

data/lib/spectest/web_objects/text_field.rb

@@ -2,6 +2,11 @@ module SpecTest
   module WebObjects
     class TextField < WebObject
 
+      def initialize(web_object, platform)
+        @web_object = web_object
+        mixin_web_objects_for platform
+      end
+
       protected
 
       def self.locators_for_watir
@@ -19,7 +24,20 @@ module SpecTest
       def self.mappings_for_selenium
         super.merge({:tag_name => :css})
       end
-      
-    end
-  end
-end
+
+      def mixin_web_objects_for(platform)
+        super
+        if platform[:platform] == :watir_webdriver
+          require "spectest/platform_watir/web_objects/text_field"
+          self.class.send :include, SpecTest::Platforms::WatirWebDriver::TextField
+        elsif platform[:platform] == :selenium_webdriver
+          require "spectest/platform_selenium/web_objects/text_field"
+          self.class.send :include, SpecTest::Platforms::SeleniumWebDriver::TextField
+        else
+          raise ArgumentError, "Unable to mixin web objects for the specified platform."
+        end
+      end
+
+    end # class TextField
+  end # module WebObjects
+end # module SpecTest

data/spec/web_objects/all_spec.rb

@@ -0,0 +1,5 @@
+require "spec_helper"
+require "spectest/web_objects/all"
+
+#describe "there are common methods for all web objects" do
+#end

data/spec/web_objects/button_spec.rb

@@ -0,0 +1,35 @@
+require "spec_helper"
+require "spectest/web_objects/all"
+require "spectest/web_objects/button"
+
+describe SpecTest::WebObjects::Button do
+  let(:button) { SpecTest::WebObjects::Button }
+
+  describe "when mapping how to identify a web object" do
+    it "it should be able to map watir locators" do
+      [:class, :id, :index, :name, :value, :xpath].each do |type|
+        locator = button.have_watir_find_object_with type => 'value'
+        locator.keys.first.should == type
+      end
+    end
+
+    it "it should be able to map selenium locators" do
+      [:class, :id, :index, :name, :value, :xpath].each do |type|
+        key, value = button.have_selenium_find_object_with type => 'value'
+        key.should == type
+      end
+    end
+  end
+
+  describe "when performing an action on a web object" do
+    let(:button_object) { double('button_object') }
+
+    context "and when selenium is the driver" do
+      it "then it should return an error when asked for text" do
+        button = SpecTest::WebObjects::Button.new(button_object, :platform => :selenium_webdriver)
+        lambda { button.text }.should raise_error
+      end
+    end
+  end
+
+end

data/spec/web_objects/link_spec.rb

@@ -0,0 +1,46 @@
+require 'spec_helper'
+require "spectest/web_objects/all"
+require "spectest/web_objects/link"
+
+describe SpecTest::WebObjects::Link do
+  let(:link) { SpecTest::WebObjects::Link }
+
+  describe "when mapping how to identify a web object" do
+    it "it should be able to map watir locators" do
+      [:class, :href, :id, :index, :name, :text, :xpath].each do |type|
+        locator = link.have_watir_find_object_with type => 'value'
+        locator.keys.first.should == type
+      end
+    end
+
+    it "it should be able to map selenium locators" do
+      [:class, :id, :link, :link_text, :name, :xpath, :index].each do |type|
+        key, value = link.have_selenium_find_object_with type => 'value'
+        key.should == type
+      end
+    end
+
+    it "it should be able to map watir selectors to selenium locators" do
+      key, value = link.have_selenium_find_object_with :text => 'value'
+      key.should == :link_text
+    end
+
+    it "it should be able to map selenium selectors to watir locators" do
+      [:link, :link_text].each do |type|
+        locator = link.have_watir_find_object_with type => 'value'
+        locator.keys.first.should == :text
+      end
+    end
+  end
+
+  describe "when performing an action on a web object" do
+    let(:link_object) { double('link_object') }
+
+    context "and when selenium is the driver" do
+      it "then it should return an error when asked for a value" do
+        link = SpecTest::WebObjects::Link.new(link_object, :platform => :selenium_webdriver)
+        lambda { link.value }.should raise_error
+      end
+    end
+  end
+end

data/spec/web_objects/text_field_spec.rb

@@ -0,0 +1,46 @@
+require "spec_helper"
+require "spectest/web_objects/all"
+require "spectest/web_objects/text_field"
+
+describe SpecTest::WebObjects::TextField do
+  let(:textfield) { SpecTest::WebObjects::TextField }
+
+  describe "when mapping how to identify a web object" do
+    it "it should be able to map watir locators" do
+      [:class, :id, :index, :name, :tag_name, :xpath].each do |type|
+        locator = textfield.have_watir_find_object_with type => 'value'
+        locator.keys.first.should == type
+      end
+    end
+
+    it "it should be able to map selenium locators" do
+      [:class, :css, :id, :name, :xpath, :index].each do |type|
+        key, value = textfield.have_selenium_find_object_with type => 'value'
+        key.should == type
+      end
+    end
+
+    it "it should be able to map watir selectors to selenium locators" do
+      key, value = textfield.have_selenium_find_object_with :tag_name => 'value'
+      key.should == :css
+    end
+
+    it "it should be able to map selenium selectors to watir locators" do
+      locator = textfield.have_watir_find_object_with :css => 'value'
+      locator.keys.first.should == :tag_name
+    end
+  end
+
+  describe "when performing an action on a web object" do
+    context "and when selenium is the driver" do
+      it "it should be able to set the value of the object" do
+        text_field_object = double('selenium_text_field')
+        selenium_text_field = SpecTest::WebObjects::TextField.new(text_field_object, :platform => :selenium_webdriver)
+        text_field_object.should_receive(:clear)
+        text_field_object.should_receive(:send_keys).with('Testing')
+        selenium_text_field.value = 'Testing'
+      end
+    end
+  end
+
+end

data/spec/webobject_selenium_spec.rb

@@ -0,0 +1,31 @@
+require "spec_helper"
+
+describe "web objects can be used by the selenium platform" do
+  let(:selenium_browser) { double('selenium_browser') }
+  let(:web_object) { SpecTest::WebObjects::WebObject.new(selenium_browser, :platform => :selenium_webdriver) }
+
+  context "and that means" do
+    it "it should be possible to tell when an object is visible" do
+      selenium_browser.stub(:displayed?).and_return(true)
+      web_object.visible?.should == true
+    end
+
+    it "it should be possible to tell when an object exists" do
+      selenium_browser.stub(:exists?).and_return(true)
+      web_object.exists?.should == true
+    end
+
+    it "it should be possible to tell when an object is not visible" do
+      selenium_browser.should_receive(:displayed?).and_return(false)
+      web_object.visible?.should == false
+    end
+
+    it "it should be possible to tell when an object does not exist" do
+      web_object = SpecTest::WebObjects::WebObject.new(nil, :platform => :selenium_webdriver)
+      selenium_browser.stub(:exists?).and_return(false)
+      selenium_browser.stub(:nil?).and_return(true)
+      web_object.exists?.should == false
+    end
+  end
+
+end

data/spec/webobject_watir_spec.rb

@@ -0,0 +1,31 @@
+require "spec_helper"
+
+describe "web objects can be used by the watir platform" do
+  let(:watir_browser) { double('watir_browser') }
+  let(:web_object) { SpecTest::WebObjects::WebObject.new(watir_browser, :platform => :watir_webdriver) }
+
+  context "and that means" do
+    it "it should be possible to tell when an object is visible" do
+      watir_browser.stub(:present?).and_return(true)
+      watir_browser.stub(:displayed?).and_return(true)
+      web_object.visible?.should == true
+    end
+
+    it "it should be possible to tell when an object exists" do
+      watir_browser.stub(:exists?).and_return(true)
+      web_object.exists?.should == true
+    end
+
+    it "it should be possible to tell when an object is not visible" do
+      watir_browser.stub(:present?).and_return(false)
+      watir_browser.stub(:displayed?).and_return(false)
+      web_object.visible?.should == false
+    end
+
+    it "it should be possible to tell when an object does not exist" do
+      watir_browser.stub(:exists?).and_return(false)
+      watir_browser.stub(:nil?).and_return(true)
+      web_object.exists?.should == false
+    end
+  end
+end

data/specs/app/test_static.html

@@ -13,10 +13,10 @@
 
 <h3>Links</h3>
 
-<p><a id="avengers_unite_id" name="avengers_unite_name" class="avengers_unite_class" href="success_1.html">Avengers Unite</a></p>
+<p><a id="avengers_assemble_id" name="avengers_assemble_name" class="avengers_assemble_class" href="success_1.html">Avengers Assemble</a></p>
 
-<p><a href="success_1.html">Justice League Assemble</a></p>
-<p><a href="success_2.html">Justice League Assemble</a></p>
+<p><a href="success_1.html">Justice League Unite</a></p>
+<p><a href="success_2.html">Justice League Unite</a></p>
 
 <p><a id="oath" href="success_1.html">"...in the brightest day and in the darkest night..."</a></p>
 

data/specs/pages/iframe_examples_page.rb

@@ -0,0 +1,13 @@
+class IFrameExamplesPage
+  include SpecTest
+
+  is_enclosed_by(:id => "static") do |encloser|
+    link(:avengers_assemble, :text => "Avengers Assemble", :frame => encloser)
+  end
+
+  is_enclosed_by(:id => "form") do |encloser|
+    text_field(:customer_code, :id => "customerCode", :frame => encloser)
+    button(:login, :id => "btnSubmit", :frame => encloser)
+  end
+
+end

data/specs/pages/landing_page.rb

@@ -4,4 +4,5 @@ class LandingPage
   url_is "http://localhost:1234"
   link :static_text_examples, :text => "Static Text Examples"
   link :form_examples, :text => "Form Examples"
+  link :iframe_examples, :text => "IFrame Examples"
 end

data/specs/steps/button_steps.rb

@@ -1,3 +1,7 @@
 When /^I click the log in button$/ do
   @page.login
+end
+
+When /^I click the framed log in button$/ do
+  @page.login
 end

data/specs/steps/link_steps.rb

@@ -1,3 +1,17 @@
 When /^I select the static text examples link$/ do
   @page.static_text_examples
 end
+
+When /^I select the framed avengers assemble link$/ do
+  @page.avengers_assemble
+end
+
+When /^I select the "([^"]*)" link$/ do |text|
+  actual_text = text.gsub(" ", "_").downcase
+  @link = @page.send "#{actual_text}"
+end
+
+When(/^I look for the "([^"]*)" link$/) do |text|
+  actual_text = text.gsub(" ", "_").downcase
+  @link = @page.send "#{actual_text}_object"
+end

data/specs/steps/object_steps.rb

@@ -1,3 +1,11 @@
 Then /^I should see the text "([^"]*)"$/ do |text|
   @text.should == text
-end
+end
+
+Then(/^I should find that the link exists$/) do
+  @link.should exist
+end
+
+Then(/^I should find that the link is visible$/) do
+  @link.should be_visible
+end

data/specs/steps/page_steps.rb

@@ -13,6 +13,12 @@ Given /^I am on the form examples page$/ do
   @page = FormExamplesPage.new(@browser)
 end
 
+Given /^I am on the iframe elements page$/ do
+  step %{I have gone to the test app site}
+  @page.iframe_examples
+  @page = IFrameExamplesPage.new(@browser)
+end
+
 Then /^I should be on the landing page$/ do
   #@page.text.should match(/^Landing Page$/)
   #@page.title.should match(/^Test App$/)
@@ -29,4 +35,18 @@ end
 Then /^I should be taken to the first success page$/ do
   @page = Success1Page.new(@browser)
   @page.text.should contain("first success page")
+end
+
+Then /^I should be taken to the first success page within the static frame$/ do
+  @page.is_enclosed_by(:id => "static") do |frame|
+    @page = Success1Page.new(@browser)
+    @page.text.should contain("first success page")
+  end
+end
+
+Then /^I should be taken to the first success page within the form frame$/ do
+  @page.is_enclosed_by(:id => "form") do |frame|
+    @page = Success1Page.new(@browser)
+    @page.text.should contain("first success page")
+  end
 end

data/specs/steps/text_field_steps.rb

@@ -5,4 +5,9 @@ end
 When /^I enter "([^"]*)" in the customer code text field$/ do |text|
   @page.customer_code = text
   @text = @page.customer_code
+end
+
+When /^I enter "([^"]*)" in the framed customer code text field$/ do |text|
+  @page.customer_code = text
+  @text = @page.customer_code
 end

data/specs/tests/iframes.feature

@@ -0,0 +1,20 @@
+Feature: Ability to handle iframes.
+
+  As a test writer
+  I need the ability to look within iframes
+  so that I can manipulate objects that are enclosed within them.
+  
+  Background:
+    Given I am on the iframe elements page
+
+  Scenario: Accessing text fields within an iframe
+    When I enter "QA" in the framed customer code text field
+    Then I should see the text "QA"
+
+  Scenario: Accessing links within an iframe
+    When I select the framed avengers assemble link
+    #Then I should be taken to the first success page within the static frame
+
+  Scenario: Accessing buttons within an iframe
+    When I click the framed log in button
+    #Then I should be taken to the first success page within the form frame

data/specs/tests/link.feature

@@ -4,9 +4,23 @@ Feature: Ability to support links.
   I need the ability to click on links
   so that I can use link-based navigation while testing.
 
+  As a test writer
+  I need to locate links on a page with different selectors
+  so that I can trawl a page to find needed links
+  and so that I can handle changes to links when they occur.
+  
   Background:
     Given I am on the landing page
 
   Scenario: Selecting a link. (Specific test step.)
     When I select the static text examples link
     Then I should be on the static text examples page
+
+  Scenario: Selecting a link. (Generic test step.)
+    When I select the "Static Text Examples" link
+    Then I should be on the static text examples page
+
+  Scenario: Finding a link (with a single parameter).
+    When I look for the "Form Examples" link
+    Then I should find that the link exists
+    And I should find that the link is visible

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectest
 version: !ruby/object:Gem::Version
-  version: 0.0.3
+  version: 0.0.4
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-14 00:00:00.000000000Z
+date: 2011-11-15 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &16039692 !ruby/object:Gem::Requirement
+  requirement: &20625144 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.3.9
   type: :runtime
   prerelease: false
-  version_requirements: *16039692
+  version_requirements: *20625144
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
-  requirement: &16038840 !ruby/object:Gem::Requirement
+  requirement: &20624472 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 2.12.1
   type: :runtime
   prerelease: false
-  version_requirements: *16038840
+  version_requirements: *20624472
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &16038348 !ruby/object:Gem::Requirement
+  requirement: &20623140 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 2.7.0
   type: :development
   prerelease: false
-  version_requirements: *16038348
+  version_requirements: *20623140
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &16037904 !ruby/object:Gem::Requirement
+  requirement: &20619588 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,10 +54,10 @@ dependencies:
         version: 1.1.2
   type: :development
   prerelease: false
-  version_requirements: *16037904
+  version_requirements: *20619588
 - !ruby/object:Gem::Dependency
   name: simplecov
-  requirement: &16037172 !ruby/object:Gem::Requirement
+  requirement: &20616636 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -65,7 +65,7 @@ dependencies:
         version: 0.5.4
   type: :development
   prerelease: false
-  version_requirements: *16037172
+  version_requirements: *20616636
 description: Test framework for specifying tests and executing tests.
 email:
 - jeffnyman@gmail.com
@@ -82,13 +82,20 @@ files:
 - Rakefile
 - cucumber.yml
 - lib/spectest.rb
+- lib/spectest/enclosers.rb
 - lib/spectest/generators.rb
 - lib/spectest/logger.rb
 - lib/spectest/matchers.rb
 - lib/spectest/platform_selenium.rb
 - lib/spectest/platform_selenium/platform_object.rb
+- lib/spectest/platform_selenium/web_objects/all.rb
+- lib/spectest/platform_selenium/web_objects/button.rb
+- lib/spectest/platform_selenium/web_objects/link.rb
+- lib/spectest/platform_selenium/web_objects/text_field.rb
 - lib/spectest/platform_watir.rb
 - lib/spectest/platform_watir/platform_object.rb
+- lib/spectest/platform_watir/web_objects/all.rb
+- lib/spectest/platform_watir/web_objects/text_field.rb
 - lib/spectest/platforms.rb
 - lib/spectest/version.rb
 - lib/spectest/web_objects/all.rb
@@ -104,6 +111,12 @@ files:
 - spec/platforms_spec.rb
 - spec/spec_helper.rb
 - spec/spectest_spec.rb
+- spec/web_objects/all_spec.rb
+- spec/web_objects/button_spec.rb
+- spec/web_objects/link_spec.rb
+- spec/web_objects/text_field_spec.rb
+- spec/webobject_selenium_spec.rb
+- spec/webobject_watir_spec.rb
 - specs/app/favicon.ico
 - specs/app/images/mass_extinction.jpg
 - specs/app/index.html
@@ -121,6 +134,7 @@ files:
 - specs/engine/borg.rb
 - specs/engine/hooks.rb
 - specs/pages/form_examples_page.rb
+- specs/pages/iframe_examples_page.rb
 - specs/pages/landing_page.rb
 - specs/pages/static_examples_page.rb
 - specs/pages/success_1_page.rb
@@ -130,6 +144,7 @@ files:
 - specs/steps/page_steps.rb
 - specs/steps/text_field_steps.rb
 - specs/tests/button.feature
+- specs/tests/iframes.feature
 - specs/tests/link.feature
 - specs/tests/page.feature
 - specs/tests/text_field.feature