Class: Cucumber::Formatter::Pretty

Inherits:
Ast::Visitor show all
Includes:
Console, FileUtils
Defined in:
lib/cucumber/formatter/pretty.rb

Overview

This formatter prints features to plain text - exactly how they were parsed, just prettier. That means with proper indentation and alignment of table columns.

If the output is STDOUT (and not a file), there are bright colours to watch too.

Direct Known Subclasses

Cli::LanguageHelpFormatter

Constant Summary

Constants included from Console

Console::FORMATS

Constants included from ANSIColor

ANSIColor::ALIASES

Instance Attribute Summary collapse

Attributes inherited from Ast::Visitor

#options

Instance Method Summary collapse

Methods included from Console

#format_step, #format_string, #print_counts, #print_elements, #print_exception, #print_snippets, #print_steps, #print_undefined_scenarios

Methods included from ANSIColor

#grey

Methods inherited from Ast::Visitor

#current_feature_lines, #current_feature_lines=, #new_world, #step_definition, #visit_outline_table, #visit_steps, #world

Constructor Details

#initialize(step_mother, io, options, delim = '|') ⇒ Pretty

Returns a new instance of Pretty.



16
17
18
19
20
21
22
# File 'lib/cucumber/formatter/pretty.rb', line 16

def initialize(step_mother, io, options, delim='|')
  super(step_mother)
  @io = io
  @options = options
  @delim = delim
  @indent = 0
end

Instance Attribute Details

#indent=(value) ⇒ Object (writeonly)

Sets the attribute indent

Parameters:

  • value

    the value to set the attribute indent to.



14
15
16
# File 'lib/cucumber/formatter/pretty.rb', line 14

def indent=(value)
  @indent = value
end

Instance Method Details

#announce(announcement) ⇒ Object



158
159
160
161
# File 'lib/cucumber/formatter/pretty.rb', line 158

def announce(announcement)
  @io.puts(announcement)
  @io.flush
end

#visit_background(background) ⇒ Object



88
89
90
91
92
93
# File 'lib/cucumber/formatter/pretty.rb', line 88

def visit_background(background)
  @indent = 2
  background_already_visible = background.already_visited_steps?
  background.accept(self)
  @io.puts unless background_already_visible
end

#visit_comment(comment) ⇒ Object



48
49
50
# File 'lib/cucumber/formatter/pretty.rb', line 48

def visit_comment(comment)
  comment.accept(self)
end

#visit_comment_line(comment_line) ⇒ Object



52
53
54
55
56
57
# File 'lib/cucumber/formatter/pretty.rb', line 52

def visit_comment_line(comment_line)
  unless comment_line.blank?
    @io.puts(comment_line.indent(@indent)) 
    @io.flush
  end
end

#visit_examples(examples) ⇒ Object



95
96
97
# File 'lib/cucumber/formatter/pretty.rb', line 95

def visit_examples(examples)
  examples.accept(self)
end

#visit_examples_name(keyword, name) ⇒ Object



99
100
101
102
103
# File 'lib/cucumber/formatter/pretty.rb', line 99

def visit_examples_name(keyword, name)
  @io.puts("\n  #{keyword} #{name}")
  @io.flush
  @indent = 4
end

#visit_feature(feature) ⇒ Object



29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
# File 'lib/cucumber/formatter/pretty.rb', line 29

def visit_feature(feature)
  @indent = 0
  if @options[:autoformat]
    file = File.join(@options[:autoformat], feature.file)
    dir = File.dirname(file)
    mkdir_p(dir) unless File.directory?(dir)
    File.open(file, Cucumber.file_mode('w')) do |io|
      @io = io
      with_color do
        feature.accept(self)
      end
    end
  else
    with_color do
      feature.accept(self)
    end
  end
end

#visit_feature_element(feature_element) ⇒ Object



80
81
82
83
84
85
86
# File 'lib/cucumber/formatter/pretty.rb', line 80

def visit_feature_element(feature_element)
  @indent = 2
  @last_undefined = feature_element.undefined?
  feature_element.accept(self)
  @io.puts
  @io.flush
end

#visit_feature_name(name) ⇒ Object



74
75
76
77
78
# File 'lib/cucumber/formatter/pretty.rb', line 74

def visit_feature_name(name)
  @io.puts(name)
  @io.puts
  @io.flush
end

#visit_features(features) ⇒ Object



24
25
26
27
# File 'lib/cucumber/formatter/pretty.rb', line 24

def visit_features(features)
  super
  print_summary(features) unless @options[:autoformat]
end

#visit_multiline_arg(multiline_arg, status) ⇒ Object



130
131
132
133
# File 'lib/cucumber/formatter/pretty.rb', line 130

def visit_multiline_arg(multiline_arg, status)
  return if @options[:no_multiline]
  multiline_arg.accept(self, status)
end

#visit_py_string(string, status) ⇒ Object



142
143
144
145
146
147
# File 'lib/cucumber/formatter/pretty.rb', line 142

def visit_py_string(string, status)
  s = "\"\"\"\n#{string}\n\"\"\"".indent(@indent)
  s = s.split("\n").map{|l| l =~ /^\s+$/ ? '' : l}.join("\n")
  @io.puts(format_string(s, status))
  @io.flush
end

#visit_scenario_name(keyword, name, file_line, source_indent) ⇒ Object



105
106
107
108
109
110
111
112
113
114
115
# File 'lib/cucumber/formatter/pretty.rb', line 105

def visit_scenario_name(keyword, name, file_line, source_indent)
  line = "  #{keyword} #{name}"
  line = format_string(line, :undefined) if @last_undefined
  @io.print(line)
  if @options[:source]
    line_comment = " # #{file_line}".indent(source_indent)
    @io.print(format_string(line_comment, :comment))
  end
  @io.puts
  @io.flush
end

#visit_step(step) ⇒ Object



117
118
119
120
121
# File 'lib/cucumber/formatter/pretty.rb', line 117

def visit_step(step)
  @indent = 6
  exception = step.accept(self)
  print_exception(exception, @indent) if exception
end

#visit_step_name(keyword, step_name, status, step_definition, source_indent) ⇒ Object



123
124
125
126
127
128
# File 'lib/cucumber/formatter/pretty.rb', line 123

def visit_step_name(keyword, step_name, status, step_definition, source_indent)
  source_indent = nil unless @options[:source]
  formatted_step_name = format_step(keyword, step_name, status, step_definition, source_indent)
  @io.puts("    " + formatted_step_name)
  @io.flush
end

#visit_table_cell(table_cell, status) ⇒ Object



149
150
151
# File 'lib/cucumber/formatter/pretty.rb', line 149

def visit_table_cell(table_cell, status)
  table_cell.accept(self, status)
end

#visit_table_cell_value(value, width, status) ⇒ Object



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

def visit_table_cell_value(value, width, status)
  @io.print(' ' + format_string((value.to_s || '').ljust(width), status) + " #{@delim}")
  @io.flush
end

#visit_table_row(table_row, status) ⇒ Object



135
136
137
138
139
140
# File 'lib/cucumber/formatter/pretty.rb', line 135

def visit_table_row(table_row, status)
  @io.print @delim.indent(@indent)
  exception = table_row.accept(self, status)
  @io.puts
  print_exception(exception, 6) if exception
end

#visit_tag_name(tag_name) ⇒ Object



67
68
69
70
71
72
# File 'lib/cucumber/formatter/pretty.rb', line 67

def visit_tag_name(tag_name)
  tag = format_string("@#{tag_name}", :tag).indent(@indent)
  @io.print(tag)
  @io.flush
  @indent = 1
end

#visit_tags(tags) ⇒ Object



59
60
61
62
63
64
65
# File 'lib/cucumber/formatter/pretty.rb', line 59

def visit_tags(tags)
  tags.accept(self)
  if @indent == 1
    @io.puts 
    @io.flush
  end
end