Version 3.0.0 (planned breaking changes and architecture improvements)

[wellwelwel]

In favor of better maintenance, performance and a more cohesive architecture, I'm planning to make some major updates and migrate the opening issues to the next Poku version.

📦 Installing

# Node.js
npm i -D poku@rc

# Node.js + TypeScript
npm i -D poku@rc tsx

# Bun
bun add poku@rc

# Deno (optional)
deno add npm:poku@rc # use "deno run npm:poku@rc" to run tests

---

⚙️ Migrating

• For Node.js, make sure you have version 14.x.x or higher.
• Instead of poku --parallel or poku -p, just use poku.
• Instead of poku (sequential in v2), use poku --sequential.
• If you have some flag using kebab case (e.g., --fail-fast), use camel case instead (e.g., --failFast).
• Instead of setting the platform manually (poku --platform=..., poku --deno, poku --bun or poku --node), just use the platform/runtime to call Poku, for example: npx poku, bun poku or deno run poku@rc.

---

🗺️ Roadmap

✅ v3.0.0-rc.0

Focused on performance and breaking changes:

• Drop the support for Node.js 8, 10 and 12 (for performance reasons).
  • chore!: drop support for Node.js v8 and v10 #885
  • chore!: drop support for Node.js v12 #896
• Remove all methods and options marked as deprecated.
  • chore!: drop include CLI flag #877
  • chore!: drop kebab case support #883
• Improve performance.
  • perf: use queue instead of groups for parallel tests #886
  • Investigate the use of fork instead of spawn:
    • Benchmarks were all negative against fork.
• Use parallel run as default, such as Node.js, Jest, etc.
  • chore!: drop parallel in favor of sequential option #888
• Remove the need to manually define the platform for environments with multiple runtimes (--platform, --node, --bun, --deno).
  • chore!: drop platform option #894

✅ v3.0.0-rc.1

Note

From this point on, there is no intention of breaking changes, except for some inevitable case.

Focused on improvements and major features:

• Revisit early access and experimental features.
  • feat: add stable only modifier to describe, it and test methods #901
  • feat: stable enforce values validation #905
• Improve the global cache to increase initial performance.
  • perf: improve global cache #907

⏳ v3.0.0

• Improve architecture to allow external plugins.
  • Investigate the use of events approach:
    • Benchmarks were all negative against events (more than 2x slower).
  • Make output report customizable #629
  • https://github.com/wellwelwel/poku/tree/reporter