endent

What is endent?

The npm package 'endent' is a utility for creating multiline strings that maintain predictable indentation. It is particularly useful when working with code generation, templating, or any scenario where managing whitespace and indentation is crucial. The package helps to ensure that multiline strings are formatted neatly without the hassle of manually managing spaces or tabs.

What are endent's main functionalities?

Indentation Management

This feature allows users to easily manage indentation within multiline strings. The example shows how to use endent to create a neatly indented function as a string.

const endent = require('endent');

const result = endent`
  function example() {
    console.log('Hello, world!');
  }
`;
console.log(result);

Template Literals Enhancement

Enhances template literals by automatically handling indentation and interpolation. The example demonstrates creating a personalized greeting message with dynamic data insertion and proper indentation.

const endent = require('endent');
const user = 'Alice';

const greeting = endent`
  Hello, ${user}!
  Welcome to our service.
`;
console.log(greeting);

Other packages similar to endent

dedent

Similar to endent, 'dedent' also helps in managing the indentation of template literals. However, while endent focuses on maintaining and managing indentation, dedent primarily aims to remove excess indentation, making it more about normalization rather than creation.

outdent

The 'outdent' package offers functionality similar to endent by allowing users to control indentation in multiline strings. It provides a slightly different API and additional options for customization compared to endent, which might be preferable depending on specific user needs.

README

Endent

An ES6 string tag that endows some indentation. Recommnend use it with dedent! May help you generate pretty javascript template with dynamic json.

Usage

import dedent from "dedent"
import endent from "endent"

function usageExample () {
  var someobj = {
    contact: {
      jack: 123456,
      tom: 654321
    },
    color: "blue",
    animals: [ "bear", "fish", "dog", "cat"]
  }

  var colors = ["red", "pink", "white"]

  var awfulTmpl = dedent`
    module.exports = store

    function store (state, emitter) {
      emitter.on("DOMContentLoaded", function () {
        state["someobj"] = ${JSON.stringify(someobj, null, 2)}
        state["colors"] = ${JSON.stringify(colors, null, 2)}
      })
    }
  `
  var prettyTmpl = dedent(endent`
    module.exports = store

    function store (state, emitter) {
      emitter.on("DOMContentLoaded", function () {
        state["someobj"] = ${endent.pretty(someobj)}
        state["colors"] = ${endent.pretty(colors)}
      })
    }
  `)

  return awfulTmpl + "\n\n" + prettyTmpl
}

> console.log(usageExample())

// awfulTmpl

module.exports = store

  function store (state, emitter) {
    emitter.on("DOMContentLoaded", function () {
      state["someobj"] = {
"contact": {
  "jack": 123456,
  "tom": 654321
},
"color": "blue",
"animals": [
  "bear"
]
}
      state["colors"] = [
"red",
"pink"
]
    })
  }


// prettyTmpl ~

module.exports = store

function store (state, emitter) {
  emitter.on("DOMContentLoaded", function () {
    state["someobj"] = {
      "contact": {
        "jack": 123456,
        "tom": 654321
      },
      "color": "blue",
      "animals": [
        "bear",
        "fish",
        "dog",
        "cat"
      ]
    }
    state["colors"] = [
      "red",
      "pink",
      "white"
    ]
  })
}

License

MIT