poku 1.21.0 → 1.23.0

package/README.md

@@ -1,20 +1,20 @@
 <div align="center">
-<img width="125" height="125" alt="Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
+<img height="180" alt="Poku's Logo" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/poku.svg">
 
 # Poku
 
 Enjoying **Poku**? Give him a star to show your support 🌟
 
-[![NPM Downloads][downloads-image]][downloads-url]
-[![Coverage][coverage-image]][coverage-url]
-[![License][license-image]][license-url]<br />
-[![GitHub Workflow Status (with event)][ci-linux-image]][ci-linux-url]
-[![GitHub Workflow Status (with event)][ci-osx-image]][ci-osx-url]
-[![GitHub Workflow Status (with event)][ci-windows-image]][ci-windows-url]
+[![NPM Downloads](https://img.shields.io/npm/dt/poku.svg?logo=npm&logoColor=white&color=1e90ff)](https://www.npmjs.com/package/poku)
+[![Coverage](https://img.shields.io/codecov/c/github/wellwelwel/poku)](https://app.codecov.io/github/wellwelwel/poku)
+[![License](https://img.shields.io/npm/l/poku?maxAge=2592000&color=9c88ff)](https://github.com/wellwelwel/poku/blob/main/LICENSE)<br />
+[![GitHub Workflow Status (Linux)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-linux.yml?event=push&label=&branch=main&logo=ubuntu&logoColor=white)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-linux.yml?query=branch%3Amain)
+[![GitHub Workflow Status (OSX)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-osx.yml?event=push&label=&branch=main&logo=apple&logoColor=white)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-osx.yml?query=branch%3Amain)
+[![GitHub Workflow Status (Windows)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-windows.yml?event=push&label=&branch=main&logo=iterm2&logoColor=white)](https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-windows.yml?query=branch%3Amain)
 
 ---
 
-🐷 [Documentation](https://poku.io)<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>🧪 [Examples](https://poku.io/docs/category/examples)<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>🔬 [Compare the Most Popular Test Runners](https://poku.io/docs/comparing)
+🐷 [Website](https://poku.io/)<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>📘 [Documentation](https://poku.io/docs/category/documentation)<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>🧪 [Examples](https://poku.io/docs/category/examples)<span>&nbsp;&nbsp;•&nbsp;&nbsp;</span>🧑🏻‍🎓 [Quick Tutorials](https://poku.io/docs/category/quick-tutorials)
 
 </div>
 
@@ -22,35 +22,32 @@ Enjoying **Poku**? Give him a star to show your support 🌟
 
 ## Why does Poku exist?
 
-💡 **Poku** makes testing easy and brings the [native **JavaScript** syntax back to tests](https://poku.io/docs/philosophy), letting you to write tests intuitively — _just like in real **JavaScript** code_.
+💡 **Poku** makes testing easy and brings the [native **JavaScript** syntax back to tests](https://poku.io/docs/philosophy#javascript-essence-for-tests-), letting you to write tests intuitively.
 
-<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> No configurations<br />
+<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> _No configurations_<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Auto detect **ESM**, **CJS**, and **TypeScript** files<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run the same test suite for [**Node.js**][node-version-url], [**Bun**][bun-version-url], and [**Deno**][deno-version-url]<br />
 
-<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easier and Less Verbose<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> [**Node.js**][node-version-url] familiar **API**<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Instantly re-run related tests in `watch` mode<br />
+<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> _Easier and Less Verbose_<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run **CJS** (**CommonJS**) files directly with [**Deno**][deno-version-url]<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle **containers**, **servers**, **services**, **processes**, and **ports**<br />
+<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Easily handle **containers**, **servers**, **processes**, and **ports**<br />
 
-<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Safety and Reliability<br />
+<img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> _Safety and Reliability_<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> High **isolation** level per file<br />
 <span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> **Performant** and **lightweight**<br />
-<span>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;</span><img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Compatible with **coverage** tools
 
 ---
 
 ## Quickstart
 
-### Install
+### <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Install
 
 <table>
 <tr>
-<td><blockquote><b>Node.js</b</blockquote></td>
-<td><blockquote><b>TypeScript + Node.js</b</blockquote></td>
-<td><blockquote><b>Bun</b</blockquote></td>
-<td><blockquote><b>Deno</b</blockquote></td>
+<td><blockquote><i>Node.js</i></blockquote></td>
+<td><blockquote><i>TypeScript (Node.js)</i></blockquote></td>
+<td><blockquote><i>Bun</i></blockquote></td>
+<td><blockquote><i>Deno</i></blockquote></td>
 </tr>
 <tr>
 <td width="400">
@@ -84,7 +81,9 @@ deno add npm:poku
 </tr>
 </table>
 
-### Test
+---
+
+### <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Test
 
 <table>
 <tr>
@@ -105,13 +104,15 @@ assert(true, 'Poku will describe it 🐷');
 </tr>
 </table>
 
-### Run
+---
+
+### <img width="16" height="16" alt="check" src="https://raw.githubusercontent.com/wellwelwel/poku/main/.github/assets/readme/check.svg"> Run
 
 <table>
 <tr>
-<td><blockquote><b>Node.js (and TypeScript)</b</blockquote></td>
-<td><blockquote><b>Bun</b</blockquote></td>
-<td><blockquote><b>Deno</b</blockquote></td>
+<td><blockquote><i>Node.js (and TypeScript)</i></blockquote></td>
+<td><blockquote><i>Bun</i></blockquote></td>
+<td><blockquote><i>Deno</i></blockquote></td>
 </tr>
 <tr>
 <td width="400">
@@ -138,32 +139,102 @@ deno run npm:poku
 </tr>
 </table>
 
-> Try the flag `--parallel` to run tests in parallel.
-
-- That's it 🎉
-
 ---
 
-## Available Methods
+## Features
 
 ### Essentials
 
-- [**poku**](https://poku.io/docs/category/-poku) _(test runner)_
-- [**assert**](https://poku.io/docs/documentation/assert) _(test assertion)_
+<table>
+  <tr>
+    <th width="250">Name</th>
+    <th width="800">Description</th>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/category/-poku">poku</a></td>
+    <td>🧪 Test runner.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/assert">assert</a></td>
+    <td>🔬 Test assertion  <i>(<strong>Node.js</strong> familiar <strong>API</strong>)</i>.</td>
+  </tr>
+</table>
 
 ### Helpers
 
-- [**test**](https://poku.io/docs/documentation/helpers/test), [**describe**](https://poku.io/docs/documentation/helpers/describe) and [**it**](https://poku.io/docs/documentation/helpers/it) _(organize, group, and isolate tests)_
-- [**watch**](https://poku.io/docs/documentation/poku/options/watch) _(watch for changes and re-run related test files)_
-- [**beforeEach**](https://poku.io/docs/category/-before-and-after-each) and [**afterEach**](https://poku.io/docs/category/-before-and-after-each) _(hooks for test setup and teardown)_
-- [**docker**](https://poku.io/docs/documentation/helpers/containers) _(build, start, compose, stop, remove, and test containers)_
-- [**startScript**](https://poku.io/docs/documentation/helpers/startScript) _(run **package.json** scripts in background)_
-- [**startService**](https://poku.io/docs/documentation/helpers/startService) _(run files in background)_
-- [**kill**](https://poku.io/docs/documentation/helpers/processes/kill) _(terminate ports, port ranges, and PIDs)_
-- [**waitForPort**](https://poku.io/docs/documentation/helpers/processes/wait-for-port) _(wait for specified ports to become active)_
-- [**waitForExpectedResult**](https://poku.io/docs/documentation/helpers/processes/wait-for-expected-result) _(retry until an expected result or times out)_
-- [**getPIDs**](https://poku.io/docs/documentation/helpers/processes/get-pids) _(debug processes IDs using ports and port ranges)_
-- _and much more_ 👇🏻
+<table>
+  <tr>
+    <th width="250">Name</th>
+    <th width="800">Description</th>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/test">test</a> • <a href="https://poku.io/docs/documentation/helpers/describe">describe</a> • <a href="https://poku.io/docs/documentation/helpers/it">it</a></td>
+    <td>🤹🏻‍♀️ Organize, group, and isolate tests.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/env">envFile</a></td>
+    <td>⚙️ Process an environment file <i>(out-of-box)</i>.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/category/-before-and-after-each">beforeEach</a> • <a href="https://poku.io/docs/category/-before-and-after-each">afterEach</a></td>
+    <td>🃏 Hooks for test setup and teardown.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/startScript">startScript</a></td>
+    <td>🌐 Run package.json scripts in background.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/startService">startService</a></td>
+    <td>🌐 Run files in background.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/containers">docker</a></td>
+    <td>🐳 Build, start, compose, stop, remove, and test containers.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/processes/kill">kill</a></td>
+    <td>🔌 Terminate ports, port ranges, and PIDs.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/processes/wait-for-port">waitForPort</a></td>
+    <td>😴 Wait for specified ports to become active.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/processes/wait-for-expected-result">waitForExpectedResult</a></td>
+    <td>🥱 Retry until an expected result or times out.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/skip">skip</a></td>
+    <td>⏭️ Skip tests when necessary.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/helpers/processes/get-pids">getPIDs</a></td>
+    <td>🕵🏻 Debug processes IDs using ports and port ranges.</td>
+  </tr>
+</table>
+
+### Common Options
+
+<table>
+  <tr>
+    <th width="250">Name</th>
+    <th width="800">Description</th>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/poku/options/watch">watch</a></td>
+    <td>🍿 Watch for changes and re-run related test files.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/poku/options/parallel">parallel</a></td>
+    <td>🏃🏻‍♀️ Run tests in parallel.</td>
+  </tr>
+  <tr>
+    <td><a href="https://poku.io/docs/documentation/poku/options/debug">debug</a></td>
+    <td>🕵🏻 Shows all logs.</td>
+  </tr>
+</table>
+
+> _and much more_ 👇🏻
 
 ---
 
@@ -173,6 +244,19 @@ To see the detailed documentation, please visit the [**Documentation**](https://
 
 ---
 
+### Tutorials
+
+**Poku** offers _mini-lessons_ for different users needs in the [**Quick Tutorials**](https://poku.io/docs/category/quick-tutorials) section.
+
+---
+
+### Common Issues
+
+- [Avoiding conflicts in environments with multiple platforms installed](https://poku.io/docs/tutorials/cross-platform#recommendations).
+- [Properly running asynchronous tests on the same file](https://poku.io/docs/examples/promises).
+
+---
+
 ## Contributing
 
 See the [**Contributing Guide**](https://github.com/wellwelwel/poku/blob/main/CONTRIBUTING.md) and please follow our [**Code of Conduct**](https://github.com/wellwelwel/poku/blob/main/CODE_OF_CONDUCT.md) 🚀
@@ -181,7 +265,7 @@ See the [**Contributing Guide**](https://github.com/wellwelwel/poku/blob/main/CO
 
 ## Security Policy
 
-[![GitHub Workflow Status (with event)][ql-image]][ql-url]
+[![GitHub Workflow Status (with event)](https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_codeql.yml?event=push&label=&branch=main&logo=github&logoColor=white)](https://github.com/wellwelwel/poku/actions/workflows/ci_codeql.yml?query=branch%3Amain)
 
 Please check the [**SECURITY.md**](https://github.com/wellwelwel/poku/blob/main/SECURITY.md).
 
@@ -191,7 +275,7 @@ Please check the [**SECURITY.md**](https://github.com/wellwelwel/poku/blob/main/
 
 ### Performance
 
-**Poku** is [continuously tested](https://github.com/wellwelwel/poku/blob/main/.github/workflows/ci_benchmark.yml) to ensure the following expectations:
+**Poku** is [continuously tested](https://github.com/wellwelwel/poku/blob/main/.github/workflows/ci_benchmark.yml) to ensure the following expectations for basic usage:
 
 - **~4x** faster than [**Jest**](https://github.com/jestjs/jest) (v29.7.0)
 - **~3x** faster than [**Vitest**](https://github.com/vitest-dev/vitest) (v1.6.0)
@@ -215,8 +299,11 @@ Please check the [**SECURITY.md**](https://github.com/wellwelwel/poku/blob/main/
 
 ### Limitations
 
-- Although it has no external dependencies, **Poku** is not _all-in-one_, so it doesn't have features such as _mocks_, _spies_, _coverage reports_, etc., where you can use your favorite packages or native solutions.
-- **Poku** community is gradually building up.
+- Although it has no external dependencies, **Poku** is not _all-in-one_, so it doesn't have integrated features such as _mocks_, _spies_, _coverage reports_, etc., where you can use your favorite packages or native solutions.
+  - See a [mock example](https://poku.io/docs/category/mock).
+- **Poku** doesn't render components (such as **Angular**, **React**, etc.).
+  - See an [_end-to-end_ test example](https://poku.io/docs/examples/browser/react).
+- Our community is gradually building up.
 
 ---
 
@@ -235,18 +322,3 @@ Please check the [**SECURITY.md**](https://github.com/wellwelwel/poku/blob/main/
 [node-version-url]: https://github.com/nodejs/node
 [bun-version-url]: https://github.com/oven-sh/bun
 [deno-version-url]: https://github.com/denoland/deno
-[typescript-url]: https://github.com/microsoft/TypeScript
-[ci-linux-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-linux.yml?query=branch%3Amain
-[ci-linux-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-linux.yml?event=push&label=&branch=main&logo=ubuntu&logoColor=white
-[ci-osx-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-osx.yml?query=branch%3Amain
-[ci-osx-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-osx.yml?event=push&label=&branch=main&logo=apple&logoColor=white
-[ci-windows-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_coverage-windows.yml?query=branch%3Amain
-[ci-windows-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_coverage-windows.yml?event=push&label=&branch=main&logo=windows&logoColor=white
-[ql-url]: https://github.com/wellwelwel/poku/actions/workflows/ci_codeql.yml?query=branch%3Amain
-[ql-image]: https://img.shields.io/github/actions/workflow/status/wellwelwel/poku/ci_codeql.yml?event=push&label=&branch=main&logo=github&logoColor=white
-[coverage-image]: https://img.shields.io/codecov/c/github/wellwelwel/poku
-[coverage-url]: https://app.codecov.io/github/wellwelwel/poku
-[downloads-image]: https://img.shields.io/npm/dt/poku.svg?logo=npm&logoColor=white&color=1e90ff
-[downloads-url]: https://www.npmjs.com/package/poku
-[license-url]: https://github.com/wellwelwel/poku/blob/main/LICENSE
-[license-image]: https://img.shields.io/npm/l/poku?maxAge=2592000&color=9c88ff

package/lib/bin/index.js

@@ -12,6 +12,7 @@ const files_js_1 = require("../configs/files.js");
 const get_runtime_js_1 = require("../parsers/get-runtime.js");
 const format_js_1 = require("../services/format.js");
 const kill_js_1 = require("../modules/helpers/kill.js");
+const env_js_1 = require("../modules/helpers/env.js");
 const map_tests_js_1 = require("../services/map-tests.js");
 const watch_js_1 = require("../services/watch.js");
 const poku_js_1 = require("../modules/essentials/poku.js");
@@ -41,6 +42,7 @@ const quiet = (0, get_arg_js_1.hasArg)('quiet');
 const debug = (0, get_arg_js_1.hasArg)('debug');
 const failFast = (0, get_arg_js_1.hasArg)('fail-fast');
 const watchMode = (0, get_arg_js_1.hasArg)('watch');
+const hasEnvFile = (0, get_arg_js_1.hasArg)('env-file');
 const concurrency = parallel
     ? Number((0, get_arg_js_1.getArg)('concurrency')) || undefined
     : undefined;
@@ -62,6 +64,10 @@ if (killPID) {
     const PIDs = killPID.split(',').map(Number);
     tasks.push(kill_js_1.kill.pid(PIDs));
 }
+if (hasEnvFile) {
+    const envFilePath = (0, get_arg_js_1.getArg)('env-file');
+    tasks.push((0, env_js_1.envFile)(envFilePath));
+}
 const options = {
     platform: (0, get_runtime_js_1.platformIsValid)(platform) ? platform : undefined,
     filter: filter ? new RegExp((0, list_files_js_1.escapeRegExp)(filter)) : undefined,

package/lib/configs/poku.d.ts

@@ -1,4 +1,5 @@
 export declare const results: {
     success: number;
     fail: number;
+    skipped: number;
 };

package/lib/configs/poku.js

@@ -4,4 +4,5 @@ exports.results = void 0;
 exports.results = {
     success: 0,
     fail: 0,
+    skipped: 0,
 };

package/lib/modules/essentials/assert.d.ts

@@ -24,7 +24,7 @@ export declare const assert: ((value: unknown, message?: ProcessAssertionOptions
     notDeepStrictEqual: (actual: unknown, expected: unknown, message?: ProcessAssertionOptions["message"]) => void;
     match: (value: string, regExp: RegExp, message?: ProcessAssertionOptions["message"]) => void;
     ifError: (value: unknown, message?: ProcessAssertionOptions["message"]) => void;
-    fail: (message?: ProcessAssertionOptions["message"]) => void;
+    fail: (message?: ProcessAssertionOptions["message"]) => never;
     rejects: typeof rejects;
 };
 export {};

package/lib/modules/essentials/assert.js

@@ -94,6 +94,7 @@ const fail = (message) => {
         defaultMessage: 'Test failed intentionally',
         hideDiff: true,
     });
+    process.exit(1);
 };
 function doesNotThrow(block, errorOrMessage, message) {
     (0, assert_js_1.processAssert)(() => {

package/lib/modules/helpers/assert-promise.d.ts

@@ -24,7 +24,7 @@ export declare const assertPromise: ((value: unknown, message?: ProcessAssertion
     notDeepStrictEqual: (actual: unknown, expected: unknown, message?: ProcessAssertionOptions["message"]) => Promise<void>;
     match: (value: string, regExp: RegExp, message?: ProcessAssertionOptions["message"]) => Promise<void>;
     ifError: (value: unknown, message?: ProcessAssertionOptions["message"]) => Promise<void>;
-    fail: (message?: ProcessAssertionOptions["message"]) => Promise<void>;
+    fail: (message?: ProcessAssertionOptions["message"]) => Promise<never>;
     rejects: typeof rejects;
 };
 export {};

package/lib/modules/helpers/assert-promise.js

@@ -100,6 +100,7 @@ const fail = (message) => __awaiter(void 0, void 0, void 0, function* () {
         defaultMessage: 'Test failed intentionally',
         hideDiff: true,
     });
+    process.exit(1);
 });
 function doesNotThrow(block, errorOrMessage, message) {
     return __awaiter(this, void 0, void 0, function* () {

package/lib/modules/helpers/env.d.ts

@@ -0,0 +1,2 @@
+/** Reads an environment file and sets the environment variables. */
+export declare const envFile: (filePath?: string) => Promise<void>;

package/lib/modules/helpers/env.js

@@ -0,0 +1,40 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envFile = void 0;
+/* c8 ignore start */ // ?
+const fs_js_1 = require("../../polyfills/fs.js");
+const list_files_js_1 = require("./list-files.js");
+const env_js_1 = require("../../services/env.js");
+const regex = {
+    comment: /^\s*#/,
+};
+/** Reads an environment file and sets the environment variables. */
+const envFile = (...args_1) => __awaiter(void 0, [...args_1], void 0, function* (filePath = '.env') {
+    /* c8 ignore stop */
+    const mapEnv = new Map();
+    const env = yield (0, fs_js_1.readFile)((0, list_files_js_1.sanitizePath)(filePath), 'utf8');
+    const lines = env
+        .split('\n')
+        .map((line) => (0, env_js_1.removeComments)(line.trim()))
+        .filter((line) => line.length > 0 && !regex.comment.test(line));
+    for (const line of lines) {
+        const parsedLine = (0, env_js_1.parseEnvLine)(line);
+        if (parsedLine) {
+            const { arg, value } = parsedLine;
+            mapEnv.set(arg, value ? (0, env_js_1.resolveEnvVariables)(value, process.env) : value);
+        }
+    }
+    for (const [arg, value] of mapEnv) {
+        process.env[arg] = value;
+    }
+});
+exports.envFile = envFile;

package/lib/modules/helpers/exit.js

@@ -20,7 +20,7 @@ const exit = (code, quiet) => {
                 write_js_1.Write.log(`    ${(0, format_js_1.format)('Duration ›').dim()} ${(0, format_js_1.format)(`${files_js_1.finalResults.time}ms`).bold().dim()} ${(0, format_js_1.format)(`(±${(0, time_js_1.parseTimeToSecs)(files_js_1.finalResults.time)} seconds)`).dim()}`);
                 write_js_1.Write.log(`  ${(0, format_js_1.format)(`Test Files › ${(0, format_js_1.format)(String(files_js_1.fileResults.success.size + files_js_1.fileResults.fail.size)).bold()}`).dim()}`);
                 write_js_1.Write.hr();
-                write_js_1.Write.log(`${(0, format_js_1.format)(` PASS › ${poku_js_1.results.success} `).bg('green')} ${(0, format_js_1.format)(` FAIL › ${poku_js_1.results.fail} `).bg(poku_js_1.results.fail === 0 ? 'grey' : 'red')}`);
+                write_js_1.Write.log(`${(0, format_js_1.format)(` PASS › ${poku_js_1.results.success - poku_js_1.results.skipped} `).bg('green')} ${(0, format_js_1.format)(` FAIL › ${poku_js_1.results.fail} `).bg(poku_js_1.results.fail === 0 ? 'grey' : 'red')} ${poku_js_1.results.skipped > 0 ? (0, format_js_1.format)(` SKIPPED › ${poku_js_1.results.skipped} `).bg(poku_js_1.results.skipped === 0 ? 'grey' : 'blue') : ''}`);
                 write_js_1.Write.hr();
             }
             write_js_1.Write.log(`${(0, format_js_1.format)('Exited with code').dim()} ${(0, format_js_1.format)(String(code)).bold()[code === 0 ? 'success' : 'fail']()}\n`);

package/lib/modules/helpers/skip.d.ts

@@ -0,0 +1 @@
+export declare const skip: (message?: string) => never;

package/lib/modules/helpers/skip.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.skip = void 0;
+const node_process_1 = require("process");
+const write_js_1 = require("../../services/write.js");
+const format_js_1 = require("../../services/format.js");
+const skip = (message) => {
+    const isPoku = typeof (node_process_1.env === null || node_process_1.env === void 0 ? void 0 : node_process_1.env.FILE) === 'string' && (node_process_1.env === null || node_process_1.env === void 0 ? void 0 : node_process_1.env.FILE.length) > 0;
+    const FILE = node_process_1.env.FILE;
+    if (message) {
+        write_js_1.Write.log((0, format_js_1.format)(isPoku
+            ? `ℹ ${message} ${(0, format_js_1.format)('›').dim()} ${(0, format_js_1.format)(`${FILE}`).italic().gray().dim()}`
+            : `ℹ ${message}`)
+            .info()
+            .bold());
+    }
+    (0, node_process_1.exit)(0);
+};
+exports.skip = skip;

package/lib/modules/helpers/wait-for.js

@@ -52,7 +52,6 @@ const waitForExpectedResult = (callback, expectedResult, options) => __awaiter(v
     /* c8 ignore stop */
     yield (0, exports.sleep)(delay);
     const startTime = Date.now();
-    // eslint-disable-next-line no-constant-condition
     while (true) {
         const result = yield callback();
         if (typeof expectedResult === 'function') {

package/lib/modules/index.d.ts

@@ -3,6 +3,8 @@ export { assert } from './essentials/assert.js';
 export { test } from './helpers/test.js';
 export { describe } from './helpers/describe.js';
 export { it } from './helpers/it.js';
+export { envFile } from './helpers/env.js';
+export { skip } from './helpers/skip.js';
 export { beforeEach, afterEach } from './helpers/each.js';
 export { docker } from './helpers/container.js';
 export { startScript, startService } from './helpers/create-service.js';

package/lib/modules/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.assertPromise = exports.listFiles = exports.log = exports.exit = exports.getPIDs = exports.kill = exports.sleep = exports.waitForPort = exports.waitForExpectedResult = exports.startService = exports.startScript = exports.docker = exports.afterEach = exports.beforeEach = exports.it = exports.describe = exports.test = exports.assert = exports.poku = void 0;
+exports.assertPromise = exports.listFiles = exports.log = exports.exit = exports.getPIDs = exports.kill = exports.sleep = exports.waitForPort = exports.waitForExpectedResult = exports.startService = exports.startScript = exports.docker = exports.afterEach = exports.beforeEach = exports.skip = exports.envFile = exports.it = exports.describe = exports.test = exports.assert = exports.poku = void 0;
 var poku_js_1 = require("./essentials/poku.js");
 Object.defineProperty(exports, "poku", { enumerable: true, get: function () { return poku_js_1.poku; } });
 var assert_js_1 = require("./essentials/assert.js");
@@ -11,6 +11,10 @@ var describe_js_1 = require("./helpers/describe.js");
 Object.defineProperty(exports, "describe", { enumerable: true, get: function () { return describe_js_1.describe; } });
 var it_js_1 = require("./helpers/it.js");
 Object.defineProperty(exports, "it", { enumerable: true, get: function () { return it_js_1.it; } });
+var env_js_1 = require("./helpers/env.js");
+Object.defineProperty(exports, "envFile", { enumerable: true, get: function () { return env_js_1.envFile; } });
+var skip_js_1 = require("./helpers/skip.js");
+Object.defineProperty(exports, "skip", { enumerable: true, get: function () { return skip_js_1.skip; } });
 var each_js_1 = require("./helpers/each.js");
 Object.defineProperty(exports, "beforeEach", { enumerable: true, get: function () { return each_js_1.beforeEach; } });
 Object.defineProperty(exports, "afterEach", { enumerable: true, get: function () { return each_js_1.afterEach; } });

package/lib/parsers/output.js

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parserOutput = exports.isDebug = exports.isQuiet = void 0;
+const poku_js_1 = require("../configs/poku.js");
 const regex = {
     newLine: /\n/,
     ansi: /u001b\[0m|\n/i,
+    skipped: /^"\\u001b\[94m\\u001b\[1mℹ/i,
 };
 const isQuiet = (configs) => typeof (configs === null || configs === void 0 ? void 0 : configs.quiet) === 'boolean' && Boolean(configs === null || configs === void 0 ? void 0 : configs.quiet);
 exports.isQuiet = isQuiet;
@@ -13,6 +15,10 @@ exports.isDebug = isDebug;
 /* c8 ignore next */ // ?
 const parserOutput = (options) => {
     const { output, result, configs } = options;
+    const normalizedOutput = JSON.stringify(output);
+    if (regex.skipped.test(normalizedOutput)) {
+        ++poku_js_1.results.skipped;
+    }
     const debug = (0, exports.isDebug)(configs);
     const pad = (configs === null || configs === void 0 ? void 0 : configs.parallel) ? '  ' : '    ';
     const splittedOutput = output.split(regex.newLine);

package/lib/services/env.d.ts

@@ -0,0 +1,6 @@
+export declare const removeComments: (input: string) => string;
+export declare const parseEnvLine: (line: string) => {
+    arg: string;
+    value: string;
+} | null;
+export declare const resolveEnvVariables: (str: string, env: typeof process.env) => string;

package/lib/services/env.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveEnvVariables = exports.parseEnvLine = exports.removeComments = void 0;
+/* c8 ignore next */ // ?
+const removeComments = (input) => {
+    let output = '';
+    let quoteChar = '';
+    let inQuote = false;
+    for (let i = 0; i < input.length; i++) {
+        const char = input[i];
+        if (inQuote) {
+            output += char;
+            if (char === quoteChar && input[i - 1] !== '\\') {
+                inQuote = false;
+            }
+        }
+        else if (char === '"' || char === "'") {
+            inQuote = true;
+            quoteChar = char;
+            output += char;
+        }
+        else if (char === '#') {
+            break;
+        }
+        else {
+            output += char;
+        }
+    }
+    return output.trim();
+};
+exports.removeComments = removeComments;
+/* c8 ignore net */ // ?
+const parseEnvLine = (line) => {
+    const index = line.indexOf('=');
+    if (index === -1) {
+        return null;
+    }
+    const arg = line.substring(0, index).trim();
+    const value = line
+        .substring(index + 1)
+        .trim()
+        .replace(/^['"]|['"]$/g, '');
+    return { arg, value };
+};
+exports.parseEnvLine = parseEnvLine;
+/* c8 ignore next */ // ?
+const resolveEnvVariables = (str, env) => {
+    let result = '';
+    let i = 0;
+    while (i < str.length) {
+        if (str[i] === '$' && str[i + 1] === '{') {
+            i += 2;
+            let varName = '';
+            while (i < str.length && str[i] !== '}') {
+                varName += str[i];
+                i++;
+            }
+            i++;
+            result += env[varName] || '';
+        }
+        else {
+            result += str[i];
+            i++;
+        }
+    }
+    return result;
+};
+exports.resolveEnvVariables = resolveEnvVariables;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "poku",
-  "version": "1.21.0",
+  "version": "1.23.0",
   "description": "🐷 Poku makes testing easy for Node.js, Bun, Deno, and you at the same time.",
   "main": "./lib/modules/index.js",
   "license": "MIT",
@@ -26,7 +26,7 @@
     "node": ">=6.0.0",
     "bun": ">=1.0.0",
     "deno": ">=1.30.0",
-    "typescript": ">=5.0.2"
+    "typescript": ">=4.7.2"
   },
   "scripts": {
     "test": "npm run test:parallel && npm run test:sequential",
@@ -59,11 +59,11 @@
   },
   "devDependencies": {
     "@biomejs/biome": "1.8.3",
-    "@types/node": "^20.14.9",
+    "@types/node": "^20.14.10",
     "c8": "^10.1.2",
     "packages-update": "^2.0.0",
     "shx": "^0.3.4",
-    "tsx": "4.16.0",
+    "tsx": "4.16.2",
     "typescript": "^5.5.3"
   },
   "keywords": [
@@ -74,18 +74,10 @@
     "assertion",
     "testing",
     "node",
-    "nodejs",
     "bun",
     "deno",
     "typescript",
     "tsx",
-    "concurrent",
-    "concurrency",
-    "parallel",
-    "parallelism",
-    "sequential",
-    "queue",
-    "queuing",
     "run",
     "cli",
     "unit",
@@ -94,8 +86,6 @@
     "end-to-end",
     "tdd",
     "bdd",
-    "isolate",
-    "isolation",
     "watch",
     "jest",
     "mocha",
@@ -106,12 +96,13 @@
     "tap",
     "tape",
     "karma",
-    "urun",
     "supertest",
+    "dotenv",
     "filter",
     "exclude",
     "list",
     "files",
+    "env",
     "kill",
     "container",
     "process",
@@ -122,11 +113,9 @@
     "esmodules",
     "esm",
     "mjs",
-    "expect",
     "framework",
     "tool",
     "runtime",
-    "poku",
-    "pokujs"
+    "poku"
   ]
 }