require 'lucid/formatter/ansicolor' require 'lucid/formatter/duration' require 'lucid/formatter/summary' module Lucid module Formatter # 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[:passed]". 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. module Console extend ANSIColor include Duration include Summary 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 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 def print_steps(status) print_elements(runtime.steps(status), status, 'steps') end 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 def print_stats(features, options) @failures = runtime.scenarios(:failed).select { |s| s.is_a?(Lucid::AST::Scenario) || s.is_a?(Lucid::AST::OutlineTable::ExampleRow) } @failures.collect! { |s| (s.is_a?(Lucid::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("Lucid #{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 def print_exception(e, status, indent) message = "#{e.message} (#{e.class})" if ENV['LUCID_TRUNCATE_OUTPUT'] message = linebreaks(message, ENV['LUCID_TRUNCATE_OUTPUT'].to_i) end string = "#{message}\n#{e.backtrace.join("\n")}".indent(indent) @io.puts(format_string(string, status)) end # http://blade.nagaokaut.ac.jp/cgi-bin/scat.rb/ruby/ruby-talk/10655 def linebreaks(s, max) s.gsub(/.{1,#{max}}(?:\s|\Z)/){($& + 5.chr).gsub(/\n\005/,"\n").gsub(/\005/,"\n")}.rstrip end def print_matchers(options) return unless options[:matchers] undefined = runtime.steps(:undefined) return if undefined.empty? unknown_programming_language = runtime.unknown_programming_language? matchers = 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 matcher = @runtime.matcher_text(step.actual_keyword, step_name, step_multiline_class) matcher end.compact.uniq text = "\nYou can implement test definitions for undefined test steps with these matchers:\n\n" text += matchers.join("\n\n") @io.puts format_string(text, :undefined) if unknown_programming_language @io.puts format_string("\nNote: no test definitions were found in this repository or any" + "\nother associated locations. These test definition files should" + "\nbe where you put any of the suggested matchers.", :failed) end @io.puts @io.flush end 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 nothing was expected to pass. These scenarios passed:", :failed) print_elements(passed, :passed, "scenarios") else @io.puts format_string("\nThe --wip switch was used, so any non-passing scenarios were expected.\n", :passed) end end def print_failing_strict(options) return unless options[:strict] undefined = runtime.steps(:undefined) pending = runtime.steps(:pending) if undefined.any? || pending.any? @io.puts format_string("\nThe --strict switch was used, so nothing was expected to be undefined or pending. These scenarios violate that:", :failed) print_elements(undefined, :undefined, "steps") print_elements(pending, :pending, "steps") end end def embed(file, mime_type, label) # no-op end #define @delayed_messages = [] in your Formatter if you want to #activate this feature 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 def print_messages @delayed_messages.each {|message| print_message(message)} empty_messages end 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 def print_message(message) @io.puts(format_string(message, :tag).indent(@indent)) @io.flush end def empty_messages @delayed_messages = [] end 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}...\n\n" end private FORMATS = Hash.new{ |hash, format| hash[format] = method(format).to_proc } def format_for(*keys) key = keys.join('_').to_sym fmt = FORMATS[key] raise "No format for #{key.inspect}: #{FORMATS.inspect}" if fmt.nil? fmt end end end end