UpdateHookRegistryTest.php

Same filename and directory in other branches
  1. 9 core/tests/Drupal/Tests/Core/Update/UpdateHookRegistryTest.php
  2. 10 core/tests/Drupal/Tests/Core/Update/UpdateHookRegistryTest.php

Namespace

Drupal\Tests\Core\Update

File

core/tests/Drupal/Tests/Core/Update/UpdateHookRegistryTest.php

View source
<?php

declare (strict_types=1);
namespace Drupal\Tests\Core\Update;

use Drupal\Core\KeyValueStore\KeyValueFactoryInterface;
use Drupal\Core\KeyValueStore\KeyValueStoreInterface;
use Drupal\Core\Update\UpdateHookRegistry;
use Drupal\Tests\UnitTestCase;

/**
 * Simulates a hook_update_N function.
 */
function under_test_update_3000() {
}

/**
 * Simulates a hook_update_N function.
 *
 * When filtered this will be rejected.
 */
function bad_3() {
}

/**
 * Simulates a hook_update_N function.
 */
function under_test_update_1() {
}

/**
 * Simulates a hook_update_N functions.
 *
 * When filtered this will be rejected.
 */
function failed_22_update() {
}

/**
 * Simulates a hook_update_N function.
 */
function under_test_update_20() {
}

/**
 * Simulates a hook_update_N function.
 *
 * When filtered this will be rejected.
 */
function under_test_update_1234_failed() {
}

/**
 * @coversDefaultClass \Drupal\Core\Update\UpdateHookRegistry
 * @group Update
 */
class UpdateHookRegistryTest extends UnitTestCase {
  
  /**
   * @var \Drupal\Core\KeyValueStore\KeyValueStoreInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $keyValueStore;
  
  /**
   * @var \Drupal\Core\KeyValueStore\KeyValueFactoryInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected $keyValueFactory;
  
  /**
   * @var \Drupal\Core\KeyValueStore\KeyValueStoreInterface|\PHPUnit\Framework\MockObject\MockObject
   */
  protected KeyValueStoreInterface $equivalentUpdatesStore;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $this->keyValueFactory = $this->createMock(KeyValueFactoryInterface::class);
    $this->keyValueStore = $this->createMock(KeyValueStoreInterface::class);
    $this->equivalentUpdatesStore = $this->createMock(KeyValueStoreInterface::class);
    $this->keyValueFactory
      ->method('get')
      ->willReturnMap([
      [
        'system.schema',
        $this->keyValueStore,
      ],
      [
        'core.equivalent_updates',
        $this->equivalentUpdatesStore,
      ],
    ]);
  }
  
  /**
   * @covers ::getAvailableUpdates
   */
  public function testGetVersions() : void {
    $module_name = 'drupal\\tests\\core\\update\\under_test';
    $update_registry = new UpdateHookRegistry([], $this->keyValueFactory);
    // Only under_test_update_X - passes through the filter.
    $expected = [
      1,
      20,
      3000,
    ];
    $actual = $update_registry->getAvailableUpdates($module_name);
    $this->assertSame($expected, $actual);
  }
  
  /**
   * @covers ::getInstalledVersion
   * @covers ::getAllInstalledVersions
   * @covers ::setInstalledVersion
   * @covers ::deleteInstalledVersion
   */
  public function testGetInstalledVersion() : void {
    $versions = [
      'module1' => 1,
      'module2' => 20,
      'module3' => 3000,
    ];
    $this->keyValueStore
      ->method('getAll')
      ->willReturnCallback(static function () use (&$versions) {
      return $versions;
    });
    $this->keyValueStore
      ->method('get')
      ->willReturnCallback(static function ($key) use (&$versions) {
      return $versions[$key];
    });
    $this->keyValueStore
      ->method('delete')
      ->willReturnCallback(static function ($key) use (&$versions) {
      $versions[$key] = UpdateHookRegistry::SCHEMA_UNINSTALLED;
    });
    $this->keyValueStore
      ->method('set')
      ->willReturnCallback(static function ($key, $value) use (&$versions) {
      $versions[$key] = $value;
    });
    $update_registry = new UpdateHookRegistry([], $this->keyValueFactory);
    $this->assertSame(3000, $update_registry->getInstalledVersion('module3'));
    $update_registry->setInstalledVersion('module3', 3001);
    $this->assertSame(3001, $update_registry->getInstalledVersion('module3'));
    $this->assertSame($versions, $update_registry->getAllInstalledVersions());
    $update_registry->deleteInstalledVersion('module3');
    $this->assertSame(UpdateHookRegistry::SCHEMA_UNINSTALLED, $update_registry->getInstalledVersion('module3'));
  }

}

Functions

Title Deprecated Summary
bad_3 Simulates a hook_update_N function.
failed_22_update Simulates a hook_update_N functions.
under_test_update_1 Simulates a hook_update_N function.
under_test_update_1234_failed Simulates a hook_update_N function.
under_test_update_20 Simulates a hook_update_N function.
under_test_update_3000 Simulates a hook_update_N function.

Classes

Title Deprecated Summary
UpdateHookRegistryTest @coversDefaultClass \Drupal\Core\Update\UpdateHookRegistry[[api-linebreak]] @group Update

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.