❤
npm
Sign UpSign In

gulp-custom-include

1.0.0 • Public • Published

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

Packagegulp-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

Readme

Keywords

Package Sidebar

Install

npm i gulp-custom-include

Repository

github.com/castastrophe/gulp-custom-include

Homepage

github.com/castastrophe/gulp-custom-include#readme

Weekly Downloads

1

Version

1.0.0

License

GPL-3.0

Unpacked Size

42.3 kB

Total Files

7

Last publish

Collaborators

  • castastrophe
Try on RunKit
Report malware