Add deletion helper to reduce complexity

CHANGELOG.md

@@ -10,6 +10,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added support for Shopware 6.6
 - Added `--dry` option to all fixture load commands
     - This option will prevent the fixtures from being executed but still prints all fixtures it would execute
+- Added new DatabaseUtils with a few helpful methods:
+  - `deleteEntities` takes an entity name and criteria and deletes all entities which match the criteria
 
 ### Changed
 - Changed argument type on `SalesChannelUtils::getTax()` from `int` to `float`
@@ -19,6 +21,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `FixtureTrait::runSpecificFixtures` is an alias to run specific fixtures with optionally dependencies
   - `FixtureTrait::runSingleFixture` (before `FixtureTrait::runSingleFixtureWithDependencies`) with dependencies can now be configured as the second parameter
   - `FixtureTrait::runFixtureGroup` is a new function to execute whole fixture groups with optionally dependencies
+- Each fixture now has direct access to the FixtureHelper using `$this->helper`
+  - **Breaking** If you have the helper (or any other helper) previously assigned to `$this->helper` it will either fail or override the FixturePlugin helper
 
 ### Removed
 - Dropped support for PHP 8.1

src/Fixture.php

@@ -6,6 +6,8 @@
 
 abstract class Fixture
 {
+    protected FixtureHelper $helper;
+
     abstract public function load(): void;
 
     /** @return string[] */
@@ -24,4 +26,12 @@ public function groups(): array
     {
         return [];
     }
+
+    /**
+     * @internal this method should only be called from the FixtureLoader
+     */
+    final public function setHelper(FixtureHelper $helper): void
+    {
+        $this->helper = $helper;
+    }
 }

src/FixtureHelper.php

@@ -7,6 +7,7 @@
 use Basecom\FixturePlugin\Utils\CategoryUtils;
 use Basecom\FixturePlugin\Utils\CmsUtils;
 use Basecom\FixturePlugin\Utils\CustomerUtils;
+use Basecom\FixturePlugin\Utils\DatabaseUtils;
 use Basecom\FixturePlugin\Utils\MediaUtils;
 use Basecom\FixturePlugin\Utils\PaymentMethodUtils;
 use Basecom\FixturePlugin\Utils\SalesChannelUtils;
@@ -22,6 +23,7 @@ public function __construct(
         private PaymentMethodUtils $paymentMethodUtils,
         private ShippingMethodUtils $shippingMethodUtils,
         private CustomerUtils $customerUtils,
+        private DatabaseUtils $databaseUtils,
     ) {
     }
 
@@ -87,4 +89,13 @@ public function ShippingMethod(): ShippingMethodUtils
     {
         return $this->shippingMethodUtils;
     }
+
+    /**
+     * Use this to access the general database helper functions
+     * of the fixture helper class.
+     */
+    public function Database(): DatabaseUtils
+    {
+        return $this->databaseUtils;
+    }
 }

src/FixtureLoader.php

@@ -14,8 +14,10 @@ class FixtureLoader
     /**
      * @param \Traversable<Fixture> $fixtures
      */
-    public function __construct(\Traversable $fixtures)
-    {
+    public function __construct(
+        \Traversable $fixtures,
+        private readonly FixtureHelper $helper,
+    ) {
         $this->fixtures = iterator_to_array($fixtures);
     }
 
@@ -177,6 +179,7 @@ private function runFixtures(FixtureOption $option, array $fixtures, ?SymfonySty
                 continue;
             }
 
+            $fixture->setHelper($this->helper);
             $fixture->load();
         }
     }

src/Utils/DatabaseUtils.php

@@ -0,0 +1,31 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Basecom\FixturePlugin\Utils;
+
+use Shopware\Core\Framework\Context;
+use Shopware\Core\Framework\DataAbstractionLayer\DefinitionInstanceRegistry;
+use Shopware\Core\Framework\DataAbstractionLayer\Search\Criteria;
+
+readonly class DatabaseUtils
+{
+    public function __construct(
+        private DefinitionInstanceRegistry $definitionInstanceRegistry,
+    ) {
+    }
+
+    public function deleteEntities(string $entity, Criteria $criteria): void
+    {
+        $repository = $this->definitionInstanceRegistry->getRepository($entity);
+
+        // First load all the ids of the entities
+        $ids = $repository->searchIds($criteria, Context::createDefaultContext())->getData();
+
+        // Delete all entities with the IDs
+        $repository->delete(
+            array_values($ids),
+            Context::createDefaultContext(),
+        );
+    }
+}