class FieldDiscoveryTest in Drupal 8

Tests the FieldDiscovery Class.

@group migrate_drupal @coversDefaultClass \Drupal\migrate_drupal\FieldDiscovery

Hierarchy

• class \Drupal\Tests\UnitTestCase extends \PHPUnit\Framework\TestCase uses PhpunitCompatibilityTrait
  • class \Drupal\Tests\migrate_drupal\Unit\FieldDiscoveryTest

File

core/modules/migrate_drupal/tests/src/Unit/FieldDiscoveryTest.php, line 19

Namespace

Drupal\Tests\migrate_drupal\Unit

class FieldDiscoveryTest extends UnitTestCase {

  /**
   * A MigrateFieldPluginManager prophecy.
   *
   * @var \Prophecy\Prophecy\ObjectProphecy
   */
  protected $fieldPluginManager;

  /**
   * A MigrationPluginManager prophecy.
   *
   * @var \Prophecy\Prophecy\ObjectProphecy
   */
  protected $migrationPluginManager;

  /**
   * A LoggerChannelInterface prophecy.
   *
   * @var \Prophecy\Prophecy\ObjectProphecy
   */
  protected $logger;

  /**
   * {@inheritdoc}
   */
  public function setUp() {
    parent::setUp();
    $this->fieldPluginManager = $this
      ->prophesize(MigrateFieldPluginManagerInterface::class);
    $this->migrationPluginManager = $this
      ->prophesize(MigrationPluginManagerInterface::class);
    $this->logger = $this
      ->prophesize(LoggerChannelInterface::class);
  }

  /**
   * Tests the protected getEntityFields method.
   *
   * @param string $entity_type_id
   *   The entity type ID.
   * @param array $expected_fields
   *   The expected fields.
   *
   * @covers ::getEntityFields
   * @dataProvider getEntityFieldsData
   */
  public function testGetEntityFields($entity_type_id, array $expected_fields) {
    $test_data = [
      'getAllFields' => [
        '7' => $this
          ->getAllFieldData(),
      ],
    ];
    $field_discovery = new FieldDiscoveryTestClass($this->fieldPluginManager
      ->reveal(), $this->migrationPluginManager
      ->reveal(), $this->logger
      ->reveal(), $test_data);
    $actual_fields = $field_discovery
      ->getEntityFields('7', $entity_type_id);
    $this
      ->assertSame($expected_fields, $actual_fields);
  }

  /**
   * Provides data for testGetEntityFields.
   *
   * @return array
   *   The data.
   */
  public function getEntityFieldsData() {
    return [
      'Node' => [
        'entity_type_id' => 'node',
        'expected_fields' => [
          'content_type_1' => [
            'field_1' => [
              'field_info_key' => 'field_1_data',
            ],
            'field_2' => [
              'field_info_key' => 'field_2_data',
            ],
            'field_3' => [
              'field_info_key' => 'field_3_data',
            ],
          ],
          'content_type_2' => [
            'field_1' => [
              'field_info_key' => 'field_1_data',
            ],
            'field_4' => [
              'field_info_key' => 'field_4_data',
            ],
            'field_5' => [
              'field_info_key' => 'field_5_data',
            ],
          ],
        ],
      ],
      'User' => [
        'entity_type_id' => 'user',
        'expected_fields' => [
          'user' => [
            'user_field_1' => [
              'field_info_key' => 'user_field_1_data',
            ],
          ],
        ],
      ],
      'Comment' => [
        'entity_type_id' => 'comment',
        'expected_fields' => [
          'comment_node_content_type_1' => [
            'cfield_1' => [
              'field_info_key' => 'field_1_data',
            ],
            'cfield_2' => [
              'field_info_key' => 'field_2_data',
            ],
            'cfield_3' => [
              'field_info_key' => 'field_3_data',
            ],
          ],
          'comment_node_content_type_2' => [
            'cfield_1' => [
              'field_info_key' => 'field_1_data',
            ],
            'cfield_4' => [
              'field_info_key' => 'field_4_data',
            ],
            'cfield_5' => [
              'field_info_key' => 'field_5_data',
            ],
          ],
        ],
      ],
      'Non-existent Entity' => [
        'entity_type_id' => 'custom_entity',
        'expected_fields' => [],
      ],
    ];
  }

  /**
   * Tests the protected getEntityFields method.
   *
   * @param string $entity_type_id
   *   The entity type ID.
   * @param string $bundle
   *   The bundle.
   * @param array $expected_fields
   *   The expected fields.
   *
   * @covers ::getBundleFields
   * @dataProvider getBundleFieldsData
   */
  public function testGetBundleFields($entity_type_id, $bundle, array $expected_fields) {
    $test_data = [
      'getAllFields' => [
        '7' => $this
          ->getAllFieldData(),
      ],
    ];
    $field_discovery = new FieldDiscoveryTestClass($this->fieldPluginManager
      ->reveal(), $this->migrationPluginManager
      ->reveal(), $this->logger
      ->reveal(), $test_data);
    $actual_fields = $field_discovery
      ->getBundleFields('7', $entity_type_id, $bundle);
    $this
      ->assertSame($expected_fields, $actual_fields);
  }

  /**
   * Provides data for testGetBundleFields.
   *
   * @return array
   *   The data.
   */
  public function getBundleFieldsData() {
    return [
      'Node - Content Type 1' => [
        'entity_type_id' => 'node',
        'bundle' => 'content_type_1',
        'expected_fields' => [
          'field_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'field_2' => [
            'field_info_key' => 'field_2_data',
          ],
          'field_3' => [
            'field_info_key' => 'field_3_data',
          ],
        ],
      ],
      'Node - Content Type 2' => [
        'entity_type_id' => 'node',
        'bundle' => 'content_type_2',
        'expected_fields' => [
          'field_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'field_4' => [
            'field_info_key' => 'field_4_data',
          ],
          'field_5' => [
            'field_info_key' => 'field_5_data',
          ],
        ],
      ],
      'User' => [
        'entity_type_id' => 'user',
        'bundle' => 'user',
        'expected_fields' => [
          'user_field_1' => [
            'field_info_key' => 'user_field_1_data',
          ],
        ],
      ],
      'Comment - Content Type 1' => [
        'entity_type_id' => 'comment',
        'bundle' => 'comment_node_content_type_1',
        'expected_fields' => [
          'cfield_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'cfield_2' => [
            'field_info_key' => 'field_2_data',
          ],
          'cfield_3' => [
            'field_info_key' => 'field_3_data',
          ],
        ],
      ],
      'Comment - Content Type 2' => [
        'entity_type_id' => 'comment',
        'bundle' => 'comment_node_content_type_2',
        'expected_fields' => [
          'cfield_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'cfield_4' => [
            'field_info_key' => 'field_4_data',
          ],
          'cfield_5' => [
            'field_info_key' => 'field_5_data',
          ],
        ],
      ],
      'Non-existent Entity Type' => [
        'entity_type_id' => 'custom_entity',
        'bundle' => 'content_type_1',
        'expected_fields' => [],
      ],
      'Non-existent Bundle' => [
        'entity_type_id' => 'node',
        'bundle' => 'content_type_3',
        'expected_fields' => [],
      ],
    ];
  }

  /**
   * Test the protected getCoreVersion method.
   *
   * @param string[] $tags
   *   The migration tags.
   * @param string|bool $expected_result
   *   The expected return value of the method.
   *
   * @covers ::getCoreVersion
   * @dataProvider getCoreVersionData
   */
  public function testGetCoreVersion(array $tags, $expected_result) {
    $migration = $this
      ->prophesize(MigrationInterface::class);
    $migration
      ->getMigrationTags()
      ->willReturn($tags);
    $field_discovery = new FieldDiscoveryTestClass($this->fieldPluginManager
      ->reveal(), $this->migrationPluginManager
      ->reveal(), $this->logger
      ->reveal());
    if (!$expected_result) {
      $this
        ->expectException(\InvalidArgumentException::class);
    }
    $actual_result = $field_discovery
      ->getCoreVersion($migration
      ->reveal());
    $this
      ->assertEquals($expected_result, $actual_result);
  }

  /**
   * Provides data for testGetCoreVersion()
   *
   * @return array
   *   The test data.
   */
  public function getCoreVersionData() {
    return [
      'Drupal 7' => [
        'tags' => [
          'Drupal 7',
        ],
        'result' => '7',
      ],
      'Drupal 6' => [
        'tags' => [
          'Drupal 6',
        ],
        'result' => '6',
      ],
      'D7 with others' => [
        'tags' => [
          'Drupal 7',
          'Translation',
          'Other Tag',
        ],
        'result' => '7',
      ],
      'Both (d7 has priority)' => [
        'tags' => [
          'Drupal 6',
          'Drupal 7',
        ],
        'result' => '7',
      ],
      'Neither' => [
        'tags' => [
          'drupal 6',
          'Drupal_6',
          'This contains Drupal 7 but is not',
        ],
        'result' => FALSE,
      ],
    ];
  }

  /**
   * Returns dummy data to test the field getters.
   */
  protected function getAllFieldData() {
    return [
      'node' => [
        'content_type_1' => [
          'field_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'field_2' => [
            'field_info_key' => 'field_2_data',
          ],
          'field_3' => [
            'field_info_key' => 'field_3_data',
          ],
        ],
        'content_type_2' => [
          'field_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'field_4' => [
            'field_info_key' => 'field_4_data',
          ],
          'field_5' => [
            'field_info_key' => 'field_5_data',
          ],
        ],
      ],
      'user' => [
        'user' => [
          'user_field_1' => [
            'field_info_key' => 'user_field_1_data',
          ],
        ],
      ],
      'comment' => [
        'comment_node_content_type_1' => [
          'cfield_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'cfield_2' => [
            'field_info_key' => 'field_2_data',
          ],
          'cfield_3' => [
            'field_info_key' => 'field_3_data',
          ],
        ],
        'comment_node_content_type_2' => [
          'cfield_1' => [
            'field_info_key' => 'field_1_data',
          ],
          'cfield_4' => [
            'field_info_key' => 'field_4_data',
          ],
          'cfield_5' => [
            'field_info_key' => 'field_5_data',
          ],
        ],
      ],
    ];
  }

  /**
   * Tests the getFieldInstanceStubMigration method.
   *
   * @param mixed $core
   *   The Drupal core version.
   * @param array|bool $expected_definition
   *   The expected migration definition, or false if an exception is expected.
   *
   * @covers ::getFieldInstanceStubMigrationDefinition
   * @dataProvider getFieldInstanceStubMigrationDefinition
   */
  public function testGetFieldInstanceStubMigrationDefinition($core, $expected_definition) {
    $field_discovery = new FieldDiscoveryTestClass($this->fieldPluginManager
      ->reveal(), $this->migrationPluginManager
      ->reveal(), $this->logger
      ->reveal());
    if (!$expected_definition) {
      $this
        ->expectException(\InvalidArgumentException::class);
      $this
        ->expectExceptionMessage(sprintf("Drupal version %s is not supported. Valid values for Drupal core version are '6' and '7'.", $core));
    }
    $actual_definition = $field_discovery
      ->getFieldInstanceStubMigrationDefinition($core);
    $this
      ->assertSame($expected_definition, $actual_definition);
  }

  /**
   * Provides data for testGetFieldInstanceStubMigrationDefinition.
   *
   * @return array
   *   The data.
   */
  public function getFieldInstanceStubMigrationDefinition() {
    return [
      'Drupal 6' => [
        'core' => FieldDiscoveryInterface::DRUPAL_6,
        'expected_definition' => [
          'destination' => [
            'plugin' => 'null',
          ],
          'idMap' => [
            'plugin' => 'null',
          ],
          'source' => [
            'ignore_map' => TRUE,
            'plugin' => 'd6_field_instance',
          ],
        ],
      ],
      'Drupal 7' => [
        'core' => FieldDiscoveryInterface::DRUPAL_7,
        'expected_definition' => [
          'destination' => [
            'plugin' => 'null',
          ],
          'idMap' => [
            'plugin' => 'null',
          ],
          'source' => [
            'ignore_map' => TRUE,
            'plugin' => 'd7_field_instance',
          ],
        ],
      ],
    ];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
FieldDiscoveryTest::$fieldPluginManager	protected	property	A MigrateFieldPluginManager prophecy.
FieldDiscoveryTest::$logger	protected	property	A LoggerChannelInterface prophecy.
FieldDiscoveryTest::$migrationPluginManager	protected	property	A MigrationPluginManager prophecy.
FieldDiscoveryTest::getAllFieldData	protected	function	Returns dummy data to test the field getters.
FieldDiscoveryTest::getBundleFieldsData	public	function	Provides data for testGetBundleFields.
FieldDiscoveryTest::getCoreVersionData	public	function	Provides data for testGetCoreVersion()
FieldDiscoveryTest::getEntityFieldsData	public	function	Provides data for testGetEntityFields.
FieldDiscoveryTest::getFieldInstanceStubMigrationDefinition	public	function	Provides data for testGetFieldInstanceStubMigrationDefinition.
FieldDiscoveryTest::setUp	public	function	Overrides UnitTestCase::setUp
FieldDiscoveryTest::testGetBundleFields	public	function	Tests the protected getEntityFields method.
FieldDiscoveryTest::testGetCoreVersion	public	function	Test the protected getCoreVersion method.
FieldDiscoveryTest::testGetEntityFields	public	function	Tests the protected getEntityFields method.
FieldDiscoveryTest::testGetFieldInstanceStubMigrationDefinition	public	function	Tests the getFieldInstanceStubMigration method.
PhpunitCompatibilityTrait::getMock Deprecated	public	function	Returns a mock object for the specified class using the available method.
PhpunitCompatibilityTrait::setExpectedException Deprecated	public	function	Compatibility layer for PHPUnit 6 to support PHPUnit 4 code.
UnitTestCase::$randomGenerator	protected	property	The random generator.
UnitTestCase::$root	protected	property	The app root.	1
UnitTestCase::assertArrayEquals	protected	function	Asserts if two arrays are equal by sorting them first.
UnitTestCase::getBlockMockWithMachineName Deprecated	protected	function	Mocks a block with a block plugin.	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.