ExtensionDiscoveryTest.php in Drupal 8

Namespace

Drupal\Tests\Core\Extension

File

core/tests/Drupal/Tests/Core/Extension/ExtensionDiscoveryTest.php

<?php

namespace Drupal\Tests\Core\Extension;

use Drupal\Core\Extension\Extension;
use Drupal\Core\Extension\ExtensionDiscovery;
use Drupal\Tests\UnitTestCase;
use org\bovigo\vfs\vfsStream;
use Symfony\Component\Yaml\Yaml;

/**
 * Tests discovery of extensions.
 *
 * @coversDefaultClass \Drupal\Core\Extension\ExtensionDiscovery
 * @group Extension
 */
class ExtensionDiscoveryTest extends UnitTestCase {

  /**
   * Tests extension discovery in a virtual filesystem with vfsStream.
   *
   * @covers ::scan
   */
  public function testExtensionDiscoveryVfs() {

    // Set up the file system.
    $filesystem = [];
    $files_by_type_and_name_expected = $this
      ->populateFilesystemStructure($filesystem);
    $vfs = vfsStream::setup('root', NULL, $filesystem);
    $root = $vfs
      ->url();
    $this
      ->assertFileExists($root . '/core/modules/system/system.module');
    $this
      ->assertFileExists($root . '/core/modules/system/system.info.yml');

    // Create an ExtensionDiscovery with $root.
    $extension_discovery = new ExtensionDiscovery($root, FALSE, NULL, 'sites/default');

    /** @var \Drupal\Core\Extension\Extension[][] $extensions_by_type */
    $extensions_by_type = [];
    $files_by_type_and_name = [];
    foreach ([
      'profile',
      'module',
      'theme',
      'theme_engine',
    ] as $type) {
      $extensions_by_type[$type] = $extension_discovery
        ->scan($type, FALSE);
      foreach ($extensions_by_type[$type] as $name => $extension) {
        $files_by_type_and_name[$type][$name] = $extension
          ->getPathname();
      }
      if ($type === 'profile') {

        // Set profile directories for discovery of the other extension types.
        $extension_discovery
          ->setProfileDirectories([
          'myprofile' => 'profiles/myprofile',
        ]);
      }
    }
    $this
      ->assertEquals($files_by_type_and_name_expected, $files_by_type_and_name);
    $extension_expected = new Extension($root, 'module', 'core/modules/system/system.info.yml', 'system.module');
    $extension_expected->subpath = 'modules/system';
    $extension_expected->origin = 'core';
    $this
      ->assertEquals($extension_expected, $extensions_by_type['module']['system'], 'system');
    $extension_expected = new Extension($root, 'theme_engine', 'core/themes/engines/twig/twig.info.yml', 'twig.engine');
    $extension_expected->subpath = 'themes/engines/twig';
    $extension_expected->origin = 'core';
    $this
      ->assertEquals($extension_expected, $extensions_by_type['theme_engine']['twig'], 'twig');
  }

  /**
   * Adds example files to the filesystem structure.
   *
   * @param array $filesystem_structure
   *
   * @return string[][]
   *   Format: $[$type][$name] = $yml_file
   *   E.g. $['module']['system'] = 'system.info.yml'
   */
  protected function populateFilesystemStructure(array &$filesystem_structure) {
    $info_by_file = [
      'core/profiles/standard/standard.info.yml' => [
        'type' => 'profile',
      ],
      'core/profiles/minimal/minimal.info.yml' => [
        'type' => 'profile',
      ],
      // Override the core instance of the 'minimal' profile.
      'sites/default/profiles/minimal/minimal.info.yml' => [
        'type' => 'profile',
      ],
      'profiles/myprofile/myprofile.info.yml' => [
        'type' => 'profile',
      ],
      'profiles/myprofile/modules/myprofile_nested_module/myprofile_nested_module.info.yml' => [],
      'profiles/otherprofile/otherprofile.info.yml' => [
        'type' => 'profile',
      ],
      'core/modules/user/user.info.yml' => [],
      'profiles/otherprofile/modules/otherprofile_nested_module/otherprofile_nested_module.info.yml' => [],
      'core/modules/system/system.info.yml' => [],
      'core/themes/seven/seven.info.yml' => [
        'type' => 'theme',
      ],
      // Override the core instance of the 'seven' theme.
      'sites/default/themes/seven/seven.info.yml' => [
        'type' => 'theme',
      ],
      'modules/devel/devel.info.yml' => [],
      'modules/poorly_placed_theme/poorly_placed_theme.info.yml' => [
        'type' => 'theme',
      ],
      'core/themes/engines/twig/twig.info.yml' => [
        'type' => 'theme_engine',
      ],
    ];
    $files_by_type_and_name_expected = [];
    $content_by_file = [];
    foreach ($info_by_file as $file => $info) {
      $name = basename($file, '.info.yml');
      $info += [
        'type' => 'module',
        'name' => "Name of ({$name})",
        'core' => '8.x',
      ];
      $type = $info['type'];
      $content_by_file[$file] = Yaml::dump($info);
      $files_by_type_and_name_expected[$type][$name] = $file;
    }
    $content_by_file['core/modules/system/system.module'] = '<?php';
    $content_by_file['core/themes/engines/twig/twig.engine'] = '<?php';
    foreach ($content_by_file as $file => $content) {
      $pieces = explode('/', $file);
      $this
        ->addFileToFilesystemStructure($filesystem_structure, $pieces, $content);
    }
    unset($files_by_type_and_name_expected['module']['otherprofile_nested_module']);
    return $files_by_type_and_name_expected;
  }

  /**
   * @param array $filesystem_structure
   * @param string[] $pieces
   *   Fragments of the file path.
   * @param string $content
   */
  protected function addFileToFilesystemStructure(array &$filesystem_structure, array $pieces, $content) {
    $piece = array_shift($pieces);
    if ($pieces !== []) {
      $filesystem_structure += [
        $piece => [],
      ];
      $this
        ->addFileToFilesystemStructure($filesystem_structure[$piece], $pieces, $content);
    }
    else {
      $filesystem_structure[$piece] = $content;
    }
  }

}

Classes

Name	Description
ExtensionDiscoveryTest	Tests discovery of extensions.