Module: Cucumber::Formatter::Console

Extended by:
ANSIColor
Includes:
Duration, Summary
Included in:
Pretty, Progress, Usage
Defined in:
lib/cucumber/formatter/console.rb

Overview

This module contains helper methods that are used by formatters that print output to the terminal.

FORMAT is a hash of Proc objects, keyed by step-definition types, e.g. “FORMAT”. The Proc is called for each line of the step’s output.

format_step calls format_string, format_string calls format_for to obtain the formatting Proc.

Example:

The ANSI color console formatter defines a map of step-type to output color (e.g. “passed” to “green”), then builds methods named for the step-types (e.g. “def passed”), which themselves wrap the corresponding color-named methods provided by Term::ANSIColor (e.g. “def red”).

During output, each line is processed by passing it to the formatter Proc which returns the formatted (e.g. colored) string.

Constant Summary

Constants included from ANSIColor

ANSIColor::ALIASES

Constants included from Term::ANSIColor

Term::ANSIColor::ATTRIBUTES, Term::ANSIColor::ATTRIBUTE_NAMES, Term::ANSIColor::COLORED_REGEXP

Instance Method Summary collapse

Methods included from ANSIColor

cukes, define_grey, define_real_grey, green_cukes, grey, red_cukes, yellow_cukes

Methods included from Term::ANSIColor

attributes, coloring=, coloring?, #uncolored

Methods included from Summary

#scenario_summary, #step_summary

Methods included from Duration

#format_duration

Instance Method Details

#embed(file, mime_type, label) ⇒ Object 



154
155
156
 
# File 'lib/cucumber/formatter/console.rb', line 154

def embed(file, mime_type, label)
  # no-op
end

#empty_messages ⇒ Object 



191
192
193
 
# File 'lib/cucumber/formatter/console.rb', line 191

def empty_messages
  @delayed_messages = []
end

#format_step(keyword, step_match, status, source_indent) ⇒ Object 



33
34
35
36
37
38
39
40
41
42
43
44
 
# File 'lib/cucumber/formatter/console.rb', line 33

def format_step(keyword, step_match, status, source_indent)
  comment = if source_indent
    c = (' # ' + step_match.file_colon_line).indent(source_indent)
    format_string(c, :comment)
  else
    ''
  end

  format = format_for(status, :param)
  line = keyword + step_match.format_args(format) + comment
  format_string(line, status)
end

#format_string(o, status) ⇒ Object 



46
47
48
49
50
51
52
53
54
55
 
# File 'lib/cucumber/formatter/console.rb', line 46

def format_string(o, status)
  fmt = format_for(status)
  o.to_s.split("\n").map do |line|
    if Proc === fmt
      fmt.call(line)
    else
      fmt % line
    end
  end.join("\n")
end

#linebreaks(s, max) ⇒ Object

blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/10655



112
113
114
 
# File 'lib/cucumber/formatter/console.rb', line 112

def linebreaks(s, max)
  s.gsub(/.{1,#{max}}(?:\s|\Z)/){($& + 5.chr).gsub(/\n\005/,"\n").gsub(/\005/,"\n")}.rstrip
end

#print_elements(elements, status, kind) ⇒ Object 



61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/cucumber/formatter/console.rb', line 61

def print_elements(elements, status, kind)
  if elements.any?
    @io.puts(format_string("(::) #{status} #{kind} (::)", status))
    @io.puts
    @io.flush
  end

  elements.each_with_index do |element, i|
    if status == :failed
      print_exception(element.exception, status, 0)
    else
      @io.puts(format_string(element.backtrace_line, status))
    end
    @io.puts
    @io.flush
  end
end

#print_exception(e, status, indent) ⇒ Object 



101
102
103
104
105
106
107
108
109
 
# File 'lib/cucumber/formatter/console.rb', line 101

def print_exception(e, status, indent)
  message = "#{e.message} (#{e.class})"
  if ENV['CUCUMBER_TRUNCATE_OUTPUT']
    message = linebreaks(message, ENV['CUCUMBER_TRUNCATE_OUTPUT'].to_i)
  end

  string = "#{message}\n#{e.backtrace.join("\n")}".indent(indent)
  @io.puts(format_string(string, status))
end

#print_message(message) ⇒ Object 



186
187
188
189
 
# File 'lib/cucumber/formatter/console.rb', line 186

def print_message(message)
  @io.puts(format_string(message, :tag).indent(@indent))
  @io.flush
end

#print_messages ⇒ Object 



174
175
176
177
 
# File 'lib/cucumber/formatter/console.rb', line 174

def print_messages
  @delayed_messages.each {|message| print_message(message)}
  empty_messages
end

#print_passing_wip(options) ⇒ Object 



143
144
145
146
147
148
149
150
151
152
 
# File 'lib/cucumber/formatter/console.rb', line 143

def print_passing_wip(options)
  return unless options[:wip]
  passed = runtime.scenarios(:passed)
  if passed.any?
    @io.puts format_string("\nThe --wip switch was used, so I didn't expect anything to pass. These scenarios passed:", :failed)
    print_elements(passed, :passed, "scenarios")
  else
    @io.puts format_string("\nThe --wip switch was used, so the failures were expected. All is good.\n", :passed)
  end
end

#print_profile_information ⇒ Object 



195
196
197
198
199
200
201
202
203
 
# File 'lib/cucumber/formatter/console.rb', line 195

def print_profile_information
  return if @options[:skip_profile_information] || @options[:profiles].nil? || @options[:profiles].empty?
  profiles = @options[:profiles]
  profiles_sentence = ''
  profiles_sentence = profiles.size == 1 ? profiles.first :
    "#{profiles[0...-1].join(', ')} and #{profiles.last}"

  @io.puts "Using the #{profiles_sentence} profile#{'s' if profiles.size> 1}..."
end

#print_snippets(options) ⇒ Object 



116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
 
# File 'lib/cucumber/formatter/console.rb', line 116

def print_snippets(options)
  return unless options[:snippets]
  undefined = runtime.steps(:undefined)
  return if undefined.empty?

  unknown_programming_language = runtime.unknown_programming_language?
  snippets = undefined.map do |step|
    step_name = Undefined === step.exception ? step.exception.step_name : step.name
    step_multiline_class = step.multiline_arg ? step.multiline_arg.class : nil
    snippet = @runtime.snippet_text(step.actual_keyword, step_name, step_multiline_class)
    snippet
  end.compact.uniq

  text = "\nYou can implement step definitions for undefined steps with these snippets:\n\n"
  text += snippets.join("\n\n")
  @io.puts format_string(text, :undefined)

  if unknown_programming_language
    @io.puts format_string("\nIf you want snippets in a different programming language," +
                           "\njust make sure a file with the appropriate file extension" +
                           "\nexists where cucumber looks for step definitions.", :failed)
  end

  @io.puts
  @io.flush
end

#print_stats(features, options) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
 
# File 'lib/cucumber/formatter/console.rb', line 79

def print_stats(features, options)
  @failures = runtime.scenarios(:failed).select { |s| s.is_a?(Cucumber::Ast::Scenario) || s.is_a?(Cucumber::Ast::OutlineTable::ExampleRow) }
  @failures.collect! { |s| (s.is_a?(Cucumber::Ast::OutlineTable::ExampleRow)) ? s.scenario_outline : s }

  if !@failures.empty?
    @io.puts format_string("Failing Scenarios:", :failed)
    @failures.each do |failure|
      profiles_string = options.custom_profiles.empty? ? '' : (options.custom_profiles.map{|profile| "-p #{profile}" }).join(' ') + ' '
      source = options[:source] ? format_string(" # Scenario: " + failure.name, :comment) : ''
      @io.puts format_string("cucumber #{profiles_string}" + failure.file_colon_line, :failed) + source
    end
    @io.puts
  end

  @io.puts scenario_summary(runtime) {|status_count, status| format_string(status_count, status)}
  @io.puts step_summary(runtime) {|status_count, status| format_string(status_count, status)}

  @io.puts(format_duration(features.duration)) if features && features.duration

  @io.flush
end

#print_steps(status) ⇒ Object 



57
58
59
 
# File 'lib/cucumber/formatter/console.rb', line 57

def print_steps(status)
  print_elements(runtime.steps(status), status, 'steps')
end

#print_table_row_messages ⇒ Object 



179
180
181
182
183
184
 
# File 'lib/cucumber/formatter/console.rb', line 179

def print_table_row_messages
  return if @delayed_messages.empty?
  @io.print(format_string(@delayed_messages.join(', '), :tag).indent(2))
  @io.flush
  empty_messages
end

#puts(*messages) ⇒ Object

define @delayed_messages = [] in your Formatter if you want to activate this feature



160
161
162
163
164
165
166
167
168
169
170
171
172
 
# File 'lib/cucumber/formatter/console.rb', line 160

def puts(*messages)
  if @delayed_messages
    @delayed_messages += messages
  else
    if @io
      @io.puts
      messages.each do |message|
        @io.puts(format_string(message, :tag))
      end
      @io.flush
    end
  end
end