assemble-streams

assemble-streams

Assemble pipeline plugin for pushing a view collection into a vinyl stream.

Install

Install with npm:

$ npm install --save assemble-streams

Usage

This plugin can be used with assemble, verb or any other application based on templates.

var assemble = require('assemble');
var streams = require('assemble-streams');

// create your application
var app = assemble();
// register the plugin
app.use(stream());

// use the plugin on app
app.toStream('pages')
  .pipe(app.dest('site/'));

// use the plugin on a collection
app.pages.toStream()
  .pipe(app.dest('site/'));

// use the plugin on a view
app.pages.getView('home').toStream()
  .pipe(app.dest('site/'));

See the tests for more examples.

API

app.toStream

Push a view collection into a vinyl stream.

Params

• collection {String}: Name of the collection to push into the stream.
• {Function}: Optionally pass a filter function to use for filtering views.
• returns {Stream}

Example

app.toStream('posts', function(file) {
  return file.path !== 'index.hbs';
})

collection.toStream

Push a view collection into a vinyl stream.

Params

• {Function}: Optionally pass a filter function to use for filtering views.
• returns {Stream}

Example

app.posts.toStream(function(file) {
  return file.path !== 'index.hbs';
})

view.toStream

Push the current view into a vinyl stream.

• returns {Stream}

Example

app.pages.getView('a.html').toStream()
  .on('data', function(file) {
    console.log(file);
    //=> <Page "a.html" <Buffer 2e 2e 2e>>
  });

About

Related projects

• assemble-loader: Assemble plugin (^0.6.0) for loading globs of views onto custom view collections. Also works with… more | homepage
• assemble-render-file: Assemble plugin for rendering views in a vinyl pipeline. | homepage
• assemble: Get the rocks out of your socks! Assemble makes you fast at creating web projects… more | homepage

Contributing

Pull requests and stars are always welcome. For bugs and feature requests, please create an issue.

Building docs

(This document was generated by verb-generate-readme (a verb generator), please don't edit the readme directly. Any changes to the readme must be made in .verb.md.)

To generate the readme and API documentation with verb:

$ npm install -g verb verb-generate-readme && verb

Running tests

Install dev dependencies:

$ npm install -d && npm test

Author

Jon Schlinkert

• github/jonschlinkert
• twitter/jonschlinkert

License

Copyright © 2016, Jon Schlinkert. Released under the MIT license.

---

This file was generated by verb-generate-readme, v0.1.28, on August 02, 2016.