Ansi to Html

This was originally a port of the ansi to html converter from bcat to JavaScript. It has since undergone quite a lot of modification.

It has a few additions:

• The API has been altered to accept options in the constructor, and input in toHtml().
• ANSI codes for setting the foreground or background color to default are handled
• the 'erase in line' escape code (\x1b[K) is dropped from the output.

Installation

1npm install ansi-to-html

Usage

1var Convert = require('ansi-to-html');
2var convert = new Convert();
3
4console.log(convert.toHtml('\x1b[30mblack\x1b[37mwhite'));
5
6/*
7    prints:
8    <span style="color:#000">black<span style="color:#AAA">white</span></span>
9*/

Command line usage

When using ansi-to-html from the command line the stream option is set to true. Other options can be provided. See ansi-to-html -h for more detail.

Process a file

1ansi-to-html the_filename

From STDIN

1git log | ansi-to-html

Options

Options can be be passed to the constructor to customize behaviour.

fg <CSS color values>. The default foreground color used when reset color codes are encountered.

bg <CSS color values>. The default background color used when reset color codes are encountered.

newline true or false. Convert newline characters to <br/>.

escapeXML true or false. Generate HTML/XML entities.

stream true or false. Save style state across invocations of toHtml().

colors Object/Array (with values 0 - 255 containing CSS color values). Can override specific colors or the entire ANSI palette

Default options

1{
2    fg: '#FFF',
3    bg: '#000',
4    newline: false,
5    escapeXML: false,
6    stream: false
7}

Development

Once you have the git repository cloned, install the dependencies:

1cd ansi-to-html
2npm install

Lint

1npm run lint

Build

1npm run build

• Builds the /src files by running babel.
• Saves the built files in /lib output directory.
• Recommended to run babel in Watch mode - will re-build the project each time the files are changed.

1npm run build:watch

Test

1npm test

• Note: Runs the tests against the built files (in the /lib directory).
• You also run the tests in watch mode (will rerun tests when files are changed).
• Recommended to run the build in watch mode as well to re-build the project before the tests are run.

1npm run test:watch