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

Readme

Source

Endent

An ES6 string tag that makes indentation right, adds some key features to dedent.

Feature

pretty object

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

var someobj = {
  contact: {
    jack: 123456,
    tom: 654321
  },
  color: "blue"
}

var somejson = '["bear", "fish", "dog", "cat"]'

var awfulTmpl = dedent`
  function store (state, emitter) {
    state["someobj"] = ${JSON.stringify(someobj, null, 2)}
    state["somejson"] = ${JSON.stringify(JSON.parse(somejson), null, 2)}
  }
`
// use endent.pretty(value) when value is object or array.
var prettyTmpl = endent`
  function store (state, emitter) {
    state["someobj"] = ${endent.pretty(someobj)}
    state["somejson"] = ${somejson}
  }
`

console.log(awfulTmpl + "\n\n" + prettyTmpl)

// awfulTmpl
function store (state, emitter) {
  state["someobj"] = {
"contact": {
  "jack": 123456,
  "tom": 654321
},
"color": "blue"
}
  state["somejson"] = [
"bear",
"fish",
"dog"
]
}

// prettyTmpl
function store (state, emitter) {
  state["someobj"] = {
    "contact": {
      "jack": 123456,
      "tom": 654321
    },
    "color": "blue"
  }
  state["somejson"] = [
    "bear",
    "fish",
    "dog",
    "cat"
  ]
}

endows suitable indentation for multiline interpolation

var dependencies = ['jquery', 'underscore', 'bootstrap']
var dependencyTmpl = ``
dependencies.forEach((d, i) => {
  dependencyTmpl += `var ${d} = require("${d}")\n`
})

var awfulTmpl = dedent`
  ;(function () {
    ${dependencyTmpl}
  })()
`

var prettyTmpl = endent`
  ;(function () {
    ${dependencyTmpl}
  })()
`

console.log(awfulTmpl + "\n\n" + prettyTmpl)

// awfulTmpl
;(function () {
  var jquery = require('jquery')
var underscore = require('underscore')
var bootstrap = require('bootstrap')
})()


// prettyTmpl
;(function () {
  var jquery = require('jquery')
  var underscore = require('underscore')
  var bootstrap = require('bootstrap')
})()

License

MIT

Keywords

FAQs

What is endent?

Is endent well maintained?

Last updated on 20 Feb 2020

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install