feat: behat support

Author: kbond

.gitattributes

@@ -15,4 +15,6 @@
 /phpstan.neon                   export-ignore
 /phpunit-dama-doctrine.xml.dist export-ignore
 /phpunit.xml.dist               export-ignore
+/behat.yml.dist                 export-ignore
 /tests                          export-ignore
+/features                       export-ignore

.gitignore

@@ -1,6 +1,7 @@
 /composer.lock
 /phpunit.xml
 /phpunit-dama-doctrine.xml
+/behat.yml
 /vendor/
 /bin/tools/*/vendor/
 /build/

behat.yml.dist

@@ -0,0 +1,11 @@
+default:
+    suites:
+        default:
+            contexts:
+                - Zenstruck\Foundry\Tests\Behat\TestContext
+                - Zenstruck\Foundry\Test\Behat\FactoriesContext
+    extensions:
+        FriendsOfBehat\SymfonyExtension:
+            kernel:
+                class: Zenstruck\Foundry\Tests\Fixtures\Kernel
+            bootstrap: tests/bootstrap.php

composer.json

@@ -28,6 +28,7 @@
         "doctrine/doctrine-migrations-bundle": "^2.2|^3.0",
         "doctrine/mongodb-odm-bundle": "^3.1|^4.2",
         "doctrine/orm": "^2.7",
+        "friends-of-behat/symfony-extension": "^2.4",
         "matthiasnoback/symfony-dependency-injection-test": "^4.1",
         "symfony/framework-bundle": "^4.4|^5.0|^6.0",
         "symfony/maker-bundle": "^1.30",
@@ -54,6 +55,9 @@
             "App\\Tests\\": "tests/Fixtures/tmp/tests"
         }
     },
+    "suggest": {
+        "friends-of-behat/symfony-extension": "To use the Behat contexts"
+    },
     "extra": {
         "bamarni-bin": {
             "target-directory": "bin/tools",

features/foundry.feature

@@ -0,0 +1,4 @@
+Feature: Foundry
+    Scenario: Ensure can create factories
+        Given there is 1 category
+        Then there is 1 category in the database

src/Bundle/DependencyInjection/ZenstruckFoundryExtension.php

@@ -4,15 +4,18 @@
 
 use Doctrine\Bundle\DoctrineBundle\DoctrineBundle;
 use Doctrine\Bundle\MongoDBBundle\DoctrineMongoDBBundle;
+use FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle;
 use Symfony\Bundle\MakerBundle\Maker\AbstractMaker;
 use Symfony\Component\Config\FileLocator;
 use Symfony\Component\DependencyInjection\ContainerBuilder;
 use Symfony\Component\DependencyInjection\Loader\XmlFileLoader;
+use Symfony\Component\DependencyInjection\Reference;
 use Symfony\Component\HttpKernel\DependencyInjection\ConfigurableExtension;
 use Zenstruck\Foundry\Bundle\Command\StubMakeFactory;
 use Zenstruck\Foundry\Bundle\Command\StubMakeStory;
 use Zenstruck\Foundry\ModelFactory;
 use Zenstruck\Foundry\Story;
+use Zenstruck\Foundry\Test\Behat\FactoriesContext;
 use Zenstruck\Foundry\Test\ORMDatabaseResetter;
 
 /**
@@ -49,6 +52,13 @@ protected function loadInternal(array $mergedConfig, ContainerBuilder $container
             $container->register('.zenstruck_foundry.maker.factory_stub', StubMakeFactory::class)->addTag('console.command');
             $container->register('.zenstruck_foundry.maker.story_stub', StubMakeStory::class)->addTag('console.command');
         }
+
+        if (self::isBundleLoaded($container, FriendsOfBehatSymfonyExtensionBundle::class)) {
+            $container->register('.zenstruck_foundry.behat.factories_context', FactoriesContext::class)
+                ->addArgument(new Reference('service_container'))
+                ->addTag('fob.context')
+            ;
+        }
     }
 
     private function configureFaker(array $config, ContainerBuilder $container): void

src/Test/Behat/FactoriesContext.php

@@ -0,0 +1,41 @@
+<?php
+
+namespace Zenstruck\Foundry\Test\Behat;
+
+use Behat\Behat\Context\Context;
+use Psr\Container\ContainerInterface;
+use Zenstruck\Foundry\ChainManagerRegistry;
+use Zenstruck\Foundry\Factory;
+use Zenstruck\Foundry\Test\LazyManagerRegistry;
+use Zenstruck\Foundry\Test\TestState;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+final class FactoriesContext implements Context
+{
+    public function __construct(private ContainerInterface $container)
+    {
+    }
+
+    /**
+     * @BeforeScenario
+     */
+    public function setUpFactories(): void
+    {
+        TestState::bootFromContainer($this->container);
+        Factory::configuration()->setManagerRegistry(
+            new LazyManagerRegistry(function (): ChainManagerRegistry {
+                return TestState::initializeChainManagerRegistry($this->container);
+            })
+        );
+    }
+
+    /**
+     * @AfterScenario
+     */
+    public function tearDownFactories(): void
+    {
+        TestState::shutdownFoundry();
+    }
+}

src/Test/Behat/ResetDatabaseContext.php

@@ -0,0 +1,33 @@
+<?php
+
+namespace Zenstruck\Foundry\Test\Behat;
+
+use Behat\Behat\Context\Context;
+use Psr\Container\ContainerInterface;
+use Zenstruck\Foundry\Test\DatabaseResetter;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+final class ResetDatabaseContext implements Context
+{
+    public function __construct(private ContainerInterface $container)
+    {
+    }
+
+    /**
+     * @BeforeSuite
+     */
+    public function resetDatabase(): void
+    {
+        DatabaseResetter::resetDatabase($this->container->get('kernel'));
+    }
+
+    /**
+     * @BeforeScenario
+     */
+    public function resetSchema(): void
+    {
+        DatabaseResetter::resetSchema($this->container->get('kernel'));
+    }
+}

tests/Behat/TestContext.php

@@ -0,0 +1,28 @@
+<?php
+
+namespace Zenstruck\Foundry\Tests\Behat;
+
+use Behat\Behat\Context\Context;
+use Zenstruck\Foundry\Tests\Fixtures\Factories\CategoryFactory;
+
+/**
+ * @author Kevin Bond <[email protected]>
+ */
+final class TestContext implements Context
+{
+    /**
+     * @Given there is :count category
+     */
+    public function thereIsCategory(int $count): void
+    {
+        CategoryFactory::createMany($count);
+    }
+
+    /**
+     * @Then there is :count category in the database
+     */
+    public function thereIsCategoryInTheDatabase(int $count): void
+    {
+        CategoryFactory::assert()->count($count);
+    }
+}

tests/Fixtures/Kernel.php

@@ -6,6 +6,7 @@
 use Doctrine\Bundle\DoctrineBundle\DoctrineBundle;
 use Doctrine\Bundle\MigrationsBundle\DoctrineMigrationsBundle;
 use Doctrine\Bundle\MongoDBBundle\DoctrineMongoDBBundle;
+use FriendsOfBehat\SymfonyExtension\Bundle\FriendsOfBehatSymfonyExtensionBundle;
 use Symfony\Bundle\FrameworkBundle\FrameworkBundle;
 use Symfony\Bundle\FrameworkBundle\Kernel\MicroKernelTrait;
 use Symfony\Bundle\MakerBundle\MakerBundle;
@@ -79,6 +80,8 @@ public function registerBundles(): iterable
         if ($this->enableDoctrine && \getenv('USE_ODM')) {
             yield new DoctrineMongoDBBundle();
         }
+
+        yield new FriendsOfBehatSymfonyExtensionBundle();
     }
 
     public function getCacheDir(): string