Skip to content
/ pupo Public

๐Ÿ“ฆ NODE.JS - Simple micro templating based on pupa using object-path.

License

Notifications You must be signed in to change notification settings

brunos3d/pupo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

3 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

pupo

npm version npm downloads Build Status object-path Dependency escape-goat Dependency Visitors

๐Ÿ“ฆ NODE.JS - Simple micro templating based on pupa using object-path.

Useful when all you need is to fill in some placeholders.

Pupo implements the object-path package to resolve the values of the data object.

Install

$ npm install pupo

# or

$ yarn add pupo

Usage

const pupo = require("pupo");

pupo("The mobile number of {name} is {phone.mobile}", {
    name: "Foo",
    phone: {
        mobile: "100 20 300",
    },
});
//=> 'The mobile number of Foo is 100 20 300'

pupo("I like {0} and {1}", ["๐Ÿฆ„", "๐Ÿฎ"]);
//=> 'I like ๐Ÿฆ„ and ๐Ÿฎ'

// Double braces encodes the HTML entities to avoid code injection
pupo("I like {{0}} and {{1}}", ["<br>๐Ÿฆ„</br>", "<i>๐Ÿฎ</i>"]);
//=> 'I like &lt;br&gt;๐Ÿฆ„&lt;/br&gt; and &lt;i&gt;๐Ÿฎ&lt;/i&gt;'

// Deep object value
pupo("{deep.obj.value-foo}", {
    deep: {
        obj: {
            "value-foo": "Hello, World!",
        },
    },
});
//=> 'This is a deep object value: Hello, World!'

// Format using object with special key names
pupo("{foo bar} {12 345} {value-foo}", {
    "foo bar": "Foo Bar",
    "12 345": "12345",
    "value-foo": "Hello, World!",
});
//=> 'Foo Bar 12345 Hello, World!'

API

pupo(template, data)

template

Type: string

Text with placeholders for data properties.

data

Type: object | unknown[]

Data to interpolate into template.

FAQ

What about template literals?

Template literals expand on creation. This module expands the template on execution, which can be useful if either or both template and data are lazily created or user-supplied.

Related

  • pupa - The original package.