add possibility to filter by tag

Author: BELGHITI ALAOUI Omar

lib/parser.js

@@ -10,6 +10,7 @@ var ParameterError = require('./errors/parameter_error');
 var ParserError    = require('./errors/parser_error');
 
 var app = {};
+var filterTag = null;
 
 function Parser(_app) {
     var self = this;
@@ -49,6 +50,11 @@ function Parser(_app) {
             self.addParser(parser, require(filename));
         }
     });
+
+    if (app.options.filterBy) {
+        var tag = app.options.filterBy.split('=')[0];
+        filterTag = (tag.indexOf('api') != -1) ? tag : null;
+    }
 }
 
 /**
@@ -410,8 +416,11 @@ Parser.prototype._findBlocks = function() {
  */
 Parser.prototype._findBlockWithApiGetIndex = function(blocks) {
     var foundIndexes = [];
+    const valueTofilter = (filterTag) ? app.options.filterBy.split('=')[1] : null;
     for (var i = 0; i < blocks.length; i += 1) {
         var found = false;
+        let isToFilterBy = false;
+        let isDefine = false;
         for (var j = 0; j < blocks[i].length; j += 1) {
             // check apiIgnore
             if (blocks[i][j].name.substr(0, 9) === 'apiignore') {
@@ -426,10 +435,24 @@ Parser.prototype._findBlockWithApiGetIndex = function(blocks) {
                 found = false;
                 break;
             }
+            // if (filterTag && blocks[i][j].name.substr(0, 10) === filterTag && blocks[i][j].content !== valueTofilter) {
+            if (filterTag) {
+                if (blocks[i][j].name.substr(0, 9) === 'apidefine') {
+                    isDefine = true;
+                }
+                if (blocks[i][j].name.substr(0, filterTag.length) === filterTag && blocks[i][j].content === valueTofilter) {
+                    isToFilterBy = true;
+                }
+            }
 
             if (blocks[i][j].name.substr(0, 3) === 'api')
                 found = true;
         }
+
+        if (filterTag) {
+            found = found && (isToFilterBy || isDefine);
+        }
+
         if (found) {
             foundIndexes.push(i);
             app.log.debug('api found in block: ' + i);