@mikeyt23/node-cli-utils 2.0.11 → 2.0.13

package/dist/esm/parallel.d.ts

@@ -0,0 +1,118 @@
+/**
+ * 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 declare const isSettledRejected: (input: PromiseSettledResult<unknown>) => input is PromiseRejectedResult;
+/**
+ * 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 declare const isSettledFulfilled: <T>(input: PromiseSettledResult<T>) => input is PromiseFulfilledResult<T>;
+/**
+ * The result from an individual operation during a call to {@link runParallel}.
+ */
+export interface ParallelItemResult<InputType, OutputType> {
+    /** The original item passed to the operation function. */
+    inputItem: InputType;
+    /** The result property will be undefined if the promise is rejected when operating on the item. */
+    outputResult?: OutputType;
+    /** Set to `true` if not skipped, the promise wasn't rejected and the success evaluation function returned true for the output, `false` otherwise. */
+    success: boolean;
+    /** The value of the promise rejection (often an Error object, but can technically be anything). */
+    rejectedReason?: unknown;
+    /**
+     * Items can be skipped if the {@link RunParallelOptions.shouldSkipFunc} is used and evaluated to `true` for an item, or if
+     * {@link RunParallelOptions.onlyFirstN} was passed and the item was not in range.
+     * */
+    skipped: boolean;
+}
+/**
+ * The result of {@link runParallel}.
+ */
+export declare class ParallelResult<InputType, OutputType> {
+    readonly allItemResults: ParallelItemResult<InputType, OutputType>[];
+    readonly onlyFirstN?: number;
+    constructor(allItemResults: ParallelItemResult<InputType, OutputType>[], onlyFirstN?: number);
+    get successfulItemResults(): ParallelItemResult<InputType, OutputType>[];
+    get allInputItems(): InputType[];
+    get allOutputResults(): OutputType[];
+    /** Does not include skipped items. */
+    get failedItemResults(): ParallelItemResult<InputType, OutputType>[];
+    get skippedItemResults(): ParallelItemResult<InputType, OutputType>[];
+    get rejectedItemResults(): ParallelItemResult<InputType, OutputType>[];
+    get numSuccessful(): number;
+    /** Note that this does not include promise rejections (see {@link numRejected}) or skipped items (see {@link numSkipped}). */
+    get numFailed(): number;
+    /** Note that this does not include successful promises with failure results - see {@link numFailed}. */
+    get numRejected(): number;
+    get numSkipped(): number;
+    get numTotalItems(): number;
+    /** Does not consider skipped items - only promise rejections and evaluated failures. */
+    get noFailures(): boolean;
+    logFinishedMessage(): void;
+}
+/** The async function to run on each item during a call to {@link runParallel}. */
+export type OperationExecutor<OutputType, InputType> = (operationItem: InputType) => Promise<OutputType>;
+/** The function that will determine whether each operation during a call to {@link runParallel} should be considered successful or not. */
+export type SuccessChecker<OutputType> = (operationResult: OutputType) => boolean;
+/** The sync or async function that determines whether a particular item input for {@link runParallel} should be skipped or not. */
+export type SkipChecker<InputType> = ((operationItem: InputType) => Promise<boolean>) | ((operationItem: InputType) => boolean);
+/** Additional options that can be passed to {@link runParallel}. */
+export interface RunParallelOptions<InputType> {
+    /**
+     * Defaults to 10 - the maximum number of tasks that will be allowed to run concurrently. While NodeJS is single-threaded,
+     * it is worth controlling the number of running tasks to avoid overwhelming I/O or an external service.
+     */
+    maxConcurrent: number;
+    /** If provided, this will be used to determine whether or not an item should be skipped. */
+    shouldSkipFunc?: SkipChecker<InputType>;
+    /**
+     * If provided, this will limit processing to the first N items. Useful for testing new functionality on a subset of items.
+     *
+     * Note that this will completely bypass any processing of items after the first N items. So for example, there won't be
+     * "skipped" items for those not processed - they simply won't be on the result object at all.
+     */
+    onlyFirstN?: number;
+}
+/**
+ * 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 declare function runParallel<InputType, OutputType>(itemsToOperateOn: Iterable<InputType>, executorFunc: OperationExecutor<OutputType, InputType>, isResultSuccessFunc: SuccessChecker<OutputType>, options?: Partial<RunParallelOptions<InputType>>): Promise<ParallelResult<InputType, OutputType>>;
+/** The return type of {@link ParallelExecutor.processQueue}. This is a generic wrapper for {@link Promise.allSettled} with results of type {@link ParallelItemResult}.
+ *
+ * To filter the results, use type guards {@link isSettledRejected} and {@link isSettledFulfilled}.
+*/
+export type AllSettledResult<ParallelItemResult> = Promise<PromiseSettledResult<Awaited<ParallelItemResult>>[]>;
+/**
+ * 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 declare class ParallelExecutor<InputType, OutputType> {
+    private maxConcurrent;
+    private numExecuting;
+    private queue;
+    private operationPromises;
+    private taskCompletePromises;
+    constructor(maxConcurrent: number);
+    queueTask(item: InputType, operationFunc: OperationExecutor<OutputType, InputType>): void;
+    processQueue(): AllSettledResult<ParallelItemResult<InputType, OutputType>>;
+    private release;
+}
+//# sourceMappingURL=parallel.d.ts.map

package/dist/esm/parallel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.d.ts","sourceRoot":"","sources":["../../src/parallel.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,UAAW,qBAAqB,OAAO,CAAC,mCAAgE,CAAA;AACtI;;;;;;;GAOG;AACH,eAAO,MAAM,kBAAkB,2EAA0G,CAAA;AAEzI;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,SAAS,EAAE,UAAU;IACvD,0DAA0D;IAC1D,SAAS,EAAE,SAAS,CAAA;IACpB,mGAAmG;IACnG,YAAY,CAAC,EAAE,UAAU,CAAA;IACzB,qJAAqJ;IACrJ,OAAO,EAAE,OAAO,CAAA;IAChB,mGAAmG;IACnG,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;SAGK;IACL,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,SAAS,EAAE,UAAU;IAC/C,QAAQ,CAAC,cAAc,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAAA;IACpE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;gBAEhB,cAAc,EAAE,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM;IAK5F,IAAI,qBAAqB,IAAI,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,EAAE,CAEvE;IACD,IAAI,aAAa,IAAI,SAAS,EAAE,CAE/B;IACD,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAEnC;IACD,sCAAsC;IACtC,IAAI,iBAAiB,gDAEpB;IACD,IAAI,kBAAkB,gDAErB;IACD,IAAI,mBAAmB,gDAEtB;IACD,IAAI,aAAa,WAEhB;IACD,8HAA8H;IAC9H,IAAI,SAAS,WAEZ;IACD,wGAAwG;IACxG,IAAI,WAAW,WAEd;IACD,IAAI,UAAU,WAEb;IACD,IAAI,aAAa,WAEhB;IACD,wFAAwF;IACxF,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,kBAAkB;CA8BnB;AAED,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,CAAC,UAAU,EAAE,SAAS,IAAI,CAAC,aAAa,EAAE,SAAS,KAAK,OAAO,CAAC,UAAU,CAAC,CAAA;AAExG,2IAA2I;AAC3I,MAAM,MAAM,cAAc,CAAC,UAAU,IAAI,CAAC,eAAe,EAAE,UAAU,KAAK,OAAO,CAAA;AAEjF,mIAAmI;AACnI,MAAM,MAAM,WAAW,CAAC,SAAS,IAAI,CAAC,CAAC,aAAa,EAAE,SAAS,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,SAAS,KAAK,OAAO,CAAC,CAAA;AAE/H,oEAAoE;AACpE,MAAM,WAAW,kBAAkB,CAAC,SAAS;IAC3C;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAA;IAErB,4FAA4F;IAC5F,cAAc,CAAC,EAAE,WAAW,CAAC,SAAS,CAAC,CAAA;IAEvC;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,EAAE,iBAAiB,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,mBAAmB,EAAE,cAAc,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,SAAS,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CA4CzS;AAED;;;EAGE;AACF,MAAM,MAAM,gBAAgB,CAAC,kBAAkB,IAAI,OAAO,CAAC,oBAAoB,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAA;AAE/G;;;;GAIG;AACH,qBAAa,gBAAgB,CAAC,SAAS,EAAE,UAAU;IACjD,OAAO,CAAC,aAAa,CAAI;IACzB,OAAO,CAAC,YAAY,CAAI;IACxB,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,iBAAiB,CAA2D;IACpF,OAAO,CAAC,oBAAoB,CAAsB;gBAEtC,aAAa,EAAE,MAAM;IAOjC,SAAS,CAAC,IAAI,EAAE,SAAS,EAAE,aAAa,EAAE,iBAAiB,CAAC,UAAU,EAAE,SAAS,CAAC;IA4C5E,YAAY,IAAI,gBAAgB,CAAC,kBAAkB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IASjF,OAAO,CAAC,OAAO;CAOhB"}

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], mergedOptions.onlyFirstN);
+    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.11",
+  "version": "2.0.13",
   "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",