abstract class MigrateTestCase in Zircon Profile 8

Provides setup and helper methods for Migrate module tests.

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \Drupal\Tests\PHPUnit_Framework_TestCase
  • class \Drupal\Tests\migrate\Unit\MigrateTestCase

8 files declare their use of MigrateTestCase

Drupal6SqlBaseTest.php in core/modules/migrate_drupal/tests/src/Unit/source/d6/Drupal6SqlBaseTest.php

Contains \Drupal\Tests\migrate_drupal\Unit\source\d6\Drupal6SqlBaseTest.

FieldInstanceSettingsTest.php in core/modules/field/tests/src/Unit/Plugin/migrate/process/d7/FieldInstanceSettingsTest.php

Contains \Drupal\Tests\field\Unit\Plugin\migrate\process\d7\FieldInstanceSettingsTest.

FieldSettingsTest.php in core/modules/field/tests/src/Unit/Plugin/migrate/process/d7/FieldSettingsTest.php

Contains \Drupal\Tests\field\Unit\Plugin\migrate\process\d7\FieldInstanceSettingsTest.

FileUriTest.php in core/modules/file/tests/src/Unit/Plugin/migrate/process/d6/FileUriTest.php

Contains \Drupal\Tests\file\Unit\Plugin\migrate\process\d6\FileUriTest.

IteratorTest.php in core/modules/migrate/tests/src/Unit/process/IteratorTest.php

Contains \Drupal\Tests\migrate\Unit\process\IteratorTest.

... See full list

File

core/modules/migrate/tests/src/Unit/MigrateTestCase.php, line 18

Contains \Drupal\Tests\migrate\Unit\MigrateTestCase.

Namespace

Drupal\Tests\migrate\Unit

abstract class MigrateTestCase extends UnitTestCase {
  protected $migrationConfiguration = [];

  /**
   * @var \Drupal\migrate\Plugin\MigrateIdMapInterface|\PHPUnit_Framework_MockObject_MockObject
   */
  protected $idMap;

  /**
   * Local store for mocking setStatus()/getStatus().
   *
   * @var \Drupal\migrate\Entity\MigrationInterface::STATUS_*
   */
  protected $migrationStatus = MigrationInterface::STATUS_IDLE;

  /**
   * Retrieve a mocked migration.
   *
   * @return \Drupal\migrate\Entity\MigrationInterface|\PHPUnit_Framework_MockObject_MockObject
   *   The mocked migration.
   */
  protected function getMigration() {
    $this->migrationConfiguration += [
      'migrationClass' => 'Drupal\\migrate\\Entity\\Migration',
    ];
    $this->idMap = $this
      ->getMock('Drupal\\migrate\\Plugin\\MigrateIdMapInterface');
    $this->idMap
      ->method('getQualifiedMapTableName')
      ->willReturn('test_map');
    $migration = $this
      ->getMockBuilder($this->migrationConfiguration['migrationClass'])
      ->disableOriginalConstructor()
      ->getMock();
    $migration
      ->method('checkRequirements')
      ->willReturn(TRUE);
    $migration
      ->method('getIdMap')
      ->willReturn($this->idMap);

    // We need the state to be toggled throughout the test so we store the value
    // on the test class and use a return callback.
    $migration
      ->expects($this
      ->any())
      ->method('getStatus')
      ->willReturnCallback(function () {
      return $this->migrationStatus;
    });
    $migration
      ->expects($this
      ->any())
      ->method('setStatus')
      ->willReturnCallback(function ($status) {
      $this->migrationStatus = $status;
    });
    $migration
      ->method('getMigrationDependencies')
      ->willReturn([
      'required' => [],
      'optional' => [],
    ]);
    $configuration =& $this->migrationConfiguration;
    $migration
      ->method('get')
      ->willReturnCallback(function ($argument) use (&$configuration) {
      return isset($configuration[$argument]) ? $configuration[$argument] : '';
    });
    $migration
      ->method('set')
      ->willReturnCallback(function ($argument, $value) use (&$configuration) {
      $configuration[$argument] = $value;
    });
    $migration
      ->method('id')
      ->willReturn($configuration['id']);
    return $migration;
  }

  /**
   * Get an SQLite database connection object for use in tests.
   *
   * @param array $database_contents
   *   The database contents faked as an array. Each key is a table name, each
   *   value is a list of table rows, an associative array of field => value.
   * @param array $connection_options
   *  (optional) Options for the database connection.
   *
   * @return \Drupal\Core\Database\Driver\sqlite\Connection
   *   The database connection.
   */
  protected function getDatabase(array $database_contents, $connection_options = []) {
    if (extension_loaded('pdo_sqlite')) {
      $connection_options['database'] = ':memory:';
      $pdo = Connection::open($connection_options);
      $connection = new Connection($pdo, $connection_options);
    }
    else {
      $this
        ->markTestSkipped('The pdo_sqlite extension is not available.');
    }

    // Initialize the DIC with a fake module handler for alterable queries.
    $container = new ContainerBuilder();
    $container
      ->set('module_handler', $this
      ->getMock('\\Drupal\\Core\\Extension\\ModuleHandlerInterface'));
    \Drupal::setContainer($container);

    // Create the tables and load them up with data, skipping empty ones.
    foreach (array_filter($database_contents) as $table => $rows) {
      $pilot_row = reset($rows);
      $connection
        ->schema()
        ->createTable($table, $this
        ->createSchemaFromRow($pilot_row));
      $insert = $connection
        ->insert($table)
        ->fields(array_keys($pilot_row));
      array_walk($rows, [
        $insert,
        'values',
      ]);
      $insert
        ->execute();
    }
    return $connection;
  }

  /**
   * Generates a table schema from a row.
   *
   * @param array $row
   *  The reference row on which to base the schema.
   *
   * @return array
   *  The Schema API-ready table schema.
   */
  protected function createSchemaFromRow(array $row) {

    // SQLite uses loose ("affinity") typing, so it's OK for every column
    // to be a text field.
    $fields = array_map(function () {
      return [
        'type' => 'text',
      ];
    }, $row);
    return [
      'fields' => $fields,
    ];
  }

  /**
   * Tests a query
   *
   * @param array|\Traversable
   *   The countable. foreach-able actual results if a query is being run.
   */
  public function queryResultTest($iter, $expected_results) {
    $this
      ->assertSame(count($expected_results), count($iter), 'Number of results match');
    $count = 0;
    foreach ($iter as $data_row) {
      $expected_row = $expected_results[$count];
      $count++;
      foreach ($expected_row as $key => $expected_value) {
        $this
          ->retrievalAssertHelper($expected_value, $this
          ->getValue($data_row, $key), sprintf('Value matches for key "%s"', $key));
      }
    }
    $this
      ->assertSame(count($expected_results), $count);
  }

  /**
   * @param array $row
   * @param string $key
   * @return mixed
   */
  protected function getValue($row, $key) {
    return $row[$key];
  }

  /**
   * Asserts tested values during test retrieval.
   *
   * @param mixed $expected_value
   *   The incoming expected value to test.
   * @param mixed $actual_value
   *   The incoming value itself.
   * @param string $message
   *   The tested result as a formatted string.
   */
  protected function retrievalAssertHelper($expected_value, $actual_value, $message) {
    if (is_array($expected_value)) {
      foreach ($expected_value as $k => $v) {
        $this
          ->retrievalAssertHelper($v, $actual_value[$k], $message . '[' . $k . ']');
      }
    }
    else {
      $this
        ->assertSame((string) $expected_value, (string) $actual_value, $message);
    }
  }

}

Members

Name	Modifiers	Type	Description	Overrides
MigrateTestCase::$idMap	protected	property
MigrateTestCase::$migrationConfiguration	protected	property		74
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	Get an SQLite database connection object for use in tests.
MigrateTestCase::getMigration	protected	function	Retrieve a mocked migration.
MigrateTestCase::getValue	protected	function		1
MigrateTestCase::queryResultTest	public	function	Tests a query
MigrateTestCase::retrievalAssertHelper	protected	function	Asserts tested values during test retrieval.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.
UnitTestCase::assertArrayEquals	protected	function	Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName	protected	function	Mocks a block with a block plugin.
UnitTestCase::getClassResolverStub	protected	function	Returns a stub class resolver.
UnitTestCase::getConfigFactoryStub	public	function	Returns a stub config factory that behaves according to the passed in 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::setUp	protected	function		259