npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

heredocument

v2.0.2

Published

Here document built on ES2015 template string literals like Ruby's <<~

Downloads

108

Readme

Here Document Using ES2015 Template String

Build Status Coverage Status

This package provides heredoc as tag of ES2015 Template String. It trims white spaces in the template string and strips common indentation like <<~ in Ruby. This package has no dependency.

const heredoc = require('heredocument');

function showError(err) {
    const msg = heredoc`
        Error: ${err.message}

          Expected: ${err.expected}
          Actual  : ${err.actual}
    `;

    assert.equal(msg, 'Error: blah blah\n\n  Expected: foo\n  Actual  : bar\n');

    console.log(msg);
}

Without this package, we need to care about indentation of the string.

    const msg = `Error: ${err.message}

  Expected: ${err.expected}
  Actual  : ${err.actual}
`;

Installation

Available via npm.

$ npm install heredocument
  • commonjs
const heredoc = require('heredocument');
  • ES6 Modules
import heredoc from 'heredocument';
  • Browser
<script src="/path/to/heredocument/index.js"></script>
<script>
  const heredoc = window.Heredoc;
</script>

Usage

By default, a heredoc tag for template strings is exported. Almost all cases, you can use it out of box.

const heredoc = require('heredocument');
console.log(`
    foo
        bar
        piyo
`);

This package cares about tab (\t) character. By default, tab character is handled as 8 whitespaces. If the indentation is split at the middle of tab character, it will be split into white spaces.

const heredoc = require('heredocument');
assert.equal(heredoc`\tfoo\t  bar\t\tpiyo`, 'foo\n  bar      \npiyo');

And default newline is NL (\n).

These behaviors can be customized. There are two options; tabSize, inputNewline and outputNewline.

const heredoc = require('heredocument')({
    tabSize: 4,
    inputNewline: '\n\r',
    outputNewline: '\n\r',
});

assert.equal(
    heredoc`
    FOO
        BAR
		BAZ
    `,
    'FOO\n    BAR\n\tBAZ\n'
);
// => OK
  • tabSize : The number of whitespaces for 1 tab character (\t). Default is 8.
  • inputNewline : The newline character to split the string into lines. Default value is \n.
  • outputNewline : The newline character used in output string. If not specified, value of inputNewline is used. Default value is \n.
  • newlineAtEnd : EOL should be added at the end of string or not. If true, newline will be added at the end. Default value is true.

For example, below oneline tag replaces all newlines in input hence it can create single line string from multiline template string.

const heredoc = require('heredocument');
const oneline = heredoc({
    inputNewline: '\n',
    outputNewline: ' ',
    newlineAtEnd: false
});

const msg = oneline`
    This message is too long. So we need to split the string literal such as
    "blah blah" + "blah blah". But with this 'oneline' tag, all newlines
    (including intepolated string) are removed and you can get oneline
    string.
`;

assert.equal(msg, `This message is too long. So we need to split the string literal such as "blah blah" + "blah blah". But with this 'oneline' tag, all newlines (including intepolated string) are removed and you can get oneline string.`);
// => OK

Development

$ git clone https://github.com/rhysd/heredocument.git && cd ./heredocument
$ npm install  # Install all dependencies
$ npm run lint # Run linter
$ npm test     # Run tests with mocha
$ npm bench    # Run benchmark
$ npm profile  # Run profiling

License

Distributed under the MIT license.