class EntityContextDefinitionIsSatisfiedTest
Tests Drupal\Core\Plugin\Context\EntityContextDefinition.
Attributes
#[CoversClass(EntityContextDefinition::class)]
#[Group('Plugin')]
  Hierarchy
- class \Drupal\Tests\UnitTestCase uses \Drupal\Tests\PhpUnitCompatibilityTrait, \Prophecy\PhpUnit\ProphecyTrait, \Drupal\TestTools\Extension\DeprecationBridge\ExpectDeprecationTrait, \Drupal\Tests\RandomGeneratorTrait extends \PHPUnit\Framework\TestCase- class \Drupal\Tests\Core\Plugin\Context\EntityContextDefinitionIsSatisfiedTest extends \Drupal\Tests\UnitTestCase
 
Expanded class hierarchy of EntityContextDefinitionIsSatisfiedTest
File
- 
              core/tests/ Drupal/ Tests/ Core/ Plugin/ Context/ EntityContextDefinitionIsSatisfiedTest.php, line 34 
Namespace
Drupal\Tests\Core\Plugin\ContextView source
class EntityContextDefinitionIsSatisfiedTest extends UnitTestCase {
  
  /**
   * The entity type manager.
   *
   * @var \Drupal\Core\Entity\EntityTypeManagerInterface
   */
  protected $entityTypeManager;
  
  /**
   * The entity type bundle info.
   *
   * @var \Drupal\Core\Entity\EntityTypeBundleInfoInterface
   */
  protected $entityTypeBundleInfo;
  
  /**
   * {@inheritdoc}
   */
  protected function setUp() : void {
    parent::setUp();
    $namespaces = new \ArrayObject([
      'Drupal\\Core\\TypedData' => $this->root . '/core/lib/Drupal/Core/TypedData',
      'Drupal\\Core\\Validation' => $this->root . '/core/lib/Drupal/Core/Validation',
      'Drupal\\Core\\Entity' => $this->root . '/core/lib/Drupal/Core/Entity',
    ]);
    $cache_backend = new NullBackend('cache');
    $module_handler = $this->prophesize(ModuleHandlerInterface::class);
    $class_resolver = $this->prophesize(ClassResolverInterface::class);
    $class_resolver->getInstanceFromDefinition(Argument::type('string'))
      ->will(function ($arguments) {
      $class_name = $arguments[0];
      return new $class_name();
    });
    $type_data_manager = new TypedDataManager($namespaces, $cache_backend, $module_handler->reveal(), $class_resolver->reveal());
    $type_data_manager->setValidationConstraintManager(new ConstraintManager($namespaces, $cache_backend, $module_handler->reveal()));
    $this->entityTypeManager = $this->prophesize(EntityTypeManagerInterface::class);
    $this->entityTypeBundleInfo = $this->prophesize(EntityTypeBundleInfoInterface::class);
    $string_translation = new TranslationManager(new LanguageDefault([]));
    $container = new ContainerBuilder();
    $container->set('typed_data_manager', $type_data_manager);
    $container->set('entity_type.manager', $this->entityTypeManager
      ->reveal());
    $container->set('entity_type.bundle.info', $this->entityTypeBundleInfo
      ->reveal());
    $container->set('string_translation', $string_translation);
    \Drupal::setContainer($container);
  }
  
  /**
   * Asserts that the requirement is satisfied as expected.
   *
   * @param bool $expected
   *   The expected outcome.
   * @param \Drupal\Core\Plugin\Context\ContextDefinition $requirement
   *   The requirement to check against.
   * @param \Drupal\Core\Plugin\Context\ContextDefinition $definition
   *   The context definition to check.
   * @param mixed $value
   *   (optional) The value to set on the context, defaults to NULL.
   *
   * @internal
   */
  protected function assertRequirementIsSatisfied(bool $expected, ContextDefinition $requirement, ContextDefinition $definition, $value = NULL) : void {
    $context = new EntityContext($definition, $value);
    $this->assertSame($expected, $requirement->isSatisfiedBy($context));
  }
  
  /**
   * Tests is satisfied by.
   *
   * @legacy-covers ::isSatisfiedBy
   * @legacy-covers ::dataTypeMatches
   * @legacy-covers ::getSampleValues
   * @legacy-covers ::getConstraintObjects
   */
  public function testIsSatisfiedBy($expected, ContextDefinition $requirement, ContextDefinition $definition, $value = NULL) : void {
    $entity_storage = $this->prophesize(EntityStorageInterface::class);
    $content_entity_storage = $this->prophesize(ContentEntityStorageInterface::class);
    $this->entityTypeManager
      ->getStorage('test_config')
      ->willReturn($entity_storage->reveal());
    $this->entityTypeManager
      ->getStorage('test_content')
      ->willReturn($content_entity_storage->reveal());
    $config_entity_type = new EntityType([
      'id' => 'test_config',
    ]);
    $content_entity_type = new EntityType([
      'id' => 'test_content',
    ]);
    $this->entityTypeManager
      ->getDefinition('test_config')
      ->willReturn($config_entity_type);
    $this->entityTypeManager
      ->getDefinition('test_content')
      ->willReturn($content_entity_type);
    $this->entityTypeManager
      ->getDefinitions()
      ->willReturn([
      'test_config' => $config_entity_type,
      'test_content' => $content_entity_type,
    ]);
    $this->entityTypeBundleInfo
      ->getBundleInfo('test_config')
      ->willReturn([
      'test_config' => [
        'label' => 'test_config',
      ],
    ]);
    $this->entityTypeBundleInfo
      ->getBundleInfo('test_content')
      ->willReturn([
      'test_content' => [
        'label' => 'test_content',
      ],
    ]);
    $this->assertRequirementIsSatisfied($expected, $requirement, $definition, $value);
  }
  
  /**
   * Provides test data for ::testIsSatisfiedBy().
   */
  public static function providerTestIsSatisfiedBy() {
    $data = [];
    $content = new EntityType([
      'id' => 'test_content',
    ]);
    $config = new EntityType([
      'id' => 'test_config',
    ]);
    // Entities without bundles.
    $data['content entity, matching type, no value'] = [
      TRUE,
      EntityContextDefinition::fromEntityType($content),
      EntityContextDefinition::fromEntityType($content),
    ];
    $entity = (new Prophet())->prophesize(ContentEntityInterface::class)
      ->willImplement(\IteratorAggregate::class);
    $entity->getIterator()
      ->willReturn(new \ArrayIterator([]));
    $entity->getCacheContexts()
      ->willReturn([]);
    $entity->getCacheTags()
      ->willReturn([]);
    $entity->getCacheMaxAge()
      ->willReturn(0);
    $entity->getEntityTypeId()
      ->willReturn('test_content');
    $data['content entity, matching type, correct value'] = [
      TRUE,
      EntityContextDefinition::fromEntityType($content),
      EntityContextDefinition::fromEntityType($content),
      $entity->reveal(),
    ];
    $data['content entity, incorrect manual constraint'] = [
      TRUE,
      EntityContextDefinition::fromEntityType($content),
      EntityContextDefinition::fromEntityType($content)->addConstraint('EntityType', 'test_config'),
    ];
    $data['config entity, matching type, no value'] = [
      TRUE,
      EntityContextDefinition::fromEntityType($config),
      EntityContextDefinition::fromEntityType($config),
    ];
    $data['generic entity requirement, specific context'] = [
      TRUE,
      new ContextDefinition('entity'),
      EntityContextDefinition::fromEntityType($config),
    ];
    $data['specific requirement, generic entity context'] = [
      FALSE,
      EntityContextDefinition::fromEntityType($content),
      new ContextDefinition('entity'),
    ];
    return $data;
  }
  
  /**
   * Tests is satisfied by generate bundled entity.
   *
   * @legacy-covers ::isSatisfiedBy
   * @legacy-covers ::dataTypeMatches
   * @legacy-covers ::getSampleValues
   * @legacy-covers ::getConstraintObjects
   */
  public function testIsSatisfiedByGenerateBundledEntity($expected, array $requirement_bundles, array $candidate_bundles, ?array $bundles_to_instantiate = NULL) : void {
    // If no bundles are explicitly specified, instantiate all bundles.
    if (!$bundles_to_instantiate) {
      $bundles_to_instantiate = $candidate_bundles;
    }
    $content_entity_storage = $this->prophesize(ContentEntityStorageInterface::class);
    foreach ($bundles_to_instantiate as $bundle) {
      $entity = $this->prophesize(ContentEntityInterface::class)
        ->willImplement(\IteratorAggregate::class);
      $entity->getEntityTypeId()
        ->willReturn('test_content');
      $entity->getIterator()
        ->willReturn(new \ArrayIterator([]));
      $entity->bundle()
        ->willReturn($bundle);
      $content_entity_storage->create([
        'the_bundle_key' => $bundle,
      ])
        ->willReturn($entity->reveal())
        ->shouldBeCalled();
    }
    // Creating entities with sample values can lead to performance issues when
    // called many times. Ensure that createWithSampleValues() is not called.
    $content_entity_storage->createWithSampleValues(Argument::any())
      ->shouldNotBeCalled();
    $entity_type = new EntityType([
      'id' => 'test_content',
      'entity_keys' => [
        'bundle' => 'the_bundle_key',
      ],
    ]);
    $this->entityTypeManager
      ->getStorage('test_content')
      ->willReturn($content_entity_storage->reveal());
    $this->entityTypeManager
      ->getDefinition('test_content')
      ->willReturn($entity_type);
    $this->entityTypeManager
      ->getDefinitions()
      ->willReturn([
      'test_content' => $entity_type,
    ]);
    $this->entityTypeBundleInfo
      ->getBundleInfo('test_content')
      ->willReturn([
      'first_bundle' => [
        'label' => 'First bundle',
      ],
      'second_bundle' => [
        'label' => 'Second bundle',
      ],
      'third_bundle' => [
        'label' => 'Third bundle',
      ],
    ]);
    $requirement = EntityContextDefinition::fromEntityType($entity_type);
    if ($requirement_bundles) {
      $requirement->addConstraint('Bundle', $requirement_bundles);
    }
    $definition = EntityContextDefinition::fromEntityType($entity_type)->addConstraint('Bundle', $candidate_bundles);
    $this->assertRequirementIsSatisfied($expected, $requirement, $definition);
  }
  
  /**
   * Provides test data for ::testIsSatisfiedByGenerateBundledEntity().
   */
  public static function providerTestIsSatisfiedByGenerateBundledEntity() {
    $data = [];
    $data['no requirement'] = [
      TRUE,
      [],
      [
        'first_bundle',
      ],
    ];
    $data['single requirement'] = [
      TRUE,
      [
        'first_bundle',
      ],
      [
        'first_bundle',
      ],
    ];
    $data['single requirement, multiple candidates, satisfies last candidate'] = [
      TRUE,
      [
        'third_bundle',
      ],
      [
        'first_bundle',
        'second_bundle',
        'third_bundle',
      ],
    ];
    $data['single requirement, multiple candidates, satisfies first candidate'] = [
      TRUE,
      [
        'first_bundle',
      ],
      [
        'first_bundle',
        'second_bundle',
        'third_bundle',
      ],
      // Once the first match is found, subsequent candidates are not checked.
[
        'first_bundle',
      ],
    ];
    $data['unsatisfied requirement'] = [
      FALSE,
      [
        'second_bundle',
      ],
      [
        'first_bundle',
        'third_bundle',
      ],
    ];
    $data['multiple requirements'] = [
      TRUE,
      [
        'first_bundle',
        'second_bundle',
      ],
      [
        'first_bundle',
      ],
    ];
    return $data;
  }
  
  /**
   * Tests is satisfied by pass bundled entity.
   *
   * @legacy-covers ::isSatisfiedBy
   * @legacy-covers ::dataTypeMatches
   * @legacy-covers ::getSampleValues
   * @legacy-covers ::getConstraintObjects
   */
  public function testIsSatisfiedByPassBundledEntity($expected, $requirement_constraint) : void {
    $entity_type = new EntityType([
      'id' => 'test_content',
    ]);
    $this->entityTypeManager
      ->getDefinitions()
      ->willReturn([
      'test_content' => $entity_type,
    ]);
    $this->entityTypeManager
      ->getDefinition('test_content')
      ->willReturn($entity_type);
    $this->entityTypeManager
      ->getStorage('test_content')
      ->shouldNotBeCalled();
    $this->entityTypeBundleInfo
      ->getBundleInfo('test_content')
      ->willReturn([
      'first_bundle' => [
        'label' => 'First bundle',
      ],
      'second_bundle' => [
        'label' => 'Second bundle',
      ],
      'third_bundle' => [
        'label' => 'Third bundle',
      ],
    ]);
    $entity = $this->prophesize(ContentEntityInterface::class)
      ->willImplement(\IteratorAggregate::class);
    $entity->getEntityTypeId()
      ->willReturn('test_content');
    $entity->getIterator()
      ->willReturn(new \ArrayIterator([]));
    $entity->getCacheContexts()
      ->willReturn([]);
    $entity->getCacheTags()
      ->willReturn([]);
    $entity->getCacheMaxAge()
      ->willReturn(0);
    $entity->bundle()
      ->willReturn('third_bundle');
    $requirement = EntityContextDefinition::fromEntityTypeId('test_content');
    if ($requirement_constraint) {
      $requirement->addConstraint('Bundle', $requirement_constraint);
    }
    $definition = EntityContextDefinition::fromEntityTypeId('test_content');
    $this->assertRequirementIsSatisfied($expected, $requirement, $definition, $entity->reveal());
  }
  
  /**
   * Provides test data for ::testIsSatisfiedByPassBundledEntity().
   */
  public static function providerTestIsSatisfiedByPassBundledEntity() {
    $data = [];
    $data[] = [
      TRUE,
      [],
    ];
    $data[] = [
      FALSE,
      [
        'first_bundle',
      ],
    ];
    $data[] = [
      FALSE,
      [
        'second_bundle',
      ],
    ];
    $data[] = [
      TRUE,
      [
        'third_bundle',
      ],
    ];
    $data[] = [
      TRUE,
      [
        'first_bundle',
        'second_bundle',
        'third_bundle',
      ],
    ];
    $data[] = [
      FALSE,
      [
        'first_bundle',
        'second_bundle',
      ],
    ];
    $data[] = [
      TRUE,
      [
        'first_bundle',
        'third_bundle',
      ],
    ];
    $data[] = [
      TRUE,
      [
        'second_bundle',
        'third_bundle',
      ],
    ];
    return $data;
  }
}Members
| Title Sort descending | Modifiers | Object type | Summary | Overriden Title | 
|---|---|---|---|---|
| EntityContextDefinitionIsSatisfiedTest::$entityTypeBundleInfo | protected | property | The entity type bundle info. | |
| EntityContextDefinitionIsSatisfiedTest::$entityTypeManager | protected | property | The entity type manager. | |
| EntityContextDefinitionIsSatisfiedTest::assertRequirementIsSatisfied | protected | function | Asserts that the requirement is satisfied as expected. | |
| EntityContextDefinitionIsSatisfiedTest::providerTestIsSatisfiedBy | public static | function | Provides test data for ::testIsSatisfiedBy(). | |
| EntityContextDefinitionIsSatisfiedTest::providerTestIsSatisfiedByGenerateBundledEntity | public static | function | Provides test data for ::testIsSatisfiedByGenerateBundledEntity(). | |
| EntityContextDefinitionIsSatisfiedTest::providerTestIsSatisfiedByPassBundledEntity | public static | function | Provides test data for ::testIsSatisfiedByPassBundledEntity(). | |
| EntityContextDefinitionIsSatisfiedTest::setUp | protected | function | Overrides UnitTestCase::setUp | |
| EntityContextDefinitionIsSatisfiedTest::testIsSatisfiedBy | public | function | Tests is satisfied by. | |
| EntityContextDefinitionIsSatisfiedTest::testIsSatisfiedByGenerateBundledEntity | public | function | Tests is satisfied by generate bundled entity. | |
| EntityContextDefinitionIsSatisfiedTest::testIsSatisfiedByPassBundledEntity | public | function | Tests is satisfied by pass bundled entity. | |
| ExpectDeprecationTrait::expectDeprecation | public | function | Adds an expected deprecation. | |
| ExpectDeprecationTrait::setUpErrorHandler | public | function | Sets up the test error handler. | |
| ExpectDeprecationTrait::tearDownErrorHandler | public | function | Tears down the test error handler. | |
| 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. | |
| UnitTestCase::$root | protected | property | The app root. | |
| 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::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::setDebugDumpHandler | public static | function | Registers the dumper CLI handler when the DebugDump extension is enabled. | |
| UnitTestCase::setupMockIterator | protected | function | Set up a traversable class mock to return specific items when iterated. | 
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.
