poku

Poku

English | Português (BR)

Poku is your Test Runner Pet for Node.js, Bun and Deno.

Enjoying Poku? Consider giving him a star ⭐️

---

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

---

Why Poku?

Poku can show you how simple testing can be 🌱

• No configurations
• Supports ESM and CJS
• High isolation level per file
• Poku is 100% documented
• Zero external dependencies
• Parallel and Sequential runs
• Designed to be highly intuitive
• Compatible with Coverage tools
• Node.js, Bun and Deno compatibility
• You don't need to learn it all at once to get started 🧑🏻‍🎓

Poku adapts to your test, not the other way around.

---

Quickstart

Install 📦

npm i -D poku	npm i -D poku tsx	bun add -d poku	import { poku } from 'npm:poku';

Test it 🔬

test/file.test.js

import { assert } from 'poku'; assert(true, 'Poku will describe it 🐷');

Note that these examples use ESM, but you can use CJS as well.

Run it 🚀

npx poku	bun poku	deno run npm:poku

That's it 🎉

• See the complete assert's documentation.
• See the complete poku's documentation.

---

Available Methods

Essentials

• poku (test runner)
• assert (test assertion)
• startScript (run package.json scripts in a background process)
• startService (run files in a background process)

Helpers

• beforeEach and afterEach
• test
• describe and log
• listFiles
• exit

See the complete documentation.

---

Overview

poku

Sequential	Concurrent

See the complete poku's documentation.

---

assert

• 💚 Use it exactly as it's for Node.js
• 🐷 Node.js, Bun and Deno compatibility

Using poku	Using node

See the complete assert's documentation.

---

Documentation and Examples

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.

---

Contributing

Please check the CONTRIBUTING.md for instructions 🚀

---

Philosophy

Please check the Philosophy section from Documentation.

---

License

Poku is under the MIT License.

---

Security Policy

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

---

Acknowledgements

---

Author

@wellwelwel