gulp-mirror
Version:
Make a mirror of stream, it's useful that do different transform of the same stream.
82 lines (60 loc) • 2.53 kB
Markdown
# gulp-mirror
Make a mirror of stream, it's useful that do different transform of the same stream.
---
[](https://npmjs.org/package/gulp-mirror)
[](https://travis-ci.org/popomore/gulp-mirror)
[](https://coveralls.io/r/popomore/gulp-mirror)
[](https://npmjs.org/package/gulp-mirror)
## Install
```
$ npm install gulp-mirror
```
## Usage
Real world [example](https://github.com/popomore/gulp-mirror/tree/master/examples).
```
var gulp = require('gulp');
var concat = require('gulp-concat');
var mirror = require('gulp-mirror');
var rename = require('gulp-rename');
gulp.task('default', function() {
return gulp.src('src/**/*.js')
.pipe(concat('all.js'))
.pipe(mirror(
rename('browser.js'),
rename('common.js'),
rename('node.js')
))
.pipe(gulp.dest('dist'));
});
```
Concat all js files in src directory, then rename it using mirror that will create three files which are the same.
## API
### mirror(stream1, stream2 ..., streamN)
Pass the input stream to all the mirrored stream with cloned `File` object. The mirrored stream also can be pipeline stream using [multipipe](https://github.com/juliangruber/multipipe), see [example 2](https://github.com/popomore/gulp-mirror/tree/master/examples#example-2).
```
gulp.src(source)
.pipe(sharedStream1)
.pipe(mirror(
stream1,
stream2,
...
streamN
))
.pipe(sharedStream2)
.pipe(gulp.dest(dest));
```
Stream flow
```
--> stream1 -->
/ \
src --> sharedStream1 --> stream2 -->
\ \
--> ... --> sharedStream2 --> dest
\ /
--> streamN -->
```
**if mirror has only one argument, it will create another passthrough stream, just like [gulp-clone](https://github.com/mariocasciaro/gulp-clone)**, See [example 3](https://github.com/popomore/gulp-mirror/tree/master/examples#example-3).
### mirror([stream1, stream2 ..., streamN])
Sometimes the number of streams is variable, then we can pass to `mirror` an array of streams as unique argument.
## LICENSE
Copyright (c) 2015 popomore. Licensed under the MIT license.