class SubProcessTest

Same name and namespace in other branches
  1. 9 core/modules/migrate/tests/src/Unit/process/SubProcessTest.php \Drupal\Tests\migrate\Unit\process\SubProcessTest
  2. 8.9.x core/modules/migrate/tests/src/Unit/process/SubProcessTest.php \Drupal\Tests\migrate\Unit\process\SubProcessTest
  3. 11.x core/modules/migrate/tests/src/Unit/process/SubProcessTest.php \Drupal\Tests\migrate\Unit\process\SubProcessTest

Tests the sub_process process plugin.

@group migrate

Hierarchy

Expanded class hierarchy of SubProcessTest

File

core/modules/migrate/tests/src/Unit/process/SubProcessTest.php, line 22

Namespace

Drupal\Tests\migrate\Unit\process
View source
class SubProcessTest extends MigrateProcessTestCase {
  
  /**
   * The sub_process plugin being tested.
   *
   * @var \Drupal\migrate\Plugin\migrate\process\SubProcess
   */
  protected $plugin;
  
  /**
   * @var array
   */
  protected $migrationConfiguration = [
    'id' => 'test',
  ];
  
  /**
   * Tests the sub_process process plugin.
   *
   * @dataProvider providerTestSubProcess
   */
  public function testSubProcess($process_configuration, $source_values = []) : void {
    $migration = $this->getMigration();
    // Set up the properties for the sub_process.
    $plugin = new SubProcess($process_configuration, 'sub_process', []);
    // Manually create the plugins. Migration::getProcessPlugins does this
    // normally but the plugin system is not available.
    foreach ($process_configuration['process'] as $destination => $source) {
      $sub_process_plugins[$destination][] = new Get([
        'source' => $source,
      ], 'get', []);
    }
    // Set up the key plugins.
    $key_plugin['key'][] = new Get([
      'source' => '@id',
    ], 'get', []);
    $migration->expects($this->exactly(2))
      ->method('getProcessPlugins')
      ->willReturnOnConsecutiveCalls($sub_process_plugins, $key_plugin);
    $event_dispatcher = $this->createMock(EventDispatcherInterface::class);
    $migrate_executable = new MigrateExecutable($migration, $this->createMock(MigrateMessageInterface::class), $event_dispatcher);
    // The current value of the pipeline.
    $current_value = [
      [
        'source_foo' => 'test',
        'source_id' => 42,
      ] + $source_values,
    ];
    // This is not used but the interface requires it, so create an empty row.
    $row = new Row($source_values);
    // After transformation, check to make sure that source_foo and source_id's
    // values ended up in the proper destinations, and that the value of the
    // key (@id) is the same as the destination ID (42).
    $new_value = $plugin->transform($current_value, $migrate_executable, $row, 'test');
    $this->assertCount(1, $new_value);
    $this->assertSameSize($process_configuration['process'], $new_value[42]);
    $this->assertSame('test', $new_value[42]['foo']);
    if ($source_values) {
      $this->assertSame('source_baz', $new_value[42]['baaa']);
    }
    $this->assertSame(42, $new_value[42]['id']);
  }
  
  /**
   * Data provider for testSubProcess().
   */
  public static function providerTestSubProcess() {
    return [
      'no source context' => [
        'process_configuration' => [
          'process' => [
            'foo' => 'source_foo',
            'id' => 'source_id',
          ],
          'key' => '@id',
        ],
      ],
      'default source key' => [
        'process_configuration' => [
          'process' => [
            'foo' => 'source_foo',
            'id' => 'source_id',
            'baaa' => 'source/baf',
          ],
          'key' => '@id',
          'include_source' => TRUE,
        ],
        'source_values' => [
          'baf' => 'source_baz',
        ],
      ],
      'renamed source key' => [
        'process_configuration' => [
          'process' => [
            'foo' => 'source_foo',
            'id' => 'source_id',
            'baaa' => 'my_source/baf',
          ],
          'key' => '@id',
          'include_source' => TRUE,
          'source_key' => 'my_source',
        ],
        'source_values' => [
          'baf' => 'source_baz',
        ],
      ],
    ];
  }
  
  /**
   * Tests the sub_process process plugin.
   *
   * @dataProvider providerTestNotFoundSubProcess
   */
  public function testNotFoundSubProcess($process_configuration, $source_values = []) : void {
    $migration = $this->getMigration();
    // Set up the properties for the sub_process.
    $plugin = new SubProcess($process_configuration, 'sub_process', []);
    // Manually create the plugins. Migration::getProcessPlugins does this
    // normally but the plugin system is not available.
    foreach ($process_configuration['process'] as $destination => $source) {
      $sub_process_plugins[$destination][] = new Get([
        'source' => $source,
      ], 'get', []);
    }
    $key_plugin['key'][] = new Get([
      'source' => '@id',
    ], 'get', []);
    $migration->expects($this->exactly(2))
      ->method('getProcessPlugins')
      ->willReturnOnConsecutiveCalls($sub_process_plugins, $key_plugin);
    $event_dispatcher = $this->createMock(EventDispatcherInterface::class);
    $migrate_executable = new MigrateExecutable($migration, $this->createMock(MigrateMessageInterface::class), $event_dispatcher);
    // The current value of the pipeline.
    $current_value = [
      [
        'source_foo' => 'test',
        'source_id' => NULL,
      ] + $source_values,
    ];
    // This is not used but the interface requires it, so create an empty row.
    $row = new Row($source_values);
    // After transformation, check to make sure that source_foo and source_id's
    // values ended up in the proper destinations, and that the value of the
    // key (@id) is the same as the destination ID (42).
    $new_value = $plugin->transform($current_value, $migrate_executable, $row, 'test');
    $this->assertSame([], $new_value);
  }
  
  /**
   * Data provider for testNotFoundSubProcess().
   */
  public static function providerTestNotFoundSubProcess() {
    return [
      'no key' => [
        'process_configuration' => [
          'process' => [
            'foo' => 'source_foo',
          ],
          'key' => '@id',
        ],
      ],
      'lookup returns NULL' => [
        'process_configuration' => [
          'process' => [
            'foo' => 'source_foo',
            'id' => 'source_id',
          ],
          'key' => '@id',
        ],
      ],
    ];
  }
  
  /**
   * Tests behavior when source children are not arrays.
   *
   * @dataProvider providerTestSourceNotArray
   */
  public function testSourceNotArray($source_values, $type) : void {
    $process = new SubProcess([
      'process' => [
        'foo' => 'source_foo',
      ],
    ], 'sub_process', []);
    $this->expectException(MigrateException::class);
    $this->expectExceptionMessage("Input array should hold elements of type array, instead element was of type '{$type}'");
    $process->transform($source_values, $this->migrateExecutable, $this->row, 'destination_property');
  }
  
  /**
   * Data provider for testSourceNotArray().
   */
  public static function providerTestSourceNotArray() {
    return [
      'strings cannot be subprocess items' => [
        [
          'strings',
          'cannot',
          'be',
          'children',
        ],
        'string',
      ],
      'xml elements cannot be subprocess items' => [
        [
          new \SimpleXMLElement("<element>Content</element>"),
        ],
        'object',
      ],
      'integers cannot be subprocess items' => [
        [
          1,
          2,
          3,
          4,
        ],
        'integer',
      ],
      'booleans cannot be subprocess items' => [
        [
          TRUE,
          FALSE,
        ],
        'boolean',
      ],
      'null cannot be subprocess items' => [
        [
          NULL,
        ],
        'NULL',
      ],
      'iterator cannot be subprocess items' => [
        [
          new \ArrayIterator([
            'some',
            'array',
          ]),
        ],
        'object',
      ],
      'all subprocess items must be arrays' => [
        [
          [
            'array',
          ],
          'not array',
        ],
        'string',
      ],
    ];
  }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
MigrateProcessTestCase::$migrateExecutable protected property
MigrateProcessTestCase::$row protected property
MigrateProcessTestCase::setUp protected function Overrides UnitTestCase::setUp 17
MigrateTestCase::$idMap protected property The migration ID map.
MigrateTestCase::$migrationStatus protected property Local store for mocking setStatus()/getStatus().
MigrateTestCase::createSchemaFromRow protected function Generates a table schema from a row.
MigrateTestCase::getDatabase protected function Gets an SQLite database connection object for use in tests.
MigrateTestCase::getMigration protected function Retrieves a mocked migration.
MigrateTestCase::getValue protected function Gets the value on a row for a given key.
MigrateTestCase::queryResultTest public function Tests a query.
MigrateTestCase::retrievalAssertHelper protected function Asserts tested values during test retrieval.
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.
SubProcessTest::$migrationConfiguration protected property Overrides MigrateTestCase::$migrationConfiguration
SubProcessTest::$plugin protected property The sub_process plugin being tested. Overrides MigrateProcessTestCase::$plugin
SubProcessTest::providerTestNotFoundSubProcess public static function Data provider for testNotFoundSubProcess().
SubProcessTest::providerTestSourceNotArray public static function Data provider for testSourceNotArray().
SubProcessTest::providerTestSubProcess public static function Data provider for testSubProcess().
SubProcessTest::testNotFoundSubProcess public function Tests the sub_process process plugin.
SubProcessTest::testSourceNotArray public function Tests behavior when source children are not arrays.
SubProcessTest::testSubProcess public function Tests the sub_process process plugin.
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::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.