Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/facile-it/paraunit
Run PHPUnit tests in parallel
https://github.com/facile-it/paraunit
hacktoberfest phar php phpunit symfony symfony-application testing-tools
Last synced: 2 days ago
JSON representation
Run PHPUnit tests in parallel
- Host: GitHub
- URL: https://github.com/facile-it/paraunit
- Owner: facile-it
- License: apache-2.0
- Created: 2015-07-13T08:24:01.000Z (over 9 years ago)
- Default Branch: 2.x
- Last Pushed: 2024-12-17T07:54:18.000Z (6 days ago)
- Last Synced: 2024-12-17T08:41:36.406Z (6 days ago)
- Topics: hacktoberfest, phar, php, phpunit, symfony, symfony-application, testing-tools
- Language: PHP
- Homepage: https://engineering.facile.it/paraunit/
- Size: 3.75 MB
- Stars: 141
- Watchers: 32
- Forks: 15
- Open Issues: 20
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG-0.x.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
# facile-it/paraunit
[![Stable release][Last stable image]][Packagist link]
[![Unstable release][Last unstable image]][Packagist link]
[](https://github.com/facile-it/paraunit/actions)
[![Coverage Status][Master coverage image]][Master coverage link]
Paraunit is a tool for faster executions of PHPUnit test suites. It makes this possible by launching multiple test in parallel with single PHPUnit processes.
Paraunit is developed using Symfony components.
## Installation
To use this package, use Composer:
* from CLI: `composer require --dev facile-it/paraunit`
* or, directly in your `composer.json`:
```json
{
"require-dev": {
"facile-it/paraunit": "^2.0"
}
}
```
### Compatibility
You can use Paraunit with many versions of PHPUnit or Symfony, following this compatibility list:
| Paraunit version | Compatible PHPUnit Version | Compatible Symfony Version |
|------------------|----------------------------|----------------------------|
| 2.3 | 10.5.4+, 11+ | 4.4, 5, 6, 7 |
| 2.0 | 10+ | 4.4, 5, 6, 7 |
| 1.3 | 9.3+ | 4.4, 5, 6 |
| 1.2 | 9.3+ | 3.4, 4, 5 |
| 1.1 | 9.1, 9.2 | 3.4, 4, 5 |
| 1.0.* | 7, 8 | 3.4, 4, 5 |
| 0.12.* | 6, 7 | 2.8, 3, 4 |
## Usage
Paraunit starts as a Symfony console command, but it's provided through a bin launcher; you can run it like this:
(assuming your Composer's bin dir is `vendor/bin`)
```
vendor/bin/paraunit run
```
This command will launch all the tests in all your configured testsuites.
### Collect test coverage
Paraunit is also able to **collect the test coverage in parallel**, like this:
```
vendor/bin/paraunit coverage --html=./dir
```
It **automatically uses the best coverage driver available**: it tries to use [Pcov](https://github.com/krakjoe/pcov) if available (since it's the fastest), otherwise it uses [Xdebug](https://xdebug.org/). If neither are available, it should always be able to use [PHPDbg](https://www.php.net/manual/en/book.phpdbg.php), which is bundled in PHP core, so it should be always present. It can produce coverage in the same formats that PHPUnit provides: HTML, Clover, Cobertura, XML, Crap4j, PHP, text file and text to console.
## Documentation
For more details about Paraunit and its usage, see the [documentation](https://engineering.facile.it/paraunit/documentation/)
[Last stable image]: https://poser.pugx.org/facile-it/paraunit/version.svg
[Last unstable image]: https://poser.pugx.org/facile-it/paraunit/v/unstable.svg
[Master coverage image]: https://codecov.io/gh/facile-it/paraunit/branch/master/graph/badge.svg
[Packagist link]: https://packagist.org/packages/facile-it/paraunit
[Master coverage link]: https://codecov.io/gh/facile-it/paraunit