class PluginManagerBaseTest

Same name and namespace in other branches
  1. 9 core/tests/Drupal/Tests/Component/Plugin/PluginManagerBaseTest.php \Drupal\Tests\Component\Plugin\PluginManagerBaseTest
  2. 8.9.x core/tests/Drupal/Tests/Component/Plugin/PluginManagerBaseTest.php \Drupal\Tests\Component\Plugin\PluginManagerBaseTest
  3. 11.x core/tests/Drupal/Tests/Component/Plugin/PluginManagerBaseTest.php \Drupal\Tests\Component\Plugin\PluginManagerBaseTest

@coversDefaultClass \Drupal\Component\Plugin\PluginManagerBase
@group Plugin

Hierarchy

  • class \Drupal\Tests\Component\Plugin\PluginManagerBaseTest uses \Prophecy\PhpUnit\ProphecyTrait implements \PHPUnit\Framework\TestCase

Expanded class hierarchy of PluginManagerBaseTest

File

core/tests/Drupal/Tests/Component/Plugin/PluginManagerBaseTest.php, line 17

Namespace

Drupal\Tests\Component\Plugin
View source
class PluginManagerBaseTest extends TestCase {
  use ProphecyTrait;
  
  /**
   * A callback method for mocking FactoryInterface objects.
   */
  public function createInstanceCallback() {
    $args = func_get_args();
    $plugin_id = $args[0];
    $configuration = $args[1];
    if ('invalid' == $plugin_id) {
      throw new PluginNotFoundException($plugin_id);
    }
    return [
      'plugin_id' => $plugin_id,
      'configuration' => $configuration,
    ];
  }
  
  /**
   * Generates a mocked FactoryInterface object with known properties.
   */
  public function getMockFactoryInterface($expects_count) {
    $mock_factory = $this->createMock('Drupal\\Component\\Plugin\\Factory\\FactoryInterface');
    $mock_factory->expects($this->exactly($expects_count))
      ->method('createInstance')
      ->willReturnCallback([
      $this,
      'createInstanceCallback',
    ]);
    return $mock_factory;
  }
  
  /**
   * Tests createInstance() with no fallback methods.
   *
   * @covers ::createInstance
   */
  public function testCreateInstance() : void {
    $manager = $this->getMockBuilder('Drupal\\Component\\Plugin\\PluginManagerBase')
      ->getMockForAbstractClass();
    // PluginManagerBase::createInstance() looks for a factory object and then
    // calls createInstance() on it. So we have to mock a factory object.
    $factory_ref = new \ReflectionProperty($manager, 'factory');
    $factory_ref->setValue($manager, $this->getMockFactoryInterface(1));
    // Finally the test.
    $configuration_array = [
      'config' => 'something',
    ];
    $result = $manager->createInstance('valid', $configuration_array);
    $this->assertEquals('valid', $result['plugin_id']);
    $this->assertEquals($configuration_array, $result['configuration']);
  }
  
  /**
   * Tests createInstance() with a fallback method.
   *
   * @covers ::createInstance
   */
  public function testCreateInstanceFallback() : void {
    // We use our special stub class which extends PluginManagerBase and also
    // implements FallbackPluginManagerInterface.
    $manager = new StubFallbackPluginManager();
    // Put our stubbed factory on the base object.
    $factory_ref = new \ReflectionProperty($manager, 'factory');
    // Set up the configuration array.
    $configuration_array = [
      'config' => 'something',
    ];
    // Test with fallback interface and valid plugin_id.
    $factory_ref->setValue($manager, $this->getMockFactoryInterface(1));
    $no_fallback_result = $manager->createInstance('valid', $configuration_array);
    $this->assertEquals('valid', $no_fallback_result['plugin_id']);
    $this->assertEquals($configuration_array, $no_fallback_result['configuration']);
    // Test with fallback interface and invalid plugin_id.
    $factory_ref->setValue($manager, $this->getMockFactoryInterface(2));
    $fallback_result = $manager->createInstance('invalid', $configuration_array);
    $this->assertEquals('invalid_fallback', $fallback_result['plugin_id']);
    $this->assertEquals($configuration_array, $fallback_result['configuration']);
  }
  
  /**
   * @covers ::getInstance
   */
  public function testGetInstance() : void {
    $options = [
      'foo' => 'F00',
      'bar' => 'bAr',
    ];
    $instance = new \stdClass();
    $mapper = $this->prophesize(MapperInterface::class);
    $mapper->getInstance($options)
      ->shouldBeCalledTimes(1)
      ->willReturn($instance);
    $manager = new StubPluginManagerBaseWithMapper($mapper->reveal());
    $this->assertEquals($instance, $manager->getInstance($options));
  }
  
  /**
   * @covers ::getInstance
   */
  public function testGetInstanceWithoutMapperShouldThrowException() : void {
    $options = [
      'foo' => 'F00',
      'bar' => 'bAr',
    ];
    /** @var \Drupal\Component\Plugin\PluginManagerBase $manager */
    $manager = $this->getMockBuilder(PluginManagerBase::class)
      ->getMockForAbstractClass();
    // Set the expected exception thrown by ::getInstance.
    $this->expectException(\BadMethodCallException::class);
    $this->expectExceptionMessage(sprintf('%s does not support this method unless %s::$mapper is set.', get_class($manager), get_class($manager)));
    $manager->getInstance($options);
  }

}

Members

Title Sort descending Modifiers Object type Summary
PluginManagerBaseTest::createInstanceCallback public function A callback method for mocking FactoryInterface objects.
PluginManagerBaseTest::getMockFactoryInterface public function Generates a mocked FactoryInterface object with known properties.
PluginManagerBaseTest::testCreateInstance public function Tests createInstance() with no fallback methods.
PluginManagerBaseTest::testCreateInstanceFallback public function Tests createInstance() with a fallback method.
PluginManagerBaseTest::testGetInstance public function @covers ::getInstance[[api-linebreak]]
PluginManagerBaseTest::testGetInstanceWithoutMapperShouldThrowException public function @covers ::getInstance[[api-linebreak]]

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