trait WorkspaceTestTrait

Same name in other branches
  1. 9 core/modules/workspaces/tests/src/Kernel/WorkspaceTestTrait.php \Drupal\Tests\workspaces\Kernel\WorkspaceTestTrait
  2. 8.9.x core/modules/workspaces/tests/src/Kernel/WorkspaceTestTrait.php \Drupal\Tests\workspaces\Kernel\WorkspaceTestTrait
  3. 11.x core/modules/workspaces/tests/src/Kernel/WorkspaceTestTrait.php \Drupal\Tests\workspaces\Kernel\WorkspaceTestTrait

A trait with common workspaces testing functionality.

Hierarchy

1 file declares its use of WorkspaceTestTrait
WorkspacesContentModerationStateTest.php in core/modules/content_moderation/tests/src/Kernel/WorkspacesContentModerationStateTest.php

File

core/modules/workspaces/tests/src/Kernel/WorkspaceTestTrait.php, line 13

Namespace

Drupal\Tests\workspaces\Kernel
View source
trait WorkspaceTestTrait {
    
    /**
     * The workspaces manager.
     *
     * @var \Drupal\workspaces\WorkspaceManagerInterface
     */
    protected $workspaceManager;
    
    /**
     * An array of test workspaces, keyed by workspace ID.
     *
     * @var \Drupal\workspaces\WorkspaceInterface[]
     */
    protected $workspaces = [];
    
    /**
     * Enables the Workspaces module and creates two workspaces.
     */
    protected function initializeWorkspacesModule() {
        // Enable the Workspaces module here instead of the static::$modules array
        // so we can test it with default content.
        $this->enableModules([
            'workspaces',
        ]);
        $this->container = \Drupal::getContainer();
        $this->entityTypeManager = \Drupal::entityTypeManager();
        $this->workspaceManager = \Drupal::service('workspaces.manager');
        $this->installEntitySchema('workspace');
        $this->installSchema('workspaces', [
            'workspace_association',
        ]);
        // Install the entity schema for supported entity types to ensure that the
        // 'workspace' revision metadata field gets created.
        foreach (array_keys(\Drupal::service('workspaces.information')->getSupportedEntityTypes()) as $entity_type_id) {
            $this->installEntitySchema($entity_type_id);
        }
        // Create two workspaces by default, 'live' and 'stage'.
        $this->workspaces['live'] = Workspace::create([
            'id' => 'live',
            'label' => 'Live',
        ]);
        $this->workspaces['live']
            ->save();
        $this->workspaces['stage'] = Workspace::create([
            'id' => 'stage',
            'label' => 'Stage',
        ]);
        $this->workspaces['stage']
            ->save();
        $permissions = array_intersect([
            'administer nodes',
            'create workspace',
            'edit any workspace',
            'view any workspace',
        ], array_keys($this->container
            ->get('user.permissions')
            ->getPermissions()));
        $this->setCurrentUser($this->createUser($permissions));
    }
    
    /**
     * Sets a given workspace as active.
     *
     * @param string $workspace_id
     *   The ID of the workspace to switch to.
     */
    protected function switchToWorkspace($workspace_id) {
        // Switch the test runner's context to the specified workspace.
        $workspace = $this->entityTypeManager
            ->getStorage('workspace')
            ->load($workspace_id);
        \Drupal::service('workspaces.manager')->setActiveWorkspace($workspace);
    }
    
    /**
     * Switches the test runner's context to Live.
     */
    protected function switchToLive() : void {
        \Drupal::service('workspaces.manager')->switchToLive();
    }
    
    /**
     * Creates a test workspace hierarchy.
     *
     * The full hierarchy including the default workspaces 'live' and 'stage' is:
     *
     * live
     * - stage
     *   - dev
     *     - local_1
     *     - local_2
     * - qa
     */
    protected function createWorkspaceHierarchy() {
        $this->workspaces['dev'] = Workspace::create([
            'id' => 'dev',
            'parent' => 'stage',
            'label' => 'dev',
        ]);
        $this->workspaces['dev']
            ->save();
        $this->workspaces['local_1'] = Workspace::create([
            'id' => 'local_1',
            'parent' => 'dev',
            'label' => 'local_1',
        ]);
        $this->workspaces['local_1']
            ->save();
        $this->workspaces['local_2'] = Workspace::create([
            'id' => 'local_2',
            'parent' => 'dev',
            'label' => 'local_2',
        ]);
        $this->workspaces['local_2']
            ->save();
        $this->workspaces['qa'] = Workspace::create([
            'id' => 'qa',
            'parent' => 'live',
            'label' => 'qa',
        ]);
        $this->workspaces['qa']
            ->save();
    }
    
    /**
     * Checks the workspace_association records for a test scenario.
     *
     * @param array $expected
     *   An array of expected values, as defined in ::testWorkspaces().
     * @param string $entity_type_id
     *   The ID of the entity type that is being tested.
     */
    protected function assertWorkspaceAssociation(array $expected, $entity_type_id) {
        
        /** @var \Drupal\workspaces\WorkspaceAssociationInterface $workspace_association */
        $workspace_association = \Drupal::service('workspaces.association');
        foreach ($expected as $workspace_id => $expected_tracked_revision_ids) {
            $tracked_entities = $workspace_association->getTrackedEntities($workspace_id, $entity_type_id);
            $tracked_revision_ids = $tracked_entities[$entity_type_id] ?? [];
            $this->assertEquals($expected_tracked_revision_ids, array_keys($tracked_revision_ids));
        }
    }
    
    /**
     * Returns all the revisions which are not associated with any workspace.
     *
     * @param string $entity_type_id
     *   An entity type ID to find revisions for.
     * @param int[]|string[]|null $entity_ids
     *   (optional) An array of entity IDs to filter the results by. Defaults to
     *   NULL.
     *
     * @return array
     *   An array of entity IDs, keyed by revision IDs.
     */
    protected function getUnassociatedRevisions($entity_type_id, $entity_ids = NULL) {
        $entity_type = \Drupal::entityTypeManager()->getDefinition($entity_type_id);
        $query = \Drupal::entityTypeManager()->getStorage($entity_type_id)
            ->getQuery()
            ->allRevisions()
            ->accessCheck(FALSE)
            ->notExists($entity_type->get('revision_metadata_keys')['workspace']);
        if ($entity_ids) {
            $query->condition($entity_type->getKey('id'), $entity_ids, 'IN');
        }
        return $query->execute();
    }
    
    /**
     * Marks an entity type as ignored in a workspace.
     *
     * @param string $entity_type_id
     *   The entity type ID.
     */
    protected function ignoreEntityType(string $entity_type_id) : void {
        $entity_type = clone \Drupal::entityTypeManager()->getDefinition($entity_type_id);
        $entity_type->setHandlerClass('workspace', IgnoredWorkspaceHandler::class);
        \Drupal::state()->set("{$entity_type_id}.entity_type", $entity_type);
        \Drupal::entityTypeManager()->clearCachedDefinitions();
    }

}

Members

Title Sort descending Modifiers Object type Summary Overrides
WorkspaceTestTrait::$workspaceManager protected property The workspaces manager. 1
WorkspaceTestTrait::$workspaces protected property An array of test workspaces, keyed by workspace ID.
WorkspaceTestTrait::assertWorkspaceAssociation protected function Checks the workspace_association records for a test scenario.
WorkspaceTestTrait::createWorkspaceHierarchy protected function Creates a test workspace hierarchy.
WorkspaceTestTrait::getUnassociatedRevisions protected function Returns all the revisions which are not associated with any workspace.
WorkspaceTestTrait::ignoreEntityType protected function Marks an entity type as ignored in a workspace.
WorkspaceTestTrait::initializeWorkspacesModule protected function Enables the Workspaces module and creates two workspaces.
WorkspaceTestTrait::switchToLive protected function Switches the test runner's context to Live.
WorkspaceTestTrait::switchToWorkspace protected function Sets a given workspace as active.

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