Class: RSpec::Core::World Private
- Inherits:
-
Object
- Object
- RSpec::Core::World
- Defined in:
- lib/rspec/core/world.rb
Overview
This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.
Internal container for global non-configuration data.
Instance Attribute Summary collapse
-
#wants_to_quit ⇒ void
private
Used internally to determine what to do when a SIGINT is received.
Instance Method Summary collapse
-
#announce_exclusion_filter(announcements) ⇒ void
private
Add exclusion filters to announcement message.
-
#announce_filters ⇒ void
private
Notify reporter of filters.
-
#announce_inclusion_filter(announcements) ⇒ void
private
Add inclusion filters to announcement message.
-
#example_count(groups = example_groups) ⇒ void
private
Get count of examples to be run.
-
#initialize(configuration = RSpec.configuration) ⇒ World
constructor
private
A new instance of World.
-
#ordered_example_groups ⇒ void
private
Apply ordering strategy from configuration to example groups.
-
#preceding_declaration_line(absolute_file_name, filter_line) ⇒ void
private
Find line number of previous declaration.
-
#register(example_group) ⇒ void
private
Register an example group.
-
#reset ⇒ void
private
Reset world to 'scratch' before running suite.
Constructor Details
#initialize(configuration = RSpec.configuration) ⇒ World
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Returns a new instance of World.
13 14 15 16 17 18 19 20 |
# File 'lib/rspec/core/world.rb', line 13 def initialize(configuration=RSpec.configuration) @configuration = configuration @example_groups = [] @example_group_counts_by_spec_file = Hash.new(0) @filtered_examples = Hash.new do |hash, group| hash[group] = filter_manager.prune(group.examples) end end |
Instance Attribute Details
#wants_to_quit ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Used internally to determine what to do when a SIGINT is received.
11 12 13 |
# File 'lib/rspec/core/world.rb', line 11 def wants_to_quit @wants_to_quit end |
Instance Method Details
#announce_exclusion_filter(announcements) ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Add exclusion filters to announcement message.
176 177 178 179 180 |
# File 'lib/rspec/core/world.rb', line 176 def announce_exclusion_filter(announcements) return if exclusion_filter.empty? announcements << "exclude #{exclusion_filter.description}" end |
#announce_filters ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Notify reporter of filters.
123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 |
# File 'lib/rspec/core/world.rb', line 123 def announce_filters filter_announcements = [] announce_inclusion_filter filter_announcements announce_exclusion_filter filter_announcements unless filter_manager.empty? if filter_announcements.length == 1 ("Run options: #{filter_announcements[0]}") else ("Run options:\n #{filter_announcements.join("\n ")}") end end if @configuration.run_all_when_everything_filtered? && example_count.zero? && !@configuration.only_failures? ("#{}; ignoring #{inclusion_filter.description}") filtered_examples.clear inclusion_filter.clear end return unless example_count.zero? example_groups.clear if filter_manager.empty? ("No examples found.") elsif exclusion_filter.empty? || inclusion_filter.empty? () end end |
#announce_inclusion_filter(announcements) ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Add inclusion filters to announcement message.
167 168 169 170 171 |
# File 'lib/rspec/core/world.rb', line 167 def announce_inclusion_filter(announcements) return if inclusion_filter.empty? announcements << "include #{inclusion_filter.description}" end |
#example_count(groups = example_groups) ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Get count of examples to be run.
81 82 83 84 |
# File 'lib/rspec/core/world.rb', line 81 def example_count(groups=example_groups) FlatMap.flat_map(groups) { |g| g.descendants }. inject(0) { |a, e| a + e.filtered_examples.size } end |
#ordered_example_groups ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Apply ordering strategy from configuration to example groups.
25 26 27 28 |
# File 'lib/rspec/core/world.rb', line 25 def ordered_example_groups ordering_strategy = @configuration.ordering_registry.fetch(:global) ordering_strategy.order(@example_groups) end |
#preceding_declaration_line(absolute_file_name, filter_line) ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Find line number of previous declaration.
99 100 101 102 103 104 105 |
# File 'lib/rspec/core/world.rb', line 99 def preceding_declaration_line(absolute_file_name, filter_line) line_numbers = descending_declaration_line_numbers_by_file.fetch(absolute_file_name) do return nil end line_numbers.find { |num| num <= filter_line } end |
#register(example_group) ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Register an example group.
51 52 53 54 55 56 |
# File 'lib/rspec/core/world.rb', line 51 def register(example_group) @configuration.on_example_group_definition_callbacks.each { |block| block.call(example_group) } example_groups << example_group @example_group_counts_by_spec_file[example_group.[:absolute_file_path]] += 1 example_group end |
#reset ⇒ void
This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.
Reset world to 'scratch' before running suite.
33 34 35 36 |
# File 'lib/rspec/core/world.rb', line 33 def reset example_groups.clear @shared_example_group_registry = nil end |