dantleech · May 20, 2024 07:13 · May 20, 2024 · May 19, 2024 · May 19, 2024 · May 19, 2024
diff --git a/10_Builder.php b/10_Builder.php
@@ -2,7 +2,7 @@
 
 /**
  * Builder classes are registed in the "FixtureContainer" and provide fixtures
- * based on the `__invoke` return type.
+ * based on the `__invoke` return type (not sure if that's a great idea).
  */
 final class ProjectBuilder
 {

diff --git a/10_Builder.php b/10_Builder.php
@@ -14,6 +14,7 @@ public function __invoke(
     {
         return new Project(
             Uuid::v4(),
+            // _get_ (or create) the organisation instance
             $container->get(Organisation::class, $organisation),
             $name
         );

diff --git a/20_FixtureContainer.php b/20_FixtureContainer.php
@@ -0,0 +1,43 @@
+<?php
+
+final class FixtureContainer
+{
+    /**
+     * @var array<string,array<string,\Closure():object>>
+     */
+    private array $factories = [];
+
+    /**
+     * @var array<string,array<string,object>>
+     */
+    private array $instances = [];
+
+    /**
+     * @param list<object> $builders
+     */
+    public function __construct(
+        private array $builders
+    )
+    {
+    }
+
+    /**
+     * @template TClass of object
+     * @param class-string<TClass> $className
+     * @return TClass
+     */
+    public function get(string $className, string $identifier): object
+    {
+        // blah...
+        return $instance;
+    }
+
+    /**
+     * @param class-string $className
+     * @param array<string,mixed> $params
+     */
+    public function register(string $className, string $identifier, array $params = []): void
+    {
+        // blah...
+    }
+}
diff --git a/10_Builder.php b/10_Builder.php
@@ -1,5 +1,9 @@
 <?php
 
+/**
+ * Builder classes are registed in the "FixtureContainer" and provide fixtures
+ * based on the `__invoke` return type.
+ */
 final class ProjectBuilder
 {
     public function __invoke(

diff --git a/Context.php → 00_Context.php b/Context.php → 00_Context.php
diff --git a/Builder.php → 10_Builder.php b/Builder.php → 10_Builder.php
diff --git a/Builder.php b/Builder.php
@@ -0,0 +1,18 @@
+<?php
+
+final class ProjectBuilder
+{
+    public function __invoke(
+        FixtureContainer $container,
+        string $name,
+        string $organisation
+    ): Project
+    {
+        return new Project(
+            Uuid::v4(),
+            $container->get(Organisation::class, $organisation),
+            $name
+        );
+    }
+}
+
diff --git a/Context.php b/Context.php
@@ -0,0 +1,40 @@
+<?php
+
+class OrganisationContext implements Context
+{
+    /**
+     * Fixture container is similar to a service container, but for class instances.
+     */
+    public function __construct(private FixtureContainer $fixture)
+    {
+    }
+
+    #[Given('I have an organisation :name')]
+    public function iHaveAnOrganisation(string $name): void
+    {
+        // register a _named_ fixture for this class
+        // a _Builder_ must be registered for the class and the parameters
+        // are passed to its __invoke method
+        $this->fixture->register(Organisation::class, $name, [
+            'name' => $name
+        ]);
+    }
+
+    #[Given('I have a project :project in organisation :organisation')]
+    public function iHaveAProject(string $project, string $organisation): void
+    {
+        // the Builders also get the FixtureContainer so can retrieve dependencies
+        // (in this case the organisation by the name we previously registered)
+        $this->fixture->register(Project::class, $project, [
+            'name' => $project,
+            'organisation' => $organisation
+        ]);
+    }
+
+    #[When('I upload an artifact to project :name')]
+    public function iUploadAnArtifactToThatProject(string $project): void
+    {
+        // calling `get` will lazily invoke the Builders
+        $project = $this->fixture->get(Project::class, $project);
+    }
+}