Class: RSpec::Core::ExampleGroup
- Inherits:
-
Object
- Object
- RSpec::Core::ExampleGroup
- Extended by:
- Hooks, MemoizedHelpers::ClassMethods, SharedExampleGroup
- Includes:
- MemoizedHelpers, Pending
- Defined in:
- lib/rspec/core/example_group.rb
Overview
ExampleGroup and Example are the main structural elements of rspec-core. Consider this example:
describe Thing do
it "does something" do
end
end
The object returned by describe Thing
is a subclass of ExampleGroup.
The object returned by it "does something"
is an instance of Example,
which serves as a wrapper for an instance of the ExampleGroup in which it
is declared.
Example group bodies (e.g. describe
or context
blocks) are evaluated
in the context of a new subclass of ExampleGroup. Individual examples are
evaluated in the context of an instance of the specific ExampleGroup
subclass to which they belong.
Besides the class methods defined here, there are other interesting macros defined in Hooks, MemoizedHelpers::ClassMethods and SharedExampleGroup. There are additional instance methods available to your examples defined in MemoizedHelpers and Pending.
Constant Summary
- WrongScopeError =
Raised when an RSpec API is called in the wrong scope, such as
before
being called from within an example rather than from within an example group block. Class.new(NoMethodError)
Metadata (collapse)
-
+ (String) description
The current example group description.
-
+ (void) metadata
The Metadata object associated with this group.
-
- (void) described_class
Returns the class or module passed to the
describe
method (or alias).
Defining Examples (collapse)
-
+ (void) example {|Example| ... }
Defines an example within a group.
-
+ (void) fexample {|Example| ... }
Shortcut to define an example with
:focus => true
. -
+ (void) fit {|Example| ... }
Shortcut to define an example with
:focus => true
. -
+ (void) focus {|Example| ... }
Shortcut to define an example with
:focus => true
. -
+ (void) fspecify {|Example| ... }
Shortcut to define an example with
:focus => true
. -
+ (void) it {|Example| ... }
Defines an example within a group.
-
+ (void) pending {|Example| ... }
Shortcut to define an example with
:pending => true
. -
+ (void) skip {|Example| ... }
Shortcut to define an example with
:skip => true
. -
+ (void) specify {|Example| ... }
Defines an example within a group.
-
+ (void) xexample {|Example| ... }
Shortcut to define an example with
:skip => 'Temporarily skipped with xexample'
. -
+ (void) xit {|Example| ... }
Shortcut to define an example with
:skip => 'Temporarily skipped with xit'
. -
+ (void) xspecify {|Example| ... }
Shortcut to define an example with
:skip => 'Temporarily skipped with xspecify'
.
Defining Example Groups (collapse)
-
+ (void) context
An alias of
example_group
. -
+ (void) describe
An alias of
example_group
. -
+ (void) example_group
Generates a subclass of this example group which inherits everything except the examples themselves.
-
+ (void) fcontext
Shortcut to define an example group with
:focus => true
. -
+ (void) fdescribe
Shortcut to define an example group with
:focus => true
. -
+ (void) xcontext
Shortcut to temporarily make an example group skipped.
-
+ (void) xdescribe
Shortcut to temporarily make an example group skipped.
Including Shared Example Groups (collapse)
-
+ (void) include_context(name, *args, &block)
Includes shared content mapped to
name
directly in the group in which it is declared, as opposed toit_behaves_like
, which creates a nested group. -
+ (void) include_examples(name, *args, &block)
Includes shared content mapped to
name
directly in the group in which it is declared, as opposed toit_behaves_like
, which creates a nested group. -
+ (void) it_behaves_like
Generates a nested example group and includes the shared content mapped to
name
in the nested group. -
+ (void) it_should_behave_like
Generates a nested example group and includes the shared content mapped to
name
in the nested group.
Class Method Summary (collapse)
-
+ (void) run(reporter = RSpec::Core::NullReporter.new)
Runs all the examples in this group.
Instance Method Summary (collapse)
-
- (ExampleGroup) initialize(inspect_output = nil)
constructor
A new instance of ExampleGroup.
Methods included from SharedExampleGroup
Methods included from MemoizedHelpers::ClassMethods
Methods included from Hooks
after, append_after, around, before, prepend_before
Methods included from Pending
Methods included from MemoizedHelpers
#is_expected, #should, #should_not, #subject
Constructor Details
- (ExampleGroup) initialize(inspect_output = nil)
Returns a new instance of ExampleGroup
603 604 605 |
# File 'lib/rspec/core/example_group.rb', line 603 def initialize(inspect_output=nil) @__inspect_output = inspect_output || '(no description provided)' end |
Dynamic Method Handling
This class handles dynamic methods through the method_missing method
- (void) method_missing(name, *args) (private)
640 641 642 643 644 645 646 647 648 649 650 |
# File 'lib/rspec/core/example_group.rb', line 640 def method_missing(name, *args) if self.class.respond_to?(name) raise WrongScopeError, "`#{name}` is not available from within an example (e.g. an " \ "`it` block) or from constructs that run in the scope of an " \ "example (e.g. `before`, `let`, etc). It is only available " \ "on an example group (e.g. a `describe` or `context` block)." end super end |
Class Method Details
+ (void) context + (void) context(&example_group_definition) + (void) context(doc_string, *metadata_keys, metadata = {}, &example_implementation)
An alias of example_group
. Generally used when grouping examples
contextually (e.g. "with xyz", "when xyz" or "if xyz").
Generates a subclass of this example group which inherits
everything except the examples themselves.
275 |
# File 'lib/rspec/core/example_group.rb', line 275 define_example_group_method :context |
+ (void) describe + (void) describe(&example_group_definition) + (void) describe(doc_string, *metadata_keys, metadata = {}, &example_implementation)
An alias of example_group
. Generally used when grouping examples by a
thing you are describing (e.g. an object, class or method).
Generates a subclass of this example group which inherits
everything except the examples themselves.
270 |
# File 'lib/rspec/core/example_group.rb', line 270 define_example_group_method :describe |
+ (String) description
Returns the current example group description
81 82 83 84 |
# File 'lib/rspec/core/example_group.rb', line 81 def self.description description = [:description] RSpec.configuration.format_docstrings_block.call(description) end |
+ (void) example + (void) example(&example_implementation) + (void) example(doc_string, *metadata_keys, metadata = {}) + (void) example(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Defines an example within a group.
151 |
# File 'lib/rspec/core/example_group.rb', line 151 define_example_method :example |
+ (void) example_group + (void) example_group(&example_group_definition) + (void) example_group(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Generates a subclass of this example group which inherits everything except the examples themselves.
265 |
# File 'lib/rspec/core/example_group.rb', line 265 define_example_group_method :example_group |
+ (void) fcontext + (void) fcontext(&example_group_definition) + (void) fcontext(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example group with :focus => true
.
Generates a subclass of this example group which inherits
everything except the examples themselves.
291 |
# File 'lib/rspec/core/example_group.rb', line 291 define_example_group_method :fcontext, :focus => true |
+ (void) fdescribe + (void) fdescribe(&example_group_definition) + (void) fdescribe(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example group with :focus => true
.
Generates a subclass of this example group which inherits
everything except the examples themselves.
287 |
# File 'lib/rspec/core/example_group.rb', line 287 define_example_group_method :fdescribe, :focus => true |
+ (void) fexample + (void) fexample(&example_implementation) + (void) fexample(doc_string, *metadata_keys, metadata = {}) + (void) fexample(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :focus => true
.
170 |
# File 'lib/rspec/core/example_group.rb', line 170 define_example_method :fexample, :focus => true |
+ (void) fit + (void) fit(&example_implementation) + (void) fit(doc_string, *metadata_keys, metadata = {}) + (void) fit(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :focus => true
.
173 |
# File 'lib/rspec/core/example_group.rb', line 173 define_example_method :fit, :focus => true |
+ (void) focus + (void) focus(&example_implementation) + (void) focus(doc_string, *metadata_keys, metadata = {}) + (void) focus(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :focus => true
.
167 |
# File 'lib/rspec/core/example_group.rb', line 167 define_example_method :focus, :focus => true |
+ (void) fspecify + (void) fspecify(&example_implementation) + (void) fspecify(doc_string, *metadata_keys, metadata = {}) + (void) fspecify(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :focus => true
.
176 |
# File 'lib/rspec/core/example_group.rb', line 176 define_example_method :fspecify, :focus => true |
+ (void) include_context(name, *args, &block)
Includes shared content mapped to name
directly in the group in which
it is declared, as opposed to it_behaves_like
, which creates a nested
group. If given a block, that block is also eval'd in the current
context.
328 329 330 |
# File 'lib/rspec/core/example_group.rb', line 328 def self.include_context(name, *args, &block) find_and_eval_shared("context", name, caller.first, *args, &block) end |
+ (void) include_examples(name, *args, &block)
Includes shared content mapped to name
directly in the group in which
it is declared, as opposed to it_behaves_like
, which creates a nested
group. If given a block, that block is also eval'd in the current
context.
338 339 340 |
# File 'lib/rspec/core/example_group.rb', line 338 def self.include_examples(name, *args, &block) find_and_eval_shared("examples", name, caller.first, *args, &block) end |
+ (void) it + (void) it(&example_implementation) + (void) it(doc_string, *metadata_keys, metadata = {}) + (void) it(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Defines an example within a group. This is the primary API to define a code example.
154 |
# File 'lib/rspec/core/example_group.rb', line 154 define_example_method :it |
+ (void) it_behaves_like
Generates a nested example group and includes the shared content
mapped to name
in the nested group.
317 |
# File 'lib/rspec/core/example_group.rb', line 317 define_nested_shared_group_method :it_behaves_like, "behaves like" |
+ (void) it_should_behave_like
Generates a nested example group and includes the shared content
mapped to name
in the nested group.
320 |
# File 'lib/rspec/core/example_group.rb', line 320 define_nested_shared_group_method :it_should_behave_like |
+ (void) metadata
The Metadata object associated with this group.
47 48 49 |
# File 'lib/rspec/core/example_group.rb', line 47 def self. @metadata ||= nil end |
+ (void) pending + (void) pending(&example_implementation) + (void) pending(doc_string, *metadata_keys, metadata = {}) + (void) pending(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :pending => true
191 |
# File 'lib/rspec/core/example_group.rb', line 191 define_example_method :pending, :pending => true |
+ (void) run(reporter = RSpec::Core::NullReporter.new)
Runs all the examples in this group.
502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 |
# File 'lib/rspec/core/example_group.rb', line 502 def self.run(reporter=RSpec::Core::NullReporter.new) if RSpec.world.wants_to_quit RSpec.world.clear_remaining_example_groups if top_level? return end reporter.example_group_started(self) should_run_context_hooks = descendant_filtered_examples.any? begin run_before_context_hooks(new('before(:context) hook')) if should_run_context_hooks result_for_this_group = run_examples(reporter) results_for_descendants = ordering_strategy.order(children).map { |child| child.run(reporter) }.all? result_for_this_group && results_for_descendants rescue Pending::SkipDeclaredInExample => ex for_filtered_examples(reporter) { |example| example.skip_with_exception(reporter, ex) } rescue Exception => ex RSpec.world.wants_to_quit = true if fail_fast? for_filtered_examples(reporter) { |example| example.fail_with_exception(reporter, ex) } ensure run_after_context_hooks(new('after(:context) hook')) if should_run_context_hooks reporter.example_group_finished(self) end end |
+ (void) skip + (void) skip(&example_implementation) + (void) skip(doc_string, *metadata_keys, metadata = {}) + (void) skip(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :skip => true
188 |
# File 'lib/rspec/core/example_group.rb', line 188 define_example_method :skip, :skip => true |
+ (void) specify + (void) specify(&example_implementation) + (void) specify(doc_string, *metadata_keys, metadata = {}) + (void) specify(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Defines an example within a group.
Useful for when your docstring does not read well off of it
.
163 |
# File 'lib/rspec/core/example_group.rb', line 163 define_example_method :specify |
+ (void) xcontext + (void) xcontext(&example_group_definition) + (void) xcontext(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to temporarily make an example group skipped. Generates a subclass of this example group which inherits everything except the examples themselves.
283 |
# File 'lib/rspec/core/example_group.rb', line 283 define_example_group_method :xcontext, :skip => "Temporarily skipped with xcontext" |
+ (void) xdescribe + (void) xdescribe(&example_group_definition) + (void) xdescribe(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to temporarily make an example group skipped. Generates a subclass of this example group which inherits everything except the examples themselves.
279 |
# File 'lib/rspec/core/example_group.rb', line 279 define_example_group_method :xdescribe, :skip => "Temporarily skipped with xdescribe" |
+ (void) xexample + (void) xexample(&example_implementation) + (void) xexample(doc_string, *metadata_keys, metadata = {}) + (void) xexample(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :skip => 'Temporarily skipped with xexample'
.
179 |
# File 'lib/rspec/core/example_group.rb', line 179 define_example_method :xexample, :skip => 'Temporarily skipped with xexample' |
+ (void) xit + (void) xit(&example_implementation) + (void) xit(doc_string, *metadata_keys, metadata = {}) + (void) xit(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :skip => 'Temporarily skipped with xit'
.
182 |
# File 'lib/rspec/core/example_group.rb', line 182 define_example_method :xit, :skip => 'Temporarily skipped with xit' |
+ (void) xspecify + (void) xspecify(&example_implementation) + (void) xspecify(doc_string, *metadata_keys, metadata = {}) + (void) xspecify(doc_string, *metadata_keys, metadata = {}, &example_implementation)
Shortcut to define an example with :skip => 'Temporarily skipped with xspecify'
.
185 |
# File 'lib/rspec/core/example_group.rb', line 185 define_example_method :xspecify, :skip => 'Temporarily skipped with xspecify' |
Instance Method Details
- (void) described_class
Returns the class or module passed to the describe
method (or alias).
Returns nil if the subject is not a class or module.
95 96 97 |
# File 'lib/rspec/core/example_group.rb', line 95 def described_class self.class.described_class end |