X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=src%2Futils.ts;h=a6f5fbcc5b729b98f5dec1da1de8178eff830d40;hb=f42c583f7cef671a4a70b2d749875ea3a155fd84;hp=809ca38b6bdb17d9f92274bc822543d61bf7a9f4;hpb=ed6dd37f9e137cf659523d9d792f0171eedcb8ed;p=poolifier.git diff --git a/src/utils.ts b/src/utils.ts index 809ca38b..a6f5fbcc 100644 --- a/src/utils.ts +++ b/src/utils.ts @@ -1,6 +1,81 @@ +import os from 'node:os' +import type { + MeasurementStatisticsRequirements, + WorkerChoiceStrategyOptions +} from './pools/selection-strategies/selection-strategies-types' + /** * An intentional empty function. */ export const EMPTY_FUNCTION: () => void = Object.freeze(() => { /* Intentionally empty */ }) + +/** + * Default worker choice strategy options. + */ +export const DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS: WorkerChoiceStrategyOptions = + { + runTime: { median: false }, + waitTime: { median: false }, + elu: { median: false } + } + +/** + * Default measurement statistics requirements. + */ +export const DEFAULT_MEASUREMENT_STATISTICS_REQUIREMENTS: MeasurementStatisticsRequirements = + { + aggregate: false, + average: false, + median: false + } + +/** + * Safe helper to get the host OS optimized maximum pool size. + */ +export const availableParallelism = (): number => { + let availableParallelism = 1 + try { + availableParallelism = os.availableParallelism() + } catch { + const cpus = os.cpus() + if (Array.isArray(cpus) && cpus.length > 0) { + availableParallelism = cpus.length + } + } + return availableParallelism +} + +/** + * Compute the median of the given data set. + * + * @param dataSet - Data set. + * @returns The median of the given data set. + */ +export const median = (dataSet: number[]): number => { + if (Array.isArray(dataSet) && dataSet.length === 0) { + return 0 + } + if (Array.isArray(dataSet) && dataSet.length === 1) { + return dataSet[0] + } + const sortedDataSet = dataSet.slice().sort((a, b) => a - b) + return ( + (sortedDataSet[(sortedDataSet.length - 1) >> 1] + + sortedDataSet[sortedDataSet.length >> 1]) / + 2 + ) +} + +/** + * Is the given object a plain object? + * + * @param obj - The object to check. + * @returns `true` if the given object is a plain object, `false` otherwise. + */ +export const isPlainObject = (obj: unknown): boolean => + typeof obj === 'object' && + obj !== null && + obj?.constructor === Object && + Object.prototype.toString.call(obj) === '[object Object]'