verb/lib/plugins/init.js

Documentation generator for GitHub projects. Verb is extremely powerful, easy to use, and is used on hundreds of projects of all sizes to generate everything from API docs to readmes.

'use strict';

var gutil = require('gulp-util');
var PluginError = gutil.PluginError;
var through = require('through2');

module.exports = function () {
  var app = this;

  return through.obj(function (file, enc, cb) {
    if (file.isNull()) {
      this.push(file);
      return cb();
    }
    if (file.isStream()) {
      this.emit('error', new PluginError('init plugin', 'Streaming is not supported.'));
      return cb();
    }

    try {
      var stream = this;
      file.content = file.contents.toString();
      app.handle('onLoad', file, function (err) {
        if (err) {
          stream.emit('error', new PluginError('renderFile', err, {stack: true}));
          cb(err);
          return;
        }
      });
      this.push(file);
      cb();
    } catch (err) {
      this.emit('error', new PluginError('init plugin', err, {stack: true}));
      cb();
    }
  });
};