cleatsquad / module-parallel-tests-plus

1.1.0 2026-08-30 10:03 UTC

Requires

• php: ~8.2|~8.3|~8.4
• brianium/paratest: ^7.4
• magento/module-developer: ^100.4

Requires (Dev)

• friendsofphp/php-cs-fixer: ^3.0
• phpstan/phpstan: ^1.0
• phpunit/phpunit: ^10.5 || ^11.0

MIT

• Mohamed EL Mrabet

• testing
• phpunit
• magento2
• developer-tools
• paratest
• parallel-testing
• magento-testing
• dev-tests-run
• static-tests

Published on Packagist.org on 2026-08-30 14:55 UTC

README

A Magento 2 extension that enhances the core dev:tests:run command by enabling parallel execution of developer tests using ParaTest.

This module significantly reduces execution time for static, unit, integration and integrity tests — via a clean declarative DI override (no core file patching) and full CI/CD compatibility.

Badges

✨ Features

• 🚀 Parallel execution of Magento developer tests.
• 🔧 Adds --processes to set worker count.
• 🧵 Adds --runner option (default: WrapperRunner).
• ⚙ Fully compatible with Magento’s native --arguments passthrough.
• 🧩 Supports all Magento test categories:
  • Static Test Suites (Default, Legacy, JS Exemplar)
  • Unit Tests (Framework + Integration Layer)
  • Integration Tests
  • Integrity Tests
• 🛡 Clean DI override of:

  Magento\Developer\Console\Command\DevTestsRunCommand
  

• 🎯 No core hacks. Safe for production and CI pipelines.

📦 Installation

You can install this module using Composer (recommended) or manually.

🔹 1. Install via Composer (recommended)

composer require cleatsquad/module-parallel-tests-plus --dev

Note: this package depends on magento/module-developer, resolved via repo.magento.com. Make sure your project has a valid Magento Marketplace auth.json configured, otherwise Composer will fail to resolve it.

Then upgrade Magento:

bin/magento setup:upgrade

🔹 2. Manual installation (app/code)

Copy the module

app/code/CleatSquad/ParallelTestsPlus

Require ParaTest

composer require --dev brianium/paratest

Then upgrade Magento:

bin/magento setup:upgrade

🚀 Usage

Run static tests with 8 workers

bin/magento dev:tests:run static --processes=8

Run unit tests with 3 workers

bin/magento dev:tests:run unit --processes=3

Run all developer tests in parallel

bin/magento dev:tests:run all --processes=8

Use a custom runner

bin/magento dev:tests:run static --runner=WrapperRunner

Pass arguments to ParaTest/PHPUnit via Magento native --arguments

bin/magento dev:tests:run static -c" --filter=MyTest"
bin/magento dev:tests:run integration --processes 2 -c" testsuite/Magento/Catalog/Model/ResourceModel/Category/CollectionTest.php"

🤝 Support & Contributions

Issues and pull requests are welcome — see CONTRIBUTING.md. For security issues, see SECURITY.md instead of opening a public issue.

GitHub:
https://github.com/CleatSquad/module-parallel-tests-plus

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

🙏 Acknowledgements

This module is powered by the excellent ParaTest project:

➡️ https://github.com/paratestphp/paratest

ParaTest enables efficient parallel execution of PHPUnit tests and is essential to the performance improvements provided by this module.

Authors

• Mohamed El Mrabet - Initial work - mimou78

📜 License

Released under the MIT License.
See the LICENSE.txt file for full details.

© 2025 - CleatSquad (https://cleatsquad.dev)