Module | Kernel |
In: |
lib/spec/runner/extensions/kernel.rb
|
Creates and registers an instance of a Spec::DSL::Behaviour (or a subclass). The instantiated behaviour class depends on the directory of the file calling this method. For example, Spec::Rails will use different classes for specs living in spec/models, spec/helpers, spec/views and spec/controllers.
It is also possible to override autodiscovery of the behaviour class with an options Hash as the last argument:
describe "name", :behaviour_type => :something_special do ...
The reason for using different behaviour classes is to have different matcher methods available from within the describe block.
See Spec::DSL::BehaviourFactory#add_behaviour_class for details about how to register special Spec::DSL::Behaviour implementations.
# File lib/spec/runner/extensions/kernel.rb, line 20 20: def describe(*args, &block) 21: raise ArgumentError if args.empty? 22: args << {} unless Hash === args.last 23: args.last[:spec_path] = caller(0)[1] 24: register_behaviour(Spec::DSL::BehaviourFactory.create(*args, &block)) 25: end