cli-highlight
    TypeScript icon, indicating that this package has built-in type declarations

    2.1.11 • Public • Published

    cli-highlight

    Syntax highlighting in your terminal

    npm downloads CI status codecov node code style: prettier semantic-release license

    Example

    Example Output

    CLI Usage

    Output a file

    $ highlight package.json

    Color output of another program with piping. Example: A database migration script that logs SQL Queries

    $ db-migrate --dry-run | highlight

    Command line options:

    Usage: highlight [options] [file]
    
    Outputs a file or STDIN input with syntax highlighting
    
    Options:
      --language, -l  Set the langugage explicitely
                      If omitted will try to auto-detect
      --theme, -t     Use a theme defined in a JSON file
      --version, -v   Show version number                                   [boolean]
      --help, -h      Show help                                             [boolean]

    Programmatic Usage

    You can use this module programmatically to highlight logs of your Node app. Example:

    const highlight = require('cli-highlight').highlight
    const Sequelize = require('sequelize')
    
    const db = new Sequelize(process.env.DB, {
      logging(log) {
        console.log(highlight(log, {language: 'sql', ignoreIllegals: true}))
      }
    })

    Detailed API documenation can be found here.

    Themes

    You can write your own theme in a JSON file and pass it with --theme. The key must be one of the highlight.js CSS class names or "default", and the value must be one or an array of Chalk styles to be applied to that token.

    {
      "keyword": "blue",
      "built_in": ["cyan", "dim"],
      "string": "red",
      "default": "gray"
    }

    The style for "default" will be applied to any substrings not handled by highlight.js. The specifics depend on the language but this typically includes things like commas in parameter lists, semicolons at the end of lines, etc.

    The theme is combined with the default theme. The default theme is still not colored a lot or optimized for many languages, PRs welcome!

    Supported Languages

    All languages of highlight.js are supported. Check a CI build for examples of all the different languages and their highlighting.

    Contributing

    The module is written in TypeScript and can be compiled with npm run build. npm run watch starts tsc in watch mode. Tests are written with mocha.

    Improving language support is done by adding more colors to the tokens in the default theme and writing more tests.

    Install

    npm i cli-highlight

    DownloadsWeekly Downloads

    1,632,622

    Version

    2.1.11

    License

    ISC

    Unpacked Size

    42.7 kB

    Total Files

    16

    Last publish

    Collaborators

    • felixfbecker