@mikeyt23/node-cli-utils 2.0.10 → 2.0.12

package/dist/esm/parallel.js

@@ -0,0 +1,222 @@
+import { Emoji, log, trace } from './generalUtils.js';
+import { cyan } from './colors.js';
+/**
+ * A type guard useful for filtering results of `Promise.allSettled`.
+ * @example
+ * ```
+ * const settledPromises = await Promise.allSettled(promises)
+ * settledPromises.filter(isSettledRejected).map(r => r.reason)
+ * ```
+ */
+export const isSettledRejected = (input) => input.status === 'rejected';
+/**
+ * A type guard useful for filtering results of `Promise.allSettled`.
+ * @example
+ * ```
+ * const settledPromises = await Promise.allSettled(promises)
+ * settledPromises.filter(isSettledFulfilled).map(r => r.value)
+ * ```
+ */
+export const isSettledFulfilled = (input) => input.status === 'fulfilled';
+/**
+ * The result of {@link runParallel}.
+ */
+export class ParallelResult {
+    allItemResults;
+    onlyFirstN;
+    constructor(allItemResults, onlyFirstN) {
+        this.allItemResults = allItemResults;
+        this.onlyFirstN = onlyFirstN;
+    }
+    get successfulItemResults() {
+        return this.allItemResults.filter(r => r.success);
+    }
+    get allInputItems() {
+        return this.allItemResults.map(r => r.inputItem);
+    }
+    get allOutputResults() {
+        return this.allItemResults.filter(r => r.outputResult !== undefined).map(r => r.outputResult);
+    }
+    /** Does not include skipped items. */
+    get failedItemResults() {
+        return this.allItemResults.filter(r => !r.success && !r.skipped);
+    }
+    get skippedItemResults() {
+        return this.allItemResults.filter(r => r.skipped);
+    }
+    get rejectedItemResults() {
+        return this.allItemResults.filter(r => r.rejectedReason);
+    }
+    get numSuccessful() {
+        return this.successfulItemResults.length;
+    }
+    /** Note that this does not include promise rejections (see {@link numRejected}) or skipped items (see {@link numSkipped}). */
+    get numFailed() {
+        return this.failedItemResults.length;
+    }
+    /** Note that this does not include successful promises with failure results - see {@link numFailed}. */
+    get numRejected() {
+        return this.rejectedItemResults.length;
+    }
+    get numSkipped() {
+        return this.skippedItemResults.length;
+    }
+    get numTotalItems() {
+        return this.allItemResults.length;
+    }
+    /** Does not consider skipped items - only promise rejections and evaluated failures. */
+    get noFailures() {
+        return this.numFailed === 0 && this.numRejected === 0;
+    }
+    logFinishedMessage() {
+        const divider = '---';
+        const onlyFirstNMessage = this.onlyFirstN !== undefined ? ` (onlyFirstN set to ${this.onlyFirstN})` : '';
+        log(`${this.noFailures ? Emoji.GreenCheck : Emoji.Warning} ${cyan('runParallel')} completed - ${this.numTotalItems - this.numSkipped} items processed${onlyFirstNMessage}`);
+        if (this.numSkipped > 0) {
+            log(`${Emoji.Info} skipped ${this.numSkipped}`);
+        }
+        if (this.numRejected > 0) {
+            log(`${Emoji.Stop} Warning: some calls were rejected instead of returning a result`);
+            log(divider);
+            for (const rejected of this.rejectedItemResults) {
+                log('item: ', rejected.inputItem);
+                log('reason: ', rejected.rejectedReason);
+                log(divider);
+            }
+        }
+        if (this.numFailed > 0) {
+            log(`${Emoji.Warning} Number of failed results: ${this.numFailed}`);
+            log(divider);
+            for (const failed of this.failedItemResults) {
+                log('item: ', failed.inputItem);
+                log('output: ', failed.outputResult);
+                log(divider);
+            }
+        }
+    }
+}
+/**
+ * Run an operation against an array of items.
+ * @template OutputType The output type of each call to `operationFunc`.
+ * @template InputType The input type for each item in the `itemsToOperateOn` array.
+ * @param itemsToOperateOn The array of items of type `InputType` to operate on.
+ * @param executorFunc The async function to call on each item in `itemsToOperateOn` - should return type `OutputType`.
+ * @param isResultSuccessFunc The boolean returning function to evaluate whether each item of type `OutputType` returned should be considered successful.
+ * @param skipCheckFunc An optional boolean async function to determine whether each item of type `InputType` should be operated on.
+ * @param onlyFirstN Optional. Stop after this number of items processed.
+ * @returns A {@link ParallelResult}
+ */
+export async function runParallel(itemsToOperateOn, executorFunc, isResultSuccessFunc, options) {
+    const defaultOptions = { maxConcurrent: 10 };
+    const mergedOptions = { ...defaultOptions, ...options };
+    const parallel = new ParallelExecutor(mergedOptions.maxConcurrent);
+    const skippedItemResults = [];
+    let i = 0;
+    for (const item of itemsToOperateOn) {
+        if (mergedOptions.onlyFirstN !== undefined && i >= mergedOptions.onlyFirstN) {
+            trace(`stopping because 'onlyFirstN' param was passed with the value ${mergedOptions.onlyFirstN}`);
+            break;
+        }
+        i++;
+        if (mergedOptions.shouldSkipFunc !== undefined && await mergedOptions.shouldSkipFunc(item)) {
+            trace(`skipped item: `, item);
+            skippedItemResults.push({ inputItem: item, skipped: true, success: false });
+            continue;
+        }
+        parallel.queueTask(item, executorFunc);
+    }
+    const promiseResults = await parallel.processQueue();
+    const itemResults = promiseResults.filter(isSettledFulfilled).map(r => r.value);
+    const promiseRejections = promiseResults.filter(isSettledRejected).map(r => r.reason);
+    if (promiseRejections.length > 0) {
+        log('---');
+        log(`${Emoji.Exclamation} Warning: control flow functions that should normally not fail had promise rejections`);
+        for (const reject of promiseRejections) {
+            log(reject);
+            log('---');
+        }
+    }
+    for (const itemResult of itemResults) {
+        itemResult.success = itemResult.rejectedReason === undefined
+            && itemResult.outputResult !== undefined
+            && isResultSuccessFunc(itemResult.outputResult);
+    }
+    const parallelResult = new ParallelResult([...itemResults, ...skippedItemResults]);
+    return parallelResult;
+}
+/**
+ * This class simulates a semaphore, running as many of the tasks simultaneously as possible while staying under the limit of the value passed for `maxConcurrent`.
+ *
+ * Note that NodeJS is single-threaded, so this is more about prevention of overwhelming I/O systems and external services than it is about true parallel execution.
+ */
+export class ParallelExecutor {
+    maxConcurrent = 0;
+    numExecuting = 0;
+    queue = [];
+    operationPromises = [];
+    taskCompletePromises = [];
+    constructor(maxConcurrent) {
+        if (maxConcurrent <= 0) {
+            throw new Error('Invalid value passed for maxConcurrent - must be greater than 0');
+        }
+        this.maxConcurrent = maxConcurrent;
+    }
+    queueTask(item, operationFunc) {
+        let completionResolver;
+        const completionPromise = new Promise((resolve) => {
+            completionResolver = resolve;
+        });
+        this.taskCompletePromises.push(completionPromise);
+        const operationWrapper = async () => {
+            return new Promise(resolve => {
+                operationFunc(item)
+                    .then(output => {
+                    resolve({
+                        inputItem: item,
+                        skipped: false,
+                        success: true,
+                        rejectedReason: undefined,
+                        outputResult: output
+                    });
+                })
+                    .catch(err => {
+                    resolve({
+                        inputItem: item,
+                        skipped: false,
+                        success: false,
+                        rejectedReason: err,
+                        outputResult: undefined
+                    });
+                });
+            });
+        };
+        const parallelTask = () => {
+            trace(`Task called - queue.length: ${this.queue.length} - numExecuting: ${this.numExecuting}`);
+            this.numExecuting++;
+            const promise = operationWrapper();
+            this.operationPromises.push(promise);
+            promise.finally(() => {
+                this.release(completionResolver);
+            });
+        };
+        this.queue.push(parallelTask);
+    }
+    async processQueue() {
+        while (this.queue.length > 0 && this.numExecuting < this.maxConcurrent) {
+            const next = this.queue.shift();
+            if (next)
+                next();
+        }
+        await Promise.allSettled(this.taskCompletePromises);
+        return await Promise.allSettled(this.operationPromises);
+    }
+    release(completionResolver) {
+        trace(`Task released - queue.length: ${this.queue.length} - numExecuting: ${this.numExecuting}`);
+        this.numExecuting--;
+        completionResolver();
+        const next = this.queue.shift();
+        if (next)
+            next();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGFyYWxsZWwuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvcGFyYWxsZWwudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEtBQUssRUFBRSxHQUFHLEVBQUUsS0FBSyxFQUFFLE1BQU0sbUJBQW1CLENBQUE7QUFDckQsT0FBTyxFQUFFLElBQUksRUFBRSxNQUFNLGFBQWEsQ0FBQTtBQUVsQzs7Ozs7OztHQU9HO0FBQ0gsTUFBTSxDQUFDLE1BQU0saUJBQWlCLEdBQUcsQ0FBQyxLQUFvQyxFQUFrQyxFQUFFLENBQUMsS0FBSyxDQUFDLE1BQU0sS0FBSyxVQUFVLENBQUE7QUFDdEk7Ozs7Ozs7R0FPRztBQUNILE1BQU0sQ0FBQyxNQUFNLGtCQUFrQixHQUFHLENBQUksS0FBOEIsRUFBc0MsRUFBRSxDQUFDLEtBQUssQ0FBQyxNQUFNLEtBQUssV0FBVyxDQUFBO0FBcUJ6STs7R0FFRztBQUNILE1BQU0sT0FBTyxjQUFjO0lBQ2hCLGNBQWMsQ0FBNkM7SUFDM0QsVUFBVSxDQUFTO0lBRTVCLFlBQVksY0FBMkQsRUFBRSxVQUFtQjtRQUMxRixJQUFJLENBQUMsY0FBYyxHQUFHLGNBQWMsQ0FBQTtRQUNwQyxJQUFJLENBQUMsVUFBVSxHQUFHLFVBQVUsQ0FBQTtJQUM5QixDQUFDO0lBRUQsSUFBSSxxQkFBcUI7UUFDdkIsT0FBTyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxPQUFPLENBQUMsQ0FBQTtJQUNuRCxDQUFDO0lBQ0QsSUFBSSxhQUFhO1FBQ2YsT0FBTyxJQUFJLENBQUMsY0FBYyxDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUMsQ0FBQTtJQUNsRCxDQUFDO0lBQ0QsSUFBSSxnQkFBZ0I7UUFDbEIsT0FBTyxJQUFJLENBQUMsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxD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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mikeyt23/node-cli-utils",
-  "version": "2.0.10",
+  "version": "2.0.12",
   "description": "Some node cli utility functions",
   "author": "Mike Thompson",
   "license": "MIT",
@@ -95,6 +95,16 @@
         "default": "./dist/cjs/hostFileUtils.js"
       }
     },
+    "./parallel": {
+      "import": {
+        "types": "./dist/esm/parallel.d.ts",
+        "default": "./dist/esm/parallel.js"
+      },
+      "require": {
+        "types": "./dist/cjs/parallel.d.ts",
+        "default": "./dist/cjs/parallel.js"
+      }
+    },
     "./testUtils": {
       "import": {
         "types": "./dist/esm/testUtils.d.ts",