Security News
tea.xyz Spam Plagues npm and RubyGems Package Registries
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
lazypipe
Advanced tools
Changelog
1.0.2
Readme
Lazypipe allows you to create an immutable, lazily-initialized pipeline. It's designed to be used in an environment where you want to reuse partial pipelines, such as with gulp.
This module returns a function that can be used to start building a lazypipe. Individual steps are added via the .pipe()
method. At any point, a new lazypipe can be built by adding to an existing one, without affecting the previous lazypipe. Lazypipes can even be used as steps within another lazypipe.
Once the partial pipeline is ready to use, call the last result from .pipe()
directly as a function (e.g.: .pipe()()
).
Install using:
npm i --save-dev lazypipe
Then create lazypipes like so:
// Example usage within a gulpfile
var lazypipe = require('lazypipe');
...
// initialize a lazypipe
var jsHintTasks = lazypipe()
// adding a pipeline step, notice the stream function has not been called!
.pipe(jshint)
// adding a step with an argument
.pipe(jshint.reporter, 'jshint-stylish');
// this is OK, because lazypipes are immutable
// jsHintTasks will _not_ be affected by the addition.
var jsTasks = jsHintTasks
.pipe(gulp.dest, 'build/js');
// Create another pipe
var cssTasks = lazypipe()
.pipe(recess, recessConfig)
.pipe(less)
.pipe(autoprefixer);
// now using the lazypipes
gulp.task('jsHint', function() {
gulp.src('js/**/*.js').pipe(jsHintTasks());
});
gulp.task('build', function() {
// for example only!
return gulp.src('js/**/*.js').pipe(jsTasks());
});
gulp.task('default', ['build'], function() {
// using gulp-watch
watch('js/**/*.js').pipe(jsTasks());
});
You can combine lazypipes in various ways:
// streamA -> streamB
var foo = lazypipe().pipe(streamA).pipe(streamB);
// streamA -> streamB -> streamC
var bar = foo.pipe(streamC);
// streamD -> streamA -> streamB -> streamE
var baz = lazypipe().pipe(streamD).pipe(foo).pipe(streamE);
Lazypipe assumes that all function parameters are static, gulp-if arguments need to be instantiated inside each lazypipe. This difference can be easily solved by passing a function on the lazypipe step
var gulpif = require('gulp-if');
var jshint = require('gulp-jshint');
var uglify = require('gulp-uglify');
var concat = require('gulp-concat');
var compressing = false;
var jsChannel = lazypipe()
// adding a pipeline step
.pipe(jshint) // notice the stream function has not been called!
.pipe(jshint.reporter)
// adding a step with an argument
.pipe(jshint.reporter, 'fail')
// adding a step with multiple arguments
.pipe(concat, 'bundle.js', {newLine: ';'})
// you can't say: .pipe(gulpif, compressing, uglify)
// because uglify needs to be instantiated separately in each lazypipe instance
// you can say this instead:
.pipe(function () {
return gulpif(compressing, uglify());
});
// why does this work? lazypipe calls the function, passing in the no arguments to it,
// it instantiates a new gulp-if pipe and returns it to lazypipe.
gulp.task('scripts', function () {
return gulp.src(paths.scripts.src)
.pipe(jsChannel())
.pipe(gulp.dest(paths.scripts.dest));
});
lazypipe()
Initializes a lazypipe. Returns a function that can be used to create the pipeline. The returned function has a function (pipe
) which can be used to create new lazypipes with an additional step.
lazypipe().pipe(fn[, arg1[, arg2[, ...]]])
Creates a new lazy pipeline with all the previous steps, and the new step added to the end. Returns the new lazypipe.
fn
- a stream creation function to call when the pipeline is created later. You can either provide existing functions (such as gulp plugins), or provide your own custom functions if you want to manipulate the stream before creation.arg1, arg2, ...
- Any remaining arguments are saved and passed into fn
when the pipeline is created.The arguments allows you to pass in configuration arguments when the pipeline is created, like this:
var pipeline = lazypipe().pipe(jsHint, jsHintOptions);
// now, when gulp.src().pipe(pipeline()) is called later, it's as if you did:
gulp.src().pipe(jsHint(jsHintOptions));
lazypipe()()
"build"Calling the result of pipe()
as a function builds the pipeline at that time. This can be used multiple times, and can even be called if the lazypipe was used to create different pipelines.
It returns a stream created using stream-combiner
, where all the internal steps are processed sequentially, and the final result is passed on.
If you'd like to support this and other OverZealous Creations (Phil DeJarnett) projects, donate via Gratipay!
FAQs
Use to create an immutable, lazily initialized pipeline from a series of streams.
The npm package lazypipe receives a total of 31,514 weekly downloads. As such, lazypipe popularity was classified as popular.
We found that lazypipe demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Tea.xyz, a crypto project aimed at rewarding open source contributions, is once again facing backlash due to an influx of spam packages flooding public package registries.
Security News
As cyber threats become more autonomous, AI-powered defenses are crucial for businesses to stay ahead of attackers who can exploit software vulnerabilities at scale.
Security News
UnitedHealth Group disclosed that the ransomware attack on Change Healthcare compromised protected health information for millions in the U.S., with estimated costs to the company expected to reach $1 billion.