poku

Poku

Poku is your test runner pet for Node.js, Bun and Deno combining flexibility, parallel and sequential runs, human-friendly assertion errors and high isolation level.

Enjoying Poku? Consider giving him a star ⭐️

---

🐷 Documentation Website

---

Why Poku?

Poku starts from the premise where tests come to help, not overcomplicate: runs test files in an individual process per file, shows progress and exits 🧙🏻

• Supports ESM and CJS
• Designed to be highly intuitive
• No need to compile TypeScript *
• Compatible with Coverage tools
• Allows both in-code and CLI usage
• Node.js, Bun and Deno compatibility
• Zero configurations, except you want
• No constraints or rules, code in your own signature style
• And much more!

---

• 
• Zero external dependencies

---

Documentation

• See detailed specifications and usage in Documentation section for queries, advanced concepts and much more.

---

Overview

Sequential	Parallel
npx poku test/unit,test/integration	npx poku --parallel test/unit,test/integration

• By default, Poku searches for all .test. files, but you can customize it using the option filter.
• The same idea for Bun and Deno (see bellow).

---

Poku also includes the assert method, keeping everything as it is, but providing human readability:

import { assert } from 'poku'; // Node and Bun
import { assert } from 'npm:poku'; // Deno

assert(true);
assert.deepStrictEqual(1, '1', 'My optional custom message');

---

Install

Node.js

npm install --save-dev poku

TypeScript (Node.js)

npm install --save-dev poku tsx

Bun

bun add --dev poku

Deno

import { poku } from 'npm:poku';

• Poku requires these permissions by default: --allow-read, --allow-env and --allow-run.

---

Quick Start

In-code

import { poku } from 'poku';

await poku(['targetDirA', 'targetDirB']);

import { poku } from 'npm:poku';

await poku(['targetDirA', 'targetDirB']);

CLI

npx poku targetDirA,targetDirB

bun poku targetDirA,targetDirB

deno run npm:poku targetDirA,targetDirB

---

To see the detailed documentation, please visit the Documentation section in the Poku's website.

---

Community

I'm continuously working to improve Poku. If you've got something interesting to share, feel free to submit a Pull Request. If you notice something wrong, I'd appreciate if you'd open an Issue.

---

Acknowledgements

• Contributors