anser

anser

A low level parser for ANSI sequences.

:rocket: Features

• Converts text containing ANSI color escape codes into equivalent HTML elements.
• Allows converting the input into JSON output.
• HTML escaping
• Converts links into HTML elements
• Friendly APIs to use with virtual dom libraries

:cloud: Installation

# Using npm
npm install --save anser

# Using yarn
yarn add anser

:clipboard: Example

const Anser = require("anser");

const txt = "\u001b[38;5;196mHello\u001b[39m \u001b[48;5;226mWorld\u001b[49m";

console.log(Anser.ansiToHtml(txt));
// <span style="color:rgb(255, 0, 0)">Hello</span> <span style="background-color:rgb(255, 255, 0)">World</span>

console.log(Anser.ansiToHtml(txt, { use_classes: true }));
// <span class="ansi-palette-196-fg">Hello</span> <span class="ansi-palette-226-bg">World</span>

console.log(Anser.ansiToJson(txt));
// [ { content: '',
//     fg: null,
//     bg: null,
//     fg_truecolor: null,
//     bg_truecolor: null,
//     clearLine: undefined,
//     decoration: null,
//     was_processed: false,
//     isEmpty: [Function: isEmpty] },
//   { content: 'Hello',
//     fg: '255, 0, 0',
//     bg: null,
//     fg_truecolor: null,
//     bg_truecolor: null,
//     clearLine: false,
//     decoration: null,
//     was_processed: true,
//     isEmpty: [Function: isEmpty] },
//   { content: ' ',
//     fg: null,
//     bg: null,
//     fg_truecolor: null,
//     bg_truecolor: null,
//     clearLine: false,
//     decoration: null,
//     was_processed: false,
//     isEmpty: [Function: isEmpty] },
//   { content: 'World',
//     fg: null,
//     bg: '255, 255, 0',
//     fg_truecolor: null,
//     bg_truecolor: null,
//     clearLine: false,
//     decoration: null,
//     was_processed: true,
//     isEmpty: [Function: isEmpty] },
//   { content: '',
//     fg: null,
//     bg: null,
//     fg_truecolor: null,
//     bg_truecolor: null,
//     clearLine: false,
//     decoration: null,
//     was_processed: false,
//     isEmpty: [Function: isEmpty] } ]

When using TypeScript without --esModuleInterop enabled you can do the following:

import Anser = require('anser');
const txt = "\u001b[38;5;196mHello\u001b[39m \u001b[48;5;226mWorld\u001b[49m";
console.log(Anser.ansiToHtml(txt));
// <span style="color:rgb(255, 0, 0)">Hello</span> <span style="background-color:rgb(255, 255, 0)">World</span>

Or with --esModuleInterop enabled you can do the following:

import Anser from 'anser';
const txt = "\u001b[38;5;196mHello\u001b[39m \u001b[48;5;226mWorld\u001b[49m";
console.log(Anser.ansiToHtml(txt));
// <span style="color:rgb(255, 0, 0)">Hello</span> <span style="background-color:rgb(255, 255, 0)">World</span>

:memo: Documentation

Add several widely used style codes

processChunk(text, options, markup)

Processes the current chunk of text.

Params

• String text: The input text.
• Object options: An object containing the following fields:
• json (Boolean): If true, the result will be an object.
• use_classes (Boolean): If true, HTML classes will be appended to the HTML output.
• Boolean markup: If false, the colors will not be parsed.

Return

• Object|String The result (object if json is wanted back or string otherwise).

:question: Get Help

There are few ways to get help:

• Please post questions on Stack Overflow. You can open issues with questions, as long you add a link to your Stack Overflow question.
• For bug reports and feature requests, open issues. :bug:
• For direct and quick help, you can use Codementor. :rocket:

:yum: How to contribute

Have an idea? Found a bug? See how to contribute.

:sparkling_heart: Support my projects

I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously, this takes time. You can integrate and use these projects in your applications for free! You can even change the source code and redistribute (even resell it).

However, if you get some profit from this or just want to encourage me to continue creating stuff, there are few ways you can do it:

• Starring and sharing the projects you like :rocket:

• —I love books! I will remember you after years if you buy me one. :grin: :book:

• —You can make one-time donations via PayPal. I'll probably buy a coffee tea. :tea:

• —Set up a recurring monthly donation and you will get interesting news about what I'm doing (things that I don't share with everyone).

• Bitcoin—You can send me bitcoins at this address (or scanning the code below): 1P9BRsmazNQcuyTxEqveUsnf5CERdq35V6

  

Thanks! :heart:

:cake: Thanks

This project is highly based on ansi_up, by @drudru. Thanks! :cake:

:scroll: License

MIT © Ionică Bizău

Similar packages

Other packages similar to anser

chalk

Chalk is a popular library for styling terminal strings in Node.js. Unlike 'anser', which focuses on converting ANSI codes to HTML, Chalk is primarily used for creating styled terminal output. It supports various styles and colors but does not provide HTML conversion.

ansi-to-html

The 'ansi-to-html' package is similar to 'anser' in that it converts ANSI escape codes to HTML. However, 'anser' offers more features like stripping ANSI codes and escaping for HTML, making it a more versatile choice for handling ANSI codes.

strip-ansi

The 'strip-ansi' package is a simple utility for removing ANSI escape codes from strings. While it performs a similar function to 'anser's' ansiToText method, it lacks the additional features like HTML conversion and escaping.