Add --fake flag to seeds run and --seed option to seeds reset

dereuromark · dereuromark · commit 0a5febc1ec45 · 2026-01-02T20:57:11.000+01:00
- Add --fake flag to mark seeds as executed without running them
- Add --seed option to seeds reset for selective seed reset
- Both features mirror similar functionality in migrations
diff --git a/src/Command/SeedCommand.php b/src/Command/SeedCommand.php
@@ -92,6 +92,10 @@ public function buildOptionParser(ConsoleOptionParser $parser): ConsoleOptionPar
                 'short' => 'f',
                 'help' => 'Force re-running seeds that have already been executed',
                 'boolean' => true,
+            ])
+            ->addOption('fake', [
+                'help' => 'Mark seeds as executed without actually running them',
+                'boolean' => true,
             ]);
 
         return $parser;
@@ -153,9 +157,14 @@ protected function executeSeeds(Arguments $args, ConsoleIo $io): ?int
 
         $versionOrder = $config->getVersionOrder();
 
+        $fake = (bool)$args->getOption('fake');
+
         if ($config->isDryRun()) {
             $io->info('DRY-RUN mode enabled');
         }
+        if ($fake) {
+            $io->warning('performing fake seeding');
+        }
         $io->verbose('<info>using connection</info> ' . (string)$args->getOption('connection'));
         $io->verbose('<info>using paths</info> ' . $config->getMigrationPath());
         $io->verbose('<info>ordering by</info> ' . $versionOrder . ' time');
@@ -208,11 +217,11 @@ protected function executeSeeds(Arguments $args, ConsoleIo $io): ?int
             }
 
             // run all the seed(ers)
-            $manager->seed(null, (bool)$args->getOption('force'));
+            $manager->seed(null, (bool)$args->getOption('force'), $fake);
         } else {
             // run seed(ers) specified as arguments
             foreach ($seeds as $seed) {
-                $manager->seed(trim($seed), (bool)$args->getOption('force'));
+                $manager->seed(trim($seed), (bool)$args->getOption('force'), $fake);
             }
         }
         $end = microtime(true);
diff --git a/src/Command/SeedResetCommand.php b/src/Command/SeedResetCommand.php
@@ -48,8 +48,12 @@ public function buildOptionParser(ConsoleOptionParser $parser): ConsoleOptionPar
             'allowing seeds to be re-run without the --force flag.',
             '',
             '<info>seeds reset</info>',
+            '<info>seeds reset --seed Users</info>',
+            '<info>seeds reset --seed Users,Posts</info>',
             '<info>seeds reset --plugin Demo</info>',
             '<info>seeds reset -c secondary</info>',
+        ])->addOption('seed', [
+            'help' => 'Comma-separated list of specific seeds to reset. Resets all seeds if not specified.',
         ])->addOption('plugin', [
             'short' => 'p',
             'help' => 'The plugin to reset seeds for',
@@ -99,9 +103,25 @@ public function execute(Arguments $args, ConsoleIo $io): ?int
         $seeds = $manager->getSeeds();
         $adapter = $manager->getEnvironment()->getAdapter();
 
-        // Reset all seeds
+        // Filter seeds if --seed option is specified
+        $seedOption = $args->getOption('seed');
         $seedsToReset = $seeds;
 
+        if ($seedOption) {
+            $requestedSeeds = array_map('trim', explode(',', (string)$seedOption));
+            $seedsToReset = [];
+
+            foreach ($requestedSeeds as $requestedSeed) {
+                $normalizedName = $manager->normalizeSeedName($requestedSeed, $seeds);
+                if ($normalizedName === null) {
+                    $io->error("Seed `{$requestedSeed}` does not exist.");
+
+                    return self::CODE_ERROR;
+                }
+                $seedsToReset[$normalizedName] = $seeds[$normalizedName];
+            }
+        }
+
         if (empty($seedsToReset)) {
             $io->warning('No seeds to reset.');
 
@@ -110,7 +130,8 @@ public function execute(Arguments $args, ConsoleIo $io): ?int
 
         // Show what will be reset and ask for confirmation
         $io->out('');
-        $io->out('<info>All seeds will be reset:</info>');
+        $resetAllMessage = $seedOption ? '<info>The following seeds will be reset:</info>' : '<info>All seeds will be reset:</info>';
+        $io->out($resetAllMessage);
         foreach ($seedsToReset as $seed) {
             $seedName = $seed->getName();
             if (str_ends_with($seedName, 'Seed')) {
diff --git a/src/Migration/Manager.php b/src/Migration/Manager.php
@@ -540,9 +540,10 @@ public function executeMigration(MigrationInterface $migration, string $directio
      *
      * @param \Migrations\SeedInterface $seed Seed
      * @param bool $force Force re-execution even if seed has already been executed
+     * @param bool $fake Record seed as executed without actually running it
      * @return void
      */
-    public function executeSeed(SeedInterface $seed, bool $force = false): void
+    public function executeSeed(SeedInterface $seed, bool $force = false, bool $fake = false): void
     {
         $this->getIo()->out('');
 
@@ -560,6 +561,26 @@ public function executeSeed(SeedInterface $seed, bool $force = false): void
             return;
         }
 
+        // Ensure seed schema table exists
+        $adapter = $this->getEnvironment()->getAdapter();
+        if (!$adapter->hasTable($adapter->getSeedSchemaTableName())) {
+            $adapter->createSeedSchemaTable();
+        }
+
+        if ($fake) {
+            // Record seed as executed without running it
+            $this->printSeedStatus($seed, 'faking');
+
+            if (!$seed->isIdempotent()) {
+                $executedTime = date('Y-m-d H:i:s');
+                $adapter->seedExecuted($seed, $executedTime);
+            }
+
+            $this->printSeedStatus($seed, 'faked');
+
+            return;
+        }
+
         // Auto-execute missing dependencies
         $missingDeps = $this->getSeedDependenciesNotExecuted($seed);
         if (!empty($missingDeps)) {
@@ -568,18 +589,12 @@ public function executeSeed(SeedInterface $seed, bool $force = false): void
                     '  Auto-executing dependency: %s',
                     $depSeed->getName(),
                 ));
-                $this->executeSeed($depSeed, $force);
+                $this->executeSeed($depSeed, $force, $fake);
             }
         }
 
         $this->printSeedStatus($seed, 'seeding');
 
-        // Ensure seed schema table exists
-        $adapter = $this->getEnvironment()->getAdapter();
-        if (!$adapter->hasTable($adapter->getSeedSchemaTableName())) {
-            $adapter->createSeedSchemaTable();
-        }
-
         // Execute the seeder and log the time elapsed.
         $start = microtime(true);
         $this->getEnvironment()->executeSeed($seed);
@@ -794,25 +809,26 @@ public function rollback(int|string|null $target = null, bool $force = false, bo
      *
      * @param string|null $seed Seeder
      * @param bool $force Force re-execution even if seed has already been executed
+     * @param bool $fake Record seed as executed without actually running it
      * @throws \InvalidArgumentException
      * @return void
      */
-    public function seed(?string $seed = null, bool $force = false): void
+    public function seed(?string $seed = null, bool $force = false, bool $fake = false): void
     {
         $seeds = $this->getSeeds();
 
         if ($seed === null) {
             // run all seeders
             foreach ($seeds as $seeder) {
                 if (array_key_exists($seeder->getName(), $seeds)) {
-                    $this->executeSeed($seeder, $force);
+                    $this->executeSeed($seeder, $force, $fake);
                 }
             }
         } else {
             // run only one seeder
             $normalizedName = $this->normalizeSeedName($seed, $seeds);
             if ($normalizedName !== null) {
-                $this->executeSeed($seeds[$normalizedName], $force);
+                $this->executeSeed($seeds[$normalizedName], $force, $fake);
             } else {
                 throw new InvalidArgumentException(sprintf('The seed `%s` does not exist', $seed));
             }
diff --git a/tests/TestCase/Command/SeedCommandTest.php b/tests/TestCase/Command/SeedCommandTest.php
@@ -570,4 +570,125 @@ public function testNonIdempotentSeedIsTracked(): void
         $this->assertOutputContains('already executed');
         $this->assertOutputNotContains('seeding');
     }
+
+    public function testFakeSeedMarksAsExecuted(): void
+    {
+        $this->createTables();
+
+        /** @var \Cake\Database\Connection $connection */
+        $connection = ConnectionManager::get('test');
+
+        // Run with --fake flag
+        $this->exec('seeds run -c test NumbersSeed --fake');
+        $this->assertExitSuccess();
+        $this->assertErrorContains('performing fake seeding');
+        $this->assertOutputContains('faking');
+        $this->assertOutputContains('faked');
+        $this->assertOutputNotContains('seeding');
+
+        // Verify NO data was inserted
+        $query = $connection->execute('SELECT COUNT(*) FROM numbers');
+        $this->assertEquals(0, $query->fetchColumn(0), 'Fake seed should not insert data');
+
+        // Verify the seed WAS tracked in cake_seeds table
+        $seedLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'NumbersSeed\'');
+        $this->assertEquals(1, $seedLog->fetchColumn(0), 'Fake seeds should be tracked');
+
+        // Running again should show already executed
+        $this->exec('seeds run -c test NumbersSeed');
+        $this->assertExitSuccess();
+        $this->assertOutputContains('already executed');
+    }
+
+    public function testFakeSeedWithForce(): void
+    {
+        $this->createTables();
+
+        /** @var \Cake\Database\Connection $connection */
+        $connection = ConnectionManager::get('test');
+
+        // Run with --fake first
+        $this->exec('seeds run -c test NumbersSeed --fake');
+        $this->assertExitSuccess();
+
+        // Verify seed is tracked
+        $seedLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'NumbersSeed\'');
+        $this->assertEquals(1, $seedLog->fetchColumn(0));
+
+        // Run with --force to actually execute it
+        $this->exec('seeds run -c test NumbersSeed --force');
+        $this->assertExitSuccess();
+        $this->assertOutputContains('seeding');
+
+        // Verify data was inserted
+        $query = $connection->execute('SELECT COUNT(*) FROM numbers');
+        $this->assertEquals(1, $query->fetchColumn(0));
+    }
+
+    public function testResetSpecificSeed(): void
+    {
+        $this->createTables();
+
+        /** @var \Cake\Database\Connection $connection */
+        $connection = ConnectionManager::get('test');
+
+        // Run two seeds
+        $this->exec('seeds run -c test NumbersSeed');
+        $this->assertExitSuccess();
+
+        $this->exec('seeds run -c test StoresSeed');
+        $this->assertExitSuccess();
+
+        // Verify both are tracked
+        $numbersLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'NumbersSeed\'');
+        $this->assertEquals(1, $numbersLog->fetchColumn(0));
+
+        $storesLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'StoresSeed\'');
+        $this->assertEquals(1, $storesLog->fetchColumn(0));
+
+        // Reset only Numbers seed
+        $this->exec('seeds reset -c test --seed Numbers', ['y']);
+        $this->assertExitSuccess();
+        $this->assertOutputContains('The following seeds will be reset:');
+        $this->assertOutputNotContains('All seeds will be reset:');
+
+        // Verify Numbers is reset but Stores is still tracked
+        $numbersLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'NumbersSeed\'');
+        $this->assertEquals(0, $numbersLog->fetchColumn(0), 'Numbers seed should be reset');
+
+        $storesLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'StoresSeed\'');
+        $this->assertEquals(1, $storesLog->fetchColumn(0), 'Stores seed should still be tracked');
+    }
+
+    public function testResetMultipleSpecificSeeds(): void
+    {
+        $this->createTables();
+
+        /** @var \Cake\Database\Connection $connection */
+        $connection = ConnectionManager::get('test');
+
+        // Run seeds
+        $this->exec('seeds run -c test NumbersSeed');
+        $this->exec('seeds run -c test StoresSeed');
+
+        // Reset both with comma-separated list
+        $this->exec('seeds reset -c test --seed Numbers,Stores', ['y']);
+        $this->assertExitSuccess();
+
+        // Verify both are reset
+        $numbersLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'NumbersSeed\'');
+        $this->assertEquals(0, $numbersLog->fetchColumn(0));
+
+        $storesLog = $connection->execute('SELECT COUNT(*) FROM cake_seeds WHERE seed_name = \'StoresSeed\'');
+        $this->assertEquals(0, $storesLog->fetchColumn(0));
+    }
+
+    public function testResetNonExistentSeed(): void
+    {
+        $this->createTables();
+
+        $this->exec('seeds reset -c test --seed NonExistent');
+        $this->assertExitError();
+        $this->assertErrorContains('Seed `NonExistent` does not exist');
+    }
 }
