README

This package ships with some helper Artisan commands and testing traits to allow you running your Feature Tests in parallel using Paratest against a MySQL or PostgreSQL database without conflicts.

The package will create 1 database for each testing process you have running to avoid race conditions when your Feature Test try to run a test creating some fixtures while another test in a another process runs the artisan migrate:fresh.

You also don't have to worry about creating the test databases. They will be created when you run your tests. There's is even a helper runner to clean up the test databases afterwards.

Installation

You can install the package via composer:

composer require muhmdraouf/laravel-paratest --dev

Usage

Attention: You will need a user with rights to create databases.

Instead of using Laravel's RefreshDatabase trait, use the package one:

<?php

use MuhmdRaouf\LaravelParatest\Testing\RefreshDatabase;

class MyTest extends TestCase
{
    use RefreshDatabase;
}

Tip: to replace all existing usages of Laravel's RefreshDatabase trait with the package's, you can use the following command:

grep -rl 'Illuminate\\Foundation\\Testing\\RefreshDatabase' tests/ | xargs sed -i 's/Illuminate\\Foundation\\Testing\\RefreshDatabase/MuhmdRaouf\\LaravelParatest\\Testing\\RefreshDatabase/g'

You need to boot this setup trait in your base TestCase manually, because Laravel does not do it automatically:

<?php

namespace Tests;

use MuhmdRaouf\LaravelParatest\Testing\RefreshDatabase;
use Illuminate\Foundation\Testing\TestCase as BaseTestCase;

abstract class TestCase extends BaseTestCase
{
    use CreatesApplication;

    protected function setUpTraits()
    {
        $uses = parent::setUpTraits();
        if (isset($uses[RefreshDatabase::class])) {
            $this->refreshDatabase();
        }
        return $uses;
    }
}

You can keep running you tests with PHPUnit:

phpunit

Or you can use Paratest:

paratest

When using paratest, one database will be created for each process. If you want to clean up these databases at the end of the tests, use the runner provided. First, register the runner alias in your composer.json file, something like this:

{
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        },
        "files": [
            "vendor/muhmdraouf/laravel-paratest/src/ParatestLaravelRunner.php"
        ]
    }
}

Now, run composer dump-autoload --optimize, and then you can use the runner, like so:

paratest --runner ParatestLaravelRunner

This will clean up the test databases after your test finishes running.

This package also gives you the following Artisan commands:

php artisan db:create
php artisan db:drop
php artisan db:recreate

THESE COMMANDS RUN ONLY IN TESTING ENVIRONMENT.

Testing

composer test

Changelog

Please see CHANGELOG for more information what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security

If you discover any security related issues, please email mohammed@raouf.me instead of using the issue tracker.

muhmdraouf / laravel-paratest

Maintainers

Details