spectest 0.0.1 → 0.0.2

data/.gitignore

@@ -2,6 +2,7 @@
 .idea/*
 .svn/*
 pkg/*
+coverage/*
 *.gem
 *.swp
 *.swo

data/.travis.yml

@@ -0,0 +1,13 @@
+script: "rake"
+
+rvm:
+  - 1.9.2
+  - 1.9.3
+
+branches:
+  only:
+    - master
+
+notifications:
+  recipients:
+    - jeffnyman@gmail.com

data/HISTORY.md

@@ -1,6 +1,17 @@
 Change Log and History
 ======================
 
+## Version 0.0.2 / 2011-11-13
+
+Platform object structure added. This allows browsers to be associated with a particular driver. That combination is called a "platform object." It's this object that directs the execution of tests against the browser. A full RSpec and Cucumber testing infrastructure has been added. The Cucumber file layout will match what users of the gem would have to create.
+
+* Browser-Level Actions Supported:
+  * navigate to
+
+* Page-Level Actions Supported:
+  * title
+  * text
+
 ## Version 0.0.1 / 2011-11-12
 
 Initial creation of the gem framework.

data/README.md

@@ -1,4 +1,4 @@
-# SpecTest
+# SpecTest [![Build Status](https://secure.travis-ci.org/jnyman/spectest.png)](http://travis-ci.org/jnyman/spectest)
 
 This gem is designed to provide a testing framework for creating executable test specifications.
 

data/Rakefile

@@ -1 +1,22 @@
-require "bundler/gem_tasks"
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+require 'cucumber/rake/task'
+
+task :default => :spec
+
+RSpec::Core::RakeTask.new(:spec)
+
+namespace :specs do
+  Cucumber::Rake::Task.new(:watir, "Run Cucumber with Watir") do |config|
+    config.profile = 'watir'
+  end
+
+  Cucumber::Rake::Task.new(:selenium, "Run Cucumber with Selenium") do |config|
+    config.profile = 'selenium'
+  end
+
+  desc "Run Cucumber with Selenium and Watir"
+  task :all => [:watir, :selenium]
+  task :watir_driver => [:watir]
+  task :selenium_driver => [:selenium]
+end

data/cucumber.yml

@@ -0,0 +1,4 @@
+default: DRIVER=watir BROWSER=firefox -r specs/engine/borg.rb -r specs specs
+
+watir: DRIVER=watir BROWSER=firefox -r specs/engine/borg.rb -r specs specs
+selenium: DRIVER=selenium BROWSER=firefox -r specs/engine/borg.rb -r specs specs

data/lib/spectest.rb

@@ -1,5 +1,50 @@
 require "spectest/version"
+require "spectest/logger"
+require "spectest/matchers"
+require "spectest/platforms"
 
 module SpecTest
+  include Matchers
+  include Platforms
 
+  # @return [TerminusSpec::Platforms::WatirWebDriver::PlatformObject] the platform object
+  # @return [TerminusSpec::Platforms::SeleniumWebDriver::PlatformObject] the platform object
+  attr_reader :platform
+
+  def self.version_info
+    "SpecTest version #{SpecTest::VERSION}"
+  end
+
+  def initialize(browser)
+    @browser = browser
+    establish_platform_driver_for browser
+  end
+
+  # Navigate to the specified URL. The URL can be specified as a domain
+  # address or as a file-based link.
+  # @param [String] url the full URL to navigate to
+  def navigate_to(url)
+    # Here is exactly why a platform object is needed. Which version do I call:
+    #   @browser.goto(url)  <-- this is for Watir
+    #   @browser.navigate.to(url)  <-- this is for Selenium
+    # I have to call the platform that has been established. The platform will
+    # be responsible for containing the correct call.
+    @platform.navigate_to url
+  end
+
+  # Returns the title of the current page as displayed in the browser.
+  def title
+    @platform.title
+  end
+
+  # Returns the text of the current page.
+  def text
+    @platform.text
+  end
+
+  private
+
+  def establish_platform_driver_for(browser)
+    @platform = platform_for browser, SpecTest::Platforms.list
+  end
 end

data/lib/spectest/logger.rb

@@ -0,0 +1,5 @@
+module SpecTest
+  def self.trace(message, level=1)
+    puts("*" * level + " #{message}") if ENV['TRACE'] == 'on'
+  end
+end

data/lib/spectest/matchers.rb

@@ -0,0 +1,48 @@
+module SpecTest
+  module Matchers
+
+    # Without this matcher, here's what RSpec decides to give you:
+    #   expected "Test" to match /^Test App$/
+    # With the  matcher, you get this:
+    #   Expected that 'Test App' would be the title of the page; found 'Test' instead.
+    RSpec::Matchers.define :have_title do |text|
+      match do |the_page|
+        the_page =~ Regexp.new(text)
+      end
+
+      failure_message_for_should do |actual|
+        "Expected that '#{text}' would be the title of the page; found '#{actual}' instead."
+      end
+
+      failure_message_for_should_not do |actual|
+        "Expected that '#{text}' would not be the title of the page; it was, however."
+      end
+
+      description do
+        "checking for a title of #{text}"
+      end
+    end
+
+    # Without this matcher, here's what RSpec decides to give you:
+    #   expected "Testing with Terminus\nLanding\nStatic Text Examples\nForm Examples\nFrame Examples\nIFrame Examples\nEvent Examples" to match /^Landing Page$/
+    # With the  matcher, you get this:
+    #   Expected that 'Landing Page' would be in the page content; it was not found.
+    RSpec::Matchers.define :contain do |text|
+      match do |the_page|
+        the_page =~ Regexp.new(text)
+      end
+      
+      failure_message_for_should do |actual|
+        "Expected that '#{text}' would be in the page content; it was not found."
+      end
+
+      failure_message_for_should_not do |actual|
+        "Expected that '#{text}' would not be in the page content; it was, however."
+      end
+
+      description do
+        "checking for #{text}"
+      end
+    end
+  end
+end

data/lib/spectest/platform_selenium.rb

@@ -0,0 +1,18 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+
+      def self.create_platform_object_for(browser)
+        require "spectest/platform_selenium/platform_object"
+        return SeleniumWebDriver::PlatformObject.new(browser)
+      end
+
+      def self.works_for?(browser)
+        browser.is_a?(Selenium::WebDriver::Driver)
+      end
+
+    end
+  end
+end
+
+SpecTest::Platforms.associate(:selenium_webdriver, SpecTest::Platforms::SeleniumWebDriver)

data/lib/spectest/platform_selenium/platform_object.rb

@@ -0,0 +1,31 @@
+module SpecTest
+  module Platforms
+    module SeleniumWebDriver
+      class PlatformObject
+
+        def initialize(browser)
+          @browser = browser
+        end
+
+        # Platform method to navigate to a specified URL.
+        # See SpecTest#navigate_to
+        def navigate_to(url)
+          @browser.navigate.to url
+        end
+
+        # Platform method to retrieve the title for the current page.
+        # See SpecTest#title
+        def title
+          @browser.title
+        end
+
+        # Platform method to retrieve text from the current page.
+        # See SpecTest#text
+        def text
+          @browser.find_element(:tag_name, 'body').text
+        end
+
+      end
+    end
+  end
+end

data/lib/spectest/platform_watir.rb

@@ -0,0 +1,18 @@
+module SpecTest
+  module Platforms
+    module WatirWebDriver
+
+      def self.create_platform_object_for(browser)
+        require "spectest/platform_watir/platform_object"
+        return WatirWebDriver::PlatformObject.new(browser)
+      end
+
+      def self.works_for?(browser)
+        browser.is_a?(Watir::Browser)
+      end
+
+    end
+  end
+end
+
+SpecTest::Platforms.associate(:watir_webdriver, SpecTest::Platforms::WatirWebDriver)

data/lib/spectest/platform_watir/platform_object.rb

@@ -0,0 +1,33 @@
+module SpecTest
+  module Platforms
+    module WatirWebDriver
+      class PlatformObject
+
+        attr_reader :browser
+
+        def initialize(browser)
+          @browser = browser
+        end
+
+        # Platform method to navigate to a specified URL.
+        # See SpecTest#navigate_to
+        def navigate_to(url)
+          @browser.goto url
+        end
+
+        # Platform method to retrieve the title for the current page.
+        # See SpecTest#title
+        def title
+          @browser.title
+        end
+
+        # Platform method to retrieve text from the current page.
+        # See SpecTest#text
+        def text
+          @browser.text
+        end
+
+      end
+    end
+  end
+end

data/lib/spectest/platforms.rb

@@ -0,0 +1,23 @@
+module SpecTest
+  module Platforms
+    @@drivers = {}
+
+    def self.list
+      @@drivers
+    end
+
+    def self.associate(key, driver)
+      @@drivers[key] = driver
+    end
+
+    def platform_for(browser, drivers)
+      drivers.each_value { |driver|
+        return driver.create_platform_object_for browser if driver.works_for? browser
+      }
+      raise "Unable to associate a platform using the provided browser."
+    end
+  end
+end
+
+require "spectest/platform_watir"
+require "spectest/platform_selenium"

data/lib/spectest/version.rb

@@ -1,3 +1,3 @@
 module SpecTest
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

data/spec/browser_level_spec.rb

@@ -0,0 +1,24 @@
+require "spec_helper"
+
+describe SpecTest do
+  let(:watir_browser) { mock_browser_with_watir }
+  let(:selenium_browser) { mock_browser_with_selenium }
+  let(:watir_page) { PageTester.new(watir_browser) }
+  let(:selenium_page) { PageTester.new(selenium_browser) }
+
+  describe "in terms of browser-level functionality" do
+    context "when using the watir platform" do
+      it "a page can be navigated to" do
+        watir_browser.should_receive(:goto).with("testerstories.com")
+        watir_page.navigate_to("testerstories.com")
+      end
+    end
+
+    context "when using the selenium platform" do
+      it "a page can be navigated to" do
+        selenium_browser.stub_chain(:navigate, :to).with("testerstories.com")
+        selenium_page.navigate_to("testerstories.com")
+      end
+    end
+  end
+end

data/spec/page_level_spec.rb

@@ -0,0 +1,34 @@
+require "spec_helper"
+
+describe SpecTest do
+  let(:watir_browser) { mock_browser_with_watir }
+  let(:selenium_browser) { mock_browser_with_selenium }
+  let(:watir_page) { PageTester.new(watir_browser) }
+  let(:selenium_page) { PageTester.new(selenium_browser) }
+
+  describe "in terms of page-level functionality" do
+    context "when using the watir platform" do
+      it "the title of the page will be accessible" do
+        watir_browser.should_receive(:title).and_return("Page Title")
+        watir_page.title.should == "Page Title"
+      end
+
+      it "the text of the page will be accessible" do
+        watir_browser.should_receive(:text).and_return("page text")
+        watir_page.text.should == "page text"
+      end
+    end
+
+    context "when using the selenium platform" do
+      it "the title of the page will be accessible" do
+        selenium_browser.should_receive(:title).and_return("Page Title")
+        selenium_page.title.should == "Page Title"
+      end
+
+      it "the text of the page will be accessible" do
+        selenium_browser.stub_chain(:find_element, :text).and_return("page text")
+        selenium_page.text.should == "page text"
+      end
+    end
+  end
+end

data/spec/platform_object_spec.rb

@@ -0,0 +1,45 @@
+require "spec_helper"
+
+class PlatformObject
+end
+
+describe SpecTest do
+  let(:watir_browser) { mock_browser_with_watir }
+  let(:selenium_browser) { mock_browser_with_selenium }
+  let(:watir_page) { PageTester.new(watir_browser) }
+  let(:selenium_page) { PageTester.new(selenium_browser) }
+
+  context "can be included with a page that will be using watir-webdriver" do
+    it "which means the page should use a watir platform object" do
+      watir_page.platform.should be_kind_of SpecTest::Platforms::WatirWebDriver::PlatformObject
+    end
+  end
+
+  context "can be included with a page that will be using selenium-webdriver" do
+    it "which means the page should use a selenium platform object" do
+      selenium_page.platform.should be_kind_of SpecTest::Platforms::SeleniumWebDriver::PlatformObject
+    end
+  end
+
+  context "might be included with a page using an unrecognized driver" do
+    it "and in that case it should raise an exception" do
+      expect { PageTester.new("fake_browser") }.to raise_error
+    end
+  end
+
+  context "might be included with a page using an unassociated custom driver" do
+    let(:custom_driver) { mock_driver(:watir_browser, PlatformObject) }
+    it "and in that case it should raise an exception" do
+      expect { custom_page = PageTester.new(:watir_browser) }.to raise_error
+    end
+  end
+
+  context "might be included with a page using an associated custom driver" do
+    let(:custom_driver) { mock_driver(:custom_browser, PlatformObject) }
+    it "which means the page should use a custom platform object" do
+      mock_drivers_list({:custom_driver => custom_driver})
+      custom_page = PageTester.new(:custom_browser)
+      custom_page.platform.should be custom_driver.create_platform_object_for
+    end
+  end
+end

data/spec/platform_selenium_spec.rb

@@ -0,0 +1,28 @@
+require "spec_helper"
+
+describe SpecTest::Platforms::SeleniumWebDriver do
+  it "should be in the platform objects driver list" do
+    SpecTest::Platforms.list[:selenium_webdriver].should be SpecTest::Platforms::SeleniumWebDriver
+  end
+
+  describe "and when used to create a platform object" do
+    let(:browser) { double('browser') }
+    let(:platform) { SpecTest::Platforms::SeleniumWebDriver.create_platform_object_for(browser) }
+
+    it "a SeleniumPlatformObject should be created" do
+      platform.should be_kind_of SpecTest::Platforms::SeleniumWebDriver::PlatformObject
+    end
+  end
+
+  describe "and when checking if the platform can be associated with a browser" do
+    it "if the browser is of type Selenium::WebDriver, the platform will be associated " do
+      browser = mock_browser_with_selenium()
+      SpecTest::Platforms::SeleniumWebDriver.works_for?(browser).should be true
+    end
+
+    it "if the browser is not of type Selenium::WebDriver, the platform will not be associated" do
+      browser = "false_browser"
+      SpecTest::Platforms::SeleniumWebDriver.works_for?(browser).should be false
+    end
+  end
+end

data/spec/platform_watir_spec.rb

@@ -0,0 +1,32 @@
+require "spec_helper"
+
+describe SpecTest::Platforms::WatirWebDriver do
+  it "should be in the platform objects driver list" do
+    SpecTest::Platforms.list[:watir_webdriver].should be SpecTest::Platforms::WatirWebDriver
+  end
+
+  describe "and when used to create a platform object" do
+    let(:browser) { double('browser') }
+    let(:platform) { SpecTest::Platforms::WatirWebDriver.create_platform_object_for(browser) }
+
+    it "a WatirPlatformObject should be created" do
+      platform.should be_kind_of SpecTest::Platforms::WatirWebDriver::PlatformObject
+    end
+
+    it "the browser should be associated with the platform object" do
+      platform.browser.should be browser
+    end
+  end
+
+  describe "and when checking if the platform can be associated with a browser" do
+    it "if the browser is of type Watir::Browser, the platform will be associated " do
+      browser = mock_browser_with_watir()
+      SpecTest::Platforms::WatirWebDriver.works_for?(browser).should be true
+    end
+
+    it "if the browser is not of type Watir::Browser, the platform will not be associated" do
+      browser = "false_browser"
+      SpecTest::Platforms::WatirWebDriver.works_for?(browser).should be false
+    end
+  end
+end

data/spec/platforms_spec.rb

@@ -0,0 +1,40 @@
+require "spec_helper"
+
+class LoadingPlatforms
+  include SpecTest::Platforms
+end
+
+describe LoadingPlatforms do
+  let(:platform) { LoadingPlatforms.new() }
+  let(:drivers) { {} }
+
+  context "if a chrome browser is associated with a chrome platform" do
+    let(:chrome_browser) { double('browser') }
+    before { drivers[:chrome_browser] = mock_driver(chrome_browser, :chrome_platform) }
+    it "then the chrome platform will be established for the chrome browser" do
+      platform.platform_for(chrome_browser, drivers).should == :chrome_platform
+    end
+
+    context "if a firefox browser is associated with a firefox platform" do
+      let(:firefox_browser) { double('browser') }
+      before { drivers[:firefox_browser] = mock_driver(firefox_browser, :firefox_platform) }
+      it "then the chrome platform will still be established for the chrome platform" do
+        platform.platform_for(chrome_browser, drivers).should == :chrome_platform
+      end
+    end
+  end
+
+  context "if a firefox browser is associated with a firefox platform" do
+    let(:firefox_browser) { double('browser') }
+    before { drivers[:firefox_browser] = mock_driver(firefox_browser, :firefox_platform) }
+    it "then the firefox platform will be established for the firefox browser" do
+      platform.platform_for(firefox_browser, drivers).should == :firefox_platform
+    end
+  end
+
+  context "if an unknown browser object is associated with a platform" do
+    it "then it should raise an exception" do
+      expect { platform.platform_for("false_browser") }.to raise_error
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,45 @@
+require 'simplecov'
+SimpleCov.start { add_filter "/spec/" } if ENV['COVERAGE']
+
+require 'rspec'
+require 'spectest'
+
+require 'watir-webdriver'
+require 'selenium-webdriver'
+
+class PageTester
+  include SpecTest
+end
+
+RSpec.configure do |config|
+  config.color_enabled = true
+  config.formatter = 'documentation'
+end
+
+def mock_browser_with_watir
+  watir_browser = double('watir')
+  watir_browser.stub(:is_a?).with(anything()).and_return(false)
+  watir_browser.stub(:is_a?).with(Selenium::WebDriver::Driver).and_return(false)
+  watir_browser.stub(:is_a?).with(Watir::Browser).and_return(true)
+  watir_browser
+end
+
+def mock_browser_with_selenium
+  selenium_browser = double('selenium')
+  selenium_browser.stub(:is_a?).with(anything()).and_return(false)
+  selenium_browser.stub(:is_a?).with(Watir::Browser).and_return(false)
+  selenium_browser.stub(:is_a?).with(Selenium::WebDriver::Driver).and_return(true)
+  selenium_browser
+end
+
+def mock_driver(browser, platform_object)
+  driver = double('driver')
+  driver.stub(:works_for?).with(anything()).and_return(false)
+  driver.stub(:works_for?).with(browser).and_return(true)
+  driver.stub(:create_platform_object_for).and_return platform_object
+  driver
+end
+
+def mock_drivers_list(drivers)
+  SpecTest::Platforms.stub(:list).and_return drivers
+end

data/spec/spectest_spec.rb

@@ -0,0 +1,7 @@
+require "spec_helper"
+
+describe SpecTest do
+  it "should be able to return its version information" do
+    SpecTest.version_info.should == "SpecTest version #{SpecTest::VERSION}"
+  end
+end

data/specs/app/index.html

@@ -0,0 +1,20 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App</title>
+    <link rel="stylesheet" href="style.css" />
+</head>
+<body>
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Landing Page</h2>
+
+<p><a href="test_static.html">Static Text Examples</a></p>
+<p><a href="test_form.html">Form Examples</a></p>
+<p><a href="test_frame.html">Frame Examples</a></p>
+<p><a href="test_iframe.html">IFrame Examples</a></p>
+<p><a href="test_event.html">Event Examples</a></p>
+
+</body>
+</html>

data/specs/app/modal_1.html

@@ -0,0 +1,41 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Modal Testing</title>
+    
+    <script>
+    function delay_action(other_function) {
+        setTimeout(other_function, 3000);
+    }
+    
+    function close_window() {
+        window.returnValue = 22
+        window.close()
+    }
+    
+    function modal1() {
+        var retValue = window.showModalDialog(
+            "modal_2.html", self,
+            "status:no;resizable:Yes;help:no;maximize:no;minimize:no;scrollbars:no;");
+    }
+    </script>
+</head>
+<body>
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Modal Page 1</h2>
+
+<h3>Close buttons</h3>
+
+<input id="close_window" type="button" onclick="close_window()" value="Close Window"/>
+<input id="delayed_close" type="button" onclick="delay_action('close_window()')" value="Close Window (with delay)" />
+
+<h3>Nested modal</h3>
+
+<input id="launch_modal" type="button" onclick='return modal1();' value="Launch Another Modal"/>
+
+
+
+</body>
+</html>

data/specs/app/modal_2.html

@@ -0,0 +1,29 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Modal Testing</title>
+    
+    <script>
+    function delay_action(other_function) {
+        setTimeout(other_function, 3000);
+    }
+    
+    function close_window() {
+        self.close()
+    }
+    </script>
+</head>
+<body>
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Modal Page 2</h2>
+
+<h3>Close buttons</h3>
+
+<input id="close_window2" type="button" onclick="close_window()" value="Close Window"/>
+<input id="delayed_close2" type="button" onclick="delay_action('close_window()')" value="Close Window (with delay)" />
+
+
+</body>
+</html>

data/specs/app/server.rb

@@ -0,0 +1,25 @@
+require 'webrick'
+
+class NonCachingFileHandler < WEBrick::HTTPServlet::FileHandler
+  def prevent_caching(res)
+    res['ETag']          = nil
+    res['Last-Modified'] = Time.now + 100**4
+    res['Cache-Control'] = 'no-store, no-cache, must-revalidate, post-check=0, pre-check=0'
+    res['Pragma']        = 'no-cache'
+    res['Expires']       = Time.now - 100**4
+  end
+  
+  def do_GET(req, res)
+    super
+    prevent_caching(res)
+  end
+end
+
+if $0 == __FILE__ then
+  server = WEBrick::HTTPServer.new(:Port => 1234, :AccessLog => [])
+  server.mount '/', NonCachingFileHandler , './'
+  ['INT', 'TERM'].each { |signal|
+    trap(signal) { server.stop }
+  }
+  server.start
+end

data/specs/app/style.css

@@ -0,0 +1,18 @@
+h1.title {
+    font-weight: normal;
+    font-size: 150%;
+    margin-left: 1px;
+    text-align: center;
+    border-bottom: thin solid;
+    font-family: 'Trebuchet MS', 'Lucida Grande', Verdana, Lucida, Geneva, Helvetica, Arial, sans-serif;
+}
+
+h2.subtitle {
+    border: #660000 0px solid;
+    padding: 0.2em 0.2em 0.2em 0px;
+    margin: 2em 1px 1px;
+    text-align: center;
+    font-weight: bold;
+    font-size: 120%;
+    color: #600;
+}

data/specs/app/success_1.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Success</title>
+</head>
+<body>
+    <h1 id="title">Success 1</h1>
+    
+    <p>This is the first success page.</p>
+</body>
+</html>

data/specs/app/success_2.html

@@ -0,0 +1,12 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Success</title>
+</head>
+<body>
+    <h1 id="title">Success 2</h1>
+    
+    <p>This is the second success page.</p>
+</body>
+</html>

data/specs/app/test_event.html

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Event Testing</title>
+    <link rel="stylesheet" href="style.css" />
+    
+    <script type="text/javascript">
+      function modal() {
+        var retValue = window.showModalDialog(
+          "modal_1.html", self,
+          "status:no;resizable:Yes;help:no;maximize:no;minimize:no;scrollbars:no;");
+      }
+    </script>
+</head>
+
+<body onload="document.senderForm.senderElement.focus()">
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Event Page</h2>
+
+<input id="alert_button" type="button" onclick="alert('I am an alert')" value="Alert">
+<input id="confirm_button" type="button" onclick="this.value = confirm('set the value')" value="Confirm">
+<input id="prompt_button" type="button" onclick='this.value = prompt("Favorite Sith Lord", "Darth Bane")' value="Prompt">
+
+
+<p><strong>Send To Another Page:</strong></p>
+<form action="" method="post" name="senderForm">
+<fieldset>
+    <input type="text" name="senderElement" id="senderElement" value="send_this_value" />
+    <input type="button" id="send" onclick="parent.frame2.document.recieverForm.recieverElement.value = document.senderForm.senderElement.value" value="Send!" />
+</fieldset>
+</form>
+
+<p><strong>Launch a Modal Dialog:</strong></p>
+<input id="modal" type="button" onclick='return modal();' value="Launch Modal Dialog" />
+
+</body>
+</html>

data/specs/app/test_form.html

@@ -0,0 +1,114 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Form Testing</title>
+    <link rel="stylesheet" href="style.css" />
+</head>
+<body>
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Form Page</h2>
+
+<h3>Connected Form Elements</h3>
+
+<form id="Login" name="Login" method="get" action="success_1.html">
+<table cellspacing="0" cellpadding="0" border="0" bgcolor="#ffffff" align="center" style="overflow:hidden;">
+    <tbody>
+    <tr>
+        <td style="padding-top:12px;">
+        <label id="lbl_server" class="Fld" no_help="true" for="server">Server:</label>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <input id="server" name="server" helpid="server" class="Fld" size="40" type="text" value="Test"/>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:12px;">
+        <label id="lbl_customerCode" class="Fld" no_help="true" for="customerCode">Customer ID:</label>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <input id="customerCode" name="customerCode" helpid="customerCode" class="Fld" size="40" type="text"/>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <label id="lbl_loginName" class="Fld" no_help="true" for="loginName">Login Name:</label>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <input id="loginName" name="loginName" helpid="loginName" class="Fld" size="40" type="text"/>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <label id="lbl_password" class="Fld" no_help="true" for="password">Password:</label>
+        </td>
+    </tr>
+    <tr>
+        <td style="padding-top:8px;">
+        <input id="password" name="password" helpid="password" class="Fld" size="40" type="text"/>
+        </td>
+    </tr>
+    <tr>
+        <td>
+        <input id="btnSubmit" name="btnSubmit" class="btn" type="submit" value="Log In">
+        </td>
+    </tr>
+    </tbody>
+</table>
+</form>
+    
+<hr />
+
+<h3>Standalone Form Elements</h3>
+    
+<div>
+<label id="lbl_title" no_help="true"><strong>Book Title:</strong></label><br />
+<input id="title" size="40" type="text"/><br />
+<label id="lbl_description" no_help="true"><strong>Description:</strong></label><br />
+<textarea rows="2" cols="80" id="description" class="text_area_class" name="description"></textarea>
+<input id="isbn" name="isbn" class="hidden_field_class" size="40" type="hidden" value="0-85131-041-9"/>
+</div>
+
+<div>
+<p><strong>Choose Your Physics Concepts:</strong></p>
+<select name="concepts" id="concepts", class="sel_list_class">
+<option value="option1">Quantum Entanglement</option>
+<option value="option2">Tachyonic Antitravel</option>
+<option value="option3">Bose-Einstein Condensates</option>
+</select>
+</div>
+    
+<div>
+<p><strong>Choose Your Futuristic Technology:</strong></p>
+<input id="camoarmor" name="camoarmor" class="cb_class" type="checkbox" value="1"/> Chameleoflage Armor<br />
+<input id="shunt" name="shunt" class="cb_class" type="checkbox" value="2"/> Neural Shunts<br />
+<input id="harpoon" name="harpoon" class="cb_class" type="checkbox" value="3"/> Kinetic Harpoons<br />
+<input id="oc" name="oc" class="cb_class" type="checkbox" value="4"/> Organic Circuitry
+</div>
+
+<div>
+<p><strong>Select Your Least Favorite Way To Vaporize:</strong></p>
+<form>
+<input type="radio" id="mtc" name="badstuff" class="rb_class" value="Multiphasic Temporal Convergence"> Multiphasic Temporal Convergence<br/>
+<input type="radio" id="ups" name="badstuff" class="rb_class" value="Unstable Phase Shift"> Unstable Phase Shift<br />
+<input type="radio" id="wcb" name="badstuff" class="rb_class" value="Warp Core Breach"> Warp Core Breach<br />
+</form>
+</div>
+
+
+<p><strong>Received Event Goes Here:</strong></p>
+<form action="" method="post" name="recieverForm">
+<fieldset>
+    <input type="text" name="recieverElement" value="old_value" />
+</fieldset>
+</form>
+
+</body>
+</html>

data/specs/app/test_frame.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Frame Testing</title>
+    <link rel="stylesheet" href="style.css" />
+</head>
+
+<frameset cols="40%, 40%, 22%">
+    <frame name="static" id="static" name="frame1" src="test_static.html" />
+    <frame name="form" id="form" name="frame2" src="test_form.html" />
+    <frame name="event" id="event" name="frame3" src="test_event.html" />
+</frameset>
+
+</html>

data/specs/app/test_iframe.html

@@ -0,0 +1,15 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Frame Testing</title>
+    <link rel="stylesheet" href="style.css" />
+</head>
+<body>
+
+<iframe name="static" id="static" name="frame1" class="iframe" width="500" src="test_static.html"></iframe>
+<br />
+<iframe name="form" id="form" name="frame2" class="iframe" width="500" src="test_form.html"></iframe>
+
+</body>
+</html>

data/specs/app/test_static.html

@@ -0,0 +1,92 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="utf-8">
+    <title>Test App - Static Text Testing</title>
+    <link rel="stylesheet" href="style.css" />
+</head>
+<body>
+
+<h1 class="title">Testing with Terminus</h1>
+<h2 class="subtitle">Static Text Page</h2>
+
+
+<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 href="success_1.html">Justice League Assemble</a></p>
+<p><a href="success_2.html">Justice League Assemble</a></p>
+
+<p><a id="oath" href="success_1.html">"...in the brightest day and in the darkest night..."</a></p>
+
+<hr />
+
+<h3>Lists</h3>
+
+<h4>Unordered List</h4>
+
+<ul id="ul_id" name="ul_name" class="ul_class">
+    <li id="li_id" name="li_name" class="li_class">Darth Nihilus</li>
+    <li>Darth Plagueis</li>
+    <li>Darth Sidious</li>
+</ul>
+
+<h4>Ordered List</h4>
+
+<ol id="ol_id" name="ol_name" class="ol_class">
+    <li>USS Enterprise XCV 330</li>
+    <li>USS Enterprise NX-01</li>
+    <li>USS Enterprise NCC-1701</li>
+</ol>
+
+<hr />
+
+<h3>Sections</h3>
+
+<div id="div_id" name="div_name" class="div_class">
+This text is stored directly inside a DIV element.
+</div>
+
+<span id="span_id" name="span_name" class="span_class">
+This text is stored directly inside a SPAN element.
+</span>
+
+<hr />
+
+<h3>Tables</h3>
+
+<table id='table_id' name='table_name' class='table_class' border='1'>
+  <thead>
+    <tr>
+      <th>Month</th>
+      <th>Savings</th>
+    </tr>
+  </thead>
+  <tfoot>
+    <tr>
+      <td>Sum</td>
+      <td>$180</td>
+    </tr>
+  </tfoot>
+  <tbody>
+    <tr>
+      <td>January</td>
+      <td id='cell_id' name='cell_name' class='cell_class'>$100</td>
+    </tr>
+    <tr>
+      <td>February</td>
+      <td>$80</td>
+    </tr>
+  </tbody>
+</table> 
+
+<hr />
+
+<p>Technically an image isn't static text, but whatever ...</p>
+
+<img src="images/mass_extinction.jpg" id="extinct" name="extinct" class="image_class">
+
+
+</body>
+</html>

data/specs/engine/borg.rb

@@ -0,0 +1,24 @@
+$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '../../', 'lib'))
+
+require 'watir-webdriver'
+require 'selenium-webdriver'
+
+require "spectest"
+
+module SpecTest
+  module Browser
+    @browser = false
+
+    def self.start
+      unless @browser
+        @browser = Watir::Browser.new(ENV['BROWSER']) if ENV['DRIVER'] == 'watir'
+        @browser = Selenium::WebDriver.for(ENV['BROWSER'].to_sym) if ENV['DRIVER'] == 'selenium'
+      end
+      return @browser
+    end
+
+    def self.stop
+      @browser.quit if @browser
+    end
+  end
+end

data/specs/engine/hooks.rb

@@ -0,0 +1,18 @@
+Before do
+  @browser = SpecTest::Browser.start
+end
+
+After do |scenario|
+  # I don't believe the following line works at all because I don't think Cucumber
+  # (on Windows at least) actually runs the After logic unless a scenario is either
+  # failing or succeeding. I'll keep this line in until I can investigate further.
+  @KEEP_OPEN = true if scenario.status == :pending or scenario.status == :undefined
+end
+
+AfterConfiguration do |config|
+  puts("Tests are being executed from: #{config.feature_dirs}")
+end
+
+at_exit do
+  SpecTest::Browser.stop if not @KEEP_OPEN
+end

data/specs/pages/landing_page.rb

@@ -0,0 +1,4 @@
+class LandingPage
+  include SpecTest
+  
+end

data/specs/steps/page_steps.rb

@@ -0,0 +1,11 @@
+Given /^I have gone to the test app site$/ do
+  @page = LandingPage.new(@browser)
+  @page.navigate_to("http://localhost:1234")
+end
+
+Then /^I should be on the landing page$/ do
+  #@page.text.should match(/^Landing Page$/)
+  #@page.title.should match(/^Test App$/)
+  @page.text.should contain("Landing Page")
+  @page.title.should have_title("Test App")
+end

data/specs/tests/page.feature

@@ -0,0 +1,9 @@
+Feature: Ability to support page viewing.
+
+As a test writer,
+I need the ability to get to pages
+so that I can actually do some testing.
+
+Scenario: Navigating to a page.
+  Given I have gone to the test app site
+  Then I should be on the landing page

data/spectest.gemspec

@@ -26,4 +26,5 @@ Gem::Specification.new do |s|
 
   s.add_development_dependency 'rspec', '>= 2.7.0'
   s.add_development_dependency 'cucumber', '>= 1.1.2'
+  s.add_development_dependency 'simplecov', '>= 0.5.4'
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: spectest
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
   prerelease: 
 platform: ruby
 authors:
@@ -9,11 +9,11 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2011-11-12 00:00:00.000000000Z
+date: 2011-11-13 00:00:00.000000000Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: watir-webdriver
-  requirement: &2229264 !ruby/object:Gem::Requirement
+  requirement: &4716876 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -21,10 +21,10 @@ dependencies:
         version: 0.3.9
   type: :runtime
   prerelease: false
-  version_requirements: *2229264
+  version_requirements: *4716876
 - !ruby/object:Gem::Dependency
   name: selenium-webdriver
-  requirement: &2227284 !ruby/object:Gem::Requirement
+  requirement: &4715880 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -32,10 +32,10 @@ dependencies:
         version: 2.12.1
   type: :runtime
   prerelease: false
-  version_requirements: *2227284
+  version_requirements: *4715880
 - !ruby/object:Gem::Dependency
   name: rspec
-  requirement: &2226504 !ruby/object:Gem::Requirement
+  requirement: &4715268 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -43,10 +43,10 @@ dependencies:
         version: 2.7.0
   type: :development
   prerelease: false
-  version_requirements: *2226504
+  version_requirements: *4715268
 - !ruby/object:Gem::Dependency
   name: cucumber
-  requirement: &2225508 !ruby/object:Gem::Requirement
+  requirement: &4714728 !ruby/object:Gem::Requirement
     none: false
     requirements:
     - - ! '>='
@@ -54,7 +54,18 @@ dependencies:
         version: 1.1.2
   type: :development
   prerelease: false
-  version_requirements: *2225508
+  version_requirements: *4714728
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: &4714200 !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 0.5.4
+  type: :development
+  prerelease: false
+  version_requirements: *4714200
 description: Test framework for specifying tests and executing tests.
 email:
 - jeffnyman@gmail.com
@@ -63,13 +74,49 @@ extensions: []
 extra_rdoc_files: []
 files:
 - .gitignore
+- .travis.yml
 - Gemfile
 - HISTORY.md
 - LICENSE
 - README.md
 - Rakefile
+- cucumber.yml
 - lib/spectest.rb
+- lib/spectest/logger.rb
+- lib/spectest/matchers.rb
+- lib/spectest/platform_selenium.rb
+- lib/spectest/platform_selenium/platform_object.rb
+- lib/spectest/platform_watir.rb
+- lib/spectest/platform_watir/platform_object.rb
+- lib/spectest/platforms.rb
 - lib/spectest/version.rb
+- spec/browser_level_spec.rb
+- spec/page_level_spec.rb
+- spec/platform_object_spec.rb
+- spec/platform_selenium_spec.rb
+- spec/platform_watir_spec.rb
+- spec/platforms_spec.rb
+- spec/spec_helper.rb
+- spec/spectest_spec.rb
+- specs/app/favicon.ico
+- specs/app/images/mass_extinction.jpg
+- specs/app/index.html
+- specs/app/modal_1.html
+- specs/app/modal_2.html
+- specs/app/server.rb
+- specs/app/style.css
+- specs/app/success_1.html
+- specs/app/success_2.html
+- specs/app/test_event.html
+- specs/app/test_form.html
+- specs/app/test_frame.html
+- specs/app/test_iframe.html
+- specs/app/test_static.html
+- specs/engine/borg.rb
+- specs/engine/hooks.rb
+- specs/pages/landing_page.rb
+- specs/steps/page_steps.rb
+- specs/tests/page.feature
 - spectest.gemspec
 homepage: https://github.com/jnyman/spectest
 licenses: