class RowTest

Same name in this branch
  1. 10 core/modules/views/tests/modules/views_test_data/src/Plugin/views/row/RowTest.php \Drupal\views_test_data\Plugin\views\row\RowTest
Same name and namespace in other branches
  1. 9 core/modules/views/tests/modules/views_test_data/src/Plugin/views/row/RowTest.php \Drupal\views_test_data\Plugin\views\row\RowTest
  2. 9 core/modules/migrate/tests/src/Unit/RowTest.php \Drupal\Tests\migrate\Unit\RowTest
  3. 8.9.x core/modules/views/tests/modules/views_test_data/src/Plugin/views/row/RowTest.php \Drupal\views_test_data\Plugin\views\row\RowTest
  4. 8.9.x core/modules/migrate/tests/src/Unit/RowTest.php \Drupal\Tests\migrate\Unit\RowTest
  5. 11.x core/modules/views/tests/modules/views_test_data/src/Plugin/views/row/RowTest.php \Drupal\views_test_data\Plugin\views\row\RowTest
  6. 11.x core/modules/migrate/tests/src/Unit/RowTest.php \Drupal\Tests\migrate\Unit\RowTest

@coversDefaultClass \Drupal\migrate\Row
@group migrate

Hierarchy

Expanded class hierarchy of RowTest

3 string references to 'RowTest'
RowTest::calculateDependencies in core/modules/views/tests/modules/views_test_data/src/Plugin/views/row/RowTest.php
Calculates dependencies for the configured plugin.
ViewEntityDependenciesTest::testGetDependencies in core/modules/views/tests/src/Kernel/Entity/ViewEntityDependenciesTest.php
Tests the getDependencies method.
views.view.test_plugin_dependencies.yml in core/modules/views/tests/modules/views_test_config/test_views/views.view.test_plugin_dependencies.yml
core/modules/views/tests/modules/views_test_config/test_views/views.view.test_plugin_dependencies.yml

File

core/modules/migrate/tests/src/Unit/RowTest.php, line 15

Namespace

Drupal\Tests\migrate\Unit
View source
class RowTest extends UnitTestCase {
  
  /**
   * The source IDs.
   *
   * @var array
   */
  protected $testSourceIds = [
    'nid' => 'Node ID',
  ];
  
  /**
   * The test values.
   *
   * @var array
   */
  protected $testValues = [
    'nid' => 1,
    'title' => 'node 1',
  ];
  
  /**
   * Test source properties for testing get and getMultiple.
   *
   * @var array
   */
  protected $testGetSourceProperties = [
    'source_key_1' => 'source_value_1',
    'source_key_2' => 'source_value_2',
    '@source_key_3' => 'source_value_3',
    'shared_key_1' => 'source_shared_value_1',
    '@shared_key_2' => 'source_shared_value_2',
    '@@@@shared_key_3' => 'source_shared_value_3',
  ];
  
  /**
   * Test source keys for testing get and getMultiple.
   *
   * @var array
   */
  protected $testGetSourceIds = [
    'source_key_1' => [],
  ];
  
  /**
   * Test destination properties for testing get and getMultiple.
   *
   * @var array
   */
  protected $testGetDestinationProperties = [
    'destination_key_1' => 'destination_value_1',
    'destination_key_2' => 'destination_value_2',
    '@destination_key_3' => 'destination_value_3',
    'shared_key_1' => 'destination_shared_value_1',
    '@shared_key_2' => 'destination_shared_value_2',
    '@@@@shared_key_3' => 'destination_shared_value_3',
  ];
  
  /**
   * The test hash.
   *
   * @var string
   */
  protected $testHash = '85795d4cde4a2425868b812cc88052ecd14fc912e7b9b4de45780f66750e8b1e';
  
  /**
   * The test hash after changing title value to 'new title'.
   *
   * @var string
   */
  protected $testHashMod = '9476aab0b62b3f47342cc6530441432e5612dcba7ca84115bbab5cceaca1ecb3';
  
  /**
   * Tests object creation: empty.
   */
  public function testRowWithoutData() : void {
    $row = new Row();
    $this->assertSame([], $row->getSource(), 'Empty row');
  }
  
  /**
   * Tests object creation: basic.
   */
  public function testRowWithBasicData() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $this->assertSame($this->testValues, $row->getSource(), 'Row with data, simple id.');
  }
  
  /**
   * Tests object creation: multiple source IDs.
   */
  public function testRowWithMultipleSourceIds() : void {
    $multi_source_ids = $this->testSourceIds + [
      'vid' => 'Node revision',
    ];
    $multi_source_ids_values = $this->testValues + [
      'vid' => 1,
    ];
    $row = new Row($multi_source_ids_values, $multi_source_ids);
    $this->assertSame($multi_source_ids_values, $row->getSource(), 'Row with data, multiple source id.');
  }
  
  /**
   * Tests object creation: invalid values.
   */
  public function testRowWithInvalidData() : void {
    $invalid_values = [
      'title' => 'node X',
    ];
    $this->expectException(\Exception::class);
    new Row($invalid_values, $this->testSourceIds);
  }
  
  /**
   * Tests source immutability after freeze.
   */
  public function testSourceFreeze() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $row->rehash();
    $this->assertSame($this->testHash, $row->getHash(), 'Correct hash.');
    $row->setSourceProperty('title', 'new title');
    $row->rehash();
    $this->assertSame($this->testHashMod, $row->getHash(), 'Hash changed correctly.');
    $row->freezeSource();
    $this->expectException(\Exception::class);
    $row->setSourceProperty('title', 'new title');
  }
  
  /**
   * Tests setting on a frozen row.
   */
  public function testSetFrozenRow() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $row->freezeSource();
    $this->expectException(\Exception::class);
    $this->expectExceptionMessage("The source is frozen and can't be changed any more");
    $row->setSourceProperty('title', 'new title');
  }
  
  /**
   * Tests hashing.
   */
  public function testHashing() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $this->assertSame('', $row->getHash(), 'No hash at creation');
    $row->rehash();
    $this->assertSame($this->testHash, $row->getHash(), 'Correct hash.');
    $row->rehash();
    $this->assertSame($this->testHash, $row->getHash(), 'Correct hash even doing it twice.');
    // Set the map to needs update.
    $test_id_map = [
      'original_hash' => '',
      'hash' => '',
      'source_row_status' => MigrateIdMapInterface::STATUS_NEEDS_UPDATE,
    ];
    $row->setIdMap($test_id_map);
    $this->assertTrue($row->needsUpdate());
    $row->rehash();
    $this->assertSame($this->testHash, $row->getHash(), 'Correct hash even if id_mpa have changed.');
    $row->setSourceProperty('title', 'new title');
    $row->rehash();
    $this->assertSame($this->testHashMod, $row->getHash(), 'Hash changed correctly.');
    // Check hash calculation algorithm.
    $hash = hash('sha256', serialize($row->getSource()));
    $this->assertSame($hash, $row->getHash());
    // Check length of generated hash used for mapping schema.
    $this->assertSame(64, strlen($row->getHash()));
    // Set the map to successfully imported.
    $test_id_map = [
      'original_hash' => '',
      'hash' => '',
      'source_row_status' => MigrateIdMapInterface::STATUS_IMPORTED,
    ];
    $row->setIdMap($test_id_map);
    $this->assertFalse($row->needsUpdate());
    // Set the same hash value and ensure it was not changed.
    $random = $this->randomMachineName();
    $test_id_map = [
      'original_hash' => $random,
      'hash' => $random,
      'source_row_status' => MigrateIdMapInterface::STATUS_NEEDS_UPDATE,
    ];
    $row->setIdMap($test_id_map);
    $this->assertFalse($row->changed());
    // Set different has values to ensure it is marked as changed.
    $test_id_map = [
      'original_hash' => $this->randomMachineName(),
      'hash' => $this->randomMachineName(),
      'source_row_status' => MigrateIdMapInterface::STATUS_NEEDS_UPDATE,
    ];
    $row->setIdMap($test_id_map);
    $this->assertTrue($row->changed());
  }
  
  /**
   * Tests getting/setting the ID Map.
   *
   * @covers ::setIdMap
   * @covers ::getIdMap
   */
  public function testGetSetIdMap() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $test_id_map = [
      'original_hash' => '',
      'hash' => '',
      'source_row_status' => MigrateIdMapInterface::STATUS_NEEDS_UPDATE,
    ];
    $row->setIdMap($test_id_map);
    $this->assertEquals($test_id_map, $row->getIdMap());
  }
  
  /**
   * Tests the source ID.
   */
  public function testSourceIdValues() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $this->assertSame([
      'nid' => $this->testValues['nid'],
    ], $row->getSourceIdValues());
  }
  
  /**
   * Tests the multiple source IDs.
   */
  public function testMultipleSourceIdValues() : void {
    // Set values in same order as ids.
    $multi_source_ids = $this->testSourceIds + [
      'vid' => 'Node revision',
      'type' => 'Node type',
      'langcode' => 'Node language',
    ];
    $multi_source_ids_values = $this->testValues + [
      'vid' => 1,
      'type' => 'page',
      'langcode' => 'en',
    ];
    $row = new Row($multi_source_ids_values, $multi_source_ids);
    $this->assertSame(array_keys($multi_source_ids), array_keys($row->getSourceIdValues()));
    // Set values in different order.
    $multi_source_ids = $this->testSourceIds + [
      'vid' => 'Node revision',
      'type' => 'Node type',
      'langcode' => 'Node language',
    ];
    $multi_source_ids_values = $this->testValues + [
      'langcode' => 'en',
      'type' => 'page',
      'vid' => 1,
    ];
    $row = new Row($multi_source_ids_values, $multi_source_ids);
    $this->assertSame(array_keys($multi_source_ids), array_keys($row->getSourceIdValues()));
  }
  
  /**
   * Tests getting the source property.
   *
   * @covers ::getSourceProperty
   */
  public function testGetSourceProperty() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $this->assertSame($this->testValues['nid'], $row->getSourceProperty('nid'));
    $this->assertSame($this->testValues['title'], $row->getSourceProperty('title'));
    $this->assertNull($row->getSourceProperty('non_existing'));
  }
  
  /**
   * Tests setting and getting the destination.
   */
  public function testDestination() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    $this->assertEmpty($row->getDestination());
    $this->assertFalse($row->hasDestinationProperty('nid'));
    // Set a destination.
    $row->setDestinationProperty('nid', 2);
    $this->assertTrue($row->hasDestinationProperty('nid'));
    $this->assertEquals([
      'nid' => 2,
    ], $row->getDestination());
  }
  
  /**
   * Tests setting/getting multiple destination IDs.
   */
  public function testMultipleDestination() : void {
    $row = new Row($this->testValues, $this->testSourceIds);
    // Set some deep nested values.
    $row->setDestinationProperty('image/alt', 'alt text');
    $row->setDestinationProperty('image/fid', 3);
    $this->assertTrue($row->hasDestinationProperty('image'));
    $this->assertFalse($row->hasDestinationProperty('alt'));
    $this->assertFalse($row->hasDestinationProperty('fid'));
    $destination = $row->getDestination();
    $this->assertEquals('alt text', $destination['image']['alt']);
    $this->assertEquals(3, $destination['image']['fid']);
    $this->assertEquals('alt text', $row->getDestinationProperty('image/alt'));
    $this->assertEquals(3, $row->getDestinationProperty('image/fid'));
  }
  
  /**
   * Tests getting source and destination properties.
   *
   * @param string $key
   *   The key to look up.
   * @param string $expected_value
   *   The expected value.
   *
   * @dataProvider getDataProvider
   * @covers ::get
   */
  public function testGet($key, $expected_value) : void {
    $row = $this->createRowWithDestinationProperties($this->testGetSourceProperties, $this->testGetSourceIds, $this->testGetDestinationProperties);
    $this->assertSame($expected_value, $row->get($key));
  }
  
  /**
   * Data Provider for testGet.
   *
   * @return array
   *   The keys and expected values.
   */
  public static function getDataProvider() {
    return [
      [
        'source_key_1',
        'source_value_1',
      ],
      [
        'source_key_2',
        'source_value_2',
      ],
      [
        '@@source_key_3',
        'source_value_3',
      ],
      [
        'shared_key_1',
        'source_shared_value_1',
      ],
      [
        '@@shared_key_2',
        'source_shared_value_2',
      ],
      [
        '@@@@@@@@shared_key_3',
        'source_shared_value_3',
      ],
      [
        '@destination_key_1',
        'destination_value_1',
      ],
      [
        '@destination_key_2',
        'destination_value_2',
      ],
      [
        '@@@destination_key_3',
        'destination_value_3',
      ],
      [
        '@shared_key_1',
        'destination_shared_value_1',
      ],
      [
        '@@@shared_key_2',
        'destination_shared_value_2',
      ],
      [
        '@@@@@@@@@shared_key_3',
        'destination_shared_value_3',
      ],
      [
        'destination_key_1',
        NULL,
      ],
      [
        '@shared_key_2',
        NULL,
      ],
      [
        '@source_key_1',
        NULL,
      ],
      [
        'random_source_key',
        NULL,
      ],
      [
        '@random_destination_key',
        NULL,
      ],
    ];
  }
  
  /**
   * Tests getting multiple source and destination properties.
   *
   * @param array $keys
   *   An array of keys to look up.
   * @param array $expected_values
   *   An array of expected values.
   *
   * @covers ::getMultiple
   * @dataProvider getMultipleDataProvider
   */
  public function testGetMultiple(array $keys, array $expected_values) : void {
    $row = $this->createRowWithDestinationProperties($this->testGetSourceProperties, $this->testGetSourceIds, $this->testGetDestinationProperties);
    $this->assertEquals(array_combine($keys, $expected_values), $row->getMultiple($keys));
  }
  
  /**
   * Data Provider for testGetMultiple.
   *
   * @return array
   *   The keys and expected values.
   */
  public static function getMultipleDataProvider() {
    return [
      'Single Key' => [
        'keys' => [
          'source_key_1',
        ],
        'expected_values' => [
          'source_value_1',
        ],
      ],
      'All Source Keys' => [
        'keys' => [
          'source_key_1',
          'source_key_2',
          '@@source_key_3',
        ],
        'expected_values' => [
          'source_value_1',
          'source_value_2',
          'source_value_3',
        ],
      ],
      'All Destination Keys' => [
        'keys' => [
          '@destination_key_1',
          '@destination_key_2',
          '@@@destination_key_3',
        ],
        'expected_values' => [
          'destination_value_1',
          'destination_value_2',
          'destination_value_3',
        ],
      ],
      'Mix of keys including non-existent' => [
        'keys' => [
          'shared_key_1',
          '@shared_key_1',
          '@@shared_key_2',
          '@@@shared_key_2',
          '@@@@@@@@@shared_key_3',
          'non_existent_source_key',
          '@non_existent_destination_key',
        ],
        'expected_values' => [
          'source_shared_value_1',
          'destination_shared_value_1',
          'source_shared_value_2',
          'destination_shared_value_2',
          'destination_shared_value_3',
          NULL,
          NULL,
        ],
      ],
    ];
  }
  
  /**
   * Create a row and load it with destination properties.
   *
   * @param array $source_properties
   *   The source property array.
   * @param array $source_ids
   *   The source ids array.
   * @param array $destination_properties
   *   The destination properties to load.
   * @param bool $is_stub
   *   Whether this row is a stub row, defaults to FALSE.
   *
   * @return \Drupal\migrate\Row
   *   The row, populated with destination properties.
   */
  protected function createRowWithDestinationProperties(array $source_properties, array $source_ids, array $destination_properties, $is_stub = FALSE) {
    $row = new Row($source_properties, $source_ids, $is_stub);
    foreach ($destination_properties as $key => $property) {
      $row->setDestinationProperty($key, $property);
    }
    return $row;
  }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary 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.
RandomGeneratorTrait::getRandomGenerator protected function Gets the random generator for the utility methods.
RandomGeneratorTrait::randomMachineName protected function Generates a unique random string containing letters and numbers.
RandomGeneratorTrait::randomObject public function Generates a random PHP object.
RandomGeneratorTrait::randomString public function Generates a pseudo-random string of ASCII characters of codes 32 to 126.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
RowTest::$testGetDestinationProperties protected property Test destination properties for testing get and getMultiple.
RowTest::$testGetSourceIds protected property Test source keys for testing get and getMultiple.
RowTest::$testGetSourceProperties protected property Test source properties for testing get and getMultiple.
RowTest::$testHash protected property The test hash.
RowTest::$testHashMod protected property The test hash after changing title value to 'new title'.
RowTest::$testSourceIds protected property The source IDs.
RowTest::$testValues protected property The test values.
RowTest::createRowWithDestinationProperties protected function Create a row and load it with destination properties.
RowTest::getDataProvider public static function Data Provider for testGet.
RowTest::getMultipleDataProvider public static function Data Provider for testGetMultiple.
RowTest::testDestination public function Tests setting and getting the destination.
RowTest::testGet public function Tests getting source and destination properties.
RowTest::testGetMultiple public function Tests getting multiple source and destination properties.
RowTest::testGetSetIdMap public function Tests getting/setting the ID Map.
RowTest::testGetSourceProperty public function Tests getting the source property.
RowTest::testHashing public function Tests hashing.
RowTest::testMultipleDestination public function Tests setting/getting multiple destination IDs.
RowTest::testMultipleSourceIdValues public function Tests the multiple source IDs.
RowTest::testRowWithBasicData public function Tests object creation: basic.
RowTest::testRowWithInvalidData public function Tests object creation: invalid values.
RowTest::testRowWithMultipleSourceIds public function Tests object creation: multiple source IDs.
RowTest::testRowWithoutData public function Tests object creation: empty.
RowTest::testSetFrozenRow public function Tests setting on a frozen row.
RowTest::testSourceFreeze public function Tests source immutability after freeze.
RowTest::testSourceIdValues public function Tests the source ID.
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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUp protected function 358
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

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