X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futils.ts;h=6f9d1226bb71210b020d987b32d169bbd593b5b8;hb=refs%2Ftags%2Fv2.6.32;hp=80e6b9f3b5473dee9e5547930f05ce8b6b473631;hpb=2845f2a5555247bbc4e5f6f1059d4f95405a49cd;p=poolifier.git diff --git a/src/utils.ts b/src/utils.ts index 80e6b9f3..6f9d1226 100644 --- a/src/utils.ts +++ b/src/utils.ts @@ -1,9 +1,15 @@ -import { cpus, availableParallelism as parallelism } from 'node:os' +import * as os from 'node:os' import type { MeasurementStatisticsRequirements, WorkerChoiceStrategyOptions } from './pools/selection-strategies/selection-strategies-types' import type { KillBehavior } from './worker/worker-options' +import type { MeasurementStatistics } from './pools/worker' + +/** + * Default task name. + */ +export const DEFAULT_TASK_NAME = 'default' /** * An intentional empty function. @@ -17,6 +23,7 @@ export const EMPTY_FUNCTION: () => void = Object.freeze(() => { */ export const DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS: WorkerChoiceStrategyOptions = { + choiceRetries: 6, runTime: { median: false }, waitTime: { median: false }, elu: { median: false } @@ -41,9 +48,9 @@ export const DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS: MeasurementStatisticsR export const availableParallelism = (): number => { let availableParallelism = 1 try { - availableParallelism = parallelism() + availableParallelism = os.availableParallelism() } catch { - const numberOfCpus = cpus() + const numberOfCpus = os.cpus() if (Array.isArray(numberOfCpus) && numberOfCpus.length > 0) { availableParallelism = numberOfCpus.length } @@ -51,6 +58,22 @@ export const availableParallelism = (): number => { return availableParallelism } +// /** +// * Computes the retry delay in milliseconds using an exponential back off algorithm. +// * +// * @param retryNumber - The number of retries that have already been attempted +// * @param maxDelayRatio - The maximum ratio of the delay that can be randomized +// * @returns Delay in milliseconds +// */ +// export const exponentialDelay = ( +// retryNumber = 0, +// maxDelayRatio = 0.2 +// ): number => { +// const delay = Math.pow(2, retryNumber) * 100 +// const randomSum = delay * maxDelayRatio * Math.random() // 0-(maxDelayRatio*100)% of the delay +// return delay + randomSum +// } + /** * Computes the median of the given data set. * @@ -123,3 +146,63 @@ export const isAsyncFunction = ( ): fn is (...args: unknown[]) => Promise => { return typeof fn === 'function' && fn.constructor.name === 'AsyncFunction' } + +/** + * Updates the given measurement statistics. + * + * @param measurementStatistics - The measurement statistics to update. + * @param measurementRequirements - The measurement statistics requirements. + * @param measurementValue - The measurement value. + * @param numberOfMeasurements - The number of measurements. + */ +export const updateMeasurementStatistics = ( + measurementStatistics: MeasurementStatistics, + measurementRequirements: MeasurementStatisticsRequirements, + measurementValue: number, + numberOfMeasurements: number +): void => { + if (measurementRequirements.aggregate) { + measurementStatistics.aggregate = + (measurementStatistics.aggregate ?? 0) + measurementValue + measurementStatistics.minimum = Math.min( + measurementValue, + measurementStatistics.minimum ?? Infinity + ) + measurementStatistics.maximum = Math.max( + measurementValue, + measurementStatistics.maximum ?? -Infinity + ) + if (measurementRequirements.average && numberOfMeasurements !== 0) { + measurementStatistics.average = + measurementStatistics.aggregate / numberOfMeasurements + } + if (measurementRequirements.median && measurementValue != null) { + measurementStatistics.history.push(measurementValue) + measurementStatistics.median = median(measurementStatistics.history) + } + } +} + +/** + * Executes a function once at a time. + * + * @param fn - The function to execute. + * @param context - The context to bind the function to. + * @returns The function to execute. + */ +export const once = ( + // eslint-disable-next-line @typescript-eslint/no-explicit-any + fn: (...args: any[]) => void, + context: unknown + // eslint-disable-next-line @typescript-eslint/no-explicit-any +): ((...args: any[]) => void) => { + let called = false + // eslint-disable-next-line @typescript-eslint/no-explicit-any + return function (...args: any[]): void { + if (!called) { + called = true + fn.apply(context, args) + called = false + } + } +}