RecipeCommandTest.php

<?php

declare (strict_types=1);
namespace Drupal\FunctionalTests\Core\Recipe;

use Drupal\contact\Entity\ContactForm;
use Drupal\Core\Config\Checkpoint\Checkpoint;
use Drupal\Tests\BrowserTestBase;

/**
 * Tests recipe command.
 *
 * BrowserTestBase is used for a proper Drupal install.
 *
 * @coversDefaultClass \Drupal\Core\Recipe\RecipeCommand
 * @group Recipe
 */
class RecipeCommandTest extends BrowserTestBase {
  use RecipeTestTrait;
  
  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';
  
  /**
   * {@inheritdoc}
   *
   * Disable strict config schema because this test explicitly makes the
   * recipe system save invalid config, to prove that it validates it after
   * the fact and raises an error.
   */
  protected $strictConfigSchema = FALSE;
  public function testRecipeCommand() : void {
    $this->assertFalse(\Drupal::moduleHandler()->moduleExists('node'), 'The node module is not installed');
    $this->assertCheckpointsExist([]);
    $process = $this->applyRecipe('core/tests/fixtures/recipes/install_node_with_config');
    $this->assertSame(0, $process->getExitCode());
    $this->assertStringContainsString("Applied Install node with config recipe.", $process->getErrorOutput());
    $this->assertStringContainsString('Install node with config applied successfully', $process->getOutput());
    $this->assertTrue(\Drupal::moduleHandler()->moduleExists('node'), 'The node module is installed');
    $this->assertCheckpointsExist([
      "Backup before the 'Install node with config' recipe.",
    ]);
    // Ensure recipes can be applied without affecting pre-existing checkpoints.
    $process = $this->applyRecipe('core/tests/fixtures/recipes/install_two_modules');
    $this->assertSame(0, $process->getExitCode());
    $this->assertStringContainsString("Applied Install two modules recipe.", $process->getErrorOutput());
    $this->assertStringContainsString('Install two modules applied successfully', $process->getOutput());
    $this->assertTrue(\Drupal::moduleHandler()->moduleExists('node'), 'The node module is installed');
    $this->assertCheckpointsExist([
      "Backup before the 'Install node with config' recipe.",
      "Backup before the 'Install two modules' recipe.",
    ]);
    // Ensure recipes that fail have an exception message.
    $process = $this->applyRecipe('core/tests/fixtures/recipes/invalid_config', 1);
    $this->assertStringContainsString("There were validation errors in core.date_format.invalid", $process->getErrorOutput());
    $this->assertCheckpointsExist([
      "Backup before the 'Install node with config' recipe.",
      "Backup before the 'Install two modules' recipe.",
    ]);
    // Create a checkpoint so we can test what happens when a recipe does not
    // create a checkpoint before applying.
    \Drupal::service('config.storage.checkpoint')->checkpoint('Test log message');
    $process = $this->applyRecipe('core/tests/fixtures/recipes/no_extensions');
    $this->assertSame(0, $process->getExitCode());
    $this->assertStringContainsString("Applied No extensions recipe.", $process->getErrorOutput());
    $this->assertCheckpointsExist([
      "Backup before the 'Install node with config' recipe.",
      "Backup before the 'Install two modules' recipe.",
      "Test log message",
    ]);
    $this->assertStringContainsString('[notice] A backup checkpoint was not created because nothing has changed since the "Test log message" checkpoint was created.', $process->getOutput());
  }
  
  /**
   * Tests that errors during config rollback won't steamroll validation errors.
   */
  public function testExceptionOnRollback() : void {
    $process = $this->applyRecipe('core/tests/fixtures/recipes/config_rollback_exception', 1);
    // The error from the config importer should be visible.
    $output = $process->getOutput();
    $this->assertStringContainsString('There were errors validating the config synchronization.', $output);
    $this->assertStringContainsString('Provides a filter plugin that is in use', $output);
    // And the exception that actually *caused* the error should be visible too.
    $this->assertStringContainsString('There were validation errors in system.image:', $process->getErrorOutput());
  }
  
  /**
   * Tests the recipe command with a non-existent directory.
   */
  public function testErrorOnNonExistentDirectory() : void {
    $process = $this->applyRecipe('core/tests/fixtures/recipes/does_not_exist', 1);
    // The directory error should be the only error visible.
    $output = trim(preg_replace('/\\s+/', ' ', $process->getOutput()));
    $this->assertSame('[ERROR] The supplied path core/tests/fixtures/recipes/does_not_exist is not a directory', $output);
    $this->assertEmpty($process->getErrorOutput());
  }
  
  /**
   * Asserts that the current set of checkpoints matches the given labels.
   *
   * @param string[] $expected_labels
   *   The labels of every checkpoint that is expected to exist currently, in
   *   the expected order.
   */
  private function assertCheckpointsExist(array $expected_labels) : void {
    $checkpoints = \Drupal::service('config.checkpoints');
    $labels = array_map(fn(Checkpoint $c) => $c->label, iterator_to_array($checkpoints));
    $this->assertSame($expected_labels, array_values($labels));
  }
  public function testPassInput() : void {
    $dir = $this->getDrupalRoot() . '/core/recipes/feedback_contact_form';
    $this->applyRecipe($dir, options: [
      '--input=feedback_contact_form.recipient=hello@good.bye',
    ]);
    $this->assertSame([
      'hello@good.bye',
    ], ContactForm::load('feedback')?->getRecipients());
  }
  public function testPassInvalidInput() : void {
    $dir = $this->getDrupalRoot() . '/core/recipes/feedback_contact_form';
    $process = $this->applyRecipe($dir, 1, options: [
      '--input=feedback_contact_form.recipient=nobody',
    ]);
    $this->assertStringContainsString('This value is not a valid email address.', $process->getErrorOutput());
  }
  public function testDefaultInputValueFromConfig() : void {
    $this->config('system.site')
      ->set('mail', 'goodbye@hello.net')
      ->save();
    $this->applyRecipe($this->getDrupalRoot() . '/core/recipes/feedback_contact_form');
    $this->assertSame([
      'goodbye@hello.net',
    ], ContactForm::load('feedback')?->getRecipients());
  }
  public function testListInputs() : void {
    $root = $this->getDrupalRoot();
    $output = $this->applyRecipe($root . '/core/recipes/feedback_contact_form', command: 'recipe:info')
      ->getOutput();
    $this->assertStringContainsString('feedback_contact_form.recipient', $output);
    $this->assertStringContainsString('The email address that should receive submissions from the feedback form.', $output);
    $output = $this->applyRecipe($root . '/core/recipes/page_content_type', command: 'recipe:info')
      ->getOutput();
    $this->assertStringContainsString('This recipe does not accept any input.', $output);
  }

}