compress-tag

!Image of code sample

compress-tag is a tiny module that enables significantly more readable code by
improving the display of strings in your source code through the use of
string template literals.

This module provides template literal tags that remove line breaks and indents
from your template literals, so that a string that is formatted to nicely fit in
your code still comes out looking like it should. They are also
chainable in case you are already using template literal tags.

In other words, you can replace these workarounds:

``js
throw new Error(
"An error occured while parsing the CSV file. Check that the 'delimiters' option is set properly and try again."
);

const result = prompt(
"Enter a description to attach to this entry. This should be " +
"descriptive, but less than 200 characters.",
"Enter your description here."
);

renderTextContent(The quick brown fox jumps over the lazy dog. The \
quick brown fox jumps over the lazy dog. The quick brown fox jumps \
over the lazy dog. The quick brown fox jumps over the lazy dog. The \
quick brown fox jumps over the lazy dog.

The quick brown fox jumps over the lazy dog. The quick brown fox \
jumps over the lazy dog. The quick brown fox jumps over the lazy \
dog. The quick brown fox jumps over the lazy dog. The quick brown \
fox jumps over the lazy dog.);
`

with these:

`js
throw new Error(c
An error occured while parsing the CSV file. Check that the
'delimiters' option is set properly and try again."
);

const result = prompt(
cEnter a description to attach to this entry. This should be
descriptive, but less than 200 characters.,
"Enter your description here."
);

renderTextContent(c
The quick brown fox jumps over the lazy dog. The quick brown fox
jumps over the lazy dog. The quick brown fox jumps over the lazy
dog. The quick brown fox jumps over the lazy dog. The quick brown
fox jumps over the lazy dog.\n\n

The quick brown fox jumps over the lazy dog. The quick brown fox
jumps over the lazy dog. The quick brown fox jumps over the lazy
dog. The quick brown fox jumps over the lazy dog. The quick brown
fox jumps over the lazy dog.
);
`

Getting Started

compress-tag is a UMD module, so it can be used in Node or on the web. Typings
are included for TypeScript as well.

$3

compress-tag is hosted on npm, so you
can install with:

`bash
npm i compress-tag
`

To use in code:

`js
import {c, t} from "compress-tag";

cExample
string.; // => Example string.
tExample
string.; // => Examplestring.
`

Documentation

Four template literal tag functions are exported by this module. compress and
c are exactly the same - they replace your linebreaks and the whitespace
surrounding each line with a single space. compressTight and t are also the
same - they remove your linebreaks and whitespace with no space.

$3

`js
import {compress, c, compressTight, t} from "compress-tag";

// Use the regular compressor (preserves spaces) for prose:

let A = compressLorem ipsum dolor sit amet, consectetur adipiscing
elit. Suspendisse sagittis mi quam, ut rhoncus nisi pulvinar in. Duis
lobortis nisl libero, non imperdiet lectus ultrices sed. Aliquam erat
volutpat. Sed egestas dignissim iaculis. Etiam felis risus, tempor ac
dignissim id, vestibulum in mauris. Nam attempus tellus. Aliquam vitae
metus tempor, tempus tellus id, vulputate magna. Vivamus a enim
feugiat, mattis leo in, blandit nunc. Cras faucibus pellentesque
dolor, et euismod mauris sagittis vitae. Quisque egestas metus pretium
mollis tempor.;
// => Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse sagittis mi quam, ut rhoncus nisi pulvinar in. Duis lobortis nisl libero, non imperdiet lectus ultrices sed. Aliquam erat volutpat. Sed egestas dignissim iaculis. Etiam felis risus, tempor ac dignissim id, vestibulum in mauris. Nam attempus tellus. Aliquam vitae metus tempor, tempus tellus id, vulputate magna. Vivamus a enim feugiat, mattis leo in, blandit nunc. Cras faucibus pellentesque dolor, et euismod mauris sagittis vitae. Quisque egestas metus pretium mollis tempor.

let B = cLorem ipsum dolor sit amet, consectetur adipiscing elit.
Suspendisse sagittis mi quam, ut rhoncus nisi pulvinar in. Duis
lobortis nisl libero, non imperdiet lectus ultrices sed. Aliquam erat
volutpat. Sed egestas dignissim iaculis. Etiam felis risus, tempor ac
dignissim id, vestibulum in mauris. Nam attempus tellus. Aliquam vitae
metus tempor, tempus tellus id, vulputate magna. Vivamus a enim
feugiat, mattis leo in, blandit nunc. Cras faucibus pellentesque
dolor, et euismod mauris sagittis vitae. Quisque egestas metus pretium
mollis tempor.;
// => Lorem ipsum dolor sit amet, consectetur adipiscing elit. Suspendisse sagittis mi quam, ut rhoncus nisi pulvinar in. Duis lobortis nisl libero, non imperdiet lectus ultrices sed. Aliquam erat volutpat. Sed egestas dignissim iaculis. Etiam felis risus, tempor ac dignissim id, vestibulum in mauris. Nam attempus tellus. Aliquam vitae metus tempor, tempus tellus id, vulputate magna. Vivamus a enim feugiat, mattis leo in, blandit nunc. Cras faucibus pellentesque dolor, et euismod mauris sagittis vitae. Quisque egestas metus pretium mollis tempor.

// Use the tight compressor (removes indentation) for code like HTML:

let C = compressTight

Heading

This is the content of the section.

This is another paragraph.

;
// =>

Heading

This is the content of the section.

This is another paragraph.

let D = t

Heading

This is the content of the section.

This is another paragraph.

;
// =>

Heading

This is the content of the section.

This is another paragraph.

`

$3

You can still output a string that has linebreaks and tabs in it simply by using
the newline (\n) and tab (\t) characters. For example:

`js
let E = cThis has\n\ta new line;
// => This has
// a new line.
`

$3

One drawback to using template literal tags is that they cannot be chained. This
means that if you are already using template literal tags, you can't use these
as described above. However, all of these tags support being used as normal
functions in this case\*:

`js
// Assuming capitalize is some other tag that makes every letter uppercase:
let F = c(capitalize
Lorem ipsum
dolor sit amet.
);
// => LOREM IPSUM DOLOR SIT AMET.
`

\* Note: When using tags as a method there is no way to preserve newlines;
using the \n character will not work.

$3

Since there is now no reason for your strings to be long, you can modify your
ESLint max-len setting to enforce the use of these tags:

_eslintrc.json_

`json
{
"rules": {
"max-len": [
"error",
{
"code": 80,
"ignoreStrings": false,
"ignoreTemplateLiterals": false
}
]
}
}
`

Contributing

Found a bug or want to see a feature added?
Submit it here!

Pull requests are always welcome, although to increase your chances of your
contribution being accepted, opening an issue and linking to it is always a good
idea.

Pull requests will not be merged unless the Actions build succeeds. To
quickly confirm that it will, just run:

`bash
npm run check
`

This checks your formatting, tests, and for TypeScript compiler errors. If the
task doesn't fail, you should be good to go.

$3

For your convenience, some other tasks are also provided in the package.json:

- npm run build - Compiles TypeScript code to JavaScript
- npm run minify - Generate minified JavaScript files from compiled files
- npm run test - Quickly run tests using TypeScript code without compiling
- npm run lint - Check code for linting errors
- npm run check - Check to ensure code will pass Pipelines checks (see above)
- npm run format` - Format code using Prettier