X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;ds=sidebyside;f=src%2Fpools%2Fselection-strategies%2Fselection-strategies-types.ts;h=2c6c2e16d6e4d52e7f19841e6d6f331db3d678f9;hb=8b4d450024ef06de939fa82f9746b005696914c0;hp=359cfb948c6334dc507a3d0894149790aef584f9;hpb=b3432a63039e7cb70c0448da5518690e457cd47e;p=poolifier.git diff --git a/src/pools/selection-strategies/selection-strategies-types.ts b/src/pools/selection-strategies/selection-strategies-types.ts index 359cfb94..2c6c2e16 100644 --- a/src/pools/selection-strategies/selection-strategies-types.ts +++ b/src/pools/selection-strategies/selection-strategies-types.ts @@ -1,5 +1,3 @@ -import type { AbstractPoolWorker } from '../abstract-pool-worker' - /** * Enumeration of worker choice strategies. */ @@ -9,9 +7,17 @@ export const WorkerChoiceStrategies = Object.freeze({ */ ROUND_ROBIN: 'ROUND_ROBIN', /** - * Less recently used worker selection strategy. + * Less used worker selection strategy. + */ + LESS_USED: 'LESS_USED', + /** + * Less busy worker selection strategy. */ - LESS_RECENTLY_USED: 'LESS_RECENTLY_USED', + LESS_BUSY: 'LESS_BUSY', + /** + * Fair share worker selection strategy. + */ + FAIR_SHARE: 'FAIR_SHARE', /** * Weighted round robin worker selection strategy. */ @@ -23,18 +29,34 @@ export const WorkerChoiceStrategies = Object.freeze({ */ export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies +/** + * Pool worker tasks usage statistics requirements. + */ +export interface RequiredStatistics { + runTime: boolean + avgRunTime: boolean +} + /** * Worker choice strategy interface. - * - * @template Worker Type of worker which manages the strategy. */ -export interface IWorkerChoiceStrategy { +export interface IWorkerChoiceStrategy { + /** + * Required pool tasks usage statistics. + */ + readonly requiredStatistics: RequiredStatistics + /** + * Resets strategy internals (counters, statistics, etc.). + */ + reset: () => boolean /** - * Is the pool attached to the strategy dynamic?. + * Chooses a worker in the pool and returns its key. */ - isDynamicPool: boolean + choose: () => number /** - * Choose a worker in the pool. + * Removes a worker reference from strategy internals. + * + * @param workerKey - The worker key. */ - choose(): Worker + remove: (workerKey: number) => boolean }