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

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

# Bun
bun add poku

# Deno (optional)
deno add npm:poku # use "deno run npm:poku" 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.

---

🗺️ 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 (fresh out of the oven)

• Improve architecture to allow external plugins.
  • Investigate the use of events approach:
    • Benchmarks were all negative against events (more than 2x slower).
  • feat: introduce custom reporters (poku, dot, compact, focus, verbose, and classic) #921

Note

I'm extremely satisfied with the current benchmarks (#926). I'll wait to write the extensive report after v3.