Class: RR::Space
- Inherits:
-
Object
- Object
- RR::Space
- Defined in:
- lib/rr/space.rb
Overview
RR::Space is a Dependency Injection en.wikipedia.org/wiki/Dependency_injection and global state object for the RR framework. The RR::Space.instance is a singleton that holds the state.
Class Attribute Summary collapse
Instance Attribute Summary collapse
-
#doubles ⇒ Object
readonly
Returns the value of attribute doubles.
-
#ordered_scenarios ⇒ Object
readonly
Returns the value of attribute ordered_scenarios.
-
#trim_backtrace ⇒ Object
Returns the value of attribute trim_backtrace.
Instance Method Summary collapse
-
#create_do_not_allow_creator(subject, &definition) ⇒ Object
Creates a DoNotAllowCreator.
-
#create_double(object, method_name) ⇒ Object
Reuses or creates, if none exists, a Double for the passed in object and method_name.
-
#create_mock_creator(subject, &definition) ⇒ Object
Creates a MockCreator.
-
#create_probe_creator(subject, &definition) ⇒ Object
Creates a ProbeCreator.
-
#create_scenario(double) ⇒ Object
Creates and registers a Scenario to be verified.
-
#create_stub_creator(subject, &definition) ⇒ Object
Creates a StubCreator.
-
#initialize ⇒ Space
constructor
A new instance of Space.
-
#register_ordered_scenario(scenario) ⇒ Object
Registers the ordered Scenario to be verified.
-
#reset_double(object, method_name) ⇒ Object
Resets the Double for the passed in object and method_name.
-
#reset_doubles ⇒ Object
Resets the registered Doubles for the next test run.
-
#verify_double(object, method_name) ⇒ Object
Verifies the Double for the passed in object and method_name.
-
#verify_doubles ⇒ Object
Verifies all the Double objects have met their TimesCalledExpectations.
-
#verify_ordered_scenario(scenario) ⇒ Object
Verifies that the passed in ordered Scenario is being called in the correct position.
Constructor Details
#initialize ⇒ Space
Returns a new instance of Space.
20 21 22 23 24 |
# File 'lib/rr/space.rb', line 20 def initialize @doubles = Hash.new {|hash, subject_object| hash[subject_object] = Hash.new} @ordered_scenarios = [] @trim_backtrace = false end |
Class Attribute Details
.instance ⇒ Object
7 8 9 |
# File 'lib/rr/space.rb', line 7 def instance @instance ||= new end |
Instance Attribute Details
#doubles ⇒ Object (readonly)
Returns the value of attribute doubles.
18 19 20 |
# File 'lib/rr/space.rb', line 18 def doubles @doubles end |
#ordered_scenarios ⇒ Object (readonly)
Returns the value of attribute ordered_scenarios.
18 19 20 |
# File 'lib/rr/space.rb', line 18 def ordered_scenarios @ordered_scenarios end |
#trim_backtrace ⇒ Object
Returns the value of attribute trim_backtrace.
19 20 21 |
# File 'lib/rr/space.rb', line 19 def trim_backtrace @trim_backtrace end |
Instance Method Details
#create_do_not_allow_creator(subject, &definition) ⇒ Object
Creates a DoNotAllowCreator.
42 43 44 |
# File 'lib/rr/space.rb', line 42 def create_do_not_allow_creator(subject, &definition) DoNotAllowCreator.new(self, subject, &definition) end |
#create_double(object, method_name) ⇒ Object
Reuses or creates, if none exists, a Double for the passed in object and method_name. When a Double is created, it binds the dispatcher to the object.
57 58 59 60 61 62 63 64 65 |
# File 'lib/rr/space.rb', line 57 def create_double(object, method_name) double = @doubles[object][method_name.to_sym] return double if double double = Double.new(self, object, method_name.to_sym) @doubles[object][method_name.to_sym] = double double.bind double end |
#create_mock_creator(subject, &definition) ⇒ Object
Creates a MockCreator.
27 28 29 |
# File 'lib/rr/space.rb', line 27 def create_mock_creator(subject, &definition) MockCreator.new(self, subject, &definition) end |
#create_probe_creator(subject, &definition) ⇒ Object
Creates a ProbeCreator.
37 38 39 |
# File 'lib/rr/space.rb', line 37 def create_probe_creator(subject, &definition) ProbeCreator.new(self, subject, &definition) end |
#create_scenario(double) ⇒ Object
Creates and registers a Scenario to be verified.
47 48 49 50 51 |
# File 'lib/rr/space.rb', line 47 def create_scenario(double) scenario = Scenario.new(self) double.register_scenario scenario scenario end |
#create_stub_creator(subject, &definition) ⇒ Object
Creates a StubCreator.
32 33 34 |
# File 'lib/rr/space.rb', line 32 def create_stub_creator(subject, &definition) StubCreator.new(self, subject, &definition) end |
#register_ordered_scenario(scenario) ⇒ Object
Registers the ordered Scenario to be verified.
68 69 70 |
# File 'lib/rr/space.rb', line 68 def register_ordered_scenario(scenario) @ordered_scenarios << scenario end |
#reset_double(object, method_name) ⇒ Object
Resets the Double for the passed in object and method_name.
107 108 109 110 111 |
# File 'lib/rr/space.rb', line 107 def reset_double(object, method_name) double = @doubles[object].delete(method_name) @doubles.delete(object) if @doubles[object].empty? double.reset end |
#reset_doubles ⇒ Object
Resets the registered Doubles for the next test run.
91 92 93 94 95 96 97 |
# File 'lib/rr/space.rb', line 91 def reset_doubles @doubles.each do |object, method_double_map| method_double_map.keys.each do |method_name| reset_double(object, method_name) end end end |
#verify_double(object, method_name) ⇒ Object
Verifies the Double for the passed in object and method_name.
100 101 102 103 104 |
# File 'lib/rr/space.rb', line 100 def verify_double(object, method_name) @doubles[object][method_name].verify ensure reset_double object, method_name end |
#verify_doubles ⇒ Object
Verifies all the Double objects have met their TimesCalledExpectations.
82 83 84 85 86 87 88 |
# File 'lib/rr/space.rb', line 82 def verify_doubles @doubles.each do |object, method_double_map| method_double_map.keys.each do |method_name| verify_double(object, method_name) end end end |
#verify_ordered_scenario(scenario) ⇒ Object
Verifies that the passed in ordered Scenario is being called in the correct position.
74 75 76 77 78 |
# File 'lib/rr/space.rb', line 74 def verify_ordered_scenario(scenario) raise Errors::ScenarioOrderError unless @ordered_scenarios.first == scenario @ordered_scenarios.shift if scenario.times_called_verified? scenario end |