rspec 1.0.0 → 1.3.1

data/examples/{multi_threaded_behaviour_runner.rb → passing/multi_threaded_example_group_runner.rb}

@@ -1,25 +1,26 @@
-
-class MultiThreadedBehaviourRunner < Spec::Runner::BehaviourRunner
-  def initialize(options)
-    super
+class MultiThreadedExampleGroupRunner < Spec::Runner::ExampleGroupRunner
+  def initialize(options, arg)
+    super(options)
     # configure these
     @thread_count = 4
     @thread_wait = 0
   end
 
-  def run_behaviours(behaviours)
+  def run
     @threads = []
     q = Queue.new
-    behaviours.each { |b| q << b}
+    example_groups.each { |b| q << b}
+    success = true
     @thread_count.times do
       @threads << Thread.new(q) do |queue|
         while not queue.empty?
-          behaviour = queue.pop
-          behaviour.run(@options.reporter, @options.dry_run, @options.reverse)
+          example_group = queue.pop
+          success &= example_group.suite.run(nil)
         end
       end
       sleep @thread_wait
     end
     @threads.each {|t| t.join}
+    success
   end
-end
+end

data/examples/passing/nested_classes_example.rb

@@ -0,0 +1,35 @@
+require 'examples/passing/stack'
+
+class StackExamples < Spec::ExampleGroup
+  describe(Stack)
+  before(:each) do
+    @stack = Stack.new
+  end
+end
+
+class EmptyStackExamples < StackExamples
+  describe("when empty")
+  it "should be empty" do
+    @stack.should be_empty
+  end
+end
+
+class AlmostFullStackExamples < StackExamples
+  describe("when almost full")
+  before(:each) do
+    (1..9).each {|n| @stack.push n}
+  end
+  it "should be full" do
+    @stack.should_not be_full
+  end
+end
+
+class FullStackExamples < StackExamples
+  describe("when full")
+  before(:each) do
+    (1..10).each {|n| @stack.push n}
+  end
+  it "should be full" do
+    @stack.should be_full
+  end
+end

data/examples/passing/options_example.rb

@@ -0,0 +1,29 @@
+# This demonstrates the use of the options hash to support custom reporting.
+# To see the result, run this command from the project root:
+# 
+#   bin/spec --require examples/passing/options_formatter.rb examples/passing/options_example.rb \
+#     --format OptionsFormatter
+
+describe "this group will be reported", :report => true do
+  it "this example will be reported", :report => true do
+    # no-op
+  end
+
+  it "this example will not be reported", :report => false do
+    # no-op
+  end
+
+  it "this example will also not be reported", :foo => 'bar' do
+    # no-op
+  end
+
+  it "this example will also also not be reported" do
+    # no-op
+  end
+end
+
+describe "this group will not be reported", :report => false do
+  it "though this example will", :report => true do
+    # no-op
+  end
+end

data/examples/passing/options_formatter.rb

@@ -0,0 +1,20 @@
+# This is an example of how you can use a custom formatter to do custom
+# reporting. This formatter will only report example groups and examples that
+# have :report => true (or anything truthy) in the declaration. See
+# options_example.rb in this directory.  
+
+require 'spec/runner/formatter/base_text_formatter'
+
+class OptionsFormatter < Spec::Runner::Formatter::BaseTextFormatter
+  def example_started(proxy)
+    if proxy.options[:report]
+      puts proxy.description
+    end
+  end
+
+  def example_group_started(proxy)
+    if proxy.options[:report]
+      puts proxy.description
+    end
+  end
+end

data/examples/{partial_mock_example.rb → passing/partial_mock_example.rb}

@@ -1,5 +1,3 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
 class MockableClass
   def self.find id
     return :original_return
@@ -25,4 +23,5 @@ describe "A partial mock" do
     MockableClass.msg_2
     MockableClass.msg_3
   end
-end
+
+end

data/examples/passing/pending_example.rb

@@ -0,0 +1,18 @@
+describe "pending example (using pending method)" do
+  it %Q|should be reported as "PENDING: for some reason"| do
+    pending("for some reason")
+  end
+end
+
+describe "pending example (with no block)" do
+  it %Q|should be reported as "PENDING: Not Yet Implemented"|
+end
+
+describe "pending example (with block for pending)" do
+  it %Q|should have a failing block, passed to pending, reported as "PENDING: for some reason"| do
+    pending("for some reason") do
+      raise "some reason"
+    end
+  end
+end
+

data/examples/{predicate_example.rb → passing/predicate_example.rb}

@@ -1,5 +1,3 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
 class BddFramework
   def intuitive?
     true
@@ -24,4 +22,4 @@ describe "BDD framework" do
     @bdd_framework.should be_intuitive
   end
 
-end
+end

data/examples/{shared_behaviours_example.rb → passing/shared_example_group_example.rb}

@@ -1,6 +1,4 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
-module SharedBehaviourExample
+module SharedExampleGroupExample
   class OneThing
     def what_things_do
       "stuff"
@@ -13,7 +11,15 @@ module SharedBehaviourExample
     end
   end
   
-  describe "All Things", :shared => true do
+  class YetAnotherThing
+    def what_things_do
+      "stuff"
+    end
+  end
+  
+  # A SharedExampleGroup is an example group that doesn't get run.
+  # You can create one like this:
+  share_examples_for "most things" do
     def helper_method
       "helper method"
     end
@@ -24,16 +30,14 @@ module SharedBehaviourExample
   end
 
   describe OneThing do
-    it_should_behave_like "All Things"
+    # Now you can include the shared example group like this, which 
+    # feels more like what you might say ...
+    it_should_behave_like "most things"
+    
     before(:each) { @thing = OneThing.new }
     
-    it "should have access to helper methods defined in the shared behaviour" do
+    it "should have access to helper methods defined in the shared example group" do
       helper_method.should == "helper method"
     end
   end
-
-  describe AnotherThing do
-    it_should_behave_like "All Things"
-    before(:each) { @thing = AnotherThing.new }
-  end
 end

data/examples/passing/shared_stack_examples.rb

@@ -0,0 +1,36 @@
+shared_examples_for "non-empty Stack" do
+
+  it { @stack.should_not be_empty }
+  
+  it "should return the top item when sent #peek" do
+    @stack.peek.should == @last_item_added
+  end
+  
+  it "should NOT remove the top item when sent #peek" do
+    @stack.peek.should == @last_item_added
+    @stack.peek.should == @last_item_added
+  end
+  
+  it "should return the top item when sent #pop" do
+    @stack.pop.should == @last_item_added
+  end
+  
+  it "should remove the top item when sent #pop" do
+    @stack.pop.should == @last_item_added
+    unless @stack.empty?
+      @stack.pop.should_not == @last_item_added
+    end
+  end
+  
+end
+
+shared_examples_for "non-full Stack" do
+
+  it { @stack.should_not be_full }
+
+  it "should add to the top when sent #push" do
+    @stack.push "newly added top item"
+    @stack.peek.should == "newly added top item"
+  end
+
+end

data/examples/passing/simple_matcher_example.rb

@@ -0,0 +1,29 @@
+describe "arrays" do
+  Spec::Matchers.define :contain_same_elements_as do |expected|
+    match do |actual|
+      if actual.size == expected.size
+        a, e = actual.dup, expected.dup
+        until e.empty? do
+          if i = a.index(e.pop) then a.delete_at(i) end
+        end
+        a.empty?
+      else
+        false
+      end
+    end
+  end
+  
+  describe "can be matched by their contents disregarding order" do
+    subject { [1,2,2,3] }
+    it { should contain_same_elements_as([1,2,2,3]) }
+    it { should contain_same_elements_as([2,3,2,1]) }
+    it { should_not contain_same_elements_as([3,3,2,1]) }
+  end
+  
+  describe "fail the match with different contents" do
+    subject { [1,2,3] }
+    it { should_not contain_same_elements_as([2,3,4])}
+    it { should_not contain_same_elements_as([1,2,2,3])}
+    it { should_not contain_same_elements_as([1,2])}
+  end
+end

data/examples/{stack.rb → passing/stack.rb}

@@ -33,4 +33,4 @@ class Stack
     @items.length == 10
   end
   
-end
+end

data/examples/{stack_spec.rb → passing/stack_spec.rb}

@@ -1,48 +1,14 @@
-require File.dirname(__FILE__) + '/spec_helper'
-require File.dirname(__FILE__) + "/stack"
-
-describe "non-empty Stack", :shared => true do
-  # NOTE that this one auto-generates the description "should not be empty"
-  it { @stack.should_not be_empty }
-  
-  it "should return the top item when sent #peek" do
-    @stack.peek.should == @last_item_added
-  end
-
-  it "should NOT remove the top item when sent #peek" do
-    @stack.peek.should == @last_item_added
-    @stack.peek.should == @last_item_added
-  end
-  
-  it "should return the top item when sent #pop" do
-    @stack.pop.should == @last_item_added
-  end
-  
-  it "should remove the top item when sent #pop" do
-    @stack.pop.should == @last_item_added
-    unless @stack.empty?
-      @stack.pop.should_not == @last_item_added
-    end
-  end
-end
-
-describe "non-full Stack", :shared => true do
-  # NOTE that this one auto-generates the description "should not be full"
-  it { @stack.should_not be_full }
-
-  it "should add to the top when sent #push" do
-    @stack.push "newly added top item"
-    @stack.peek.should == "newly added top item"
-  end
-end
+require 'examples/passing/stack'
+require 'examples/passing/shared_stack_examples'
 
 describe Stack, " (empty)" do
   before(:each) do
     @stack = Stack.new
   end
   
-  # NOTE that this one auto-generates the description "should be empty"
-  it { @stack.should be_empty }
+  # This uses @stack (because the described class is Stack) auto-generates the
+  # description "should be empty"
+  it { should be_empty }
   
   it_should_behave_like "non-full Stack"
   
@@ -94,4 +60,4 @@ describe Stack, " (full)" do
     lambda { @stack.push Object.new }.should raise_error(StackOverflowError)
   end
   
-end
+end

data/examples/passing/stack_spec_with_nested_example_groups.rb

@@ -0,0 +1,66 @@
+require 'examples/passing/stack'
+require 'examples/passing/shared_stack_examples'
+
+describe Stack do
+  
+  before(:each) do
+    @stack = Stack.new
+  end
+
+  describe "(empty)" do
+
+    it { @stack.should be_empty }
+  
+    it_should_behave_like "non-full Stack"
+  
+    it "should complain when sent #peek" do
+      lambda { @stack.peek }.should raise_error(StackUnderflowError)
+    end
+  
+    it "should complain when sent #pop" do
+      lambda { @stack.pop }.should raise_error(StackUnderflowError)
+    end
+
+  end
+
+  describe "(with one item)" do
+    
+    before(:each) do
+      @stack.push 3
+      @last_item_added = 3
+    end
+
+    it_should_behave_like "non-empty Stack"
+    it_should_behave_like "non-full Stack"
+
+  end
+
+  describe "(with one item less than capacity)" do
+    
+    before(:each) do
+      (1..9).each { |i| @stack.push i }
+      @last_item_added = 9
+    end
+  
+    it_should_behave_like "non-empty Stack"
+    it_should_behave_like "non-full Stack"
+  end
+
+  describe "(full)" do
+    
+    before(:each) do
+      (1..10).each { |i| @stack.push i }
+      @last_item_added = 10
+    end
+
+    it { @stack.should be_full }  
+
+    it_should_behave_like "non-empty Stack"
+
+    it "should complain on #push" do
+      lambda { @stack.push Object.new }.should raise_error(StackOverflowError)
+    end
+  
+  end
+
+end

data/examples/{stubbing_example.rb → passing/stubbing_example.rb}

@@ -1,5 +1,3 @@
-require File.dirname(__FILE__) + '/spec_helper'
-
 describe "A consumer of a stub" do
   it "should be able to stub methods on any Object" do
     obj = Object.new
@@ -66,4 +64,4 @@ describe "A mock" do
   end
 end
 
-    
+    

data/examples/passing/yielding_example.rb

@@ -0,0 +1,31 @@
+class MessageAppender
+  
+  def initialize(appendage)
+    @appendage = appendage
+  end
+  
+  def append_to(message)
+    if_told_to_yield do
+      message << @appendage
+    end
+  end
+    
+end
+
+describe "a message expectation yielding to a block" do
+  it "should yield if told to" do
+    appender = MessageAppender.new("appended to")
+    appender.should_receive(:if_told_to_yield).and_yield
+    message = ""
+    appender.append_to(message)
+    message.should == "appended to"
+  end
+
+  it "should not yield if not told to" do
+    appender = MessageAppender.new("appended to")
+    appender.should_receive(:if_told_to_yield)
+    message = ""
+    appender.append_to(message)
+    message.should == ""
+  end
+end

data/examples/ruby1.9.compatibility/access_to_constants_spec.rb

@@ -0,0 +1,85 @@
+# courtesy of Matthias Hennemeyer
+#
+# The following should pass against ruby 1.8 and 1.9. It currently only passes
+# 1.8 (as of 1/2/2009)
+#
+# Once cucumber supports ruby 1.9, this should be moved to cucumber scenarios instead. 
+module Foo 
+  module Bar
+    
+    module ModuleInEnclosingModule;end
+    class ClassInEnclosingModule;end 
+    def method_in_enclosing_module;end
+    CONSTANT_IN_ENCLOSING_MODULE = 0
+
+    describe "Examples trying to access constants defined in an enclosing module" do
+
+      it "can access Modules" do
+        ModuleInEnclosingModule
+      end
+      it "can access Classes" do
+        ClassInEnclosingModule.new
+      end
+      it "can access CONSTANTS" do
+        CONSTANT_IN_ENCLOSING_MODULE
+      end
+      it "can NOT access methods" do
+        lambda {method_in_enclosing_module}.should raise_error(/undefined/)
+      end
+
+      describe "from a nested example group" do
+
+        it "can access Modules" do
+          ModuleInEnclosingModule
+        end
+        it "can access Classes" do
+          ClassInEnclosingModule.new
+        end
+        it "can access CONSTANTS" do
+          CONSTANT_IN_ENCLOSING_MODULE
+        end
+        it "can NOT access methods" do
+          lambda {method_in_enclosing_module}.should raise_error(/undefined/)
+        end
+
+      end 
+
+    end
+    
+    describe "Examples trying to access constants defined in the example group" do
+      
+      module ModuleDefinedInGroup;end
+      class ClassDefinedInGroup; end 
+      def method_defined_in_group; end
+      CONSTANT_DEFINED_IN_GROUP = 0
+
+      it "can access Modules" do
+        ModuleDefinedInGroup
+      end
+      it "can access Classes" do
+        ClassDefinedInGroup.new
+      end
+      it "can access CONSTANTS" do
+        CONSTANT_DEFINED_IN_GROUP
+      end
+      it "can access methods" do
+        method_defined_in_group
+      end
+      
+      describe "that live inside a nested group" do
+        it "can access Modules" do
+          ModuleDefinedInGroup
+        end
+        it "can access Classes" do
+          ClassDefinedInGroup.new
+        end
+        it "can access CONSTANTS" do
+          CONSTANT_DEFINED_IN_GROUP
+        end
+        it "can access methods" do
+          method_defined_in_group
+        end
+      end
+    end 
+  end 
+end