You are here

Home » API reference » Drupal 10 » UpdateRegistryTest.php

class UpdateRegistryTest in Drupal 10

Same name and namespace in other branches
  1. 8 core/tests/Drupal/Tests/Core/Update/UpdateRegistryTest.php \Drupal\Tests\Core\Update\UpdateRegistryTest
  2. 9 core/tests/Drupal/Tests/Core/Update/UpdateRegistryTest.php \Drupal\Tests\Core\Update\UpdateRegistryTest

@coversDefaultClass \Drupal\Core\Update\UpdateRegistry @group Update

Note we load code, so isolate the tests.

@runTestsInSeparateProcesses @preserveGlobalState disabled

Hierarchy

  • class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Symfony\Bridge\PhpUnit\ExpectDeprecationTrait, PhpUnitWarnings

Expanded class hierarchy of UpdateRegistryTest

File

core/tests/Drupal/Tests/Core/Update/UpdateRegistryTest.php, line 21

Namespace

Drupal\Tests\Core\Update
View source 
class UpdateRegistryTest extends UnitTestCase {

  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $settings = [];
    $settings['extension_discovery_scan_tests'] = TRUE;
    new Settings($settings);
  }

  /**
   * Sets up some extensions with some update functions.
   */
  protected function setupBasicExtensions() {
    $info_a = <<<'EOS'
type: module
name: Module A
core_version_requirement: '*'
EOS;
    $info_b = <<<'EOS'
type: module
name: Module B
core_version_requirement: '*'
EOS;
    $info_c = <<<'EOS'
type: module
name: Module C
core_version_requirement: '*'
EOS;
    $info_d = <<<'EOS'
type: theme
name: Theme D
EOS;
    $module_a = <<<'EOS'
<?php

/**
 * Module A update B.
 */
function module_a_post_update_b() {
}

/**
 * Module A update A.
 */
function module_a_post_update_a() {
}

EOS;
    $module_b = <<<'EOS'
<?php

/**
 * Module B update A.
 */
function module_b_post_update_a() {
}

/**
 * Implements hook_removed_post_updates().
 */
function module_b_removed_post_updates() {
  return [
    'module_b_post_update_b' => '8.9.0',
    'module_b_post_update_c' => '8.9.0',
  ];
}

EOS;
    $module_c = <<<'EOS'
<?php

/**
 * Module C update A.
 */
function module_c_post_update_a() {
}

/**
 * Module C update B.
 */
function module_c_post_update_b() {
}

/**
 * Implements hook_removed_post_updates().
 */
function module_c_removed_post_updates() {
  return [
    'module_c_post_update_b' => '8.9.0',
    'module_c_post_update_c' => '8.9.0',
  ];
}

EOS;
    $theme_d = <<<'EOS'
<?php

/**
 * Theme D update B.
 */
function theme_d_post_update_b() {
}

/**
 * Theme D update C.
 */
function theme_d_post_update_c() {
}

/**
 * Implements hook_removed_post_updates().
 */
function theme_d_removed_post_updates() {
  return [
    'theme_d_post_update_a' => '8.9.0',
  ];
}

EOS;
    vfsStream::setup('drupal');
    vfsStream::create([
      'sites' => [
        'default' => [
          'modules' => [
            'module_a' => [
              'module_a.post_update.php' => $module_a,
              'module_a.info.yml' => $info_a,
            ],
            'module_b' => [
              'module_b.post_update.php' => $module_b,
              'module_b.info.yml' => $info_b,
            ],
            'module_c' => [
              'module_c.post_update.php' => $module_c,
              'module_c.info.yml' => $info_c,
            ],
          ],
          'themes' => [
            'theme_d' => [
              'theme_d.post_update.php' => $theme_d,
              'theme_d.info.yml' => $info_c,
            ],
          ],
        ],
      ],
    ]);
  }

  /**
   * @covers ::getPendingUpdateFunctions
   */
  public function testGetPendingUpdateFunctionsNoExistingUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([]);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $this
      ->assertEquals([
      'module_a_post_update_a',
      'module_a_post_update_b',
      'module_b_post_update_a',
      'theme_d_post_update_b',
      'theme_d_post_update_c',
    ], $update_registry
      ->getPendingUpdateFunctions());
  }

  /**
   * @covers ::getPendingUpdateFunctions
   */
  public function testGetPendingUpdateFunctionsWithLoadedModulesButNotEnabled() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([]);
    $key_value = $key_value
      ->reveal();

    // Preload modules to ensure that ::getAvailableUpdateFunctions filters out
    // not enabled modules.
    include_once 'vfs://drupal/sites/default/modules/module_a/module_a.post_update.php';
    include_once 'vfs://drupal/sites/default/modules/module_b/module_b.post_update.php';
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
    ], $key_value, FALSE);
    $this
      ->assertEquals([
      'module_a_post_update_a',
      'module_a_post_update_b',
    ], $update_registry
      ->getPendingUpdateFunctions());
  }

  /**
   * @covers ::getPendingUpdateFunctions
   */
  public function testGetPendingUpdateFunctionsExistingUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([
      'module_a_post_update_a',
      'theme_d_post_update_a',
      'theme_d_post_update_b',
    ]);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $this
      ->assertEquals(array_values([
      'module_a_post_update_b',
      'module_b_post_update_a',
      'theme_d_post_update_c',
    ]), array_values($update_registry
      ->getPendingUpdateFunctions()));
  }

  /**
   * @covers ::getPendingUpdateInformation
   */
  public function testGetPendingUpdateInformation() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([]);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $expected = [];
    $expected['module_a']['pending']['a'] = 'Module A update A.';
    $expected['module_a']['pending']['b'] = 'Module A update B.';
    $expected['module_a']['start'] = 'a';
    $expected['module_b']['pending']['a'] = 'Module B update A.';
    $expected['module_b']['start'] = 'a';
    $expected['theme_d']['pending']['b'] = 'Theme D update B.';
    $expected['theme_d']['pending']['c'] = 'Theme D update C.';
    $expected['theme_d']['start'] = 'b';
    $this
      ->assertEquals($expected, $update_registry
      ->getPendingUpdateInformation());
  }

  /**
   * @covers ::getPendingUpdateInformation
   */
  public function testGetPendingUpdateInformationWithExistingUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([
      'module_a_post_update_a',
      'theme_d_post_update_a',
      'theme_d_post_update_b',
    ]);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $expected = [];
    $expected['module_a']['pending']['b'] = 'Module A update B.';
    $expected['module_a']['start'] = 'b';
    $expected['module_b']['pending']['a'] = 'Module B update A.';
    $expected['module_b']['start'] = 'a';
    $expected['theme_d']['pending']['c'] = 'Theme D update C.';
    $expected['theme_d']['start'] = 'c';
    $this
      ->assertEquals($expected, $update_registry
      ->getPendingUpdateInformation());
  }

  /**
   * @covers ::getPendingUpdateInformation
   */
  public function testGetPendingUpdateInformationWithRemovedUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([
      'module_a_post_update_a',
    ]);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_c',
    ], $key_value, FALSE);
    $this
      ->expectException(RemovedPostUpdateNameException::class);
    $update_registry
      ->getPendingUpdateInformation();
  }

  /**
   * @covers ::getUpdateFunctions
   */
  public function testGetUpdateFunctions() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class)
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $this
      ->assertEquals([
      'module_a_post_update_a',
      'module_a_post_update_b',
    ], array_values($update_registry
      ->getUpdateFunctions('module_a')));
    $this
      ->assertEquals([
      'module_b_post_update_a',
    ], array_values($update_registry
      ->getUpdateFunctions('module_b')));
    $this
      ->assertEquals([
      'theme_d_post_update_b',
      'theme_d_post_update_c',
    ], array_values($update_registry
      ->getUpdateFunctions('theme_d')));
  }

  /**
   * @covers ::registerInvokedUpdates
   */
  public function testRegisterInvokedUpdatesWithoutExistingUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([])
      ->shouldBeCalledTimes(1);
    $key_value
      ->set('existing_updates', [
      'module_a_post_update_a',
    ])
      ->willReturn(NULL)
      ->shouldBeCalledTimes(1);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $update_registry
      ->registerInvokedUpdates([
      'module_a_post_update_a',
    ]);
  }

  /**
   * @covers ::registerInvokedUpdates
   */
  public function testRegisterInvokedUpdatesWithMultiple() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([])
      ->shouldBeCalledTimes(1);
    $key_value
      ->set('existing_updates', [
      'module_a_post_update_a',
      'module_a_post_update_b',
      'theme_d_post_update_c',
    ])
      ->willReturn(NULL)
      ->shouldBeCalledTimes(1);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $update_registry
      ->registerInvokedUpdates([
      'module_a_post_update_a',
      'module_a_post_update_b',
      'theme_d_post_update_c',
    ]);
  }

  /**
   * @covers ::registerInvokedUpdates
   */
  public function testRegisterInvokedUpdatesWithExistingUpdates() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([
      'module_a_post_update_b',
    ])
      ->shouldBeCalledTimes(1);
    $key_value
      ->set('existing_updates', [
      'module_a_post_update_b',
      'module_a_post_update_a',
    ])
      ->willReturn(NULL)
      ->shouldBeCalledTimes(1);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
    ], $key_value, FALSE);
    $update_registry
      ->registerInvokedUpdates([
      'module_a_post_update_a',
    ]);
  }

  /**
   * @covers ::filterOutInvokedUpdatesByExtension
   */
  public function testFilterOutInvokedUpdatesByExtension() {
    $this
      ->setupBasicExtensions();
    $key_value = $this
      ->prophesize(KeyValueStoreInterface::class);
    $key_value
      ->get('existing_updates', [])
      ->willReturn([
      'module_a_post_update_b',
      'module_a_post_update_a',
      'module_b_post_update_a',
      'theme_d_post_update_c',
    ])
      ->shouldBeCalledTimes(1);
    $key_value
      ->set('existing_updates', [
      'module_b_post_update_a',
      'theme_d_post_update_c',
    ])
      ->willReturn(NULL)
      ->shouldBeCalledTimes(1);
    $key_value = $key_value
      ->reveal();
    $update_registry = new UpdateRegistry('vfs://drupal', 'sites/default', [
      'module_a',
      'module_b',
      'theme_d',
    ], $key_value, FALSE);
    $update_registry
      ->filterOutInvokedUpdatesByExtension('module_a');
  }

}

Members

Namesort descending Modifiers Type Description Overrides
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
UnitTestCase::$randomGenerator protected property The random generator.
UnitTestCase::$root protected property The app root. 1
UnitTestCase::getClassResolverStub protected function Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub public function Returns a stub config factory that behaves according to the passed array.
UnitTestCase::getConfigStorageStub public function Returns a stub config storage that returns the supplied configuration.
UnitTestCase::getContainerWithCacheTagsInvalidator protected function Sets up a container with a cache tags invalidator.
UnitTestCase::getRandomGenerator protected function Gets the random generator for the utility methods.
UnitTestCase::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::randomMachineName public function Generates a unique random string containing letters and numbers.
UnitTestCase::setUpBeforeClass public static function
UpdateRegistryTest::setUp protected function Overrides UnitTestCase::setUp
UpdateRegistryTest::setupBasicExtensions protected function Sets up some extensions with some update functions.
UpdateRegistryTest::testFilterOutInvokedUpdatesByExtension public function @covers ::filterOutInvokedUpdatesByExtension
UpdateRegistryTest::testGetPendingUpdateFunctionsExistingUpdates public function @covers ::getPendingUpdateFunctions
UpdateRegistryTest::testGetPendingUpdateFunctionsNoExistingUpdates public function @covers ::getPendingUpdateFunctions
UpdateRegistryTest::testGetPendingUpdateFunctionsWithLoadedModulesButNotEnabled public function @covers ::getPendingUpdateFunctions
UpdateRegistryTest::testGetPendingUpdateInformation public function @covers ::getPendingUpdateInformation
UpdateRegistryTest::testGetPendingUpdateInformationWithExistingUpdates public function @covers ::getPendingUpdateInformation
UpdateRegistryTest::testGetPendingUpdateInformationWithRemovedUpdates public function @covers ::getPendingUpdateInformation
UpdateRegistryTest::testGetUpdateFunctions public function @covers ::getUpdateFunctions
UpdateRegistryTest::testRegisterInvokedUpdatesWithExistingUpdates public function @covers ::registerInvokedUpdates
UpdateRegistryTest::testRegisterInvokedUpdatesWithMultiple public function @covers ::registerInvokedUpdates
UpdateRegistryTest::testRegisterInvokedUpdatesWithoutExistingUpdates public function @covers ::registerInvokedUpdates