car·di·nal (kärdn-l, kärdnl) - crested thick-billed North American finch having bright red plumage in the male.
Features
- highlights JavaScript code with ANSI colors to improve terminal output
- theming support, see custom color themes
- optionally print line numbers
- API and command line interface (
cdl
) .cardinalrc
config to customize settings- supports UNIX pipes
Table of Contents generated with DocToc
- As library - As Commandline Tool - Highlight a file - As part of a UNIX pipe - Theme - highlight(code, opts) - highlightFileSync(fullPath, opts) - highlightFile(fullPath, opts, callback) - opts
Installation
As library
npm install cardinal
As Commandline Tool
[sudo] npm install -g cardinal
Note:When installed globally, cardinal exposes itself as the
cdl
command.Commandline
Highlight a file
cdl <file.js> [options]
options:
- --nonum
: turns off line number printing (relevant if it is turned on inside ~/.cardinalrc
As part of a UNIX pipe
cat file.js | grep console | cdl
Note:Not all code lines may be parsable JavaScript. In these cases the line is printed to the terminal without highlighting it.
Theme
The default theme will be used for highlighting.To use a different theme, include a
.cardinalrc
file in your HOME
directory.This is a JSON file of the following form:
{
"theme": "hide-semicolons",
"linenos": true|false
}
theme
can be the name of any of the built-in themes or the
- linenos toggles line number printing
API
highlight(code, opts)
- returns the highlighted version of the passed code ({String}) or throws an error if it was not able to parse it
- opts (see below)
highlightFileSync(fullPath, opts)
- returns the highlighted version of the file whose fullPath ({String}) was passed or throws an error if it was not able
- opts (see below)
highlightFile(fullPath, opts, callback)
- calls back with the highlighted version of the file whose fullPath ({String}) was passed or with an error if it was not able
- opts (see below)
callback
({Function}) has the following signature:function (err, highlighted) { .. }
opts
opts is an {Object} with the following properties:theme
{Object} is used to optionally override the theme used to highlightlinenos
{Boolean} iftrue
line numbers are included in the highlighted codefirstline
{Integer} sets line number of the first line when line numbers are printedjsx
{Boolean} iftrue
JSX syntax is supported, otherwise cardinal will raise an error
when encountering _JSX_ (default: `false`)
Note The json
option is obsoleted and not necessary anymore as cardinal properly understands both JSON and JavaScript.