fix: correctly load external config file

- external configuration files are properly handled
- transform verbose parameter in config file to a 'loglevel' integer
  that can be increased. uniformity in handling of verbose param
- add test cases

Author: dlouzan

README.md

@@ -65,7 +65,7 @@ Options:
   -r, --rules [ruleFile]  provide multiple rules files
   -s, --skip [ruleName]   provide multiple rules to skip
   -j, --json-schema       treat $ref like JSON Schema and convert to OpenAPI Schema Objects
-  -v, --verbose           increase verbosity
+  -v, --verbose           set verbosity (use multiple times to increase level)
   -h, --help              output usage information
 ```
 
@@ -98,7 +98,7 @@ Options:
   -o, --output <file>  file to output to
   -q, --quiet          reduce verbosity
   -j, --json-schema    treat $ref like JSON Schema and convert to OpenAPI Schema Objects
-  -v, --verbose        increase verbosity
+  -v, --verbose        set verbosity (use multiple times to increase level)
   -h, --help           output usage information
 ```
 
@@ -122,7 +122,7 @@ Options:
   -p, --port [value]  port on which the server will listen (default: 5000)
   -q, --quiet         reduce verbosity
   -j, --json-schema   treat $ref like JSON Schema and convert to OpenAPI Schema Objects
-  -v, --verbose       increase verbosity
+  -v, --verbose       set verbosity (use multiple times to increase level)
   -h, --help          output usage information
 ```
 
@@ -138,7 +138,8 @@ jsonSchema: true
 # Keep the noise down
 quiet: true
 # Output a lot of information about what is happening (wont work if you have quiet on)
-verbose: true
+# Default stdout = 1
+verbose: 2
 # Rules specific to the lint command
 lint:
   # rules files to load

lib/config.js

@@ -7,7 +7,7 @@ nconf.formats.yaml = require('nconf-yaml');
 class Config {
 
     init(args) {
-        const configFile = args.config || './speccy.yaml';
+        const configFile = (args.parent && args.parent.config) ? args.parent.config : './speccy.yaml';
 
         this.load(configFile, {
             quiet: args.quiet,
@@ -40,20 +40,28 @@ class Config {
             format: nconf.formats.yaml,
             file,
         });
+
+        if (!nconf.get('quiet') && nconf.get('verbose') > 2) {
+            console.error('LOADING CONFIG', file);
+        }
     }
 
     get(key, defaultValue) {
         // Search through all known stores for the value
         const value = nconf.get(key);
-        return (value === undefined) ? defaultValue : value;
+        const result = (value === undefined) ? defaultValue : value;
+        if (!nconf.get('quiet') && nconf.get('verbose') > 2) {
+            console.error(`CONFIG VALUE ${key} = ${result} (default = ${defaultValue})`)
+        }
+        return result
     }
 
     // Don't want an object full of null
     cleanObject(object) {
         const cleaned = {};
         Object.keys(object).forEach(key => {
             const value = object[key];
-            if (value === undefined || value === null) {
+            if (value === undefined || value === null || (Array.isArray(value) && value.length === 0)) {
                 return;
             } else if (typeof value === "object" && !Array.isArray(value)) {
                 cleaned[key] = this.cleanObject(value);

lib/loader.js

@@ -130,9 +130,9 @@ async function asyncMap(array, callback) {
 
 const loadRulesets = async (loadFiles, options = {}) => {
     const { verbose } = options;
-    const rulesetList = (loadFiles.length > 0 ? loadFiles : ['default']);
-    const allDependancies = await asyncMap(rulesetList, ruleset => recursivelyLoadRulesets(ruleset, [], { verbose }));
-    const flatDependencies = [].concat(...allDependancies);
+    const rulesetList = (loadFiles && loadFiles.length > 0 ? loadFiles : ['default']);
+    const allDependencies = await asyncMap(rulesetList, ruleset => recursivelyLoadRulesets(ruleset, [], { verbose }));
+    const flatDependencies = [].concat(...allDependencies);
     // Unique copy of the array
     return [...(new Set(flatDependencies))];
 }
@@ -146,7 +146,7 @@ const resolveContent = (openapi, options) => {
         externalRefs: {},
         rewriteRefs: true,
         openapi: openapi,
-        verbose: options.verbose === 2,
+        verbose: options.verbose > 1,
     });
 }
 

lint.js

@@ -68,7 +68,7 @@ More information: https://speccy.io/rules/1-rulesets#${rule.name}
 const command = async (specFile, cmd) => {
     config.init(cmd);
     const jsonSchema = config.get('jsonSchema');
-    const verbose = config.get('quiet') ? 0 : config.get('verbose', 1); 
+    const verbose = config.get('quiet') ? 0 : config.get('verbose', 1);
     const rulesets = config.get('lint:rules');
     const skip = config.get('lint:skip');
 
@@ -80,7 +80,7 @@ const command = async (specFile, cmd) => {
 
     const spec = await loader.readOrError(
         specFile,
-        buildLoaderOptions(jsonSchema, verbose),
+        buildLoaderOptions(jsonSchema, verbose)
     );
 
     return new Promise((resolve, reject) => {

package-lock.json

@@ -6,16 +6,18 @@ const fs = require('fs');
 const yaml = require('js-yaml');
 const config = require('./lib/config.js');
 const loader = require('./lib/loader.js');
-const resolver = require('oas-resolver');
 const fromJsonSchema = require('json-schema-to-openapi-schema');
 
 const command = async (file, cmd) => {
     config.init(cmd);
     const jsonSchema = config.get('jsonSchema');
     const output = config.get('resolve:output');
-    const verbose = config.get('quiet') ? 0 : (config.get('verbose') ? 2 : 1);
+    const verbose = config.get('quiet') ? 0 : config.get('verbose', 1);
 
-    const spec = await loader.readOrError(file, buildLoaderOptions(jsonSchema, verbose));
+    const spec = await loader.readOrError(
+        file,
+        buildLoaderOptions(jsonSchema, verbose)
+    );
     const content = yaml.safeDump(spec, { lineWidth: -1 });
 
     return new Promise((resolve, reject) => {
@@ -52,4 +54,4 @@ const buildLoaderOptions = (jsonSchema, verbose) => {
     return options;
 }
 
-module.exports = { command }
+module.exports = { command };

resolve.js

@@ -37,7 +37,7 @@ const launchServer = (app, port, specFile, { verbose }) => {
 const command = async (specFile, cmd) => {
     config.init(cmd);
     const jsonSchema = config.get('jsonSchema');
-    const verbose = config.get('quiet') ? 0 : (config.get('verbose') ? 2 : 1);
+    const verbose = config.get('quiet') ? 0 : config.get('verbose', 1);
     const port = config.get('serve:port', DEFAULT_PORT);
 
     const app = express();

serve.js

@@ -32,11 +32,16 @@ program
     .option('-r, --rules [ruleFile]', 'provide multiple rules files', collect, [])
     .option('-s, --skip [ruleName]', 'provide multiple rules to skip', collect, [])
     .option('-j, --json-schema', 'treat $ref like JSON Schema and convert to OpenAPI Schema Objects (default: false)')
-    .option('-v, --verbose', 'increase verbosity', increaseVerbosity, 0)
+    .option('-v, --verbose', 'increase verbosity', increaseVerbosity, 1)
     .action((specFile, cmd) => {
         lint.command(specFile, cmd)
             .then(() => { process.exit(0) })
-            .catch(() => { process.exit(1) });
+            .catch((err) => {
+                if (err) {
+                    console.error(err.message);
+                }
+                process.exit(1);
+            });
     });
 
 program
@@ -45,11 +50,16 @@ program
     .option('-o, --output <file>', 'file to output to')
     .option('-q, --quiet', 'reduce verbosity')
     .option('-j, --json-schema', 'treat $ref like JSON Schema and convert to OpenAPI Schema Objects (default: false)')
-    .option('-v, --verbose', 'increase verbosity', increaseVerbosity, 0)
-    .action((file, cmd) => {
-        resolve.command(file, cmd)
+    .option('-v, --verbose', 'increase verbosity', increaseVerbosity,1)
+    .action((specFile, cmd) => {
+        resolve.command(specFile, cmd)
             .then(() => { process.exit(0) })
-            .catch(() => { process.exit(1) });
+            .catch((err) => {
+                if (err) {
+                    console.error(err.message);
+                }
+                process.exit(1);
+            });
     });
 
 program
@@ -58,9 +68,17 @@ program
     .option('-p, --port [value]', 'port on which the server will listen (default: 5000)')
     .option('-q, --quiet', 'reduce verbosity')
     .option('-j, --json-schema', 'treat $ref like JSON Schema and convert to OpenAPI Schema Objects (default: false)')
-    .option('-v, --verbose', 'increase verbosity', increaseVerbosity, 0)
+    .option('-v, --verbose', 'increase verbosity', increaseVerbosity,1)
     // TODO .option('-w, --watch', 'reloading browser on spec file changes')
-    .action(serve.command);
+    .action((specFile, cmd) => {
+        serve.command(specFile, cmd)
+            .catch((err) => {
+                if (err) {
+                    console.error(err.message);
+                }
+                process.exit(1);
+            });
+    });
 
 program.parse(process.argv);
 

speccy.js

@@ -1,7 +1,7 @@
 {
     "jsonSchema": true,
     "quiet": true,
-    "verbose": true,
+    "verbose": 2,
     "lint": {
       "rules": [
         "strict",
@@ -18,4 +18,4 @@
     "serve": {
       "port": 8001
     }
-  }
+}