Support --shallow argument for lint command. Closes #956

Author: bubenkoff

__tests__/bin.js

@@ -185,7 +185,11 @@ describe('lint command', function() {
     try {
       await documentation(['lint fixture/lint/lint.input.js'], {}, false);
     } catch (err) {
-      var data = err.stderr.toString().split('\n').slice(2).join('\n');
+      var data = err.stderr
+        .toString()
+        .split('\n')
+        .slice(2)
+        .join('\n');
       expect(data).toMatchSnapshot();
     }
   });
@@ -224,6 +228,15 @@ describe('lint command', function() {
       expect(err.code > 0).toBeTruthy();
     }
   });
+
+  test('generates lint output with shallow', async function() {
+    const data = await documentation(
+      ['lint fixture/lint/lint.input.shallow.js --shallow'],
+      {},
+      false
+    );
+    expect(data).toBe('');
+  });
 });
 
 test('given no files', async function() {

__tests__/fixture/lint/lint.input.dependency.js

@@ -0,0 +1,19 @@
+/**
+ * @param {String} foo bar
+ * @returns {object} bad object return type
+ * @type {Array<object>} bad object type
+ * @memberof notfound
+ */
+
+/**
+ * @param {String} baz bar
+ * @property {String} bad property
+ * @private
+ */
+
+/**
+ * @param {number} c explicit but not found
+ */
+function add(a, b) {}
+
+module.exports.add = add;

__tests__/fixture/lint/lint.input.shallow.js

@@ -0,0 +1,7 @@
+var dep = require('./lint.input.dependency');
+
+/**
+ * @param {string} a
+ * @param {boolean} b
+ */
+function add(a, b) {}

src/commands/lint.js

@@ -1,14 +1,17 @@
 /* @flow */
 
-var documentation = require('../');
-var fs = require('fs');
-var path = require('path');
+var documentation = require('../'),
+  sharedOptions = require('./shared_options'),
+  fs = require('fs'),
+  path = require('path');
 
 /* eslint no-console: 0 */
 
 module.exports.command = 'lint [input..]';
 module.exports.description = 'check for common style and uniformity mistakes';
-module.exports.builder = {};
+module.exports.builder = {
+  shallow: sharedOptions.sharedInputOptions.shallow
+};
 
 /**
  * Wrap around the documentation.lint method and add the additional