Gulp plugin to find the named ultimate dependent in the dependency graph.
When you're running an incremental build system, you usually only want to build the files that change. For frontend applications with multiple main source files (Webpack entry points, individual style files, etc.), you usually only want to build the files containing a changed file. This plugin builds a dependency list and iterates through to find the highest-level dependent. This way, you won't have to do a full rebuild every time a file changes, but build just the files that depend on the changed file.
Of course, this package has uses other than frontend applications. You can use it to build other types of sources, or to generate the list of dependencies for your files.
- Find the top-most files matching the
ultimateGlob
- For each file, find the dependencies and record them in a
Map<fileName: string, dependencies: string[]>
- For each of the dependencies, repeat step 2 until all files are processed
- Search for the changed file in the dependency values of all the maps. If found, then search for that parent file in the dependencies for other files until you reach a parent that matches the
ultimateGlob
. Return those matches. - For any changed file, only rebuild the dependencies for that file (not the dependencies for each of that file's dependencies).
- Node.js 14 or higher
- gulp v4 (untested with other versions)
npm install --save-dev gulp-ultimate-dependent
const gulp = require('gulp');
const ultimateDependent = require('gulp-ultimate-dependent');
const firstRun = Date.now();
const getDependencyStream = ultimateDependent({
ultimateGlob: 'src/**/*ParentPage.jsx',
extensions: ['.js'],
dependencyFile: 'dependencies.json',
warnOnMissing: true,
failOnMissing: true
});
gulp.task('incrementalBuild', () => {
return gulp.src([
'src/**/*.{js, jsx}' // all watched files
], { since: gulp.lastRun(incrementalBuild) || firstRun }) // what's changed
.pipe(getDependencyStream())
.pipe(build()) // build the ultimate dependents
.pipe(gulp.dest('output/'));
});
-
ultimateGlob: string
- required - search glob pattern identifying all ultimate parent dependents -
extensions: string[]
- optional, default['.js']
- used to further process matched dependency string, such as add inferred file extensions -
dependencyFile: string | () => string
- optional - if you want to output the dependency list, specify a file name or function which returns a file name -
warnOnMissing: bool
- optional, defaultfalse
- iftrue
, stream will output to console if it finds a dependency whose file is missing. -
failOnMissing: bool
- optional, defaultfalse
- iftrue
, stream will fail if it finds a dependency whose underlying file is missing (this is common if you delete a file you're watching). Iffalse
, stream still returns affected dependents. The stream will still fail on other errors. -
ignoreCircularDependency: bool
- optional, defaulttrue
- iftrue
, stream will ignore files it's already traversed, indicating a circular dependency. Iffalse
, stream will emit an error with the first file it sees twice.
npm run test
MIT