zarro 1.184.0 → 1.186.0

package/gulp-tasks/modules/parse-flag.js

@@ -0,0 +1,47 @@
+"use strict";
+(function () {
+    const positives = new Set([
+        "yes",
+        "y",
+        "1",
+        "true",
+        "on"
+    ]);
+    const negatives = new Set([
+        "no",
+        "n",
+        "0",
+        "false",
+        "off"
+    ]);
+    function parseFlag(value, fallback) {
+        const lower = (value || "").toLowerCase();
+        if (positives.has(lower)) {
+            return true;
+        }
+        if (negatives.has(lower)) {
+            return false;
+        }
+        if (fallback !== undefined) {
+            return fallback;
+        }
+        const possiblePositives = [];
+        for (const item of positives) {
+            possiblePositives.push(item);
+        }
+        const possibleNegatives = [];
+        for (const item of negatives) {
+            possibleNegatives.push(item);
+        }
+        throw new Error(`${value} is not a valid flag value.
+Try one of:
+  - accepted truthy values:
+    ${possiblePositives.join(", ")}
+  - accepted falsey values:
+    ${possibleNegatives.join(", ")}
+`);
+    }
+    module.exports = {
+        parseFlag
+    };
+})();

package/gulp-tasks/modules/system.js

@@ -91,6 +91,21 @@ ${tempFileContents}
         const result = new SystemResult(`${exe}`, programArgs, undefined, [], []);
         return new Promise((resolve, reject) => {
             const child = child_process.spawn(exe, programArgs, spawnOptions);
+            if (!!options) {
+                const optsWithKill = options;
+                optsWithKill.kill = (signal) => {
+                    destroyPipesOn(child);
+                    child.kill(signal);
+                };
+                if (optsWithKill === null || optsWithKill === void 0 ? void 0 : optsWithKill.onChildSpawned) {
+                    try {
+                        optsWithKill.onChildSpawned(child, optsWithKill);
+                    }
+                    catch (e) {
+                        // suppress
+                    }
+                }
+            }
             const stdoutFn = typeof opts.stdout === "function" ? opts.stdout : noop;
             const stderrFn = typeof opts.stderr === "function" ? opts.stderr : noop;
             const stdoutLineBuffer = new LineBuffer(s => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zarro",
-  "version": "1.184.0",
+  "version": "1.186.0",
   "description": "Some glue to make gulp easier, perhaps even zero- or close-to-zero-conf",
   "bin": {
     "zarro": "index.js"

package/types.d.ts

@@ -5,7 +5,7 @@ import { StatsBase } from "fs";
 import { Stream, Transform } from "stream";
 import ansiColors, { StyleFunction } from "ansi-colors";
 import { RimrafOptions } from "./gulp-tasks/modules/rimraf";
-import { ExecFileOptionsWithBufferEncoding } from "child_process";
+import { ChildProcess, ExecFileOptionsWithBufferEncoding } from "child_process";
 import * as vinyl from "vinyl";
 import { BufferFile } from "vinyl";
 // noinspection ES6PreferShortImport
@@ -546,6 +546,10 @@ declare global {
     open(url: string): Promise<void>;
   }
 
+  interface ParseFlag {
+    parseFlag: (value: string, fallback?: boolean) => boolean;
+  }
+
   type ResolveNugetApiKey = (forSource?: string) => Promise<Optional<string>>;
 
   interface Env
@@ -1091,6 +1095,7 @@ declare global {
      * io writer or the result from after spawn completes
      */
     suppressOutput?: boolean;
+
   }
 
   interface SystemOptions {
@@ -1130,6 +1135,17 @@ declare global {
      * / error as the first argument, with the exe set to either cmd or sh
      */
     keepTempFiles?: boolean;
+
+    // gain direct access to the child process as
+    // soon as it spawns
+    onChildSpawned?: (child: ChildProcess, originalOptions: SystemOptionsWithKill) => void;
+
+  }
+
+  interface SystemOptionsWithKill extends SystemOptions {
+    // this function will be filled in for you once the
+    // child process has started
+    kill: (signal?: NodeJS.Signals | number) => void;
   }
 
   /**