NonStableModulesTest.php

<?php

namespace Drupal\Tests\system\Functional\Module;

use Drupal\Tests\BrowserTestBase;

/**
 * Tests the installation of deprecated and experimental modules.
 *
 * @group Module
 */
class NonStableModulesTest extends BrowserTestBase {
    
    /**
     * The admin user.
     *
     * @var \Drupal\user\UserInterface
     */
    protected $adminUser;
    
    /**
     * {@inheritdoc}
     */
    protected $defaultTheme = 'stark';
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        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() : void {
        // 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->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        $this->assertSession()
            ->pageTextContains('Module Test page has been enabled.');
        $this->assertSession()
            ->pageTextNotContains('Experimental modules are provided for testing purposes only.');
        // There should be no warning about enabling experimental or deprecated
        // modules, since there's no confirmation form.
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable ');
        // 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->drupalGet('admin/modules');
        $this->submitForm($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->assertSession()
            ->pageTextNotContains('Experimental Test has been enabled.');
        $this->assertSession()
            ->pageTextContains('Experimental modules are provided for testing purposes only.');
        $this->assertSession()
            ->pageTextContains('The following module is experimental: Experimental Test');
        // There should be a warning about enabling experimental modules, but no
        // warnings about deprecated modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // There should be no message about enabling dependencies.
        $this->assertSession()
            ->pageTextNotContains('You must enable');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $this->assertSession()
            ->pageTextContains('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->drupalGet('admin/modules');
        $this->submitForm($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->assertSession()
            ->pageTextNotContains('2 modules have been enabled: Experimental Dependency Test, Experimental Test');
        $this->assertSession()
            ->pageTextContains('Experimental modules are provided for testing purposes only.');
        $this->assertSession()
            ->pageTextContains('The following module is experimental: Experimental Test');
        // There should be a warning about enabling experimental modules, but no
        // warnings about deprecated modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // Ensure the non-experimental module is not listed as experimental.
        $this->assertSession()
            ->pageTextNotContains('The following modules are experimental: Experimental Test, Experimental Dependency Test');
        $this->assertSession()
            ->pageTextNotContains('The following module is experimental: Experimental Dependency Test');
        // There should be a message about enabling dependencies.
        $this->assertSession()
            ->pageTextContains('You must enable the Experimental Test module to install Experimental Dependency Test');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $this->assertSession()
            ->pageTextContains('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->drupalGet('admin/modules');
        $this->submitForm($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->assertSession()
            ->pageTextNotContains('2 modules have been enabled: Experimental Dependency Test, Experimental Test');
        $this->assertSession()
            ->pageTextContains('Experimental modules are provided for testing purposes only.');
        $this->assertSession()
            ->pageTextContains('The following module is experimental: Experimental Test');
        // There should be a warning about enabling experimental modules, but no
        // warnings about deprecated modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // Ensure the non-experimental module is not listed as experimental.
        $this->assertSession()
            ->pageTextNotContains('The following modules are experimental: Experimental Dependency Test, Experimental Test');
        $this->assertSession()
            ->pageTextNotContains('The following module is experimental: Experimental Dependency Test');
        // There should be no message about enabling dependencies.
        $this->assertSession()
            ->pageTextNotContains('You must enable');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $this->assertSession()
            ->pageTextContains('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->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // Verify that if the module can not be installed, we are not taken to the
        // confirm form.
        $this->assertSession()
            ->addressEquals('admin/modules');
        $this->assertSession()
            ->pageTextContains('The Experimental Test Requirements module can not be installed.');
    }
    
    /**
     * Tests installing deprecated modules and dependencies in the UI.
     *
     * @group legacy
     */
    public function testDeprecatedConfirmForm() : void {
        // Test installing a deprecated module with no dependencies. There should be
        // a confirmation form with a deprecated warning, but no list of
        // dependencies.
        $edit = [];
        $edit["modules[deprecated_module][enable]"] = TRUE;
        $this->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // The module should not be enabled and there should be a warning and a
        // list of the deprecated modules with only this one.
        $assert = $this->assertSession();
        $assert->pageTextNotContains('Deprecated module has been enabled.');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core. Use at your own risk.');
        $assert->pageTextContains('The Deprecated module module is deprecated');
        $more_information_link = $assert->elementExists('named', [
            'link',
            'The Deprecated module module is deprecated. (more information)',
        ]);
        $this->assertEquals('http://example.com/deprecated', $more_information_link->getAttribute('href'));
        // There should be a warning about enabling deprecated modules, but no
        // warnings about experimental modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // There should be no message about enabling dependencies.
        $assert->pageTextNotContains('You must enable');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $assert->pageTextContains('Deprecated module has been enabled.');
        // Uninstall the module.
        \Drupal::service('module_installer')->uninstall([
            'deprecated_module',
        ]);
        // Test enabling a module that is not itself deprecated, but that depends on
        // a deprecated module.
        $edit = [];
        $edit["modules[deprecated_module_dependency][enable]"] = TRUE;
        $this->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // The module should not be enabled and there should be a warning and a
        // list of the deprecated modules with only this one.
        $assert->pageTextNotContains('2 modules have been enabled: Deprecated module dependency, Deprecated module');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core. Use at your own risk.');
        $assert->pageTextContains('The Deprecated module module is deprecated');
        // There should be a warning about enabling deprecated modules, but no
        // warnings about experimental modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // Ensure the non-deprecated module is not listed as deprecated.
        $assert->pageTextNotContains('The Deprecated module dependency module is deprecated');
        // There should be a message about enabling dependencies.
        $assert->pageTextContains('You must enable the Deprecated module module to install Deprecated module dependency');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $assert->pageTextContains('2 modules have been enabled: Deprecated module dependency, Deprecated module');
        // Uninstall the modules.
        \Drupal::service('module_installer')->uninstall([
            'deprecated_module',
            'deprecated_module_dependency',
        ]);
        // Check a deprecated module with a non-deprecated dependency.
        $edit = [];
        $edit["modules[deprecated_module_with_non_deprecated_dependency][enable]"] = TRUE;
        $this->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // The module should not be enabled and there should be a warning and a
        // list of the deprecated modules with only this one.
        $assert->pageTextNotContains('2 modules have been enabled: Deprecated module with non deprecated dependency, Drupal system listing compatible test');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core. Use at your own risk.');
        $assert->pageTextContains('The Deprecated module with non deprecated dependency module is deprecated');
        $more_information_link = $assert->elementExists('named', [
            'link',
            'The Deprecated module with non deprecated dependency module is deprecated. (more information)',
        ]);
        $this->assertEquals('http://example.com/deprecated', $more_information_link->getAttribute('href'));
        // There should be a warning about enabling deprecated modules, but no
        // warnings about experimental modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // Ensure the non-deprecated dependency module is not listed as deprecated.
        $assert->pageTextNotContains('The Drupal system listing compatible test module is deprecated');
        // There should be a message about enabling dependencies.
        $assert->pageTextContains('You must enable the Drupal system listing compatible test module to install Deprecated module with non deprecated dependency.');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $assert->pageTextContains('2 modules have been enabled: Deprecated module with non deprecated dependency, Drupal system listing compatible test.');
        // Uninstall the modules.
        \Drupal::service('module_installer')->uninstall([
            'deprecated_module_with_non_deprecated_dependency',
            'drupal_system_listing_compatible_test',
        ]);
        // Check both the module and its deprecated dependency. There is still a
        // warning about deprecated modules, but no message about dependencies,
        // since the user specifically enabled the dependency.
        $edit = [];
        $edit["modules[deprecated_module_dependency][enable]"] = TRUE;
        $edit["modules[deprecated_module][enable]"] = TRUE;
        $this->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // The module should not be enabled and there should be a warning and a
        // list of the deprecated modules with only this one.
        $assert->pageTextNotContains('2 modules have been enabled: Deprecated module dependency, Deprecated module');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core. Use at your own risk.');
        $assert->pageTextContains('The Deprecated module module is deprecated');
        // There should be a warning about enabling deprecated modules, but no
        // warnings about experimental modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable a deprecated module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable an experimental module?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental and deprecated modules?');
        // Ensure the non-deprecated module is not listed as deprecated.
        $assert->pageTextNotContains('The Deprecated module dependency module is deprecated');
        // There should be no message about enabling dependencies.
        $assert->pageTextNotContains('You must enable');
        // Enable the modules and confirm that it worked.
        $this->submitForm([], 'Continue');
        $assert->pageTextContains('2 modules have been enabled: Deprecated module, Deprecated module dependency');
        \Drupal::service('module_installer')->uninstall([
            'deprecated_module',
            'deprecated_module_dependency',
        ]);
        // Now, test when installing a non-core deprecated module alone and then
        // with a core deprecated module. First, install 'deprecated_module_test'
        // because it uses hook_system_info_alter() to set the origin of
        // 'deprecated_module_contrib' to something other than 'core'.
        $this->drupalGet('admin/modules');
        $this->submitForm([
            "modules[deprecated_module_test][enable]" => TRUE,
        ], 'Install');
        $assert->pageTextContains('Module Deprecated module test has been enabled.');
        // Test installing a non-core deprecated module. There should be a
        // confirmation form with a deprecated warning for a 'project' and not for
        // Drupal core.
        $this->drupalGet('admin/modules');
        $this->submitForm([
            "modules[deprecated_module_contrib][enable]" => TRUE,
        ], 'Install');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of this project. Use at your own risk.');
        // Test installing a non-core deprecated module and a core deprecated
        // module. There should be a confirmation form with a deprecated warning for
        // both a 'project' and Drupal core.
        $this->drupalGet('admin/modules');
        $this->submitForm([
            "modules[deprecated_module_contrib][enable]" => TRUE,
            "modules[deprecated_module][enable]" => TRUE,
        ], 'Install');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core and the relevant contributed module. Use at your own risk.');
    }
    
    /**
     * Tests installing deprecated and experimental modules at the same time.
     *
     * @group legacy
     */
    public function testDeprecatedAndExperimentalConfirmForm() : void {
        $edit = [];
        $edit["modules[deprecated_module][enable]"] = TRUE;
        $edit["modules[experimental_module_test][enable]"] = TRUE;
        $this->drupalGet('admin/modules');
        $this->submitForm($edit, 'Install');
        // The module should not be enabled and there should be a warning and a
        // list of the deprecated modules with only this one.
        $assert = $this->assertSession();
        $assert->pageTextNotContains('Deprecated module has been enabled.');
        $assert->pageTextContains('Deprecated modules are modules that may be removed from the next major release of Drupal core. Use at your own risk.');
        $assert->pageTextContains('The Deprecated module module is deprecated');
        $more_information_link = $assert->elementExists('named', [
            'link',
            'The Deprecated module module is deprecated. (more information)',
        ]);
        $this->assertEquals('http://example.com/deprecated', $more_information_link->getAttribute('href'));
        // The module should not be enabled and there should be a warning and a
        // list of the experimental modules with only this one.
        $assert->pageTextNotContains('Experimental Test has been enabled.');
        $assert->pageTextContains('Experimental modules are provided for testing purposes only.');
        $assert->pageTextContains('The following module is experimental: Experimental Test');
        // There should be a warning about enabling experimental and deprecated
        // modules, but no warnings about solitary experimental or deprecated
        // modules.
        $this->assertSession()
            ->pageTextContains('Are you sure you wish to enable experimental and deprecated modules?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable experimental modules?');
        $this->assertSession()
            ->pageTextNotContains('Are you sure you wish to enable deprecated modules?');
        // There should be no message about enabling dependencies.
        $assert->pageTextNotContains('You must enable');
        // Enable the module and confirm that it worked.
        $this->submitForm([], 'Continue');
        $assert->pageTextContains('2 modules have been enabled: Deprecated module, Experimental Test.');
    }

}