JSPM

                   _  _                       _   
                  (_)(_)                     | |  
  __ _  ___   ___  _  _  ______   __ _  _ __ | |_ 
 / _` |/ __| / __|| || ||______| / _` || '__|| __|
| (_| |\__ \| (__ | || |        | (_| || |   | |_ 
 \__,_||___/ \___||_||_|         \__,_||_|    \__|
 

###ascii-art.js

Images, fonts and terminal styles in Node.js & the browser. 100% JS.

It features support for Images, Styles and Figlet Fonts as well as handling multi-line joining automatically.

In the beginning there was colors.js but in the fine tradition of vendors calling out a problem they have the solution to, chalk was introduced. In that same vein, I offer ascii-art.

Why would I use this instead of X?

• zero dependencies - while the CL utility and test have dependencies, we will never call out to a module for what is supposed to be this lib's core competancy.
• color profiles support - other libraries assume you are running x11
• no prototype manipulation - Nobody is actually forcing String.prototype on anyone, but that doesn't stop it being a hot topic. In addition, we aren't using __proto__ under the hood and pretending we aren't doing dynamic prototype manipulation (zing!).
• handles the ugly intersection of multiline text and ansi codes for you.
• runs in the browser and Node.js (CommonJS, AMD, globals or webpack)
• JS + Canvas Ascii image generation utilities in node don't actually touch any pixels, but usually call out to a binary, we do 100% of our transform in JS, which allows us plug into averaging, distance and other logic dynamically, in powerful ways.
• Expressive API is a buzzword for chaining from days of yore, but the other guys are excited about having one and we have one too.
• It works like a package manager for figlet fonts.
• The other libraries out there do too little and focus on logging above other domains.
• Actively maintained If we don't update the code we'll tweak a code of conduct or something... maybe just re-up with self congratulatory pull requests, just to keep kicking that can. We might even add badges if we get saucy.
• Supports your existing API We allow you to use the colors.js/chalk API or our own (where we reserve chaining for utility rather than code aesthetics).
• Loads nothing that isn't used (Images, Fonts, Image Logic, etc.)
• It's awesome and that thing you're holding is looking played out.

On the Command Line

npm install -g ascii-art

Look at a list of fonts from the maintainers of Figlet:

ascii-art list all

Preview your font in a browser:

ascii-art preview doom

Now, install a figlet font (globally)

ascii-art install doom -g

Render some text

ascii-art text -s green -F doom "some text"

or render an image (use npm run sample to generate and view a gallery)

ascii-art image -f path/to/my/file.jpg

In your Code

The font method also allows you to optionally pass styles and supports chaining, so if I want two strings rendered together:

art.font('Prompt', 'Basic', 'red').font('v1', 'Doom', 'magenta', function(rendered){
    console.log(rendered);
});

There is also an image() call in the chain, that requires canvas in Node.js and shims in the browser's Canvas object (but only when image is used, so that dependency is optional):

art.image({
    width : 40,
    filepath : parentDir+'/Images/initech.png',
    alphabet : 'wide'
}).font('INITECH', 'Doom', 'cyan', function(ascii){
    console.log(ascii);
});

Which produces (from this and this):

Color Table	color	bright_color	color_bg
black
red
green
yellow
blue
cyan
magenta
white

Styles are: italic, bold, underline, |framed|, |encircled|, overline, blink and  inverse .

For example: if I wanted underlined blue text on a white background, my style would be underlined+blue+white_bg. Check out the detailed style docs for more information.

Compatibility

If you're a chalk user, just use var chalk = require('ascii-art/kaolin'); in place of your existing chalk references (Much of color.js, too... since chalk is a subset of colors.js). No migration needed, keep using the wacky syntax you are used to(In this mode, refer to their docs, not mine).

I may support the other colors stuff (extras & themes) eventually, but it's currently a low priority.

Upcoming Features

• A wider set of color profiles for color accuracy
• 256 color support
• true color (hex) support
• HTML .style() output
• Windows tests?
• More built-in averagers

Testing

In the root directory run:

npm run test

which runs the test suite directly. In order to test it in Chrome try:

npm run browser-test

In order to run the chalk test, use:

npm run chalk-test

Please make sure to run the tests before submitting a patch and report any rough edges. Thanks!

Enjoy,

-Abbey Hawk Sparrow