fix: Report errors from setting bad options on CLI

Closes #1237

Author: Gerrit0

src/lib/utils/options/readers/arguments.ts

@@ -19,6 +19,8 @@ export class ArgumentsReader implements OptionsReader {
         const seen = new Set<string>();
         let index = 0;
 
+        const error = (error: Error) => logger.error(error.message);
+
         while (index < this.args.length) {
             const name = this.args[index];
             const decl = name.startsWith('-')
@@ -30,19 +32,19 @@ export class ArgumentsReader implements OptionsReader {
                     container.setValue(
                         decl.name,
                         (container.getValue(decl.name) as string[]).concat(this.args[index])
-                    );
+                    ).mapErr(error);
                 } else if (decl.type === ParameterType.Boolean) {
                     const value = String(this.args[index]).toLowerCase();
 
                     if (value === 'true' || value === 'false') {
-                        container.setValue(decl.name, value === 'true');
+                        container.setValue(decl.name, value === 'true').mapErr(error);
                     } else {
-                        container.setValue(decl.name, true);
+                        container.setValue(decl.name, true).mapErr(error);
                         // Bool option didn't consume the next argument as expected.
                         index--;
                     }
                 } else {
-                    container.setValue(decl.name, this.args[index]);
+                    container.setValue(decl.name, this.args[index]).mapErr(error);
                 }
                 seen.add(decl.name);
             } else {

src/test/converter.test.ts

@@ -26,16 +26,16 @@ describe('Converter', function() {
     const checks: [string, () => void, () => void][] = [
         ['specs', () => { }, () => { }],
         ['specs.d',
-            () => app.options.setValue('includeDeclarations', true),
-            () => app.options.setValue('includeDeclarations', false)
+            () => app.options.setValue('includeDeclarations', true).unwrap(),
+            () => app.options.setValue('includeDeclarations', false).unwrap()
         ],
         ['specs-without-exported',
-            () => app.options.setValue('excludeNotExported', true),
-            () => app.options.setValue('excludeNotExported', false)
+            () => app.options.setValue('excludeNotExported', true).unwrap(),
+            () => app.options.setValue('excludeNotExported', false).unwrap()
         ],
         ['specs-with-lump-categories',
-            () => app.options.setValue('categorizeByGroup', false),
-            () => app.options.setValue('categorizeByGroup', true)
+            () => app.options.setValue('categorizeByGroup', false).unwrap(),
+            () => app.options.setValue('categorizeByGroup', true).unwrap()
         ]
     ];
 

src/test/typedoc.test.ts

@@ -25,22 +25,22 @@ describe('TypeDoc', function() {
         });
         it('honors the exclude argument even on a fixed directory list', function() {
             const inputFiles = Path.join(__dirname, 'converter', 'class');
-            application.options.setValue('exclude', '**/class.ts');
+            application.options.setValue('exclude', '**/class.ts').unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert(!expanded.includes(Path.join(inputFiles, 'class.ts')));
             Assert(!expanded.includes(inputFiles));
         });
         it('honors the exclude argument even on a fixed file list', function() {
             const inputFiles = Path.join(__dirname, 'converter', 'class', 'class.ts');
-            application.options.setValue('exclude', '**/class.ts');
+            application.options.setValue('exclude', '**/class.ts').unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert(!expanded.includes(inputFiles));
         });
         it('supports multiple excludes', function() {
             const inputFiles = Path.join(__dirname, 'converter');
-            application.options.setValue('exclude', '**/+(class|access).ts');
+            application.options.setValue('exclude', '**/+(class|access).ts').unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert(!expanded.includes(Path.join(inputFiles, 'class', 'class.ts')));
@@ -49,7 +49,7 @@ describe('TypeDoc', function() {
         });
         it('supports array of excludes', function() {
             const inputFiles = Path.join(__dirname, 'converter');
-            application.options.setValue('exclude', [ '**/class.ts', '**/access.ts' ]);
+            application.options.setValue('exclude', [ '**/class.ts', '**/access.ts' ]).unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert(!expanded.includes(Path.join(inputFiles, 'class', 'class.ts')));
@@ -58,7 +58,7 @@ describe('TypeDoc', function() {
         });
         it('supports excluding directories beginning with dots', function() {
             const inputFiles = __dirname;
-            application.options.setValue('exclude', '**/+(.dot)/**');
+            application.options.setValue('exclude', '**/+(.dot)/**').unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert(!expanded.includes(Path.join(inputFiles, '.dot', 'index.ts')));
@@ -79,7 +79,7 @@ describe('TypeDoc', function() {
 
         it('supports directory excludes', function() {
             const inputFiles = Path.join(__dirname, 'converter');
-            application.options.setValue('exclude', [ '**/alias' ]);
+            application.options.setValue('exclude', [ '**/alias' ]).unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert.strictEqual(expanded.includes(Path.join(inputFiles, 'class', 'class.ts')), true);
@@ -89,7 +89,7 @@ describe('TypeDoc', function() {
 
         it('supports negations in directory excludes', function() {
             const inputFiles = Path.join(__dirname, 'converter');
-            application.options.setValue('exclude', [ '**/!(alias)/' ]);
+            application.options.setValue('exclude', [ '**/!(alias)/' ]).unwrap();
             const expanded = application.expandInputFiles([inputFiles]);
 
             Assert.strictEqual(expanded.includes(Path.join(inputFiles, 'class', 'class.ts')), false);