require 'rbconfig' module RSpec module Core # @api private # # Internal container for global non-configuration data class World include RSpec::Core::Hooks # @private attr_reader :example_groups, :filtered_examples # Used internally to determine what to do when a SIGINT is received attr_accessor :wants_to_quit def initialize(configuration=RSpec.configuration) @configuration = configuration @example_groups = [] @filtered_examples = Hash.new do |hash, group| hash[group] = begin examples = group.examples.dup examples = filter_manager.prune(examples) examples.uniq! examples end end end # @private # Used internally to clear remaining groups when fail_fast is set def clear_remaining_example_groups example_groups.clear end # @private def windows_os? RbConfig::CONFIG['host_os'] =~ /cygwin|mswin|mingw|bccwin|wince|emx/ end # @api private # # Apply ordering strategy from configuration to example groups def ordered_example_groups ordering_strategy = @configuration.ordering_registry.fetch(:global) ordering_strategy.order(@example_groups) end # @api private # # Reset world to 'scratch' before running suite def reset example_groups.clear @shared_example_group_registry = nil end # @private def filter_manager @configuration.filter_manager end # @api private # # Register an example group def register(example_group) example_groups << example_group example_group end # @private def shared_example_group_registry @shared_example_group_registry ||= SharedExampleGroup::Registry.new end # @private def inclusion_filter @configuration.inclusion_filter end # @private def exclusion_filter @configuration.exclusion_filter end # @private def configure_group(group) @configuration.configure_group(group) end # @api private # # Get count of examples to be run def example_count(groups=example_groups) FlatMap.flat_map(groups) { |g| g.descendants }. inject(0) { |a, e| a + e.filtered_examples.size } end # @api private # # Find line number of previous declaration def preceding_declaration_line(filter_line) declaration_line_numbers.sort.inject(nil) do |highest_prior_declaration_line, line| line <= filter_line ? line : highest_prior_declaration_line end end # @private def reporter @configuration.reporter end # @api private # # Notify reporter of filters def announce_filters filter_announcements = [] announce_inclusion_filter filter_announcements announce_exclusion_filter filter_announcements unless filter_manager.empty? if filter_announcements.length == 1 reporter.message("Run options: #{filter_announcements[0]}") else reporter.message("Run options:\n #{filter_announcements.join("\n ")}") end end if @configuration.run_all_when_everything_filtered? && example_count.zero? reporter.message("#{everything_filtered_message}; ignoring #{inclusion_filter.description}") filtered_examples.clear inclusion_filter.clear end return unless example_count.zero? example_groups.clear if filter_manager.empty? reporter.message("No examples found.") elsif exclusion_filter.empty? message = everything_filtered_message if @configuration.run_all_when_everything_filtered? message << "; ignoring #{inclusion_filter.description}" end reporter.message(message) elsif inclusion_filter.empty? reporter.message(everything_filtered_message) end end # @private def everything_filtered_message "\nAll examples were filtered out" end # @api private # # Add inclusion filters to announcement message def announce_inclusion_filter(announcements) return if inclusion_filter.empty? announcements << "include #{inclusion_filter.description}" end # @api private # # Add exclusion filters to announcement message def announce_exclusion_filter(announcements) return if exclusion_filter.empty? announcements << "exclude #{exclusion_filter.description}" end private def declaration_line_numbers @line_numbers ||= example_groups.inject([]) do |lines, g| lines + g.declaration_line_numbers end end end end end