gulp-pre-proc

   

This gulp plugin is wrapper of preProc.

* Grunt plugin: grunt-pre-proc
* webpack loader: pre-proc-loader

The super simple preprocessor for front-end development.
See preProc for options and more information about preProc.

Getting Started

``shell
npm install gulp-pre-proc --save-dev
`

Usage

gulpfile.js

`js
var gulp = require('gulp'),
preProc = require('gulp-pre-proc');

gulp.task('default', function() {
return gulp.src('./develop/*/')
.pipe(preProc({
// Remove DEBUG contents from all files in dir1 directory and all JS files.
removeTag: {tag: 'DEBUG', pathTest: ['/path/to/dir1', /\.js$/]}
}))
.pipe(gulp.dest('./public_html/'));
});
`

Options

$3

If removeTag option is specified, call removeTag method with current content.

You can specify an object that has properties as arguments of the method.
Following properties are accepted:

- tag
- pathTest

Also, you can specify common values for the arguments into upper layer. That is, the options.pathTest is used when options.removeTag.pathTest is not specified.

If the pathTest is specified, current source file path is tested with the pathTest.

For example:

`js
gulp.task('default', function() {
return gulp.src('./develop/*/')
.pipe(preProc({
tag: 'DEBUG', // common
pathTest: '/path/to', // common

removeTag: {}, // tag: 'DEBUG', pathTest: '/path/to'
replaceTag: {tag: ['SPEC1', 'SPEC2']}, // tag: ['SPEC1', 'SPEC2'], pathTest: '/path/to'
pickTag: {} // tag: 'DEBUG', pathTest: '/path/to'
}))
.pipe(gulp.dest('./public_html/'));
});
`

$3

If replaceTag option is specified, call replaceTag method with current content.

You can specify arguments by the same way as the removeTag.
Following arguments are accepted:

- tag
- pathTest
- replacement (As options.replaceTag.replacement, not options.replacement)

$3

If pickTag option is specified, call pickTag method with current content.

You can specify arguments by the same way as the removeTag.
Following arguments are accepted:

- tag
- allowErrors (As options.pickTag.allowErrors, not options.allowErrors)

When the tag was not found, this method throws an error by default. If true is specified for allowErrors, it returns null (not a string) without error. It is useful for handling unknown source code. (You should check that by file.isNull()`.)
Also, you can specify options to call multiple methods, and other methods are not called when the tag was not found.