Class: RSpec::Core::Formatters::BaseTextFormatter

Inherits:
BaseFormatter
  • Object
show all
Defined in:
lib/rspec/core/formatters/base_text_formatter.rb

Overview

Base for all of RSpec's built-in formatters. See RSpec::Core::Formatters::BaseFormatter to learn more about all of the methods called by the reporter.

See Also:

Direct Known Subclasses

DocumentationFormatter, HtmlFormatter, ProgressFormatter

Constant Summary

VT100_COLORS =
{
  :black => 30,
  :red => 31,
  :green => 32,
  :yellow => 33,
  :blue => 34,
  :magenta => 35,
  :cyan => 36,
  :white => 37
}
VT100_COLOR_CODES =
VT100_COLORS.values.to_set

Constants included from Helpers

Helpers::DEFAULT_PRECISION, Helpers::SUB_SECOND_PRECISION

Instance Attribute Summary

Attributes inherited from BaseFormatter

#duration, #example_count, #example_group, #examples, #failed_examples, #failure_count, #output, #pending_count, #pending_examples

Instance Method Summary (collapse)

Methods inherited from BaseFormatter

#example_failed, #example_group_finished, #example_group_started, #example_passed, #example_pending, #example_started, #format_backtrace, #initialize, #start, #start_dump, #stop

Methods included from Helpers

#format_duration, #format_seconds, #pluralize, #strip_trailing_zeroes

Methods included from BacktraceFormatter

#format_backtrace

Constructor Details

This class inherits a constructor from RSpec::Core::Formatters::BaseFormatter

Instance Method Details

- (Object) close



162
163
164
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 162

def close
  output.close if IO === output && output != $stdout
end

- (Object) color_code_for(code_or_symbol)



179
180
181
182
183
184
185
186
187
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 179

def color_code_for(code_or_symbol)
  if VT100_COLOR_CODES.include?(code_or_symbol)
    code_or_symbol
  else
    VT100_COLORS.fetch(code_or_symbol) do
      color_code_for(:white)
    end
  end
end

- (Object) colorise_summary(summary)

Colorizes the output red for failure, yellow for pending, and green otherwise.

Parameters:

  • string (String)


35
36
37
38
39
40
41
42
43
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 35

def colorise_summary(summary)
  if failure_count > 0
    color(summary, RSpec.configuration.failure_color)
  elsif pending_count > 0
    color(summary, RSpec.configuration.pending_color)
  else
    color(summary, RSpec.configuration.success_color)
  end
end

- (Object) colorize(text, code_or_symbol)



189
190
191
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 189

def colorize(text, code_or_symbol)
  "\e[#{color_code_for(code_or_symbol)}m#{text}\e[0m"
end

- (Object) dump_commands_to_rerun_failed_examples

Outputs commands which can be used to re-run failed examples.



57
58
59
60
61
62
63
64
65
66
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 57

def dump_commands_to_rerun_failed_examples
  return if failed_examples.empty?
  output.puts
  output.puts("Failed examples:")
  output.puts

  failed_examples.each do |example|
    output.puts(failure_color("rspec #{RSpec::Core::Metadata::relative_path(example.location)}") + " " + detail_color("# #{example.full_description}"))
  end
end

- (Object) dump_failures



18
19
20
21
22
23
24
25
26
27
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 18

def dump_failures
  return if failed_examples.empty?
  output.puts
  output.puts "Failures:"
  failed_examples.each_with_index do |example, index|
    output.puts
    pending_fixed?(example) ? dump_pending_fixed(example, index) : dump_failure(example, index)
    dump_backtrace(example)
  end
end

- (Object) dump_pending



139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 139

def dump_pending
  unless pending_examples.empty?
    output.puts
    output.puts "Pending:"
    pending_examples.each do |pending_example|
      output.puts pending_color("  #{pending_example.full_description}")
      output.puts detail_color("    # #{pending_example.execution_result[:pending_message]}")
      output.puts detail_color("    # #{format_caller(pending_example.location)}")
      if pending_example.execution_result[:exception] \
        && RSpec.configuration.show_failures_in_pending_blocks?
        dump_failure_info(pending_example)
        dump_backtrace(pending_example)
      end
    end
  end
end

- (Object) dump_profile

Outputs the slowest examples and example groups in a report when using --profile COUNT (default 10).



72
73
74
75
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 72

def dump_profile
  dump_profile_slowest_examples
  dump_profile_slowest_example_groups
end

- (Object) dump_profile_slowest_example_groups



96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 96

def dump_profile_slowest_example_groups
  number_of_examples = RSpec.configuration.profile_examples
  example_groups = {} 

  examples.each do |example|
    location = example.example_group.parent_groups.last.[:example_group][:location]

    example_groups[location] ||= Hash.new(0)
    example_groups[location][:total_time]  += example.execution_result[:run_time]
    example_groups[location][:count]       += 1
    example_groups[location][:description] = example.example_group.top_level_description unless example_groups[location].has_key?(:description)
  end

  # stop if we've only one example group
  return if example_groups.keys.length <= 1
  
  example_groups.each do |loc, hash|
    hash[:average] = hash[:total_time].to_f / hash[:count]
  end
  
  sorted_groups = example_groups.sort_by {|_, hash| -hash[:average]}.first(number_of_examples)

  output.puts "\nTop #{sorted_groups.size} slowest example groups:"
  sorted_groups.each do |loc, hash| 
    average = "#{failure_color(format_seconds(hash[:average]))} #{failure_color("seconds")} average"
    total   = "#{format_seconds(hash[:total_time])} seconds"
    count   = pluralize(hash[:count], "example")
    output.puts "  #{hash[:description]}"
    output.puts detail_color("    #{average} (#{total} / #{count}) #{loc}")
  end
end

- (Object) dump_profile_slowest_examples



77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 77

def dump_profile_slowest_examples
  number_of_examples = RSpec.configuration.profile_examples
  sorted_examples = examples.sort_by {|example|
    example.execution_result[:run_time] }.reverse.first(number_of_examples)

  total, slows = [examples, sorted_examples].map {|exs|
    exs.inject(0.0) {|i, e| i + e.execution_result[:run_time] }}

  time_taken = slows / total
  percentage = '%.1f' % ((time_taken.nan? ? 0.0 : time_taken) * 100)

  output.puts "\nTop #{sorted_examples.size} slowest examples (#{format_seconds(slows)} seconds, #{percentage}% of total time):\n"

  sorted_examples.each do |example|
    output.puts "  #{example.full_description}"
    output.puts detail_color("    #{failure_color(format_seconds(example.execution_result[:run_time]))} #{failure_color("seconds")} #{format_caller(example.location)}")
  end
end

- (Object) dump_summary(duration, example_count, failure_count, pending_count)



45
46
47
48
49
50
51
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 45

def dump_summary(duration, example_count, failure_count, pending_count)
  super(duration, example_count, failure_count, pending_count)
  dump_profile unless mute_profile_output?(failure_count)
  output.puts "\nFinished in #{format_duration(duration)}\n"
  output.puts colorise_summary(summary_line(example_count, failure_count, pending_count))
  dump_commands_to_rerun_failed_examples
end

- (Object) message(message)



14
15
16
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 14

def message(message)
  output.puts message
end

- (Object) seed(number)



156
157
158
159
160
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 156

def seed(number)
  output.puts
  output.puts "Randomized with seed #{number}"
  output.puts
end

- (Object) summary_line(example_count, failure_count, pending_count)

Outputs summary with number of examples, failures and pending.



132
133
134
135
136
137
# File 'lib/rspec/core/formatters/base_text_formatter.rb', line 132

def summary_line(example_count, failure_count, pending_count)
  summary = pluralize(example_count, "example")
  summary << ", " << pluralize(failure_count, "failure")
  summary << ", #{pending_count} pending" if pending_count > 0
  summary
end