chore(doc-gen): add debug-dump processor

docs/config/index.js

@@ -17,7 +17,8 @@ module.exports = function(config) {
     require('./processors/versions-data'),
     require('./processors/pages-data'),
     require('./processors/protractor-generate'),
-    require('./processors/index-page')
+    require('./processors/index-page'),
+    require('./processors/debug-dump')
   ]);
 
   config.append('processing.tagDefinitions', [

docs/config/processors/debug-dump.js

@@ -0,0 +1,26 @@
+var writer = require('dgeni/lib/utils/doc-writer');
+var log = require('winston');
+var util = require("util");
+
+var filter, outputPath, depth;
+
+module.exports = {
+  name: 'debug-dump',
+  runBefore: ['write-files'],
+  description: 'This processor dumps docs that match a filter to a file',
+  init: function(config, injectables) {
+    filter = config.get('processing.debug-dump.filter');
+    outputPath = config.get('processing.debug-dump.outputPath');
+    depth = config.get('processing.debug-dump.depth', 2);
+  },
+  process: function(docs) {
+    if ( filter && outputPath ) {
+      log.info('Dumping docs:', filter, outputPath);
+      var filteredDocs = filter(docs);
+      var dumpedDocs = util.inspect(filteredDocs, depth);
+      return writer.writeFile(outputPath, dumpedDocs).then(function() {
+        return docs;
+      });
+    }
+  }
+};