Module: Cucumber::Formatter::ANSIColor

Includes:
Term::ANSIColor
Included in:
Console
Defined in:
lib/cucumber/formatter/ansicolor.rb

Overview

Defines aliases for coloured output. You don’t invoke any methods from this module directly, but you can change the output colours by defining a CUCUMBER_COLORS variable in your shell, very much like how you can tweak the familiar POSIX command ls with <a href=“mipsisrisc.com/rambling/2008/06/27/lscolorsls_colors-now-with-linux-support/”>$LSCOLORS/$LS_COLORS</a>

The colours that you can change are:

  • undefined - defaults to yellow

  • pending - defaults to yellow

  • pending_param - defaults to yellow,bold

  • failed - defaults to red

  • failed_param - defaults to red,bold

  • passed - defaults to green

  • passed_param - defaults to green,bold

  • outline - defaults to cyan

  • outline_param - defaults to cyan,bold

  • skipped - defaults to cyan

  • skipped_param - defaults to cyan,bold

  • comment - defaults to grey

  • tag - defaults to cyan

For instance, if your shell has a black background and a green font (like the “Homebrew” settings for OS X’ Terminal.app), you may want to override passed steps to be white instead of green.

Although not listed, you can also use grey.

Examples: (On Windows, use SET instead of export.)

export CUCUMBER_COLORS="passed=white"
export CUCUMBER_COLORS="passed=white,bold:passed_param=white,bold,underline"

To see what colours and effects are available, just run this in your shell:

ruby -e "require 'rubygems'; require 'term/ansicolor'; puts Cucumber::Term::ANSIColor.attributes"

Constant Summary collapse

ALIASES = 
Hash.new do |h,k|
  if k.to_s =~ /(.*)_param/
    h[$1] + ',bold'
  end
end.merge({
  'undefined' => 'yellow',
  'pending'   => 'yellow',
  'failed'    => 'red',
  'passed'    => 'green',
  'outline'   => 'cyan',
  'skipped'   => 'cyan',
  'comment'   => 'grey',
  'tag'       => 'cyan'
})

Constants included from Term::ANSIColor

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

Class Method Summary collapse

Instance Method Summary collapse

Methods included from Term::ANSIColor

attributes, coloring=, coloring?, #uncolored

Class Method Details

.define_grey ⇒ Object

:nodoc:



103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 103

def self.define_grey #:nodoc:
  begin
    gem 'genki-ruby-terminfo'
    require 'terminfo'
    case TermInfo.default_object.tigetnum("colors")
    when 0
      raise "Your terminal doesn't support colours."
    when 1
      ::Cucumber::Term::ANSIColor.coloring = false
      alias grey white
    when 2..8
      alias grey white
    else
      define_real_grey
    end
  rescue Exception => e
    if e.class.name == 'TermInfo::TermInfoError'
      STDERR.puts "*** WARNING ***"
      STDERR.puts "You have the genki-ruby-terminfo gem installed, but you haven't set your TERM variable."
      STDERR.puts "Try setting it to TERM=xterm-256color to get grey colour in output."
      STDERR.puts "\n"
      alias grey white
    else
      define_real_grey
    end
  end
end

.define_real_grey ⇒ Object

:nodoc:



131
132
133
134
135
136
137
138
139
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 131

def self.define_real_grey #:nodoc:
  def grey(string) #:nodoc:
    if ::Cucumber::Term::ANSIColor.coloring?
      "\e[90m#{string}\e[0m"
    else
      string
    end
  end
end

Instance Method Details

#cukes(n) ⇒ Object 



143
144
145
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 143

def cukes(n)
  ("(::) " * n).strip
end

#green_cukes(n) ⇒ Object 



147
148
149
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 147

def green_cukes(n)
  blink(green(cukes(n)))
end

#grey(string) ⇒ Object

:nodoc:



132
133
134
135
136
137
138
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 132

def grey(string) #:nodoc:
  if ::Cucumber::Term::ANSIColor.coloring?
    "\e[90m#{string}\e[0m"
  else
    string
  end
end

#red_cukes(n) ⇒ Object 



151
152
153
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 151

def red_cukes(n)
  blink(red(cukes(n)))
end

#yellow_cukes(n) ⇒ Object 



155
156
157
 
# File 'lib/cucumber/formatter/ansicolor.rb', line 155

def yellow_cukes(n)
  blink(yellow(cukes(n)))
end