dmarynicz / behat-parallel-extension
Parallel extension for Behat
Installs: 262 341
Dependents: 1
Suggesters: 0
Security: 0
Stars: 19
Watchers: 2
Forks: 6
Open Issues: 5
Requires
- php: >=7.2
- behat/behat: ^3.6
- symfony/console: ^2.7.52 || ^2.8.33 || ^3.3.15 || ^3.4.3 || ^4.0 || ^5.0 || ^6.0 || ^7.0
- symfony/dependency-injection: ^2.7.52 || ^3.0 || ^4.0 || ^4.1.12 || ^5.0 || ^6.0 || ^7.0
- symfony/event-dispatcher: ^2.7.52 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0
- symfony/expression-language: ^2.7.52 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0
- symfony/process: ^2.7.52 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0
- symfony/serializer: ^2.7.52 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0
- symfony/yaml: ^2.7.52 || ^3.0 || ^4.0 || ^5.0 || ^6.0 || ^7.0
Requires (Dev)
- ext-json: *
- dg/bypass-finals: ^1.1 || ^1.2
- phpunit/phpunit: ^8.5 || ^9.0
README
Intro
This extension is for an executing behat 3.x tests in parallel mode.
If you Properly integrate your app with this extension then it can be dramatically speed up your behat tests!
Features
- Displays nice progress bar :).
- Extension can cancel your tests when you hit CTRL+C.
- When you have failed tests in Parallel scenario mode then can you rerun this test with Behat option
--rerun
. - For each worker you can set environment variables.
Main modes
Behat Parallel Extension can work in two main modes:
- Parallel scenario witch can be enabled by option
--parallel
or-l
. - Parallel feature to enable this you need use behat option
--parallel-feature
.
Parallel feature option does not support's --rerun
option.
Requirements
PHP compatibility
This Behat extension requires php 5.6
or higher.
The main reason for choosing php 5.6 is to be able to share this tool with more programmers :).
Installing Behat Parallel Extension
The most convenient way to install Behat Parallel Extension is by using Composer:
For more information about installing Composer please follow the documentation: https://getcomposer.org/download/
Install
composer require --dev dmarynicz/behat-parallel-extension
Configuration
You can then activate and configure the extension in your behat.yml
or behat.yml.dist
.
In the array environments
you can set you environment vars for each worker.
From this environments
array depends on how much maximum you can run Workers.
If you do note set environments
array then you can run an unlimited amount of Workers.
If the environmental
array is defined, the maximum number of workers is the size of this array.
Example for maximum 4 Workers:
default: # ... extensions: DMarynicz\BehatParallelExtension\Extension: environments: - ANY_YOUR_ENV_VARIABLE: with any value DATABASE_URL: mysql://db_user:db_password@127.0.0.1:3306/db_name_00?serverVersion=5.7 - ANY_YOUR_ENV_VARIABLE: with any value DATABASE_URL: mysql://db_user:db_password@127.0.0.1:3306/db_name_01?serverVersion=5.7 - ANY_YOUR_ENV_VARIABLE: with any value DATABASE_URL: mysql://db_user:db_password@127.0.0.1:3306/db_name_02?serverVersion=5.7 - ANY_YOUR_ENV_VARIABLE: with any value DATABASE_URL: mysql://db_user:db_password@127.0.0.1:3306/db_name_03?serverVersion=5.7
Example for maximum an unlimited amount of Workers:
default: # ... extensions: DMarynicz\BehatParallelExtension\Extension: ~
Integration with SymfonyExtension and Symfony
To integrate this extension with SymfonyExtension and MinkExtension you need install by Composer command packages
composer require --dev \ friends-of-behat/mink \ friends-of-behat/mink-extension \ friends-of-behat/mink-browserkit-driver \ friends-of-behat/symfony-extension
Configure the extension in your behat.yml
or behat.yml.dist
as in this example:
default: suites: default: contexts: # Your contexts... extensions: Behat\MinkExtension: sessions: symfony: symfony: ~ FriendsOfBehat\SymfonyExtension: # for symfony 5.3+ with symfony/runtime installed by composer command bootstrap: tests/bootstrap.php # for symfony versions older than 5.3 #bootstrap: config/bootstrap.php DMarynicz\BehatParallelExtension\Extension: environments: - DATABASE_URL: "sqlite:///%%kernel.project_dir%%/var/data_test1.db" # doc for APP_CACHE_DIR https://symfony.com/doc/current/configuration/override_dir_structure.html#override-the-cache-directory APP_CACHE_DIR: "var/cache1" # SYMFONY_DOTENV_VARS does not have symfony's docs but without this tests will ignore env vars like DATABASE_URL, APP_CACHE_DIR and tests will not work SYMFONY_DOTENV_VARS: - DATABASE_URL: "sqlite:///%%kernel.project_dir%%/var/data_test2.db" APP_CACHE_DIR: "var/cache2" SYMFONY_DOTENV_VARS: - DATABASE_URL: "sqlite:///%%kernel.project_dir%%/var/data_test3.db" APP_CACHE_DIR: "var/cache3" SYMFONY_DOTENV_VARS: - DATABASE_URL: "sqlite:///%%kernel.project_dir%%/var/data_test4.db" APP_CACHE_DIR: "var/cache4" SYMFONY_DOTENV_VARS:
In tests/bootstrap.php
for Symfony 5.3+ you need to have
<?php use Symfony\Component\Dotenv\Dotenv; require_once dirname(__DIR__) . '/vendor/autoload_runtime.php'; (new Dotenv())->bootEnv(dirname(__DIR__) . '/.env');
Full example is available at https://github.com/Daniel-Marynicz/BehatParallelExtension-IntegrationWithSymfony-Example
Usage
Use --parallel
or -l
option for start in parallel scenario mode.
Or use --parallel-feature
to start in parallel feature mode.
Optionally you can to specify number of concurrent workers in these modes.
Examples with enabled option --colors
:
$ vendor/bin/behat -l 8 --colors
Starting parallel scenario tests with 8 workers
Feature: Parallel
Scenario: Test behat tests with failed result
3/3 [============================] 100% 12 secs/12 secs
$ vendor/bin/behat --parallel-feature 8 --colors
Starting parallel scenario tests with 8 workers
Feature: Parallel
Scenario: Test behat tests with failed result
3/3 [============================] 100% 12 secs/12 secs
Tools and Coding standards
The extension uses the following coding standards and quality tools:
Doctrine Coding Standard
The Doctrine Coding Standard with some exceptions for php 5.6 compatibility. The Doctrine Coding Standard is a set of rules for PHP_CodeSniffer. It is based on PSR-1 and PSR-12 , with some noticeable exceptions/differences/extensions.
For more information about Doctrine Coding Standard please follow the documentation:
PHPStan
PHPStan A php framework for auto testing your business expectations. PHPStan focuses on finding errors in your code without actually running it. It catches whole classes of bugs even before you write tests for the code. It moves PHP closer to compiled languages in the sense that the correctness of each line of the code can be checked before you run the actual line.
PHPUnit
PHPUnit The PHP Testing Framework with tests in directory tests
Behat
You can find Behat tests in directory features and fixtures in tests/fixtures and some classes for behat tests in directory tests/Behat.