ExperimentalModuleTest.php in Drupal 8

Namespace

Drupal\Tests\system\Functional\Module

File

core/modules/system/tests/src/Functional/Module/ExperimentalModuleTest.php

<?php

namespace Drupal\Tests\system\Functional\Module;

use Drupal\Tests\BrowserTestBase;

/**
 * Tests the installation of modules.
 *
 * @group Module
 */
class ExperimentalModuleTest extends BrowserTestBase {

  /**
   * The admin user.
   *
   * @var \Drupal\user\UserInterface
   */
  protected $adminUser;

  /**
   * {@inheritdoc}
   */
  protected $defaultTheme = 'stark';

  /**
   * {@inheritdoc}
   */
  protected function setUp() {
    parent::setUp();
    $this->adminUser = $this
      ->drupalCreateUser([
      'access administration pages',
      'administer modules',
    ]);
    $this
      ->drupalLogin($this->adminUser);
  }

  /**
   * Tests installing experimental modules and dependencies in the UI.
   */
  public function testExperimentalConfirmForm() {

    // First, test installing a non-experimental module with no dependencies.
    // There should be no confirmation form and no experimental module warning.
    $edit = [];
    $edit["modules[test_page_test][enable]"] = TRUE;
    $this
      ->drupalPostForm('admin/modules', $edit, t('Install'));
    $this
      ->assertText('Module Test page has been enabled.');
    $this
      ->assertNoText('Experimental modules are provided for testing purposes only.');

    // Uninstall the module.
    \Drupal::service('module_installer')
      ->uninstall([
      'test_page_test',
    ]);

    // Next, test installing an experimental module with no dependencies.
    // There should be a confirmation form with an experimental warning, but no
    // list of dependencies.
    $edit = [];
    $edit["modules[experimental_module_test][enable]"] = TRUE;
    $this
      ->drupalPostForm('admin/modules', $edit, 'Install');

    // The module should not be enabled and there should be a warning and a
    // list of the experimental modules with only this one.
    $this
      ->assertNoText('Experimental Test has been enabled.');
    $this
      ->assertText('Experimental modules are provided for testing purposes only.');
    $this
      ->assertText('The following modules are experimental: Experimental Test');

    // There should be no message about enabling dependencies.
    $this
      ->assertNoText('You must enable');

    // Enable the module and confirm that it worked.
    $this
      ->drupalPostForm(NULL, [], 'Continue');
    $this
      ->assertText('Experimental Test has been enabled.');

    // Uninstall the module.
    \Drupal::service('module_installer')
      ->uninstall([
      'experimental_module_test',
    ]);

    // Test enabling a module that is not itself experimental, but that depends
    // on an experimental module.
    $edit = [];
    $edit["modules[experimental_module_dependency_test][enable]"] = TRUE;
    $this
      ->drupalPostForm('admin/modules', $edit, 'Install');

    // The module should not be enabled and there should be a warning and a
    // list of the experimental modules with only this one.
    $this
      ->assertNoText('2 modules have been enabled: Experimental Dependency Test, Experimental Test');
    $this
      ->assertText('Experimental modules are provided for testing purposes only.');
    $this
      ->assertText('The following modules are experimental: Experimental Test');

    // Ensure the non-experimental module is not listed as experimental.
    $this
      ->assertNoText('The following modules are experimental: Experimental Test, Experimental Dependency Test');
    $this
      ->assertNoText('The following modules are experimental: Experimental Dependency Test');

    // There should be a message about enabling dependencies.
    $this
      ->assertText('You must enable the Experimental Test module to install Experimental Dependency Test');

    // Enable the module and confirm that it worked.
    $this
      ->drupalPostForm(NULL, [], 'Continue');
    $this
      ->assertText('2 modules have been enabled: Experimental Dependency Test, Experimental Test');

    // Uninstall the modules.
    \Drupal::service('module_installer')
      ->uninstall([
      'experimental_module_test',
      'experimental_module_dependency_test',
    ]);

    // Finally, check both the module and its experimental dependency. There is
    // still a warning about experimental modules, but no message about
    // dependencies, since the user specifically enabled the dependency.
    $edit = [];
    $edit["modules[experimental_module_test][enable]"] = TRUE;
    $edit["modules[experimental_module_dependency_test][enable]"] = TRUE;
    $this
      ->drupalPostForm('admin/modules', $edit, 'Install');

    // The module should not be enabled and there should be a warning and a
    // list of the experimental modules with only this one.
    $this
      ->assertNoText('2 modules have been enabled: Experimental Dependency Test, Experimental Test');
    $this
      ->assertText('Experimental modules are provided for testing purposes only.');
    $this
      ->assertText('The following modules are experimental: Experimental Test');

    // Ensure the non-experimental module is not listed as experimental.
    $this
      ->assertNoText('The following modules are experimental: Experimental Dependency Test, Experimental Test');
    $this
      ->assertNoText('The following modules are experimental: Experimental Dependency Test');

    // There should be no message about enabling dependencies.
    $this
      ->assertNoText('You must enable');

    // Enable the module and confirm that it worked.
    $this
      ->drupalPostForm(NULL, [], 'Continue');
    $this
      ->assertText('2 modules have been enabled: Experimental Dependency Test, Experimental Test');

    // Try to enable an experimental module that can not be due to
    // hook_requirements().
    \Drupal::state()
      ->set('experimental_module_requirements_test_requirements', TRUE);
    $edit = [];
    $edit["modules[experimental_module_requirements_test][enable]"] = TRUE;
    $this
      ->drupalPostForm('admin/modules', $edit, 'Install');
    $this
      ->assertUrl('admin/modules', [], 'If the module can not be installed we are not taken to the confirm form.');
    $this
      ->assertText('The Experimental Test Requirements module can not be installed.');
  }

}

Classes

Name	Description
ExperimentalModuleTest	Tests the installation of modules.