add WebTestCase for phpunit emulation

CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## 1.1.0 - 2023-09-02
+
+### Added
+
+- `Innmind\BlackBox\Symfony\Bundle\FrameworkBundle\Test\WebTestCase`

README.md

@@ -140,3 +140,9 @@ return static function() {
     );
 }
 ```
+
+### PHPUnit emulation
+
+BlackBox is able to run PHPUnit tests and this extension allows to run functional tests. For this to work you only need to prefix the `Symfony\Bundle\FrameworkBundle\Test\WebTestCase` by `Innmind\BlackBox\`.
+
+**Warning**: custom assertions provided by Symfony are not supported.

composer.json

@@ -16,7 +16,7 @@
     },
     "require": {
         "php": "~8.2",
-        "innmind/black-box": "~5.0",
+        "innmind/black-box": "~5.3",
         "symfony/framework-bundle": "~6.0",
         "symfony/browser-kit": "~6.0",
         "symfony/http-foundation": "~6.0",

src/Bundle/FrameworkBundle/Test/WebTestCase.php

@@ -0,0 +1,80 @@
+<?php
+declare(strict_types = 1);
+
+namespace Innmind\BlackBox\Symfony\Bundle\FrameworkBundle\Test;
+
+use Innmind\BlackBox\PHPUnit\Framework\TestCase;
+use Symfony\Bundle\FrameworkBundle\KernelBrowser;
+use Symfony\Component\DependencyInjection\ContainerInterface;
+use Symfony\Component\HttpKernel\KernelInterface;
+use Symfony\Contracts\Service\ResetInterface;
+use App\Kernel;
+
+abstract class WebTestCase extends TestCase
+{
+    protected static ?KernelInterface $kernel = null;
+    protected static bool $booted = false;
+    protected static ?KernelBrowser $_client = null;
+
+    protected function tearDown(): void
+    {
+        parent::tearDown();
+        self::ensureKernelShutdown();
+    }
+
+    protected static function bootKernel(): KernelInterface
+    {
+        self::ensureKernelShutdown();
+
+        $kernel = self::createKernel();
+        $kernel->boot();
+        self::$kernel = $kernel;
+        self::$booted = true;
+
+        return self::$kernel;
+    }
+
+    protected static function getContainer(): ContainerInterface
+    {
+        $kernel = self::$kernel ?? self::bootKernel();
+
+        if (!self::$booted) {
+            $kernel = self::bootKernel();
+        }
+
+        /** @var ContainerInterface */
+        return $kernel->getContainer()->get('test.service_container');
+    }
+
+    protected static function createKernel(): KernelInterface
+    {
+        return new Kernel('test', true);
+    }
+
+    protected static function ensureKernelShutdown(): void
+    {
+        if (null !== self::$kernel) {
+            self::$kernel->boot();
+            $container = self::$kernel->getContainer();
+            self::$kernel->shutdown();
+            self::$booted = false;
+
+            if ($container instanceof ResetInterface) {
+                $container->reset();
+            }
+        }
+    }
+
+    protected static function createClient(): KernelBrowser
+    {
+        if (self::$_client) {
+            return self::$_client;
+        }
+
+        $kernel = self::bootKernel();
+        /** @var KernelBrowser */
+        self::$_client = $kernel->getContainer()->get('test.client');
+
+        return self::$_client;
+    }
+}