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.