spectie 0.0.3

data/spec/selenium_config.rb

@@ -0,0 +1,11 @@
+Spec::Runner.configure do |config|
+  config.selenium.driver_options = {
+    :host => "10.211.55.127",
+    :port => 4444,
+    :browser => "*firefox",
+    :timeout_in_seconds => 300,
+    :url => "http://10.211.55.1:4567"
+  }
+  config.selenium.start_browser_once = true
+  config.selenium.controlled = false
+end

data/spec/spec_helper.rb

@@ -0,0 +1,10 @@
+require File.expand_path(File.dirname(__FILE__) + "/example_run_state_tracking")
+
+require File.expand_path(File.dirname(__FILE__) + "/../initialize")
+
+$LOAD_PATH.unshift File.expand_path(File.join(File.dirname(__FILE__), '..', 'lib'))
+require 'spectie'
+
+Spec::Runner.configure do |config|
+  config.mock_with :mocha
+end

data/spec/spectie/rails_helper.rb

@@ -0,0 +1,29 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+Dir[File.expand_path(File.dirname(__FILE__) + "/../../vendor/rails/*/lib")].each do |rails_lib|
+  $:.unshift rails_lib
+end
+
+ENV["RAILS_ENV"] = "test"
+$:.unshift File.expand_path(File.dirname(__FILE__) + "/../support/rails_app/controllers")
+
+require "initializer"
+require "action_controller"
+
+ActionController::Base.session = {:key => "_myapp_session", :secret => "a"*30}
+
+require "spectie/rails"
+
+module HelperToTestRailsIntegration
+  def method_missing(method, *args, &block)
+    if method.to_sym == :i_dont_exist_in_the_integration_session
+      # handled here
+    else
+      super
+    end
+  end
+end
+
+Spec::Runner.configure do |config|
+  config.include HelperToTestRailsIntegration
+end

data/spec/spectie/rails_story_example_group_spec.rb

@@ -0,0 +1,59 @@
+require File.expand_path(File.dirname(__FILE__) + "/rails_helper")
+
+class TestsController < ApplicationController
+  def index; render :text => "<p>Hello there!</p>" end
+end
+# Not sure why the following line needs to exist, I would think it'd just use the default routes from routes.rb,
+# but apparently not. Need to figure out why, but not now.
+ActionController::Routing::Routes.add_route "/tests/:action", :controller => "tests"
+
+module Spectie
+  describe "Rails Stories" do
+
+    track_example_run_state
+
+    it "is registered by default for the 'integration' behavior type" do
+      created_example_group = Spec::Example::ExampleGroupFactory.create_example_group(:type => :integration) {}
+      created_example_group.superclass.should == RailsStoryExampleGroup
+    end
+
+    it "can include a helper module that defines method_missing" do
+      (example_group = Class.new(RailsStoryExampleGroup)).class_eval do
+        Scenario "I'm going to call a method that doesn't exist in the integration session" do
+          i_dont_exist_in_the_integration_session
+        end
+      end
+
+      @options.run_examples
+
+      example.should be_successful
+    end
+
+    it "can make a controller request and inspect the response" do
+      example_group = Class.new(RailsStoryExampleGroup)
+      example_group.Scenario "Make a request to a controller" do
+        Given :i_want_to_write_an_integration_test_for_rails
+        When  :i_make_a_controller_request
+        Then  :i_can_assert_the_response
+      end
+      
+      example_group.class_eval do
+        def i_want_to_write_an_integration_test_for_rails; end
+        
+        def i_make_a_controller_request
+          get "/tests"
+        end
+
+        def i_can_assert_the_response
+          response.should be_success
+          response.should have_tag("p", "Hello there!")
+        end
+      end
+
+      example_group.run(@options)
+
+      example.should_not be_failed
+    end
+
+  end
+end

data/spec/spectie/selenium/configuration_spec.rb

@@ -0,0 +1,91 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+module Spectie
+  module Configuration
+    describe Selenium do
+      it "creates a configuration the first time it's accessed" do
+        Spec::Runner.configuration.selenium.should_not be_nil
+        Spec::Runner.configuration.selenium.class.should == Selenium
+      end
+      
+      it "provides driver options" do
+        config = Selenium.new
+        config.driver_options = "blah"
+        config.driver_options.should == "blah"
+      end
+
+      it "raises an error if driver options are not set before they're accessed" do
+        config = Selenium.new
+        lambda { config.driver_options }.should raise_error
+      end
+
+      describe "affect on example group runs" do
+        track_example_run_state
+
+        it "only starts the driver once for multiple example groups if browser reset instead of restart is enabled" do
+          @original_value = Spec::Runner.configuration.selenium.start_browser_once
+          begin
+            start_call_count = 0
+            ::Selenium::Client::Driver.stubs(:new).
+              returns(mock_driver = stub_everything("mock selenium driver"))
+            mock_driver.stubs(:start).with { start_call_count += 1; true }
+              
+            Spec::Runner.configuration.selenium.start_browser_once = true
+
+            example_group1 = Class.new(SeleniumStoryExampleGroup)
+            example_group1.class_eval do
+              def teardown_mocks_for_rspec
+                # do nothing so that the mock persists through to the second example group
+              end
+            end
+            example_group1.Scenario "The selenium driver is started once" do
+              start_call_count.should == 1
+            end
+            example_group2 = Class.new(SeleniumStoryExampleGroup)
+            example_group2.Scenario "The selenium driver is still started once" do
+              start_call_count.should == 1
+            end
+
+            with_selenium_control { @options.run_examples }
+            example.should be_successful
+          ensure
+            Spec::Runner.configuration.selenium.start_browser_once = @original_value
+          end
+        end
+
+        it "starts the driver for each example if browser reset instead of restart is disabled" do
+          @original_value = Spec::Runner.configuration.selenium.start_browser_once
+          begin
+            start_call_count = 0
+            ::Selenium::Client::Driver.stubs(:new).
+              returns(mock_driver = stub_everything("mock selenium driver"))
+            mock_driver.stubs(:start).with { start_call_count += 1; true }
+
+            Spec::Runner.configuration.selenium.start_browser_once = false
+
+            example_group1 = Class.new(SeleniumStoryExampleGroup)
+            example_group1.class_eval do
+              def teardown_mocks_for_rspec
+                # do nothing so that the mock persists through to the second example group
+              end
+            end
+            example_group1.Scenario "The selenium driver is started once" do
+              start_call_count.should == 1
+            end
+            example_group2 = Class.new(SeleniumStoryExampleGroup)
+            example_group2.Scenario "The selenium driver is started twice" do
+              start_call_count.should == 2
+            end
+            
+            with_selenium_control { @options.run_examples }
+            example.should be_successful
+          ensure
+            Spec::Runner.configuration.selenium.start_browser_once = @original_value
+          end
+        end
+
+      end
+
+    end
+  end
+end

data/spec/spectie/selenium/spec_helper.rb

@@ -0,0 +1,16 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")
+require "spectie/selenium"
+require File.expand_path(File.dirname(__FILE__) + "/../../selenium_config")
+
+module SeleniumStoryExampleGroupTestingHelper
+  def with_selenium_control
+    Spec::Runner.configuration.selenium.controlled = true
+    yield
+  ensure
+    Spec::Runner.configuration.selenium.controlled = false
+  end
+end
+
+Spec::Runner.configure do |config|
+  config.include(SeleniumStoryExampleGroupTestingHelper)
+end

data/spec/spectie/selenium/story_example_group_spec.rb

@@ -0,0 +1,132 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+module Spectie
+  describe "Selenium Stories" do
+
+    track_example_run_state
+
+    it "can open a path, inspect response, and interact with elements" do
+      example_group = Class.new(SeleniumStoryExampleGroup)
+      example_group.Scenario "Open a page and click on a link" do
+        Given :i_am_on_a_page_with_a_link
+        When  :i_click_a_link
+        Then  :i_go_to_the_destination
+      end
+
+      example_group.class_eval do
+        def i_am_on_a_page_with_a_link
+          open "/"
+          wait_for_text "Whazzup!?"
+        end
+        def i_click_a_link
+          wait_for_element "link=Click me"
+          click "link=Click me"
+        end
+        def i_go_to_the_destination
+          wait_for_text "Booyah!"
+        end
+      end
+
+      with_selenium_control { @options.run_examples }
+
+      example.should be_successful
+    end
+
+    share_examples_for "the browser is in a consistent state for each example" do
+      it "supports a session for each example in a group" do
+        example_group = Class.new(SeleniumStoryExampleGroup)
+        example_group.Scenario "I can see my session info when I log in" do
+          Given :i_log_in
+          When  :i_am_sent_back_to_the_home_page
+          Then  :i_see_session_info
+        end
+        example_group.Scenario "I can't see the session info from the last example" do
+          Given :i_am_a_guest_user
+          When  :i_am_on_the_home_page
+          Then  :i_dont_see_the_session_info_of_the_last_user
+        end
+
+        example_group.class_eval do
+          class << self
+            attr_accessor :login
+          end
+          def login; self.class.login end
+        end
+        example_group.login = "joeschmoe"
+
+        example_group.class_eval do
+          def i_log_in
+            open "/"
+            type "id=login", login
+            click "id=submit_login"
+          end
+          def i_am_sent_back_to_the_home_page
+            wait_for_page_to_load
+            wait_for_text "Whazzup!?"
+          end
+          def i_see_session_info
+            wait_for_text login
+          end
+          def i_am_a_guest_user; end
+          def i_am_on_the_home_page
+            open "/"
+          end
+          def i_dont_see_the_session_info_of_the_last_user
+            text?(login).should be_false
+          end
+        end
+
+        with_selenium_control { @options.run_examples }
+
+        example.should be_successful
+      end
+
+      it "deletes all cookies between each example" do
+        example_group = Class.new(SeleniumStoryExampleGroup)
+        example_group.Scenario "I do something that creates cookies" do
+          Given :i_create_a_bunch_of_cookies
+        end
+        example_group.Scenario "I have no cookies :(" do
+          Then  :i_have_no_cookies
+        end
+
+        example_group.class_eval do
+          def i_create_a_bunch_of_cookies
+            create_cookie "a=1"
+            create_cookie "b=2"
+            cookies.should == "a=1; b=2"
+          end
+          def i_have_no_cookies
+            cookies.should == ""
+          end
+        end
+
+        with_selenium_control { @options.run_examples }
+
+        example.should be_successful
+      end
+    end
+
+    describe "browser restart before each example" do
+      it_should_behave_like "the browser is in a consistent state for each example"
+      before :each do
+        @original_value = Spec::Runner.configuration.selenium.start_browser_once
+        Spec::Runner.configuration.selenium.start_browser_once = false
+      end
+      after :each do
+        Spec::Runner.configuration.selenium.start_browser_once = @original_value
+      end
+    end
+
+    describe "browser reset instead of restart before each example" do
+      it_should_behave_like "the browser is in a consistent state for each example"
+      before :each do
+        @original_value = Spec::Runner.configuration.selenium.start_browser_once
+        Spec::Runner.configuration.selenium.start_browser_once = true
+      end
+      after :each do
+        Spec::Runner.configuration.selenium.start_browser_once = @original_value
+      end
+    end
+  end
+end

data/spec/spectie/spec_helper.rb

@@ -0,0 +1 @@
+require File.expand_path(File.dirname(__FILE__) + "/../spec_helper")

data/spec/spectie/story_example_group_methods_spec.rb

@@ -0,0 +1,217 @@
+require File.expand_path(File.dirname(__FILE__) + "/spec_helper")
+
+module Spectie
+
+  class StoryExampleGroup
+    include StoryExampleGroupMethods
+  end
+
+  describe StoryExampleGroup do
+
+    track_example_run_state
+
+    it "supports 'xScenario' method for disabling an example" do
+      example_group = Class.new(StoryExampleGroup)
+      example_ran_as_scenario = false
+      Kernel.expects(:warn).with { |message| message =~ /^Example disabled/  }
+
+      example_group.xScenario "As a user, I want to make a series of requests for our mutual benefit" do
+        example_ran_as_scenario = true
+      end
+      example_group.run(@options)
+
+      example_ran_as_scenario.should be_false
+    end
+
+    it "supports pending scenarios" do
+      example_group = Class.new(StoryExampleGroup)
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit"
+      @options.reporter.expects(:example_finished).with(anything, ::Spec::Example::ExamplePendingError)
+
+      example_group.run(@options)
+    end
+
+    it "supports 'scenario' method for creating an example" do
+      example_group = Class.new(StoryExampleGroup)
+      example_ran_as_scenario = false
+
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+        example_ran_as_scenario = true
+      end
+      example_group.run(@options)
+
+      example_ran_as_scenario.should be_true
+    end
+
+    [:Given, :When, :Then, :And].each do |scenario_method|
+      it "can use #{scenario_method} to call scenario statements from within the scenario" do
+        example_group = Class.new(StoryExampleGroup) do
+          class << self
+            attr_accessor :scenario_statement_was_executed
+          end
+        end
+
+        example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+          send scenario_method, :i_am_executed
+        end
+
+        example_group.class_eval do
+          def i_am_executed
+            self.class.scenario_statement_was_executed = true
+          end
+        end
+        example_group.run(@options)
+
+        example_group.scenario_statement_was_executed.should be_true
+      end
+    end
+
+    it "has access to the scenario statements defined on a parent example group" do
+      parent_example_group = Class.new(StoryExampleGroup) do
+        class << self
+          attr_accessor :scenario_statement_was_executed
+        end
+      end
+      parent_example_group.class_eval do
+        def i_am_executed
+          self.class.scenario_statement_was_executed = true
+        end
+      end
+      example_group = Class.new(parent_example_group)
+
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+        Given :i_am_executed
+      end
+      example_group.run(@options)
+
+      example_group.scenario_statement_was_executed.should be_true
+    end
+
+    it "can override the definition of a scenario statement on a parent example group" do
+      parent_example_group = Class.new(StoryExampleGroup) do
+        class << self
+          attr_accessor :scenario_statement_was_executed
+        end
+      end
+      parent_example_group.class_eval do
+        def i_am_executed
+          self.class.scenario_statement_was_executed = "parent"
+        end
+      end
+      example_group = Class.new(parent_example_group)
+      example_group.class_eval do
+        def i_am_executed
+          self.class.scenario_statement_was_executed = "child"
+        end
+      end
+
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+        Given :i_am_executed
+      end
+      example_group.run(@options)
+
+      example_group.scenario_statement_was_executed.should == "child"
+    end
+
+    it "supports scenario statement nesting" do
+      example_group = Class.new(StoryExampleGroup)
+      example_group.class_eval do
+        class << self
+          attr_accessor :nested_statement_was_executed
+        end
+      end
+      example_group.Scenario "As a tester, I want to be able to write nested dsl statements" do
+        Given :this_statement_takes_a_block do 
+          Then :i_can_nest_a_statement
+        end
+      end
+      example_group.class_eval do 
+        def this_statement_takes_a_block
+          yield
+        end
+        def i_can_nest_a_statement
+          self.class.nested_statement_was_executed = true
+        end
+      end
+
+      example_group.run(@options)
+
+      example.should_not be_failed
+      example_group.nested_statement_was_executed.should be_true
+    end
+
+    xit "handles scenario statements that start with 'should'" do
+      # This example doesn't quite describe the issue. For some reason,
+      # RSpec treates methods inside an example group that start with 
+      # 'should' differently, and counts them as examples. Need to 
+      # figure out why before going any futher w/this.
+      example_group = Class.new(StoryExampleGroup)
+      example_group.class_eval do 
+        class << self
+          attr_accessor :called_the_method
+        end
+      end
+      example_group.Scenario "As a tester, I want to start a scenario statement with 'should'" do
+        Given :this_statement_calls_a_method_starting_with_should
+      end
+      example_group.class_eval do 
+        def this_statement_calls_a_method_starting_with_should
+          should_do_something
+        end
+        def should_do_something
+          self.class.called_the_method = true
+          1.should == 1
+        end
+      end
+
+      example_group.run(@options)
+
+      example_group.called_the_method.should be_true
+      example.should_not be_failed
+    end
+
+    it "shares state between the scenario and the scenario statements" do
+      example_group = Class.new(StoryExampleGroup)
+
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+        Given :the_example_has_state
+        @state.should == 1
+        @state = 2
+        Then  :the_state_is_shared
+      end
+
+      example_group.class_eval do
+        def the_example_has_state
+          @state = 1
+        end
+        def the_state_is_shared
+          @state.should == 2
+        end
+      end
+      example_group.run(@options)
+
+      example.should_not be_failed
+    end
+
+    it "can invoke any method defined in the example group as a scenario statement" do
+      example_group = Class.new(StoryExampleGroup)
+      example_group.class_eval do
+        class << self
+          attr_accessor :normal_method_executed
+        end
+        def a_normal_method_defined_in_the_example_group
+          self.class.normal_method_executed = true
+        end
+      end
+
+      example_group.Scenario "As a user, I want to make a series of requests for our mutual benefit" do
+        Given :a_normal_method_defined_in_the_example_group
+      end
+
+      example_group.run(@options)
+
+      example.should_not be_failed
+      example_group.normal_method_executed.should be_true
+    end
+  end
+end