Gobble plugin to naïvely include some files into other files.
Sometimes you need to include some file into other files. Maybe you've tried gobble-replace
but doesn't work with files, and gobble-browserify
is overkill.
gobble-include
covers that gap. Just Write include('otherfile.ext')
.
I assume you already know the basics of Gobble.
npm i -D gobble-include
Let's assume you've got two files named data.json
and code.js
:
{ "foo": "foo", "bar": "bar" }
var something = include('data.json');
do(something);
After running gobble-include
, the file data.json
will be deleted and code.js
will contain:
var something = { "foo": "foo", "bar", "bar" };
do(something);
Available options are those described in this gobblefile.js
example:
var gobble = require( 'gobble' );
module.exports = gobble( 'src' ).transform( 'include', {
// supply custom delimiters
delimiters: [ '<%=', '%>' ],
// Force generating a sourcemap (by default maps are generated for .css and .js)
sourceMap: true
});
gobble-include
is naïve. This means it:
- Ignores double quotes in
include("file")
. The default is single quotes. - Doesn't care about language syntax. e.g.
include('file')
doesn't mean anything in raw HTML, but files will still be included because the string matches. Custom delimiters can alleviate this. - Doesn't care about multiple levels of included files or dependency graphs. Consider
gobble-browserify
or carefully rungobble-include
in serial. - Sourcemaps do not include information about the included files.
"THE BEER-WARE LICENSE":
<[email protected]> wrote this file. As long as you retain this notice you
can do whatever you want with this stuff. If we meet some day, and you think
this stuff is worth it, you can buy me a beer in return.