tape-six-proc 1.2.3 → 1.2.5

package/README.md

@@ -10,9 +10,9 @@ and supports TypeScript natively without transpilation.
 ## Why?
 
 The standard `tape6` runner uses worker threads. `tape6-proc` spawns each test file
-in its own subprocess instead, providing full process isolation. This prevents shared
-state leaks and is useful when tests need a clean environment. TypeScript test files
-(`.ts`) are run natively by modern Node, Deno, and Bun — no transpilation needed.
+in its own subprocess instead, providing full process isolation. This prevents shared-state
+leaks and is useful when tests need a clean environment. TypeScript test files (`.ts`)
+run natively on modern Node, Deno, and Bun — no transpilation needed.
 
 ## Install
 
@@ -66,11 +66,10 @@ npm test
 
 ## Docs
 
-The documentation can be found in the [wiki](https://github.com/uhop/tape-six-proc/wiki).
+See the [wiki](https://github.com/uhop/tape-six-proc/wiki) for full documentation.
 `tape-six` has its own [wiki](https://github.com/uhop/tape-six/wiki).
 
-`tape-six-proc` uses the same test configuration as `tape-six`. The utility `tape6-proc`
-has the same usage as `tape6`.
+`tape-six-proc` uses the same test configuration and CLI conventions as `tape-six`.
 
 ### Command-line utilities
 
@@ -89,6 +88,8 @@ LLM-friendly documentation is available:
 
 The most recent releases:
 
+- 1.2.5 _Synchronized with `tape-six` 1.7.6+. Simplified CLI via shared config utilities. Added `--info` flag. Fixed Deno stdout flush._
+- 1.2.4 _Synchronized with `tape-six` 1.7.4. Added Min reporter support. Improved docs and npm keywords._
 - 1.2.3 _Updated dependencies, cleaned up docs, added AI-friendly links and TS info._
 - 1.2.2 _Synchronized the implementation with `tape-six` 1.7.0._
 - 1.2.1 _Synchronized the implementation with `tape-six` 1.5.1._
@@ -104,4 +105,4 @@ The most recent releases:
 - 1.0.1 _Updated dependencies._
 - 1.0.0 _The first official release._
 
-For more info consult full [release notes](https://github.com/uhop/tape-six-proc/wiki/Release-notes).
+See the full [release notes](https://github.com/uhop/tape-six-proc/wiki/Release-notes) for details.

package/bin/tape6-proc-node.js

@@ -1,29 +1,16 @@
 #!/usr/bin/env node
 
 import process from 'node:process';
-import os from 'node:os';
 import {fileURLToPath} from 'node:url';
 
-import {
-  getReporterFileName,
-  getReporterType,
-  resolveTests,
-  resolvePatterns,
-  runtime
-} from 'tape-six/utils/config.js';
+import {getOptions, initFiles, initReporter, showInfo} from 'tape-six/utils/config.js';
 
 import {getReporter, setReporter} from 'tape-six/test.js';
 import {selectTimer} from 'tape-six/utils/timer.js';
 
 import TestWorker from '../src/TestWorker.js';
 
-const options = {},
-  rootFolder = process.cwd();
-
-let flags = '',
-  parallel = '',
-  runFileArgs = [],
-  files = [];
+const rootFolder = process.cwd();
 
 const showSelf = () => {
   const self = new URL(import.meta.url);
@@ -35,124 +22,44 @@ const showSelf = () => {
   process.exit(0);
 };
 
-const config = () => {
-  if (process.argv.includes('--self')) showSelf();
-
-  const optionNames = {
-    f: 'failureOnly',
-    t: 'showTime',
-    b: 'showBanner',
-    d: 'showData',
-    o: 'failOnce',
-    n: 'showAssertNumber',
-    m: 'monochrome',
-    c: 'dontCaptureConsole',
-    h: 'hideStreams'
-  };
-
-  let parIsSet = false;
-
-  for (let i = 2; i < process.argv.length; ++i) {
-    const arg = process.argv[i];
-    if (arg == '-f' || arg == '--flags') {
-      if (++i < process.argv.length) {
-        flags += process.argv[i];
-      }
-      continue;
-    }
-    if (arg == '-p' || arg == '--par') {
-      if (++i < process.argv.length) {
-        parallel = process.argv[i];
-        parIsSet = true;
-        if (!parallel || isNaN(parallel)) {
-          parallel = '';
-          parIsSet = false;
-        }
-      }
-      continue;
-    }
-    if (arg == '-r' || arg == '--runFileArgs') {
-      if (++i < process.argv.length) {
-        runFileArgs.push(process.argv[i]);
-      }
-      continue;
-    }
-    files.push(arg);
-  }
-
-  flags = (process.env.TAPE6_FLAGS || '') + flags;
-  for (let i = 0; i < flags.length; ++i) {
-    const option = flags[i].toLowerCase(),
-      name = optionNames[option];
-    if (typeof name == 'string') options[name] = option !== flags[i];
-  }
-  options.flags = flags;
-
-  if (!parIsSet) {
-    parallel = process.env.TAPE6_PAR || parallel;
-  }
-  if (parallel) {
-    parallel = Math.max(0, +parallel);
-    if (parallel === Infinity) parallel = 0;
-  } else {
-    parallel = 0;
-  }
-  if (!parallel) {
-    if (typeof navigator !== 'undefined' && navigator.hardwareConcurrency) {
-      parallel = navigator.hardwareConcurrency;
-    } else {
-      try {
-        parallel = os.availableParallelism();
-      } catch (e) {
-        void e;
-        parallel = 1;
-      }
+const main = async () => {
+  const runFileArgs = [];
+  const options = getOptions({
+    '--self': showSelf,
+    '--info': {isValueRequired: false},
+    '--runFileArgs': {
+      aliases: ['-r'],
+      isValueRequired: true,
+      fn: (_, _name, value) => runFileArgs.push(value)
     }
-  }
+  });
+  options.flags.runFileArgs = runFileArgs;
 
-  options.runFileArgs = runFileArgs;
-};
+  const [files] = await Promise.all([
+    initFiles(options.files, rootFolder),
+    initReporter(getReporter, setReporter, options.flags),
+    selectTimer()
+  ]);
 
-const init = async () => {
-  const currentReporter = getReporter();
-  if (!currentReporter) {
-    const reporterType = getReporterType(),
-      reporterFile = getReporterFileName(reporterType),
-      CustomReporter = (await import('tape-six/reporters/' + reporterFile)).default,
-      hasColors = !(
-        options.monochrome ||
-        process.env.NO_COLOR ||
-        process.env.NODE_DISABLE_COLORS ||
-        process.env.FORCE_COLOR === '0'
-      ),
-      customOptions = reporterType === 'tap' ? {useJson: true, hasColors} : {...options, hasColors},
-      customReporter = new CustomReporter(customOptions);
-    setReporter(customReporter);
-  }
+  process.on('uncaughtException', (error, origin) => {
+    console.error('UNHANDLED ERROR:', origin, error);
+    process.exit(1);
+  });
 
-  if (files.length) {
-    files = await resolvePatterns(rootFolder, files);
-  } else {
-    files = await resolveTests(rootFolder, runtime.name);
+  if (options.optionFlags['--info'] === '') {
+    showInfo(options, files);
+    await new Promise(r => process.stdout.write('', r));
+    process.exit(0);
   }
-};
-
-const main = async () => {
-  config();
-  await init();
-  await selectTimer();
-
-  process.on('uncaughtException', (error, origin) =>
-    console.error('UNHANDLED ERROR:', origin, error)
-  );
 
   if (!files.length) {
     console.log('No files found.');
+    await new Promise(r => process.stdout.write('', r));
     process.exit(1);
   }
 
   const reporter = getReporter(),
-    worker = new TestWorker(reporter, parallel, options);
+    worker = new TestWorker(reporter, options.parallel, options.flags);
 
   reporter.report({type: 'test', test: 0});
 
@@ -169,6 +76,7 @@ const main = async () => {
     fail: hasFailed
   });
 
+  await new Promise(r => process.stdout.write('', r));
   process.exit(hasFailed ? 1 : 0);
 };
 

package/llms-full.txt

@@ -8,7 +8,7 @@
 - Drop-in replacement for `tape6` (worker-thread runner)
 - Same configuration format as `tape-six`
 - Parallel execution with configurable concurrency
-- TAP, TTY (colored), and JSONL output formats
+- TAP, TTY (colored), JSONL, and minimal output formats
 
 ## Install
 
@@ -55,8 +55,10 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 - `--flags FLAGS` (`-f`) — output control flags (see Supported flags below).
 - `--par N` (`-p`) — number of parallel processes. Default: all CPU cores (via `os.availableParallelism()` or `navigator.hardwareConcurrency`).
 - `--runFileArgs ARGS` (`-r`) — extra arguments passed to the spawned interpreter. Can be specified multiple times. Mainly used for Deno permissions.
+- `--info` — prints runtime, reporter, parallelism, flags, and test files, then exits.
 - `--self` — prints the absolute path to `tape6-proc.js` and exits. Used in cross-runtime scripts.
 - Positional arguments: test file glob patterns. If none given, reads from configuration.
+- Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
 ### Examples
 
@@ -145,6 +147,7 @@ Environment-specific subsections (`node`, `deno`, `bun`) are supported. The runn
 - `TAPE6_PAR` — number of parallel processes (overridden by `--par`).
 - `TAPE6_TAP` — force TAP reporter (any non-empty value).
 - `TAPE6_JSONL` — force JSONL reporter (any non-empty value).
+- `TAPE6_MIN` — force minimal reporter (any non-empty value).
 - `TAPE6_TEST` — set by the runner: unique ID for each spawned test process.
 - `TAPE6_TEST_FILE_NAME` — set by the runner: file name of the current test.
 - `TAPE6_JSONL_PREFIX` — set by the runner: UUID prefix for JSONL lines in stdout.
@@ -160,9 +163,11 @@ Environment-specific subsections (`node`, `deno`, `bun`) are supported. The runn
 
 ### Main CLI (`bin/tape6-proc-node.js`)
 
-1. Parses CLI arguments (`--flags`, `--par`, `--runFileArgs`, positional test patterns).
-2. Selects reporter: TTY (default for terminals), TAP, or JSONL (based on environment variables).
-3. Resolves test files from configuration or CLI patterns using `tape-six/utils/config.js`.
+Delegates argument parsing, reporter setup, and file resolution to `tape-six/utils/config.js`:
+
+1. Calls `getOptions()` to parse CLI arguments (`--flags`, `--par`, `--runFileArgs`, `--info`, positional test patterns).
+2. Calls `initReporter()` to select the reporter: TTY (default for terminals), TAP, JSONL, or Min (based on environment variables).
+3. Calls `initFiles()` to resolve test files from configuration or CLI patterns.
 4. Creates a `TestWorker` instance and executes all test files.
 5. Reports final results and exits with code 0 (success) or 1 (failures).
 
@@ -173,7 +178,6 @@ Extends `EventServer` from `tape-six`. Manages parallel subprocess execution:
 - **`constructor(reporter, numberOfTasks, options)`** — initializes with a reporter, concurrency limit, and options. Generates a UUID prefix for JSONL parsing.
 - **`makeTask(fileName)`** — spawns a child process for a test file using `dollar-shell`. Sets up stream pipelines for stdout and stderr. Returns a task ID.
 - **`destroyTask(id)`** — cleans up a completed task.
-- **`getConcurrency()`** — static method, returns available CPU cores.
 
 ### Stream pipeline
 
@@ -204,7 +208,7 @@ process.stderr → TextDecoderStream → lines → wrap-lines → report
 
 ## Dependencies
 
-- **`tape-six`** — the core test library. Imports: `State.js`, `utils/EventServer.js`, `utils/makeDeferred.js`, `utils/config.js`, `test.js`, reporters (`TapReporter`, `TTYReporter`, `JSONLReporter`), `utils/timer.js`.
+- **`tape-six`** — the core test library. Imports: `utils/config.js` (`getOptions`, `initFiles`, `initReporter`, `showInfo`), `test.js` (`getReporter`, `setReporter`), `utils/timer.js`, `State.js`, `utils/EventServer.js`, `utils/makeDeferred.js`.
 - **`dollar-shell`** — cross-runtime process spawning. Imports: `spawn`, `currentExecPath`, `runFileArgs`.
 
 ## Writing tests

package/llms.txt

@@ -51,11 +51,13 @@ tape6-proc [--flags FLAGS] [--par N] [--runFileArgs ARGS] [tests...]
 
 ### Options
 
-- `--flags FLAGS` (`-f`) — output control flags (same as tape6: F=failures only, T=time, B=banner, D=data, O=fail once, N=assert number, M=monochrome, C=don't capture console, H=hide streams).
+- `--flags FLAGS` (`-f`) — output control flags (same as tape6: F=failures only, T=time, B=banner, D=data, O=fail once, N=assert number, M=monochrome, C=don't capture console, H=hide streams). Can be specified multiple times.
 - `--par N` (`-p`) — number of parallel processes (default: all CPU cores).
-- `--runFileArgs ARGS` (`-r`) — extra arguments passed to the spawned interpreter. Can be used multiple times. Mainly for Deno permissions.
+- `--runFileArgs ARGS` (`-r`) — extra arguments for the spawned interpreter. Can be specified multiple times. Mainly for Deno permissions.
+- `--info` — prints runtime, reporter, parallelism, flags, and test files, then exits.
 - `--self` — prints the path to `tape6-proc.js` (for cross-runtime scripts).
 - No arguments: runs tests from configuration.
+- Options accept `--flags FO` or `--flags=FO`. The `=` form does not support quoting.
 
 ### Cross-runtime usage
 
@@ -97,7 +99,8 @@ Environment-specific subsections: `node`, `deno`, `bun`.
 - `TAPE6_PAR` — number of parallel processes.
 - `TAPE6_TAP` — force TAP reporter.
 - `TAPE6_JSONL` — force JSONL reporter.
-- `TAPE6_TEST_FILE_NAME` — set by the runner to identify the current test file.
+- `TAPE6_MIN` — force minimal reporter.
+- `TAPE6_TEST_FILE_NAME` — set by the runner: file name of the current test.
 
 ## Links
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "tape-six-proc",
-  "version": "1.2.3",
-  "description": "Helper for tape-six to run tests in separate processes. Works with Node, Deno, and Bun. Supports TypeScript without transpilation.",
+  "version": "1.2.5",
+  "description": "Process-isolated test runner for tape-six. Runs each test file in its own subprocess. Works with Node, Deno, and Bun. Supports TypeScript without transpilation.",
   "type": "module",
   "bin": {
     "tape6-proc": "bin/tape6-proc.js"
@@ -15,22 +15,25 @@
   },
   "keywords": [
     "tap",
+    "tape6",
+    "tape-six",
     "test",
-    "harness",
-    "assert",
-    "process",
+    "test-runner",
     "unit-test",
     "testing",
-    "test-runner",
-    "esm",
-    "es-modules",
+    "harness",
+    "process",
+    "subprocess",
+    "isolation",
+    "parallel",
+    "cross-runtime",
+    "nodejs",
     "deno",
     "bun",
-    "nodejs",
-    "cross-runtime",
-    "subprocess",
-    "isolated-process",
-    "typescript"
+    "esm",
+    "es-modules",
+    "typescript",
+    "no-transpile"
   ],
   "author": "Eugene Lazutkin <eugene.lazutkin@gmail.com> (https://www.lazutkin.com)",
   "funding": "https://github.com/sponsors/uhop",
@@ -53,8 +56,8 @@
     "llms-full.txt"
   ],
   "dependencies": {
-    "dollar-shell": "^1.1.9",
-    "tape-six": "^1.7.2"
+    "dollar-shell": "^1.1.11",
+    "tape-six": "^1.7.8"
   },
   "tape6": {
     "tests": [

package/src/TestWorker.js

@@ -1,5 +1,4 @@
 import process from 'node:process';
-import os from 'node:os';
 import {sep} from 'node:path';
 import {pathToFileURL, fileURLToPath} from 'node:url';
 import crypto from 'node:crypto';
@@ -17,7 +16,7 @@ import wrap from './streams/wrap-lines.js';
 const baseName = pathToFileURL(process.cwd() + sep);
 
 export default class TestWorker extends EventServer {
-  constructor(reporter, numberOfTasks = TestWorker.getConcurrency(), options) {
+  constructor(reporter, numberOfTasks, options) {
     super(reporter, numberOfTasks, options);
     this.counter = 0;
     this.idToWorker = {};
@@ -38,7 +37,10 @@ export default class TestWorker extends EventServer {
             TAPE6_TEST: id,
             TAPE6_TEST_FILE_NAME: fileName,
             TAPE6_JSONL: 'Y',
-            TAPE6_JSONL_PREFIX: this.prefix
+            TAPE6_JSONL_PREFIX: this.prefix,
+            TAPE6_MIN: '',
+            TAPE6_TAP: '',
+            TAPE6_TTY: ''
           }
         }
       );
@@ -91,17 +93,13 @@ export default class TestWorker extends EventServer {
           reason.push(`signal: ${worker.signalCode}`);
         }
         if (reason.length) {
-          try {
-            self.report(id, {
-              name: 'process has failed, ' + reason.join(', '),
-              test: 0,
-              marker: new Error(),
-              operator: 'error',
-              fail: true
-            });
-          } catch (error) {
-            if (!isStopTest(error)) throw error;
-          }
+          self.report(id, {
+            name: 'process has failed, ' + reason.join(', '),
+            test: 0,
+            marker: new Error(),
+            operator: 'error',
+            fail: true
+          });
           self.report(id, {type: 'terminated', test: 0, name: 'FILE: /' + fileName});
         }
       }
@@ -116,16 +114,4 @@ export default class TestWorker extends EventServer {
       delete this.idToWorker[id];
     }
   }
-  static getConcurrency() {
-    if (typeof navigator !== 'undefined' && navigator.hardwareConcurrency) {
-      return navigator.hardwareConcurrency;
-    }
-    try {
-      return os.availableParallelism();
-    } catch (e) {
-      void e;
-      // squelch
-    }
-    return 1;
-  }
 }