fix: filtering empty lines in docblocks preventing markdown tables from working (#275)

Author: erunion

__tests__/extractor.test.js

@@ -75,6 +75,30 @@ describe('Extractor', () => {
       expect(typeof endpoint.responses['200']).toBe('object');
     });
 
+    it('extracts markdown tables from endpoint comment strings', () => {
+      const operation = [
+        ' @api [get] /pets',
+        ' summary: Get pets',
+        ' description: |',
+        '   Get pets',
+        '   ',
+        '   |a|b|',
+        '   |-|-|',
+        '   |1|2|',
+      ].join('\n');
+
+      const endpoint = Extractor.extractEndpoint(operation);
+
+      expect(endpoint.method).toBe('get');
+      expect(endpoint.route).toBe('/pets');
+      expect(endpoint.description).toContain(`Get pets
+
+|a|b|
+|-|-|
+|1|2|
+`);
+    });
+
     it('extracts endpoints from comment strings + summary', () => {
       const operationWithSummary = [
         '',

src/extractor.js

@@ -1,14 +1,6 @@
 const extractComments = require('multilang-extract-comments');
 const jsYaml = require('js-yaml');
 
-function pushLine(array, line) {
-  if (line.trim()) {
-    array.push(line);
-    return true;
-  }
-  return false;
-}
-
 function loadYamlWithPrettyErrors(prettyObject, yamlLines) {
   try {
     return jsYaml.load(yamlLines.join('\n').replace(/\t/g, ' '));
@@ -85,12 +77,12 @@ class Extractor {
     let route = null;
     let scopeMatched = false;
 
-    lines.some(line => {
+    lines.forEach(line => {
       if (route) {
         if (options && options.scope) {
           if (line.trim().indexOf('scope:') === 0 && line.indexOf(options.scope) >= 0) {
             scopeMatched = true;
-            return false;
+            return;
           }
         } else {
           scopeMatched = true;
@@ -100,16 +92,14 @@ class Extractor {
           // Only return false here if this line is an explicit `scope: {string}` property and not perhaps a `scope`
           // property within a request body, parameter, or response schema.
           if (line.trim().match(/scope: (.*)/)) {
-            return false;
+            return;
           }
         }
 
-        pushLine(yamlLines, line);
-        // eslint-disable-next-line consistent-return
+        yamlLines.push(line);
         return;
       }
       route = route || line.match(this.ROUTE_REGEX);
-      return false;
     });
 
     if (!scopeMatched) {
@@ -138,7 +128,7 @@ class Extractor {
         if (line.trim().indexOf('scope:') === 0) {
           return;
         }
-        pushLine(yamlLines, line);
+        yamlLines.push(line);
         return;
       }
       route = route || line.match(this.SCHEMA_REGEX);