Newton's Preposterous Miscalculation


1.0.1 • Public • Published


The stream fragment build system

Gurt Frags replace Gulp Tasks. Instead of explicitly defining a src and dest, frags receive, filter and return the entire source tree as a stream. Frags are then declaratively combined into a pipeline at runtime. This approach provides a more reusable building block, which also happen to be more efficient.

Pipelines are disk-less, streams are piped directly between frags. As a result filtered files "fall through", becoming available to other transforms further down the pipeline for maximum concurrency. Disk I/O is eliminated, incremental builds become a natural feature of any pipeline by only sending changes.


npm install -g gurt
man gurt


For quick start, use Gurt-Frags. To write custom frags, see below:

Plugs: Gurt is only a task replacement for Gulp, it still uses Gulp's most excellent Vinyl FS module. This means you can use gulp plugins. Gulp tasks can often be converted into Gurt frags by simply replacing src / dest with filter.

const foo = require('gulp-foo');
const bar = require('gulp-bar');
const exp = module.exports; // Attach all frags

Frags: These are just functions that receive, filter, transform and return a stream. Each glob is like a branch in the stream and each filter invocation merges previous branches, so the full source tree is available to every glob.

exp['Foo'] = (stream, filter) => stream
exp['Bar'] = (stream, filter) => stream

Chain: Aliases define a chain to be referenced like a fragment at runtime, build and serve are default chains used by their respective commands. Feel free to add custom aliases for other chains you might commonly use at runtime.

exp['build'] = 'Foo.Bar';
exp['serve'] = 'Foo';
exp['other'] = 'build.Foo'; // = Foo.Bar.Foo

Save your frags as a local file or npm module and use Gurt's --frags option to load it. It's possible to mix frags from other modules by including them into yours (require), this makes it trivial to extend existing modules.


Suggestions and contributions will be considered. When crafting a pull request please consider if your contribution is a good fit with the project, follow contribution best practices and use the github "flow" workflow.


The MIT License


npm i gurt

Downloadsweekly downloads









last publish


  • avatar
Report a vulnerability