@naturalcycles/dev-lib 12.20.2 → 12.21.0

package/dist/util/jest.util.js

@@ -41,7 +41,7 @@ async function runJest(opt = {}) {
         console.log((0, colors_1.dimGrey)(`node_modules/${(0, colors_1.white)('jest')} not found, skipping tests`));
         return;
     }
-    const { CI, TZ = 'UTC', APP_ENV, JEST_NO_ALPHABETIC, NODE_OPTIONS } = process.env;
+    const { CI, TZ = 'UTC', APP_ENV, JEST_NO_ALPHABETIC, JEST_SHARDS, NODE_OPTIONS } = process.env;
     const { integration, manual, leaks } = opt;
     const processArgs = process.argv.slice(2);
     let jestConfig;
@@ -106,8 +106,19 @@ async function runJest(opt = {}) {
     else {
         console.log(`${(0, colors_1.dimGrey)('NODE_OPTIONS are not defined')}`);
     }
-    await (0, exec_1.execWithArgs)('jest', (0, js_lib_1._uniq)(args), {
-        env,
-    });
+    if (JEST_SHARDS) {
+        const totalShards = Number(JEST_SHARDS);
+        const shards = (0, js_lib_1._range)(1, totalShards + 1);
+        for await (const shard of shards) {
+            await (0, exec_1.execWithArgs)('jest', (0, js_lib_1._uniq)([...args, `--shard=${shard}/${totalShards}`]), {
+                env,
+            });
+        }
+    }
+    else {
+        await (0, exec_1.execWithArgs)('jest', (0, js_lib_1._uniq)(args), {
+            env,
+        });
+    }
 }
 exports.runJest = runJest;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@naturalcycles/dev-lib",
-  "version": "12.20.2",
+  "version": "12.21.0",
   "scripts": {
     "prepare": "husky install",
     "tsn-debug": "tsn testScript.ts",

package/readme.md

@@ -125,6 +125,17 @@ For manual tests:
 pre-defined sequencer file that sorts all filenames alphabetically). Set `JEST_NO_ALPHABETIC` env
 variable to disable it.
 
+##### Shard support (experimental)
+
+Jest 28 introduced [--shard](https://jestjs.io/docs/cli#--shard) feature.
+
+Set `JEST_SHARDS` environment variable (e.g `export JEST_SHARDS=3`), so that your `yarn test*`
+commands will automatically split your tests by N number of shards and execute them **one after
+another** (serially, **not** in parallel). Might be helpful to avoid Jest's notorious memory leaks.
+
+If you need to execute shards **in parallel**, you can follow e.g
+[this instruction](https://medium.com/@mfreundlich1/speed-up-your-jest-tests-with-shards-776e9f02f637).
+
 #### Lint commands
 
 - `lint-all`: runs ESLint, Stylelint, Prettier, in the right order.