Module: RSpec::Core::MemoizedHelpers
- Included in:
- ExampleGroup
- Defined in:
- lib/rspec/core/memoized_helpers.rb
Overview
This module is included in ExampleGroup, making the methods available to be called from within example blocks.
Defined Under Namespace
Modules: ClassMethods
Instance Method Summary (collapse)
-
- (void) is_expected
Wraps the
subject
inexpect
to make it the target of an expectation. -
- (void) should(matcher = nil, message = nil)
When
should
is called with no explicit receiver, the call is delegated to the object returned bysubject
. -
- (void) should_not(matcher = nil, message = nil)
Just like
should
,should_not
delegates to the subject (implicit or explicit) of the example group. - - (void) subject
Instance Method Details
- (void) is_expected
This only works if you are using rspec-expectations.
Wraps the subject
in expect
to make it the target of an expectation.
Designed to read nicely for one-liners.
118 119 120 |
# File 'lib/rspec/core/memoized_helpers.rb', line 118 def is_expected expect(subject) end |
- (void) should(matcher = nil, message = nil)
This only works if you are using rspec-expectations.
If you are using RSpec's newer expect-based syntax you may
want to use is_expected.to
instead of should
.
When should
is called with no explicit receiver, the call is
delegated to the object returned by subject
. Combined with an
implicit subject this supports very concise expressions.
80 81 82 |
# File 'lib/rspec/core/memoized_helpers.rb', line 80 def should(matcher=nil, =nil) RSpec::Expectations::PositiveExpectationHandler.handle_matcher(subject, matcher, ) end |
- (void) should_not(matcher = nil, message = nil)
This only works if you are using rspec-expectations.
If you are using RSpec's newer expect-based syntax you may
want to use is_expected.to_not
instead of should_not
.
Just like should
, should_not
delegates to the subject (implicit or
explicit) of the example group.
99 100 101 |
# File 'lib/rspec/core/memoized_helpers.rb', line 99 def should_not(matcher=nil, =nil) RSpec::Expectations::NegativeExpectationHandler.handle_matcher(subject, matcher, ) end |
- (void) subject
subject
was contributed by Joe Ferris to support the one-liner
syntax embraced by shoulda matchers:
describe Widget do
it { is_expected.to validate_presence_of(:name) }
# or
it { should validate_presence_of(:name) }
end
While the examples below demonstrate how to use subject
explicitly in examples, we recommend that you define a method with
an intention revealing name instead.
Because subject
is designed to create state that is reset
between each example, and before(:context)
is designed to setup
state that is shared across all examples in an example group,
subject
is not intended to be used in a before(:context)
hook.
55 56 57 58 59 60 61 62 |
# File 'lib/rspec/core/memoized_helpers.rb', line 55 def subject __memoized.fetch(:subject) do __memoized[:subject] = begin described = described_class || self.class..fetch(:description_args).first Class === described ? described.new : described end end end |