newbamboo-rspec 1.1.12

data/spec/spec/dsl/main_spec.rb

@@ -0,0 +1,88 @@
+require File.dirname(__FILE__) + '/../../spec_helper.rb'
+
+module Spec
+  module DSL
+    describe Main do
+      before(:each) do
+        @main = Class.new do; include Spec::DSL::Main; end
+      end
+
+      [:describe, :context].each do |method|
+        describe "##{method}" do
+          it "should delegate to Spec::Example::ExampleGroupFactory.create_example_group" do
+            block = lambda {}
+            Spec::Example::ExampleGroupFactory.should_receive(:create_example_group).with(
+              "The ExampleGroup", hash_including(:spec_path), &block
+            )
+            @main.__send__ method, "The ExampleGroup", &block
+          end
+        end
+      end
+      
+      [:share_examples_for, :shared_examples_for].each do |method|
+        describe "##{method}" do
+          it "should create a shared ExampleGroup" do
+            block = lambda {}
+            Spec::Example::ExampleGroupFactory.should_receive(:create_shared_example_group).with(
+              "shared group", hash_including(:spec_path), &block
+            )
+            @main.__send__ method, "shared group", &block
+          end
+        end
+      end
+
+      describe "#describe; with RUBY_VERSION = 1.9" do
+        it "includes an enclosing module into the block's scope" do
+          Spec::Ruby.stub!(:version).and_return("1.9")
+
+          module Foo; module Bar; end; end
+          
+          Foo::Bar.should_receive(:included).with do |*args|
+            included_by = args.last
+            included_by.description.should == "this example group"
+          end
+          
+          module Foo
+            module Bar
+              describe("this example group") do; end
+            end
+          end
+        end
+      end
+
+    
+      describe "#share_as" do
+        def self.next_group_name
+          @group_number ||= 0
+          @group_number += 1
+          "Group#{@group_number}"
+        end
+        
+        def group_name
+          @group_name ||= self.class.next_group_name
+        end
+        
+        it "registers a shared ExampleGroup" do
+          block = lambda {}
+          Spec::Example::ExampleGroupFactory.should_receive(:create_shared_example_group).with(
+            group_name, hash_including(:spec_path), &block
+          )
+          @main.share_as group_name, &block
+        end
+      
+        it "creates a constant that points to a Module" do
+          group = @main.share_as group_name do end
+          Object.const_get(group_name).should equal(group)
+        end
+      
+        it "complains if you pass it a not-constantizable name" do
+          lambda do
+            @group = @main.share_as "Non Constant" do end
+          end.should raise_error(NameError, /The first argument to share_as must be a legal name for a constant/)
+        end
+      
+      end
+    end
+  end
+end
+  

data/spec/spec/example/example_group_class_definition_spec.rb

@@ -0,0 +1,49 @@
+require File.dirname(__FILE__) + '/../../spec_helper'
+
+module Spec
+  module Example
+    class ExampleGroupSubclass < ExampleGroup
+      class << self
+        attr_accessor :examples_ran
+      end
+
+      @@class_variable = :class_variable
+      CONSTANT = :constant
+
+      before(:each) do
+        @instance_variable = :instance_variable
+      end
+      
+      after(:all) do
+        self.class.examples_ran = true
+      end
+
+      def a_method
+        22
+      end
+
+      it "can access instance variables defined before(:each)" do
+        @instance_variable.should == :instance_variable
+      end
+
+      it "can access class variables" do
+        @@class_variable.should == :class_variable
+      end
+
+      it "can access constants" do
+        CONSTANT.should == :constant
+      end
+
+      it "can access methods defined in the Example Group" do
+        a_method.should == 22
+      end
+      
+    end
+
+    describe ExampleGroupSubclass do
+      it "should run" do
+        ExampleGroupSubclass.examples_ran.should be_true
+      end
+    end
+  end
+end

data/spec/spec/example/example_group_factory_spec.rb

@@ -0,0 +1,224 @@
+require File.expand_path(File.dirname(__FILE__) + '/../../spec_helper')
+
+module Spec
+  module Example
+    describe ExampleGroupFactory do
+      describe "#get" do
+        attr_reader :example_group
+        before(:each) do
+          @example_group_class = Class.new(ExampleGroupDouble)
+          ExampleGroupFactory.register(:registered_type, @example_group_class)
+        end
+
+        after(:each) do
+          ExampleGroupFactory.reset
+        end
+
+        it "should return the default ExampleGroup type for nil" do
+          ExampleGroupFactory.get(nil).should == ExampleGroup
+        end
+
+        it "should return the default ExampleGroup for an unregistered non-nil value" do
+          ExampleGroupFactory.get(:does_not_exist).should == ExampleGroup
+        end
+
+        it "should return custom type if registered" do
+          ExampleGroupFactory.get(:registered_type).should == @example_group_class
+        end
+
+        it "should return the actual type when that is what is submitted" do
+          ExampleGroupFactory.get(@example_group_class).should == @example_group_class
+        end
+
+        it "should get the custom type after setting the default" do
+          @alternate_example_group_class = Class.new(ExampleGroupDouble)
+          ExampleGroupFactory.default(@alternate_example_group_class)
+          ExampleGroupFactory.get(:registered_type).should == @example_group_class
+        end
+      end
+
+      describe "#create_example_group" do
+        attr_reader :parent_example_group
+        before do
+          @parent_example_group = Class.new(ExampleGroupDouble) do
+            def initialize(*args, &block)
+              ;
+            end
+          end
+        end
+
+        it "should create a uniquely named class" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("example_group") {}
+          example_group.name.should =~ /Spec::Example::ExampleGroup::Subclass_\d+/
+        end
+
+        it "should create a Spec::Example::Example subclass by default" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("example_group") {}
+          example_group.superclass.should == Spec::Example::ExampleGroup
+        end
+
+        it "should raise when no description is given" do
+          lambda {
+            Spec::Example::ExampleGroupFactory.create_example_group do; end
+          }.should raise_error(ArgumentError)
+        end
+
+        it "should raise when no block is given" do
+          lambda { Spec::Example::ExampleGroupFactory.create_example_group "foo" }.should raise_error(ArgumentError)
+        end
+
+        it "should run registered ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group "The ExampleGroup" do end
+          Spec::Runner.options.example_groups.should include(example_group)
+        end
+
+        it "should not run unregistered ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group "The ExampleGroup" do Spec::Runner.options.remove_example_group self; end
+          Spec::Runner.options.example_groups.should_not include(example_group)
+        end
+
+        describe "with :type => :default" do
+          it "should create a Spec::Example::ExampleGroup" do
+            example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :type => :default
+            ) {}
+            example_group.superclass.should == Spec::Example::ExampleGroup
+          end
+        end
+
+        describe "with :type => :something_other_than_default" do
+          it "should create the specified type" do
+            Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+            non_default_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+              "example_group", :type => :something_other_than_default
+            ) {}
+            non_default_example_group.superclass.should == parent_example_group
+          end
+        end
+
+        it "should create a type indicated by :spec_path" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/something_other_than_default/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should create a type indicated by :spec_path (with spec_path generated by caller on windows)" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group",
+            :spec_path => "./spec\\something_other_than_default\\some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should create a type indicated by spec_path for a path-like key" do
+          Spec::Example::ExampleGroupFactory.register('path/to/custom/', parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/path/to/custom/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should use the longest key that matches when creating a type indicated by spec_path" do
+          longer = Class.new parent_example_group
+          Spec::Example::ExampleGroupFactory.register(:longer, longer)
+          long = Class.new parent_example_group
+          Spec::Example::ExampleGroupFactory.register(:long, long)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "example_group", :spec_path => "./spec/longer/some_spec.rb"
+          ) {}
+          custom_example_group.superclass.should == longer
+        end
+
+        it "sets the spec_path from the caller" do
+          options = {}
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_example_group("foo", options) {}
+          options[:spec_path].should =~ /#{__FILE__}:#{__LINE__ - 1}/
+        end
+
+        describe "with :shared => true" do
+          def shared_example_group
+            @shared_example_group ||= Spec::Example::ExampleGroupFactory.create_example_group(
+              "name", :spec_path => '/blah/spec/models/blah.rb', :type => :controller, :shared => true
+            ) {}
+          end
+
+          it "should create and register a Spec::Example::SharedExampleGroup" do
+            shared_example_group.should be_an_instance_of(Spec::Example::SharedExampleGroup)
+            SharedExampleGroup.should include(shared_example_group)
+          end
+        end
+
+        it "should favor the :type over the :spec_path" do
+          Spec::Example::ExampleGroupFactory.register(:something_other_than_default, parent_example_group)
+          custom_example_group = Spec::Example::ExampleGroupFactory.create_example_group(
+            "name", :spec_path => '/blah/spec/models/blah.rb', :type => :something_other_than_default
+          ) {}
+          custom_example_group.superclass.should == parent_example_group
+        end
+
+        it "should register ExampleGroup by default" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("The ExampleGroup") do
+          end
+          Spec::Runner.options.example_groups.should include(example_group)
+        end
+
+        it "should enable unregistering of ExampleGroups" do
+          example_group = Spec::Example::ExampleGroupFactory.create_example_group("The ExampleGroup") do
+            Spec::Runner.options.remove_example_group self
+          end
+          Spec::Runner.options.example_groups.should_not include(example_group)
+        end
+
+        after(:each) do
+          Spec::Example::ExampleGroupFactory.reset
+        end
+      end
+
+      describe "#create_shared_example_group" do
+        it "registers a new shared example group" do
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_shared_example_group("something shared") {}
+          shared_example_group.should be_an_instance_of(Spec::Example::SharedExampleGroup)
+          SharedExampleGroup.should include(shared_example_group)
+        end
+
+        it "sets the spec_path from the caller" do
+          options = {}
+          shared_example_group = Spec::Example::ExampleGroupFactory.create_shared_example_group("foo", options) {}
+          options[:spec_path].should =~ /#{__FILE__}:#{__LINE__ - 1}/
+        end
+      end
+
+      describe "#registered_or_ancestor_of_registered?" do
+        before(:each) do
+          @unregistered_parent = Class.new(ExampleGroupDouble)
+          @registered_child = Class.new(@unregistered_parent)
+          @unregistered_grandchild = Class.new(@registered_child)
+          Spec::Example::ExampleGroupFactory.register :registered_child, @registered_child
+        end
+
+        it "should return true for empty list" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([]).should be_true
+        end
+
+        it "should return true for a registered example group class" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@registered_child]).should be_true
+        end
+
+        it "should return true for an ancestor of a registered example_group_classes" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@unregistered_parent]).should be_true
+        end
+
+        it "should return false for a subclass of a registered example_group_class" do
+          Spec::Example::ExampleGroupFactory.registered_or_ancestor_of_registered?([@unregistered_grandchild]).should be_false
+        end
+
+        after(:each) do
+          Spec::Example::ExampleGroupFactory.reset
+        end
+      end
+    end
+  end
+end