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.

By creating Poku, my aim is to show that testing can be simpler.

Enjoying Poku? Consider giving him a star ⭐️

---

🐷 Documentation Website • 🔬 Compare Poku with the Most Popular Test Runners • 🧪 Examples

---

Why Poku?

Let's make describe, beforeEach and everything else easier 🚀

• Supports ESM and CJS
• Designed to be highly intuitive
• Compatible with Coverage tools
• Node.js, Bun and Deno compatibility
• Zero configurations, except you want
• Allows both API (in-code) and CLI usage
• Poku adapts to your test, not the other way around
• You can use Poku's assert with every test runner you want
• And much more!

---

• 
• Zero external dependencies 🌱

---

Documentation

• See detailed usage in Documentation section for Poku's CLI, API (in-code) and assert, advanced concepts and much more.

---

Examples

• See real example usages in Examples section for Poku's + Mock, Virutal DOM and more.

---

Overview

poku

Sequential	Concurrent

See the complete poku documentation.

---

assert

Using poku	Using node

See the complete assert's documentation.

---

Install

Node.js

npm i -D poku

TypeScript (Node.js)

npm i -D poku tsx

Bun

bun add -d poku

Deno

import { poku } from 'npm:poku';

---

Quick Start

poku

CLI

Try to set the flag --parallel before the target path 🚀

npx poku targetPath
npx poku targetPathA,targetPathB

bun poku targetPath
bun poku targetPathA,targetPathB

deno run npm:poku targetPath
deno run npm:poku targetPathA,targetPathB

API (In-code)

Node.js, TypeScript (Node.js) and Bun

import { poku } from 'poku';

await poku(['targetPath']);

Deno

import { poku } from 'npm:poku';

await poku(['targetPath']);

assert

Use it exactly as it's for Node.js 💚

---

To see the detailed documentation, please visit the Documentation and Examples sections 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.

---

Contributing

Please check the CONTRIBUTING.md for instructions 🚀

---

License

Poku is under the MIT License.

---

Security Policy

Please check the SECURITY.md and the section Is Poku Safe? from Documentation.

Changelog

1.6.0 (2024-02-29)

Features

• innovating beforeEach and afterEach (#53) (3ea3a12)
• support target file and directories (#47) (4353996)