class RSpec::Core::FilterManager

@private

Attributes

Public Class Methods

# File rspec-core/lib/rspec/core/filter_manager.rb, line 7
def initialize
  @exclusions, @inclusions = FilterRules.build
end

Public Instance Methods

add_ids (rerun_path, scoped_ids)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 22
def add_ids(rerun_path, scoped_ids)
  # ids is a hash of relative paths to arrays of ids
  # to match against. e.g.
  #   { "./path/to/file.rb" => ["1:1", "2:4"] }
  rerun_path = Metadata.relative_path(File.expand_path rerun_path)
  add_path_to_arrays_filter(:ids, rerun_path, scoped_ids)
end

add_location (file_path, line_numbers)

@api private

@param file_path [String] @param line_numbers [Array]

# File rspec-core/lib/rspec/core/filter_manager.rb, line 15
def add_location(file_path, line_numbers)
  # locations is a hash of expanded paths to arrays of line
  # numbers to match against. e.g.
  #   { "path/to/file.rb" => [37, 42] }
  add_path_to_arrays_filter(:locations, File.expand_path(file_path), line_numbers)
end

empty? ()

# File rspec-core/lib/rspec/core/filter_manager.rb, line 30
def empty?
  inclusions.empty? && exclusions.empty?
end

exclude (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 57
def exclude(*args)
  exclusions.add(args.last)
end

exclude_only (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 61
def exclude_only(*args)
  exclusions.use_only(args.last)
end

exclude_with_low_priority (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 65
def exclude_with_low_priority(*args)
  exclusions.add_with_low_priority(args.last)
end

include (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 69
def include(*args)
  inclusions.add(args.last)
end

include_only (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 73
def include_only(*args)
  inclusions.use_only(args.last)
end

include_with_low_priority (*args)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 77
def include_with_low_priority(*args)
  inclusions.add_with_low_priority(args.last)
end

prune (examples)

# File rspec-core/lib/rspec/core/filter_manager.rb, line 34
def prune(examples)
  # Semantically, this is unnecessary (the filtering below will return the empty
  # array unmodified), but for perf reasons it's worth exiting early here. Users
  # commonly have top-level examples groups that do not have any direct examples
  # and instead have nested groups with examples. In that kind of situation,
  # `examples` will be empty.
  return examples if examples.empty?

  examples = prune_conditionally_filtered_examples(examples)

  if inclusions.standalone?
    examples.select { |e| inclusions.include_example?(e) }
  else
    locations, ids, non_scoped_inclusions = inclusions.split_file_scoped_rules

    examples.select do |ex|
      file_scoped_include?(ex.metadata, ids, locations) do
        !exclusions.include_example?(ex) && non_scoped_inclusions.include_example?(ex)
      end
    end
  end
end