gulp-custom-include

gulp-custom-include

Gulp plugin for including files

The include plugin searches the provided file for a standardized format and if found, gets the content of the provided file and injects into the original at that location.

Installation

Install package with NPM and add it to your development dependencies:

npm install --save-dev gulp-custom-include

Information

Package	gulp-custom-include
Description	Include files into others using a standardized syntax
Node Version	>= 0.10

Usage

var include = require("gulp-custom-include");

gulp.task("scripts", function() {
    return gulp
        .src("foo.js")
        .pipe(include())
        .pipe(gulp.dest("./dist/"));
});

foo.js

//@include(bar.js)

API

Returns a stream with the included content injected into the Vinyl files.

include([opts])

opts.includes

Type: Array

An array of paths to search for the included file.

var include = require("gulp-custom-include");

gulp.task("scripts", function() {
    return gulp
        .src("./path/*.js")
        .pipe(
            include({
                includes: ["js/includes", "includes"],
            }),
        )
        .pipe(gulp.dest("./dist/"));
});

opts.prefix

Type: String

A way to optionally customize the prefix that triggers the include; default is //@.

var include = require("gulp-custom-include");

gulp.task("scripts", function() {
    return gulp
        .src("foo.js")
        .pipe(
            include({
                prefix: "//--",
            }),
        )
        .pipe(gulp.dest("./dist/"));
});

foo.js

//--include(bar.js)

opts.keyword

Type: String

A way to optionally customize the keyword that triggers the include; default allows for either include or replace.

var include = require("gulp-custom-include");

gulp.task("scripts", function() {
    return gulp
        .src("foo.js")
        .pipe(
            include({
                keyword: "inject",
            }),
        )
        .pipe(gulp.dest("./dist/"));
});

foo.js

//@inject(bar.js)

opts.regex

Type: String

A way to optionally customize the regex which facilitates the capturing of the filename from the include string. This parses everything that appears after the prefix and the keyword. The default is: \\([\\s\'\"]*([a-z\.]*)[\\s\'\"]*\\).

var include = require("gulp-custom-include");

gulp.task("scripts", function() {
    return gulp
        .src("foo.js")
        .pipe(
            include({
                regex: ":[\\s'\"]*([a-z.]*)[\\s'\"]*",
            }),
        )
        .pipe(gulp.dest("./dist/"));
});

foo.js

//@include: bar.js

Changelog

1.0.0 (2018-08-07)

• Initial code release