poku

Poku

Poku can show you how simple testing can be 🌱

Enjoying Poku? Consider giving him a star ⭐️

---

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

---

Reasons to Adopt a Poku →

No configurations
      Auto detect ESM and CJS
      Auto detect Typescript files
      Don't export your server (just run it) 🚀
      Run the same test suite for Node.js, Bun and Deno.

Safety and Reliability
      No global state
      High isolation level per file
      Compatible with Coverage tools
      Run CJS (CommonJS) files directly with Deno
      Easily handle services, servers, processes and ports
      Poku doesn't use eval nor will it change the environment's behavior 🔐

---

Quickstart

Install 📦

npm i -D poku	npm i -D poku tsx	bun add -d poku	deno add npm:poku

Test it 🔬

test/file.test.mjs

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

Change from .mjs to .js by defining "type": "module" in your package.json.

Run it 🚀

npx poku	bunx poku	deno run npm:poku

That's it 🎉

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

---

Available Methods

Essentials

• Test
  • poku (test runner)
  • assert (test assertion)
• Background Services
  • startScript (run package.json scripts in a background process)
  • startService (run files in a background process)
• Processes
  • kill (terminate Ports, Port Ranges and PIDs)
  • getPIDs (get all processes IDs using ports and port ranges)

Helpers

• beforeEach and afterEach
• test
• describe
• and much more ✨

---

Designed to be human-friendly

• ✨ You're free to work with the packages you desire
• 🧑🏻‍🎓 You don't need to learn it all at once to get started
• 👴🏼 Poku doesn't restrict you from testing in legacy environments

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.

---

Limitations

• Poku community is gradually building up 🤝
• Although it has no external dependencies, Poku is not all-in-one, so it doesn't have features such as mocks and spies, where you can use your favorite packages or native solutions.

---

Acknowledgements

---

Author

@wellwelwel