has_finder 0.1.1

data/spec/rails/vendor/plugins/rspec/lib/spec/dsl/behaviour_callbacks.rb

@@ -0,0 +1,78 @@
+module Spec
+  module DSL
+    # See http://rspec.rubyforge.org/documentation/before_and_after.html
+    module BehaviourCallbacks
+      def prepend_before(*args, &block)
+        scope, options = scope_and_options(*args)
+        add(scope, options, :before, :unshift, &block)
+      end
+      def append_before(*args, &block)
+        scope, options = scope_and_options(*args)
+        add(scope, options, :before, :<<, &block)
+      end
+      alias_method :before, :append_before
+
+      def prepend_after(*args, &block)
+        scope, options = scope_and_options(*args)
+        add(scope, options, :after, :unshift, &block)
+      end
+      alias_method :after, :prepend_after
+      def append_after(*args, &block)
+        scope, options = scope_and_options(*args)
+        add(scope, options, :after, :<<, &block)
+      end
+      
+      def scope_and_options(*args)
+        args, options = args_and_options(*args)
+        scope = (args[0] || :each), options
+      end
+      
+      def add(scope, options, where, how, &block)
+        scope ||= :each
+        options ||= {}
+        behaviour_type = options[:behaviour_type]
+        case scope
+          when :each; self.__send__("#{where}_each_parts", behaviour_type).__send__(how, block)
+          when :all;  self.__send__("#{where}_all_parts", behaviour_type).__send__(how, block)
+        end
+      end
+
+      # Deprecated. Use before(:each)
+      def setup(&block)
+        before(:each, &block)
+      end
+
+      # Deprecated. Use after(:each)
+      def teardown(&block)
+        after(:each, &block)
+      end
+
+      def before_all_parts(behaviour_type=nil) # :nodoc:
+        @before_all_parts ||= {}
+        @before_all_parts[behaviour_type] ||= []
+      end
+
+      def after_all_parts(behaviour_type=nil) # :nodoc:
+        @after_all_parts ||= {}
+        @after_all_parts[behaviour_type] ||= []
+      end
+
+      def before_each_parts(behaviour_type=nil) # :nodoc:
+        @before_each_parts ||= {}
+        @before_each_parts[behaviour_type] ||= []
+      end
+
+      def after_each_parts(behaviour_type=nil) # :nodoc:
+        @after_each_parts ||= {}
+        @after_each_parts[behaviour_type] ||= []
+      end
+
+      def clear_before_and_after! # :nodoc:
+        @before_all_parts = nil
+        @after_all_parts = nil
+        @before_each_parts = nil
+        @after_each_parts = nil
+      end
+    end
+  end
+end

data/spec/rails/vendor/plugins/rspec/lib/spec/dsl/behaviour_eval.rb

@@ -0,0 +1,220 @@
+module Spec
+  module DSL
+    module BehaviourEval
+      module ModuleMethods
+        include BehaviourCallbacks
+
+        attr_writer :behaviour
+        attr_accessor :description
+
+        # RSpec runs every example in a new instance of Object, mixing in
+        # the behaviour necessary to run examples. Because this behaviour gets
+        # mixed in, it can get mixed in to an instance of any class at all.
+        #
+        # This is something that you would hardly ever use, but there is one
+        # common use case for it - inheriting from Test::Unit::TestCase. RSpec's
+        # Rails plugin uses this feature to provide access to all of the features
+        # that are available for Test::Unit within RSpec examples.
+        def inherit(klass)
+          raise ArgumentError.new("Shared behaviours cannot inherit from classes") if @behaviour.shared?
+          @behaviour_superclass = klass
+          derive_execution_context_class_from_behaviour_superclass
+        end
+
+        # You can pass this one or many modules. Each module will subsequently
+        # be included in the each object in which an example is run. Use this
+        # to provide global helper methods to your examples.
+        #
+        # == Example
+        #
+        #   module HelperMethods
+        #     def helper_method
+        #       ...
+        #     end
+        #   end
+        #
+        #   describe Thing do
+        #     include HelperMethods
+        #     it "should do stuff" do
+        #       helper_method
+        #     end
+        #   end
+        def include(*mods)
+          mods.each do |mod|
+            included_modules << mod
+            mod.send :included, self
+          end
+        end
+
+        # Use this to pull in examples from shared behaviours.
+        # See Spec::Runner for information about shared behaviours.
+        def it_should_behave_like(behaviour_description)
+          behaviour = @behaviour.class.find_shared_behaviour(behaviour_description)
+          if behaviour.nil?
+            raise RuntimeError.new("Shared Behaviour '#{behaviour_description}' can not be found")
+          end
+          behaviour.copy_to(self)
+        end
+
+        def copy_to(eval_module) # :nodoc:
+          examples.each          { |e| eval_module.examples << e; }
+          before_each_parts.each { |p| eval_module.before_each_parts << p }
+          after_each_parts.each  { |p| eval_module.after_each_parts << p }
+          before_all_parts.each  { |p| eval_module.before_all_parts << p }
+          after_all_parts.each   { |p| eval_module.after_all_parts << p }
+          included_modules.each  { |m| eval_module.included_modules << m }
+          eval_module.included_modules << self
+        end
+        
+        # :call-seq:
+        #   predicate_matchers[matcher_name] = method_on_object
+        #   predicate_matchers[matcher_name] = [method1_on_object, method2_on_object]
+        #
+        # Dynamically generates a custom matcher that will match
+        # a predicate on your class. RSpec provides a couple of these
+        # out of the box:
+        #
+        #   exist (or state expectations)
+        #     File.should exist("path/to/file")
+        #
+        #   an_instance_of (for mock argument constraints)
+        #     mock.should_receive(:message).with(an_instance_of(String))
+        #
+        # == Examples
+        #
+        #   class Fish
+        #     def can_swim?
+        #       true
+        #     end
+        #   end
+        #
+        #   describe Fish do
+        #     predicate_matchers[:swim] = :can_swim?
+        #     it "should swim" do
+        #       Fish.new.should swim
+        #     end
+        #   end
+        def predicate_matchers
+          @predicate_matchers ||= {:exist => :exist?, :an_instance_of => :is_a?}
+        end
+        
+        def define_predicate_matchers(hash=nil) # :nodoc:
+          if hash.nil?
+            define_predicate_matchers(predicate_matchers)
+            define_predicate_matchers(Spec::Runner.configuration.predicate_matchers)
+          else
+            hash.each_pair do |matcher_method, method_on_object|
+              define_method matcher_method do |*args|
+                eval("be_#{method_on_object.to_s.gsub('?','')}(*args)")
+              end
+            end
+          end
+        end
+        
+        # Creates an instance of Spec::DSL::Example and adds
+        # it to a collection of examples of the current behaviour.
+        def it(description=:__generate_description, opts={}, &block)
+          examples << Example.new(description, opts, &block)
+        end
+        
+        # Alias for it.
+        def specify(description=:__generate_description, opts={}, &block)
+          it(description, opts, &block)
+        end
+
+        def methods # :nodoc:
+          my_methods = super
+          my_methods |= behaviour_superclass.methods
+          my_methods
+        end
+
+      protected
+
+        def method_missing(method_name, *args)
+          if behaviour_superclass.respond_to?(method_name)
+            return execution_context_class.send(method_name, *args)
+          end
+          super
+        end
+
+        def before_all_proc(behaviour_type, &error_handler)
+          parts = []
+          parts.push(*Behaviour.before_all_parts(nil))
+          parts.push(*Behaviour.before_all_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*before_all_parts(nil))
+          parts.push(*before_all_parts(behaviour_type)) unless behaviour_type.nil?
+          CompositeProcBuilder.new(parts).proc(&error_handler)
+        end
+
+        def after_all_proc(behaviour_type, &error_handler)
+          parts = []
+          parts.push(*after_all_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*after_all_parts(nil))
+          parts.push(*Behaviour.after_all_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*Behaviour.after_all_parts(nil))
+          CompositeProcBuilder.new(parts).proc(&error_handler)
+        end
+
+        def before_each_proc(behaviour_type, &error_handler)
+          parts = []
+          parts.push(*Behaviour.before_each_parts(nil))
+          parts.push(*Behaviour.before_each_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*before_each_parts(nil))
+          parts.push(*before_each_parts(behaviour_type)) unless behaviour_type.nil?
+          CompositeProcBuilder.new(parts).proc(&error_handler)
+        end
+
+        def after_each_proc(behaviour_type, &error_handler)
+          parts = []
+          parts.push(*after_each_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*after_each_parts(nil))
+          parts.push(*Behaviour.after_each_parts(behaviour_type)) unless behaviour_type.nil?
+          parts.push(*Behaviour.after_each_parts(nil))
+          CompositeProcBuilder.new(parts).proc(&error_handler)
+        end
+
+      private
+
+        def execution_context_class
+          @execution_context_class ||= derive_execution_context_class_from_behaviour_superclass
+        end
+
+        def derive_execution_context_class_from_behaviour_superclass
+          @execution_context_class = Class.new(behaviour_superclass)
+          behaviour_superclass.spec_inherited(self) if behaviour_superclass.respond_to?(:spec_inherited)
+          @execution_context_class
+        end
+
+        def behaviour_superclass
+          @behaviour_superclass ||= Object
+        end
+
+        protected
+        def included_modules
+          @included_modules ||= [::Spec::Matchers]
+        end
+
+        def examples
+          @examples ||= []
+        end
+      end
+
+      module InstanceMethods
+        def initialize(*args, &block) #:nodoc:
+          # TODO - inheriting from TestUnit::TestCase fails without this
+          # - let's figure out why and move this somewhere else
+        end
+
+        def violated(message="")
+          raise Spec::Expectations::ExpectationNotMetError.new(message)
+        end
+
+        def inspect
+          "[Dynamically generated class for RSpec example]"
+        end
+
+      end
+
+    end
+  end
+end

data/spec/rails/vendor/plugins/rspec/lib/spec/dsl/behaviour_factory.rb

@@ -0,0 +1,42 @@
+module Spec
+  module DSL
+    class BehaviourFactory
+
+      class << self
+
+        BEHAVIOUR_CLASSES = {:default => Spec::DSL::Behaviour}
+        
+        # Registers a behaviour class +klass+ with the symbol
+        # +behaviour_type+. For example:
+        #
+        #   Spec::DSL::BehaviourFactory.add_behaviour_class(:farm, Spec::Farm::DSL::FarmBehaviour)
+        #
+        # This will cause Kernel#describe from a file living in 
+        # <tt>spec/farm</tt> to create behaviour instances of type
+        # Spec::Farm::DSL::FarmBehaviour.
+        def add_behaviour_class(behaviour_type, klass)
+          BEHAVIOUR_CLASSES[behaviour_type] = klass
+        end
+
+        def remove_behaviour_class(behaviour_type)
+          BEHAVIOUR_CLASSES.delete(behaviour_type)
+        end
+
+        def create(*args, &block)
+          opts = Hash === args.last ? args.last : {}
+          if opts[:shared]
+            behaviour_type = :default
+          elsif opts[:behaviour_type]
+            behaviour_type = opts[:behaviour_type]
+          elsif opts[:spec_path] =~ /spec\/(#{BEHAVIOUR_CLASSES.keys.join('|')})/
+            behaviour_type = $1.to_sym
+          else
+            behaviour_type = :default
+          end
+          return BEHAVIOUR_CLASSES[behaviour_type].new(*args, &block)
+        end
+
+      end
+    end
+  end
+end

data/spec/rails/vendor/plugins/rspec/lib/spec/dsl/composite_proc_builder.rb

@@ -0,0 +1,28 @@
+module Spec
+  module DSL
+    class CompositeProcBuilder < Array
+      def initialize(callbacks=[])
+        push(*callbacks)
+      end
+
+      def proc(&error_handler)
+        parts = self
+        Proc.new do
+          parts.collect do |part|
+            begin
+              if part.is_a?(UnboundMethod)
+                part.bind(self).call
+              else
+                instance_eval(&part)
+              end
+            rescue Exception => e
+              raise e unless error_handler
+              error_handler.call(e)
+              e
+            end
+          end
+        end
+      end
+    end
+  end
+end

data/spec/rails/vendor/plugins/rspec/lib/spec/dsl/configuration.rb

@@ -0,0 +1,119 @@
+module Spec
+  module DSL
+    class Configuration
+      
+      # Chooses what mock framework to use. Example:
+      #
+      #   Spec::Runner.configure do |config|
+      #     config.mock_with :rspec # or :mocha, or :flexmock
+      #   end
+      #
+      # To use any other mock framework, you'll have to provide
+      # your own adapter. This is simply a module that responds to
+      # setup_mocks_for_rspec, verify_mocks_for_rspec and teardown_mocks_for_rspec.
+      # These are your hooks into the lifecycle of a given example. RSpec will
+      # call setup_mocks_for_rspec before running anything else in each Example.
+      # After executing the #after methods, RSpec will then call verify_mocks_for_rspec
+      # and teardown_mocks_for_rspec (this is guaranteed to run even if there are
+      # failures in verify_mocks_for_rspec).
+      #
+      # Once you've defined this module, you can pass that to mock_with:
+      #
+      #   Spec::Runner.configure do |config|
+      #     config.mock_with MyMockFrameworkAdapter
+      #   end
+      #
+      def mock_with(mock_framework)
+        @mock_framework = case mock_framework
+        when Symbol
+          mock_framework_path(mock_framework.to_s)
+        else
+          mock_framework
+        end
+      end
+      
+      def mock_framework # :nodoc:
+        @mock_framework ||= mock_framework_path("rspec")
+      end
+      
+      # Declares modules to be included in all behaviours (<tt>describe</tt> blocks).
+      #
+      #   config.include(My::Bottle, My::Cup)
+      #
+      # If you want to restrict the inclusion to a subset of all the behaviours then
+      # specify this in a Hash as the last argument:
+      #
+      #   config.include(My::Pony, My::Horse, :behaviour_type => :farm)
+      #
+      # Only behaviours that have that type will get the modules included:
+      #
+      #   describe "Downtown", :behaviour_type => :city do
+      #     # Will *not* get My::Pony and My::Horse included
+      #   end
+      #
+      #   describe "Old Mac Donald", :behaviour_type => :farm do
+      #     # *Will* get My::Pony and My::Horse included
+      #   end
+      #
+      def include(*args)
+        included_modules.push(*args)
+      end
+      
+      def included_modules # :nodoc:
+        @included_modules ||= []
+      end
+      
+      # Defines global predicate matchers. Example:
+      #
+      #   config.predicate_matchers[:swim] = :can_swim?
+      #
+      # This makes it possible to say:
+      #
+      #   person.should swim # passes if person.should_swim? returns true
+      #
+      def predicate_matchers
+        @predicate_matchers ||= {}
+      end
+      
+      # Prepends a global <tt>before</tt> block to all behaviours.
+      # See #append_before for filtering semantics.
+      def prepend_before(*args, &proc)
+        Behaviour.prepend_before(*args, &proc)
+      end
+      # Appends a global <tt>before</tt> block to all behaviours.
+      #
+      # If you want to restrict the block to a subset of all the behaviours then
+      # specify this in a Hash as the last argument:
+      #
+      #   config.prepend_before(:all, :behaviour_type => :farm)
+      #
+      # or
+      #
+      #   config.prepend_before(:behaviour_type => :farm)
+      #
+      def append_before(*args, &proc)
+        Behaviour.append_before(*args, &proc)
+      end
+      alias_method :before, :append_before
+
+      # Prepends a global <tt>after</tt> block to all behaviours.
+      # See #append_before for filtering semantics.
+      def prepend_after(*args, &proc)
+        Behaviour.prepend_after(*args, &proc)
+      end
+      alias_method :after, :prepend_after
+      # Appends a global <tt>after</tt> block to all behaviours.
+      # See #append_before for filtering semantics.
+      def append_after(*args, &proc)
+        Behaviour.append_after(*args, &proc)
+      end
+
+    private
+    
+      def mock_framework_path(framework_name)
+        File.expand_path(File.join(File.dirname(__FILE__), "..", "..", "..", "plugins", "mock_frameworks", framework_name))
+      end
+      
+    end
+  end
+end