repositories
/
poolifier.git
/ blobdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
|
commitdiff
|
tree
raw
|
inline
| side by side
docs: enhance documentation
[poolifier.git]
/
src
/
pools
/
selection-strategies
/
selection-strategies-types.ts
diff --git
a/src/pools/selection-strategies/selection-strategies-types.ts
b/src/pools/selection-strategies/selection-strategies-types.ts
index f875c2906ee3a173ffab6790d93aece511b2a0ef..065b310fa5e8a3454f84d5b0edd6324c7c2d0520 100644
(file)
--- a/
src/pools/selection-strategies/selection-strategies-types.ts
+++ b/
src/pools/selection-strategies/selection-strategies-types.ts
@@
-1,5
+1,3
@@
-import type { IPoolWorker } from '../pool-worker'
-
/**
* Enumeration of worker choice strategies.
*/
/**
* Enumeration of worker choice strategies.
*/
@@
-9,9
+7,13
@@
export const WorkerChoiceStrategies = Object.freeze({
*/
ROUND_ROBIN: 'ROUND_ROBIN',
/**
*/
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 worker selection strategy.
*/
@@
-28,32
+30,55
@@
export const WorkerChoiceStrategies = Object.freeze({
export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies
/**
export type WorkerChoiceStrategy = keyof typeof WorkerChoiceStrategies
/**
- *
Pool tasks usage statistics requirement
s.
+ *
Worker choice strategy option
s.
*/
*/
-export type RequiredStatistics = {
- runTime: boolean
+export interface WorkerChoiceStrategyOptions {
+ /**
+ * Use tasks median run time instead of average run time.
+ */
+ medRunTime?: boolean
}
/**
}
/**
- *
Worker choice strategy interface
.
+ *
Pool worker tasks usage statistics requirements
.
*
*
- * @
template Worker Type of worker which manages the strategy.
+ * @
internal
*/
*/
-export interface IWorkerChoiceStrategy<Worker extends IPoolWorker> {
+export interface RequiredStatistics {
+ /**
+ * Require tasks run time.
+ */
+ runTime: boolean
/**
/**
- *
Is the pool attached to the strategy dynamic?
.
+ *
Require tasks average run time
.
*/
*/
-
readonly isDynamicPool
: boolean
+
avgRunTime
: boolean
/**
/**
- * Required pool tasks usage statistics.
+ * Require tasks median run time.
+ */
+ medRunTime: boolean
+}
+
+/**
+ * Worker choice strategy interface.
+ */
+export interface IWorkerChoiceStrategy {
+ /**
+ * Required tasks usage statistics.
*/
readonly requiredStatistics: RequiredStatistics
/**
*/
readonly requiredStatistics: RequiredStatistics
/**
- * Resets strategy internal statistics.
+ * Resets strategy internals (counters, statistics, etc.).
+ */
+ reset: () => boolean
+ /**
+ * Chooses a worker node in the pool and returns its key.
*/
*/
- resetStatistics(): boolean
+ choose: () => number
/**
/**
- * Chooses a worker in the pool.
+ * Removes a worker node key from strategy internals.
+ *
+ * @param workerNodeKey - The worker node key.
*/
*/
- choose(): Worker
+ remove: (workerNodeKey: number) => boolean
}
}