Update TestCase.php

Initial commit

Add integration test for parallel worker sessions

Rewrite integration test to use real parallel processes

Add Dusk fixture suite and run it under paratest in integration tests

Replace fixture tests with real Dusk browser tests against a local server

Split fixture suite into LoginTest, DashboardTest and NavigationTest

Fix missing --browse and --without-tty options in DuskParallelCommand

Author: jackbayliss

.github/workflows/ci.yml

@@ -0,0 +1,64 @@
+name: Tests
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  unit:
+    runs-on: ubuntu-latest
+
+    strategy:
+      fail-fast: false
+      matrix:
+        php: ['8.1', '8.2', '8.3', '8.4']
+
+    name: Unit (PHP ${{ matrix.php }})
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: ${{ matrix.php }}
+          extensions: zip, json
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-interaction --no-progress
+
+      - name: Run unit tests
+        run: vendor/bin/phpunit --testsuite=Unit
+
+  integration:
+    runs-on: ubuntu-latest
+
+    name: Integration (PHP 8.3)
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup PHP
+        uses: shivammathur/setup-php@v2
+        with:
+          php-version: '8.3'
+          extensions: zip, json
+          coverage: none
+
+      - name: Install dependencies
+        run: composer install --prefer-dist --no-interaction --no-progress
+
+      - name: Start test services
+        run: |
+          php -S localhost:8000 -t tests/Integration/Fixtures/public &
+          chromedriver --port=9515 &
+          chromedriver --port=9516 &
+          sleep 2
+
+      - name: Run integration tests
+        run: vendor/bin/phpunit --testsuite=Integration

.gitignore

@@ -0,0 +1,4 @@
+/.idea
+/vendor
+.phpunit.result.cache
+*.lock

composer.json

@@ -0,0 +1,54 @@
+{
+    "name": "jackbayliss/laravel-dusk-parallel",
+    "description": "Parallel test execution for Laravel Dusk.",
+    "keywords": [
+        "laravel",
+        "dusk",
+        "testing",
+        "parallel"
+    ],
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "Jack Bayliss",
+            "email": "jjbdev@proton.me"
+        }
+    ],
+    "require": {
+        "php": "^8.1",
+        "laravel/dusk": "^8.0|^9.0"
+    },
+    "require-dev": {
+        "brianium/paratest": "^7.0|^8.0",
+        "orchestra/testbench": "^8.0|^9.0|^10.0",
+        "phpunit/phpunit": "^10.5|^11.0"
+    },
+    "suggest": {
+        "brianium/paratest": "Required for PHPUnit parallel execution. Not needed when using Pest --parallel."
+    },
+    "autoload": {
+        "psr-4": {
+            "JackBayliss\\DuskParallel\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "JackBayliss\\DuskParallel\\Tests\\": "tests/"
+        }
+    },
+    "extra": {
+        "laravel": {
+            "providers": [
+                "JackBayliss\\DuskParallel\\DuskParallelServiceProvider"
+            ]
+        }
+    },
+    "scripts": {
+        "test": "vendor/bin/phpunit"
+    },
+    "config": {
+        "sort-packages": true
+    },
+    "minimum-stability": "dev",
+    "prefer-stable": true
+}

phpunit.xml

@@ -0,0 +1,15 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+>
+    <testsuites>
+        <testsuite name="Unit">
+            <directory>tests/Unit</directory>
+        </testsuite>
+        <testsuite name="Integration">
+            <directory>tests/Integration</directory>
+        </testsuite>
+    </testsuites>
+</phpunit>

src/Console/DuskParallelCommand.php

@@ -0,0 +1,48 @@
+<?php
+
+namespace JackBayliss\DuskParallel\Console;
+
+use Laravel\Dusk\Console\DuskCommand;
+use Symfony\Component\Console\Attribute\AsCommand;
+
+#[AsCommand(name: 'dusk:parallel')]
+class DuskParallelCommand extends DuskCommand
+{
+    protected $signature = 'dusk:parallel
+                {--processes=2 : Number of parallel processes to use}
+                {--browse : Open a browser instead of using headless mode}
+                {--without-tty : Disable output to TTY}';
+
+    protected $description = 'Run the Dusk tests in parallel';
+
+    protected function binary()
+    {
+        $paratestPath = base_path('vendor/bin/paratest');
+
+        if (! file_exists($paratestPath)) {
+            $this->error('paratest not found. Install it with: composer require --dev brianium/paratest');
+
+            exit(1);
+        }
+
+        return [PHP_BINARY, $paratestPath];
+    }
+
+    protected function phpunitArguments($options)
+    {
+        $options = array_values(array_filter($options, function ($option) {
+            return ! str_starts_with($option, '--processes=')
+                && ! str_starts_with($option, '--runner=');
+        }));
+
+        $args = parent::phpunitArguments($options);
+
+        $args[] = '--processes';
+        $args[] = $this->option('processes');
+
+        $args[] = '--runner';
+        $args[] = 'WrapperRunner';
+
+        return $args;
+    }
+}

src/DuskParallelServiceProvider.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace JackBayliss\DuskParallel;
+
+use Illuminate\Support\ServiceProvider;
+use JackBayliss\DuskParallel\Console\DuskParallelCommand;
+
+class DuskParallelServiceProvider extends ServiceProvider
+{
+    /**
+     * Register the service provider.
+     *
+     * @return void
+     */
+    public function register(): void
+    {
+        if ($this->app->runningInConsole()) {
+            $this->commands([
+                DuskParallelCommand::class,
+            ]);
+        }
+    }
+}

src/ParallelDriver.php

@@ -0,0 +1,52 @@
+<?php
+
+namespace JackBayliss\DuskParallel;
+
+class ParallelDriver
+{
+    public static function runningInParallel(): bool
+    {
+        return isset($_ENV['TEST_TOKEN']);
+    }
+
+    public static function parallelDriverPort(): int
+    {
+        return 9515 + (int) $_ENV['TEST_TOKEN'];
+    }
+
+    public static function hasExplicitPort(array $arguments): bool
+    {
+        foreach ($arguments as $argument) {
+            if (str_starts_with($argument, '--port=')) {
+                return true;
+            }
+        }
+
+        return false;
+    }
+
+    public static function hasExplicitDriverUrl(): bool
+    {
+        return isset($_ENV['DUSK_DRIVER_URL']) || env('DUSK_DRIVER_URL') !== null;
+    }
+
+    public static function resolveDriverArguments(array $arguments = []): array
+    {
+        if (static::runningInParallel() && ! static::hasExplicitDriverUrl() && ! static::hasExplicitPort($arguments)) {
+            $arguments[] = '--port='.static::parallelDriverPort();
+        }
+
+        return $arguments;
+    }
+
+    public static function resolveDriverUrl(): string
+    {
+        $url = $_ENV['DUSK_DRIVER_URL'] ?? env('DUSK_DRIVER_URL');
+
+        if (! $url && static::runningInParallel()) {
+            $url = 'http://localhost:'.static::parallelDriverPort();
+        }
+
+        return $url ?? 'http://localhost:9515';
+    }
+}

src/TestCase.php

@@ -0,0 +1,23 @@
+<?php
+
+namespace JackBayliss\DuskParallel;
+
+use Facebook\WebDriver\Remote\DesiredCapabilities;
+use Facebook\WebDriver\Remote\RemoteWebDriver;
+use Laravel\Dusk\TestCase as DuskTestCase;
+
+abstract class TestCase extends DuskTestCase
+{
+    public static function startChromeDriver(array $arguments = []): void
+    {
+        parent::startChromeDriver(ParallelDriver::resolveDriverArguments($arguments));
+    }
+
+    protected function driver(): RemoteWebDriver
+    {
+        return RemoteWebDriver::create(
+            ParallelDriver::resolveDriverUrl(),
+            DesiredCapabilities::chrome()
+        );
+    }
+}

tests/Integration/Fixtures/DashboardTest.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace JackBayliss\DuskParallel\Tests\Integration\Fixtures;
+
+use Laravel\Dusk\Browser;
+
+class DashboardTest extends DuskTestCase
+{
+    public function test_dashboard_page_loads(): void
+    {
+        $this->browse(function (Browser $browser) {
+            $browser->visit('/dashboard.html')
+                    ->assertTitle('Dashboard - Test App')
+                    ->assertSee('You are logged in.');
+        });
+    }
+
+    public function test_dashboard_has_home_link(): void
+    {
+        $this->browse(function (Browser $browser) {
+            $browser->visit('/dashboard.html')
+                    ->assertSeeLink('Home');
+        });
+    }
+}

tests/Integration/Fixtures/DuskTestCase.php

@@ -0,0 +1,16 @@
+<?php
+
+namespace JackBayliss\DuskParallel\Tests\Integration\Fixtures;
+
+use JackBayliss\DuskParallel\TestCase;
+use Orchestra\Testbench\Concerns\CreatesApplication;
+
+abstract class DuskTestCase extends TestCase
+{
+    use CreatesApplication;
+
+    protected function baseUrl(): string
+    {
+        return 'http://localhost:8000';
+    }
+}