inject-code v1.0.0
Injector
This package aims at injecting content (mostly code) into files at specific locations.
Usage
const inject = require('inject-code');
inject(
// your content as a string
'your_content',
// opts
{
// path to file where to inject content
into: '/path/to/dest/file',
// OR content string containing tags
intoStr: '...',
// tags
// insert between these two tags (this will remove anything that is written between them)
between: {
starttag: '// injectcode:start',
endtag: '// endinjectcode'
},
// OR insert before this tag
before: '// injectcode',
// OR insert after this tag
after: '// injectcode',
// use synchronous api (default is false)
sync: true,
// content must be treated as code
// using this option will preserve indentation for multilined content
// (based on the indentation of the given tag, or starttag).
// this is the default
contentType: 'code',
// detect new line parameter (crlf or lf) and automatically converts into result string.
// if no new lines are found, 'lf' is the default.
// this option is ignored if the contentType option is not 'code'.
// values:
// - 'auto' (auto detect)
// - 'lf' or '\n' (unix style)
// - 'crlf' or '\r\n' (windows style)
newLine: 'auto'
}
)
The between
option takes precedence over the before
option, which take precedence over the after
option.
The into
option takes precedence over the intoStr
option.
Return value
By default, the inject
function is asynchronous and returns an ES6 Promise.
If you set the sync
option to true
, the function will use the node synchronous API and return undefined
(or the final string if the intoStr
option is specified instead).
Using the asynchronous API, the resolve
function will be called with no argument if into
is a valid file, or the result string ìf the intoStr
option is specified instead.
Errors
Using the synchronous API, errors will be thrown using throw new Error()
.
Using the asynchronous API, errors will be sent to the reject
method and you can catch them like you would with a simple Promise.
7 years ago