class RSpec::Core::Bisect::Coordinator

@private
- A bisect formatter: provides progress updates to the user.
- A bisect runner: runs a set of examples and returns the results.
- Bisect::ExampleMinimizer: Contains the core bisect logic.
- Bisect::ShellCommand: Generates shell commands to run spec subsets
The main entry point into the bisect logic. Coordinates among:

def self.bisect_with(spec_runner, original_cli_args, formatter) 

def self.bisect_with(spec_runner, original_cli_args, formatter)
  new(spec_runner, original_cli_args, formatter).bisect
end

def bisect 

def bisect
  repro = start_bisect_runner do |runner|
    minimizer = ExampleMinimizer.new(@shell_command, runner, @notifier)
    gracefully_abort_on_sigint(minimizer)
    minimizer.find_minimal_repro
    minimizer.repro_command_for_currently_needed_ids
  end
  @notifier.publish(:bisect_repro_command, :repro => repro)
  true
rescue BisectFailedError => e
  @notifier.publish(:bisect_failed, :failure_explanation => e.message)
  false
ensure
  @notifier.publish(:close)
end

def gracefully_abort_on_sigint(minimizer) 

def gracefully_abort_on_sigint(minimizer)
  trap('INT') do
    repro = minimizer.repro_command_for_currently_needed_ids
    @notifier.publish(:bisect_aborted, :repro => repro)
    exit(1)
  end
end

def initialize(spec_runner, original_cli_args, formatter) 

def initialize(spec_runner, original_cli_args, formatter)
  @spec_runner   = spec_runner
  @shell_command = ShellCommand.new(original_cli_args)
  @notifier      = Bisect::Notifier.new(formatter)
end

def start_bisect_runner(&block) 

def start_bisect_runner(&block)
  klass = @spec_runner.configuration.bisect_runner_class
  klass.start(@shell_command, @spec_runner, &block)
end