Jenkins ANSI Color Plugin
Java HTML
Clone or download
dblock Merge pull request #107 from jglick/quiet
Removing startup banner
Latest commit 350138e Sep 29, 2017

README.md

Jenkins ANSI Color Plugin

Build Status

This plugin adds support for standard ANSI escape sequences, including color, to Console Output.

This plugin is available here and has a page on the Jenkins Wiki.

Install

install

Enable

enable

Using in pipeline workflows

The build wrapper can be used to colorize the output of steps in a pipeline build (plugin formally known as workflows). The example below shows how to use it.

wrap([$class: 'AnsiColorBuildWrapper', 'colorMapName': 'XTerm']) {
  sh 'something that outputs ansi colored stuff'
}

Also, the following pipeline syntax can be used without allocating a node and a separate build wrapper.

ansiColor('xterm') {
  echo 'something that outputs ansi colored stuff'
}

The TERM environment variable will be set to the provided name inside the block scope.

ansiColor('xterm') {
  echo "TERM=${env.TERM}"
  // prints out TERM=xterm
}

Color!

color

Customize

color

Misc

Does it Even Work?

Create a job in Jenkins that executes the following shell script. Don't forget to check the "Color the ANSI Console Output" option.

printf "\e[31mHello World\e[0m\n"
printf "Normal \e[1mBold\e[0m\n"
printf "Normal \e[4mUnderlined\e[0m\n"

color

Check out this guide for more examples.

Notes on the shells Zsh and Bash

If you commonly use Zsh as your login shell, it's important to keep in mind that the echo command (shell builtin) supports character escaping.

Bash however, does not.

This can cause you a bit of confusion. For example, if you test your shell scripts (which use echo) in Zsh, and they work fine. Then you try to run them as part of a job on Jenkins (which will use be using Bash by default), it's quite possible you won't see colorized output, instead, you only see the ANSI control codes, still embedded in your text.

There are ways around this, however, we recommend you use the printf command instead. It'll just work everywhere, and allow \e, \033 or \x1b to be used as the escape character.

For example:

printf "\e[31mHello\e[0m\n"
printf "\033[31mHello\033[0m\n"
printf "\x1b[31mHello\x1b[0m\n"

Will all print Hello in red on any system / shell that has printf (ie. anything POSIX compliant)

Supported ANSI Color Codes and Attributes

Most of the attributes and color modes described at wikipedia/ANSI escape code were supported, including:

  • attributes bold / italic / underline / negative / conceal / crossed-out / framed / overlined
  • standard text colors 30-37 and background colors 40-47
  • high intensity text colors 90-97 and background colors 100-107 (aixterm)
  • xterm 256 colors and ISO-8613-3 24 bit colors (38 and 48)

Not supported attributes:

  • faint
  • blink
  • font switching
  • encircled
  • ideogram attributes 60-65

The colorize ruby library, for example, emits high intensity codes when using the "light" color options.

Colorizing Ruby RSpec Output

RSpec formatters detect whether RSpec is running in a terminal or not, therefore suppressing color output under Jenkins. Specify --colour --tty when calling rspec or add it to your .rspec file.

License

The ANSI Color Plugin is licensed under the MIT License.

It uses JANSI (Apache 2.0 License).

Contributing

See CONTRIBUTING.