string-remove-duplicate-heads-tails^7.2.1

Installation

Quick Take

Examples

• Remove a duplicate outer layer with the default markers
• Remove mixed outer wrappers while preserving inner variables
• Remove empty marker pairs around meaningful text
• Leave content intact unless both outer markers match

The Purpose

Let’s say, you know that variables are wrapped with heads, for example, {{ and tails, }}.

For example:

"Hi {{ first_name }}!";

This library detects and deletes redundant heads and tails wrapped around the whole input string:

"{{ Hi {{ first_name }}! }}" => "Hi {{ first_name }}!"

But it’s also smart and detects legit heads and tails at the edges of string: {{ first_name }} {{ last_name }} is not turned into first_name }} {{ last_name.

That’s what this library is mainly about — being able to detect, are outer heads and tails currently wrapping a single chunk of text, or are those heads and tails from separate chunks.

Also, this lib removes the leading/trailing empty clumps of empty heads/tails, with or without empty space:

// without whitespace:
`{{}}{{}} {{}}{{}} {{}}{{}} a {{}}{{}}` => `a`
// with whitespace:
`{{   \n   }}   \t   a   \n\n {{ \n\n \n\n   }}   \t\t` => `a`

You can configure heads and tails to be whatever you like, single string or array of them. Also, the length of the different heads in your given set can be different.

API — remDup()

The main function remDup() is imported like this:

It’s a function which takes three input arguments:

The Optional Options Object has the following shape:

These double curly braces are default for Nunjucks/Jinja and many other templating languages.

Here are all defaults in one place for copying:

The function will return a string.

API — defaults

You can import defaults:

It's a plain object:

The main function calculates the options to be used by merging the options you passed with these defaults.

API — version

You can import version:

API — types

This package is written in TypeScript and exports the following types:

import type { LenientOpts, Opts } from "string-remove-duplicate-heads-tails";

Changelog