Resolve dependency directives in assets, e.g.
@depend
(Juicer) or//= require
(Sprockets)). Inspired by grunt-concat-in-order. Useful in combination with gulp-concat.
First, install gulp-resolve-dependencies
as a development dependency:
npm install --save-dev gulp-resolve-dependencies
Then, add it to your gulpfile.js
(probably together with gulp-concat):
var resolveDependencies = require('gulp-resolve-dependencies');
var concat = require('gulp-concat');
gulp.task('js', function(){
gulp.src(['app/assets/js/main.js'])
.pipe(resolveDependencies({
pattern: /\* @requires [\s-]*(.*\.js)/g
}))
.on('error', function(err) {
console.log(err.message);
})
.pipe(concat())
.pipe(gulp.dest('dest/assets/js/'));
});
And use the directives in your JS files (dependencies can be nested, they are handled recursively):
/**
* @requires libs/jquery/jquery.js
* @requires ../modules/slideshow/slideshow.js
*/
(function(window, document, $, undefined) {
'use strict';
$(document).on('ready', function() {
$('.slideshow').slideshow();
});
})(window, document, jQuery);
Warning: This might not be very efficient (especially in case of nested dependencies). Some kind of caching mechanism could come in handy.
Circular dependencies are either silently ignored or emit an error (thanks to @huang64). See options.ignoreCircularDependencies
below.
Type: RegExp
The matching pattern (defaults to /\* @requires [\s-]*(.*?\.js)/g
).
Type: Boolean
Whether to log the resolved dependencies (defaults to false
).
Type: Boolean
Whether to just continue instead of emitting an error if circular dependencies are detected (defaults to false
).