benchmarks/README.md

   1 # Poolifier Benchmarks
   2
   3 Welcome to poolifier benchmarks and thanks to look into this project.
   4
   5 ## Folder Structure
   6
   7 The internal folder contains poolifier internal benchmarks.
   8 The versus-external-pools folder contains benchmarks versus other Node.js pools.
   9
  10 ## Poolifier vs other pools benchmark
  11
  12 To compare poolifier pools performance vs other pools performance we chose to use [hyperfine](https://github.com/sharkdp/hyperfine).
  13 We chose to use this tool because it allows to run isolated Node.js processes so that each pool does not impact each other.
  14 External pools with which we compared the poolifier results:
  15
  16 - [piscina](https://github.com/piscinajs/piscina)
  17 - [SUCHMOKUO/node-worker-threads-pool](https://github.com/SUCHMOKUO/node-worker-threads-pool)
  18
  19 Those are our results:
  20
  21 - CPU Intensive task with 100k operations submitted to each pool [BENCH-100000.MD](./versus-external-pools/BENCH-100000.MD).
  22   This benchmark ran on a MacBook Pro 2015, 2,2 GHz Intel Core i7 quad-core, 16 GB 1600 MHz DDR3.
  23
  24 > :warning: **We would need funds to run our benchmarks more often and on Cloud VMs, please consider to sponsor this project**
  25
  26 ## How to run benchmarks
  27
  28 ### Internal
  29
  30 To run the internal benchmark you just need to navigate to the root of poolifier project and run `npm run benchmark`
  31
  32 ## Versus other pools
  33
  34 To run the benchmark versus other pools you will need to:
  35
  36 - [Install hyperfine](https://github.com/sharkdp/hyperfine#installation)
  37 - Run the `./bench.sh` into the `versus-external-pools` folder
  38
  39 > :warning: **Please be sure to use a quite PC when you run the benchmarks**