@bablr/cli 0.1.8 → 0.1.10

package/README.md

@@ -10,13 +10,13 @@ This package has no built-in language support, but rather expects you to supply
 Usage: bablr [options]
 
 Options:
-  -l, --language [URL]     The URL of the BABLR language to parse with
-  -p, --production [type]  The top-level type for the parse
-  -f, --format             Pretty-format CSTML output
-  -F, --no-format          Produce machine-readable CSTML output
+  -l, --language [URL]     The URL of the top BABLR language
+  -p, --production [type]  The name of the top production type
+  -f, --format             Pretty-format CSTML output (default: true)
+  -F, --no-format
   -v, --verbose            Prints debugging information to stderr
-  -c, --color              Force colored output (default: true)
-  -C, --no-color           Do not color output
+  -c, --color [WHEN]       When to use ANSI escape colors
+    WHEN: "auto" | "always" | "never" (default: "auto")
   -e, --embedded           Requires quoted input but enables gap parsing
   -h, --help               display help for command
 ```

package/bin/index.js

@@ -15,18 +15,31 @@ import { generateCSTML } from '../lib/syntax.js';
 import { writeLinesToWritableStream } from '../lib/utils/node.js';
 
 program
-  .option('-l, --language [URL]', 'The URL of the BABLR language to parse with')
-  .option('-p, --production [type]', 'The top-level type for the parse')
-  .option('-F, --no-format', 'Produce machine-readable CSTML output')
-  .option('-f, --format', 'Pretty-format CSTML output')
+  .option('-l, --language [URL]', 'The URL of the top BABLR language')
+  .option('-p, --production [type]', 'The name of the top production type')
+  .option('-f, --format', 'Pretty-format CSTML output', true)
+  .option('-F, --no-format')
   .option('-v, --verbose', 'Prints debugging information to stderr')
-  .option('-c, --color', 'Force colored output', true)
-  .option('-C, --no-color', 'Do not color output')
+  .option(
+    '-c, --color [WHEN]',
+    'When to use ANSI escape colors \n  WHEN: "auto" | "always" | "never"',
+    'auto',
+  )
   .option('-e, --embedded', 'Requires quoted input but enables gap parsing')
   .parse(process.argv);
 
 const programOpts = program.opts();
-const options = { ...programOpts, color: colorSupport.hasBasic && programOpts.color };
+
+if (programOpts.color && !['auto', 'always', 'never'].includes(programOpts.color.toLowerCase())) {
+  throw new Error('invalid value for --color');
+}
+
+const options = {
+  ...programOpts,
+  color:
+    (programOpts.color.toLowerCase() === 'auto' && colorSupport.hasBasic) ||
+    programOpts.color.toLowerCase() === 'always',
+};
 
 const language = await import(options.language);
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@bablr/cli",
   "description": "CLI for running BABLR parsers",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "author": "Conrad Buck<conartist6@gmail.com>",
   "type": "module",
   "files": [
@@ -23,7 +23,7 @@
     "@bablr/boot": "0.2.3",
     "@bablr/coroutine": "0.1.0",
     "@bablr/helpers": "0.15.4",
-    "@bablr/language-cstml": "0.2.2",
+    "@bablr/language-cstml": "0.2.4",
     "bablr": "0.1.3",
     "color-support": "1.1.3",
     "commander": "12.0.0"