Class Spec::Runner::Options

# File lib/spec/runner/options.rb, line 78
      def add_example_group(example_group)
        @example_groups << example_group
      end

# File lib/spec/runner/options.rb, line 143
      def after_suite_parts
        Spec::Example::BeforeAndAfterHooks.after_suite_parts
      end

# File lib/spec/runner/options.rb, line 139
      def before_suite_parts
        Spec::Example::BeforeAndAfterHooks.before_suite_parts
      end

# File lib/spec/runner/options.rb, line 160
      def colour=(colour)
        @colour = colour
        if @colour && RUBY_PLATFORM =~ /mswin|mingw/ ;\
          begin ;\
            replace_output = @output_stream.equal?($stdout) ;\
            require 'rubygems' unless ENV['NO_RUBYGEMS'] ;\
            require 'Win32/Console/ANSI' ;\
            @output_stream = $stdout if replace_output ;\
          rescue LoadError ;\
            warn "You must 'gem install win32console' to use colour on Windows" ;\
            @colour = false ;\
          end
        end
      end

# File lib/spec/runner/options.rb, line 261
      def dry_run?
        @dry_run == true
      end

# File lib/spec/runner/options.rb, line 86
      def example_line
        Spec::Runner::LineNumberQuery.new(self).example_line_for(files.first, line_number)
      end

# File lib/spec/runner/options.rb, line 147
      def examples_run?
        @examples_run
      end

# File lib/spec/runner/options.rb, line 151
      def examples_should_not_be_run
        @examples_should_be_run = false
      end

# File lib/spec/runner/options.rb, line 245
      def files_to_load
        result = []
        sorted_files.each do |file|
          if File.directory?(file)
            filename_pattern.split(",").each do |pattern|
              result += Dir[File.expand_path("#{file}/#{pattern.strip}")]
            end
          elsif File.file?(file)
            result << file
          else
            raise "File or directory not found: #{file}"
          end
        end
        result
      end

# File lib/spec/runner/options.rb, line 225
      def formatter_options
        @formatter_options ||= OpenStruct.new(
          :colour   => colour,
          :autospec => autospec,
          :dry_run  => dry_run
        )
      end

# File lib/spec/runner/options.rb, line 208
      def formatters
        @format_options ||= [['progress', @output_stream]]
        @formatters ||= load_formatters(@format_options, EXAMPLE_FORMATTERS)
      end

# File lib/spec/runner/options.rb, line 82
      def line_number_requested?
        !!line_number
      end

# File lib/spec/runner/options.rb, line 213
      def load_formatters(format_options, formatters)
        format_options.map do |format, where|
          formatter_type = if formatters[format]
            require formatters[format][0]
            eval(formatters[format][1], binding, __FILE__, __LINE__)
          else
            load_class(format, 'formatter', '--format')
          end
          formatter_type.new(formatter_options, where)
        end
      end

# File lib/spec/runner/options.rb, line 233
      def load_heckle_runner(heckle)
        @format_options ||= [['silent', @output_stream]]
        suffix = ([/mswin/, /java/].detect{|p| p =~ RUBY_PLATFORM} || Spec::Ruby.version.to_f == 1.9) ? '_unsupported' : ''
        require "spec/runner/heckle_runner#{suffix}"
        @heckle_runner = ::Spec::Runner::HeckleRunner.new(heckle)
      end

# File lib/spec/runner/options.rb, line 155
      def mock_framework
        # TODO - don't like this dependency - perhaps store this in here instead?
        Spec::Runner.configuration.mock_framework
      end

# File lib/spec/runner/options.rb, line 240
      def number_of_examples
        return examples.size unless examples.empty?
        @example_groups.inject(0) {|sum, group| sum + group.number_of_examples}
      end

# File lib/spec/runner/options.rb, line 175
      def parse_diff(format)
        case format
        when :context, 'context', 'c'
          @diff_format  = :context
          default_differ
        when :unified, 'unified', 'u', '', nil
          @diff_format  = :unified
          default_differ
        else
          @diff_format  = :custom
          self.differ_class = load_class(format, 'differ', '--diff')
        end
      end

# File lib/spec/runner/options.rb, line 189
      def parse_example(example)
        if(File.file?(example))
          @examples = [File.open(example).read.split("\n")].flatten
        else
          @examples = [example]
        end
      end

# File lib/spec/runner/options.rb, line 197
      def parse_format(format_arg)
        format, where = ClassAndArgumentsParser.parse(format_arg)
        unless where
          raise "When using several --format options only one of them can be without a file" if @out_used
          where = @output_stream
          @out_used = true
        end
        @format_options ||= []
        @format_options << [format, where]
      end

# File lib/spec/runner/options.rb, line 90
      def remove_example_group(example_group)
        @example_groups.delete(example_group)
      end

# File lib/spec/runner/options.rb, line 94
      def require_ruby_debug
        require 'rubygems' unless ENV['NO_RUBYGEMS']
        require 'ruby-debug'
      end

# File lib/spec/runner/options.rb, line 99
      def run_examples
        require_ruby_debug if debug
        return true unless examples_should_be_run?
        success = true
        begin
          runner = custom_runner || ExampleGroupRunner.new(self)

          unless @files_loaded
            runner.load_files(files_to_load)
            @files_loaded = true
          end
          
          define_predicate_matchers
          plugin_mock_framework

          # TODO - this has to happen after the files get loaded,
          # otherwise the before_suite_parts are not populated
          # from the configuration. There is no spec for this
          # directly, but features/before_and_after_blocks/before_and_after_blocks.story
          # will fail if this happens before the files are loaded.
          before_suite_parts.each do |part|
            part.call
          end

          if example_groups.empty?
            true
          else
            set_spec_from_line_number if line_number
            success = runner.run
            @examples_run = true
            heckle if heckle_runner
            success
          end
        ensure
          after_suite_parts.each do |part|
            part.arity < 1 ? part.call : part.call(success)
          end
        end
      end