X-Git-Url: https://git.piment-noir.org/?a=blobdiff_plain;f=README.md;h=b86b69eb778f6e3d606701a47e3e55b96881c6cc;hb=d1affa4c917ac602f06557e3317850bec80f7535;hp=39da874467fe459653b2ecd6aba06d4fe504e303;hpb=46e857ca84ffb9aaac3f8de2ec7a5ac4f2ad9f51;p=poolifier.git diff --git a/README.md b/README.md index 39da8744..b86b69eb 100644 --- a/README.md +++ b/README.md @@ -3,10 +3,6 @@

Node Thread Pool and Cluster Pool :arrow_double_up: :on:

-

- - Ko-fi -

@@ -16,11 +12,13 @@ Quality Gate Status - Code coverage + Code Coverage Javascript Standard Style Guide Gitter chat + + Open Collective Dependabot @@ -39,16 +37,16 @@ Please consult our general guidelines - Performance :racehorse: [benchmarks](./benchmarks/README.md) - Security :bank: :cop: [![Security Rating](https://sonarcloud.io/api/project_badges/measure?project=pioardi_poolifier&metric=security_rating)](https://sonarcloud.io/dashboard?id=pioardi_poolifier) [![Vulnerabilities](https://sonarcloud.io/api/project_badges/measure?project=pioardi_poolifier&metric=vulnerabilities)](https://sonarcloud.io/dashboard?id=pioardi_poolifier) - Easy to use :couple: -- Easy switch from a pool to another, easy to tune :heavy_check_mark: -- Dynamic pool size :heavy_check_mark: -- No runtime dependencies :heavy_check_mark: -- Proper async integration with node async hooks :heavy_check_mark: -- Support for worker threads and cluster node modules :heavy_check_mark: -- Support sync and async tasks :heavy_check_mark: -- General guidance on pools to use :heavy_check_mark: -- Widely tested :heavy_check_mark: -- Error handling out of the box :heavy_check_mark: -- Active community :heavy_check_mark: +- Easy switch from a pool to another, easy to tune :white_check_mark: +- Dynamic pool size :white_check_mark: +- No runtime dependencies :white_check_mark: +- Proper async integration with node async hooks :white_check_mark: +- Support for worker threads and cluster node modules :white_check_mark: +- Support sync and async tasks :white_check_mark: +- General guidance on pools to use :white_check_mark: +- Widely tested :white_check_mark: +- Error handling out of the box :white_check_mark: +- Active community :white_check_mark: - Code quality :octocat: [![Bugs](https://sonarcloud.io/api/project_badges/measure?project=pioardi_poolifier&metric=bugs)](https://sonarcloud.io/dashboard?id=pioardi_poolifier) [![Code Smells](https://sonarcloud.io/api/project_badges/measure?project=pioardi_poolifier&metric=code_smells)](https://sonarcloud.io/dashboard?id=pioardi_poolifier) [![Duplicated Lines (%)](https://sonarcloud.io/api/project_badges/measure?project=pioardi_poolifier&metric=duplicated_lines_density)](https://sonarcloud.io/dashboard?id=pioardi_poolifier) @@ -99,7 +97,7 @@ You can implement a worker-threads worker in a simple way by extending the class 'use strict' const { ThreadWorker } = require('poolifier') -function yourFunction (data) { +function yourFunction(data) { // this will be executed in the worker thread, // the data will be received by using the execute method return { ok: 1 } @@ -146,10 +144,12 @@ Remember that workers can only send and receive serializable data. ## Node versions -You can use node versions >= 12.x for thread pool, and node versions >= 16.x for cluster pool. +Node versions >= 16.x are supported. ## API +### [Documentation](https://poolifier.github.io/poolifier/) + ### `pool = new FixedThreadPool/FixedClusterPool(numberOfThreads/numberOfWorkers, filePath, opts)` `numberOfThreads/numberOfWorkers` (mandatory) Number of workers for this pool @@ -163,11 +163,12 @@ You can use node versions >= 12.x for thread pool, and node versions >= 16.x for - `workerChoiceStrategy` (optional) - The worker choice strategy to use in this pool: - `WorkerChoiceStrategies.ROUND_ROBIN`: Submit tasks to worker in a round robbin fashion - - `WorkerChoiceStrategies.LESS_RECENTLY_USED`: Submit tasks to the less recently used worker + - `WorkerChoiceStrategies.LESS_USED`: Submit tasks to the less used worker + - `WorkerChoiceStrategies.LESS_BUSY`: Submit tasks to the less busy worker - `WorkerChoiceStrategies.WEIGHTED_ROUND_ROBIN` Submit tasks to worker using a weighted round robin scheduling algorithm based on tasks execution time - `WorkerChoiceStrategies.FAIR_SHARE`: Submit tasks to worker using a fair share tasks scheduling algorithm based on tasks execution time - `WorkerChoiceStrategies.WEIGHTED_ROUND_ROBIN` and `WorkerChoiceStrategies.FAIR_SHARE` strategies are targeted to heavy and long tasks + `WorkerChoiceStrategies.WEIGHTED_ROUND_ROBIN` and `WorkerChoiceStrategies.FAIR_SHARE` strategies are targeted to heavy and long tasks Default: `WorkerChoiceStrategies.ROUND_ROBIN` - `enableEvents` (optional) - Events emission enablement in this pool. Default: true @@ -203,7 +204,7 @@ This method will call the terminate method on each worker. - `async` - true/false, true if your function contains async code pieces, else false - `killBehavior` - Dictates if your async unit (worker/process) will be deleted in case that a task is active on it. **KillBehaviors.SOFT**: If `currentTime - lastActiveTime` is greater than `maxInactiveTime` but a task is still running, then the worker **won't** be deleted. - **KillBehaviors.HARD**: If `lastActiveTime` is greater than `maxInactiveTime` but a task is still running, then the worker will be deleted. + **KillBehaviors.HARD**: If `currentTime - lastActiveTime` is greater than `maxInactiveTime` but a task is still running, then the worker will be deleted. This option only apply to the newly created workers. Default: `KillBehaviors.SOFT` @@ -248,7 +249,7 @@ But in general, **always profile your application** ## Contribute See guidelines [CONTRIBUTING](CONTRIBUTING.md) -Choose your task here [2.3.0](https://github.com/orgs/poolifier/projects/1), propose an idea, a fix, an improvement. +Choose your task here [2.4.x](https://github.com/orgs/poolifier/projects/1), propose an idea, a fix, an improvement. ## Team