class LibraryDiscoveryParserTest

Same name in other branches
  1. 9 core/tests/Drupal/Tests/Core/Asset/LibraryDiscoveryParserTest.php \Drupal\Tests\Core\Asset\LibraryDiscoveryParserTest
  2. 8.9.x core/tests/Drupal/Tests/Core/Asset/LibraryDiscoveryParserTest.php \Drupal\Tests\Core\Asset\LibraryDiscoveryParserTest
  3. 11.x core/tests/Drupal/Tests/Core/Asset/LibraryDiscoveryParserTest.php \Drupal\Tests\Core\Asset\LibraryDiscoveryParserTest

@coversDefaultClass \Drupal\Core\Asset\LibraryDiscoveryParser @group Asset

Hierarchy

Expanded class hierarchy of LibraryDiscoveryParserTest

File

core/tests/Drupal/Tests/Core/Asset/LibraryDiscoveryParserTest.php, line 24

Namespace

Drupal\Tests\Core\Asset
View source
class LibraryDiscoveryParserTest extends UnitTestCase {
    
    /**
     * The tested library discovery parser service.
     *
     * @var \Drupal\Core\Asset\LibraryDiscoveryParser|\Drupal\Tests\Core\Asset\TestLibraryDiscoveryParser
     */
    protected $libraryDiscoveryParser;
    
    /**
     * The mocked cache backend.
     *
     * @var \Drupal\Core\Cache\CacheBackendInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $cache;
    
    /**
     * The mocked module handler.
     *
     * @var \Drupal\Core\Extension\ModuleHandlerInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $moduleHandler;
    
    /**
     * The mocked theme manager.
     *
     * @var \Drupal\Core\Theme\ThemeManagerInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $themeManager;
    
    /**
     * The mocked active theme.
     *
     * @var \Drupal\Core\Theme\ActiveTheme|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $activeTheme;
    
    /**
     * The mocked lock backend.
     *
     * @var \Drupal\Core\Lock\LockBackendInterface|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $lock;
    
    /**
     * The mocked stream wrapper manager.
     *
     * @var \Drupal\Core\StreamWrapper\StreamWrapperManagerInterface||\PHPUnit\Framework\MockObject\MockObject
     */
    protected $streamWrapperManager;
    
    /**
     * The mocked libraries directory file finder.
     *
     * @var \Drupal\Core\Asset\LibrariesDirectoryFileFinder||\PHPUnit\Framework\MockObject\MockObject
     */
    protected $librariesDirectoryFileFinder;
    
    /**
     * The mocked extension path resolver.
     *
     * @var \Drupal\Core\Extension\ExtensionPathResolver|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $extensionPathResolver;
    
    /**
     * The mocked extension path resolver.
     *
     * @var \Drupal\Core\Theme\ComponentPluginManager|\PHPUnit\Framework\MockObject\MockObject
     */
    protected $componentPluginManager;
    
    /**
     * {@inheritdoc}
     */
    protected function setUp() : void {
        parent::setUp();
        $this->moduleHandler = $this->createMock('Drupal\\Core\\Extension\\ModuleHandlerInterface');
        $this->themeManager = $this->createMock(ThemeManagerInterface::class);
        $this->activeTheme = $this->getMockBuilder(ActiveTheme::class)
            ->disableOriginalConstructor()
            ->getMock();
        $this->activeTheme
            ->expects($this->any())
            ->method('getLibrariesOverride')
            ->willReturn([]);
        $this->themeManager
            ->expects($this->any())
            ->method('getActiveTheme')
            ->willReturn($this->activeTheme);
        $this->streamWrapperManager = $this->createMock(StreamWrapperManagerInterface::class);
        $this->librariesDirectoryFileFinder = $this->createMock(LibrariesDirectoryFileFinder::class);
        $this->extensionPathResolver = $this->createMock(ExtensionPathResolver::class);
        $this->componentPluginManager = $this->createMock(ComponentPluginManager::class);
        $this->libraryDiscoveryParser = new TestLibraryDiscoveryParser($this->root, $this->moduleHandler, $this->themeManager, $this->streamWrapperManager, $this->librariesDirectoryFileFinder, $this->extensionPathResolver, $this->componentPluginManager);
    }
    
    /**
     * Tests that basic functionality works for getLibraryByName.
     *
     * @covers ::buildByExtension
     *
     * @runInSeparateProcess
     */
    public function testBuildByExtensionSimple() : void {
        FileCacheFactory::setPrefix('testing');
        // Use the default file cache configuration.
        FileCacheFactory::setConfiguration([
            'library_parser' => [],
        ]);
        $this->libraryDiscoveryParser = new TestLibraryDiscoveryParser($this->root, $this->moduleHandler, $this->themeManager, $this->streamWrapperManager, $this->librariesDirectoryFileFinder, $this->extensionPathResolver, $this->componentPluginManager);
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_module')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_module')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_module');
        $library = $libraries['example'];
        $this->assertCount(0, $library['js']);
        $this->assertCount(2, $library['css']);
        $this->assertCount(0, $library['dependencies']);
        $this->assertEquals($path . '/css/example.css', $library['css'][0]['data']);
        // Ensures that VERSION is replaced by the current core version.
        $this->assertEquals(\Drupal::VERSION, $library['version']);
        // Ensure that the expected FileCache entry exists.
        $cache = FileCacheFactory::get('library_parser')->get($path . '/example_module.libraries.yml');
        $this->assertArrayHasKey('example', $cache);
    }
    
    /**
     * Tests that a theme can be used instead of a module.
     *
     * @covers ::buildByExtension
     */
    public function testBuildByExtensionWithTheme() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_theme')
            ->willReturn(FALSE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('theme', 'example_theme')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_theme');
        $library = $libraries['example'];
        $this->assertCount(0, $library['js']);
        $this->assertCount(1, $library['css']);
        $this->assertCount(0, $library['dependencies']);
        $this->assertEquals($path . '/css/example.css', $library['css'][0]['data']);
    }
    
    /**
     * Tests that a module with a missing library file results in FALSE.
     *
     * @covers ::buildByExtension
     */
    public function testBuildByExtensionWithMissingLibraryFile() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_module')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files_not_existing';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_module')
            ->willReturn($path);
        $this->assertSame($this->libraryDiscoveryParser
            ->buildByExtension('example_module'), []);
    }
    
    /**
     * Tests that an exception is thrown when a libraries file couldn't be parsed.
     *
     * @covers ::buildByExtension
     */
    public function testInvalidLibrariesFile() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('invalid_file')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'invalid_file')
            ->willReturn($path);
        $this->expectException(InvalidLibraryFileException::class);
        $this->libraryDiscoveryParser
            ->buildByExtension('invalid_file');
    }
    
    /**
     * Tests that no exception is thrown when only dependencies are specified.
     *
     * @covers ::buildByExtension
     */
    public function testBuildByExtensionWithOnlyDependencies() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_module_only_dependencies')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_module_only_dependencies')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_module_only_dependencies');
        $this->assertArrayHasKey('example', $libraries);
    }
    
    /**
     * Tests that an exception is thrown with only the version property specified.
     *
     * @covers ::buildByExtension
     */
    public function testBuildByExtensionWithMissingInformation() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_module_missing_information')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_module_missing_information')
            ->willReturn($path);
        $this->expectException(IncompleteLibraryDefinitionException::class);
        $this->expectExceptionMessage("Incomplete library definition for definition 'example' in extension 'example_module_missing_information'");
        $this->libraryDiscoveryParser
            ->buildByExtension('example_module_missing_information');
    }
    
    /**
     * Tests the version property, and how it propagates to the contained assets.
     *
     * @covers ::buildByExtension
     */
    public function testVersion() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('versions')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'versions')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('versions');
        $this->assertArrayNotHasKey('version', $libraries['versionless']);
        $this->assertEquals(-1, $libraries['versionless']['css'][0]['version']);
        $this->assertEquals(-1, $libraries['versionless']['js'][0]['version']);
        $this->assertEquals('9.8.7.6', $libraries['versioned']['version']);
        $this->assertEquals('9.8.7.6', $libraries['versioned']['css'][0]['version']);
        $this->assertEquals('9.8.7.6', $libraries['versioned']['js'][0]['version']);
        $this->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['version']);
        $this->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['css'][0]['version']);
        $this->assertEquals(\Drupal::VERSION, $libraries['core-versioned']['js'][0]['version']);
    }
    
    /**
     * Tests that the version property of external libraries is handled.
     *
     * @covers ::buildByExtension
     */
    public function testExternalLibraries() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('external')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'external')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('external');
        $library = $libraries['example_external'];
        $this->assertEquals('http://example.com/css/example_external.css', $library['css'][0]['data']);
        $this->assertEquals('http://example.com/example_external.js', $library['js'][0]['data']);
        $this->assertEquals('3.14', $library['version']);
    }
    
    /**
     * Ensures that CSS weights are taken into account properly.
     *
     * @covers ::buildByExtension
     */
    public function testDefaultCssWeights() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('css_weights')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'css_weights')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('css_weights');
        $library = $libraries['example'];
        $css = $library['css'];
        $this->assertCount(10, $css);
        // The following default weights are tested:
        // - CSS_BASE: -200
        // - CSS_LAYOUT: -100
        // - CSS_COMPONENT: 0
        // - CSS_STATE: 100
        // - CSS_THEME: 200
        $this->assertEquals(200, $css[0]['weight']);
        $this->assertEquals(200 + 29, $css[1]['weight']);
        $this->assertEquals(-200, $css[2]['weight']);
        $this->assertEquals(-200 + 97, $css[3]['weight']);
        $this->assertEquals(-100, $css[4]['weight']);
        $this->assertEquals(-100 + 92, $css[5]['weight']);
        $this->assertEquals(0, $css[6]['weight']);
        $this->assertEquals(45, $css[7]['weight']);
        $this->assertEquals(100, $css[8]['weight']);
        $this->assertEquals(100 + 8, $css[9]['weight']);
    }
    
    /**
     * Ensures that you cannot provide positive weights for JavaScript libraries.
     *
     * @covers ::buildByExtension
     */
    public function testJsWithPositiveWeight() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('js_positive_weight')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'js_positive_weight')
            ->willReturn($path);
        $this->expectException(\UnexpectedValueException::class);
        $this->libraryDiscoveryParser
            ->buildByExtension('js_positive_weight');
    }
    
    /**
     * Tests a library with CSS/JavaScript and a setting.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryWithCssJsSetting() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('css_js_settings')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'css_js_settings')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('css_js_settings');
        $library = $libraries['example'];
        // Ensures that the group and type are set automatically.
        $this->assertEquals(-100, $library['js'][0]['group']);
        $this->assertEquals('file', $library['js'][0]['type']);
        $this->assertEquals($path . '/js/example.js', $library['js'][0]['data']);
        $this->assertEquals(0, $library['css'][0]['group']);
        $this->assertEquals('file', $library['css'][0]['type']);
        $this->assertEquals($path . '/css/base.css', $library['css'][0]['data']);
        $this->assertEquals([
            'key' => 'value',
        ], $library['drupalSettings']);
    }
    
    /**
     * Tests a library with dependencies.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryWithDependencies() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('dependencies')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'dependencies')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('dependencies');
        $library = $libraries['example'];
        $this->assertCount(2, $library['dependencies']);
        $this->assertEquals('external/example_external', $library['dependencies'][0]);
        $this->assertEquals('example_module/example', $library['dependencies'][1]);
    }
    
    /**
     * Tests a library with a couple of data formats like full URL.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryWithDataTypes() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('data_types')
            ->willReturn(TRUE);
        $this->streamWrapperManager
            ->expects($this->atLeastOnce())
            ->method('isValidUri')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'data_types')
            ->willReturn($path);
        $this->libraryDiscoveryParser
            ->setFileValidUri('public://test.css', TRUE);
        $this->libraryDiscoveryParser
            ->setFileValidUri('public://test2.css', FALSE);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('data_types');
        $library = $libraries['example'];
        $this->assertCount(5, $library['css']);
        $this->assertEquals('external', $library['css'][0]['type']);
        $this->assertEquals('http://example.com/test.css', $library['css'][0]['data']);
        $this->assertEquals('file', $library['css'][1]['type']);
        $this->assertEquals('tmp/test.css', $library['css'][1]['data']);
        $this->assertEquals('external', $library['css'][2]['type']);
        $this->assertEquals('//cdn.com/test.css', $library['css'][2]['data']);
        $this->assertEquals('file', $library['css'][3]['type']);
        $this->assertEquals('public://test.css', $library['css'][3]['data']);
    }
    
    /**
     * Tests a library with JavaScript-specific flags.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryWithJavaScript() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('js')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'js')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('js');
        $library = $libraries['example'];
        $this->assertCount(2, $library['js']);
        $this->assertEquals(FALSE, $library['js'][0]['minified']);
        $this->assertEquals(TRUE, $library['js'][1]['minified']);
    }
    
    /**
     * Tests that an exception is thrown when license is missing when 3rd party.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryThirdPartyWithMissingLicense() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('licenses_missing_information')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'licenses_missing_information')
            ->willReturn($path);
        $this->expectException(LibraryDefinitionMissingLicenseException::class);
        $this->expectExceptionMessage("Missing license information in library definition for definition 'no-license-info-but-remote' extension 'licenses_missing_information': it has a remote, but no license.");
        $this->libraryDiscoveryParser
            ->buildByExtension('licenses_missing_information');
    }
    
    /**
     * Tests a library with various licenses, some GPL-compatible, some not.
     *
     * @covers ::buildByExtension
     */
    public function testLibraryWithLicenses() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('licenses')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'licenses')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('licenses');
        // For libraries without license info, the default license is applied.
        $library = $libraries['no-license-info'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $this->assertTrue(isset($library['license']));
        $default_license = [
            'name' => 'GPL-2.0-or-later',
            'url' => 'https://www.drupal.org/licensing/faq',
            'gpl-compatible' => TRUE,
        ];
        $this->assertEquals($library['license'], $default_license);
        // GPL2-licensed libraries.
        $library = $libraries['gpl2'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $expected_license = [
            'name' => 'gpl2',
            'url' => 'https://url-to-gpl2-license',
            'gpl-compatible' => TRUE,
        ];
        $this->assertEquals($library['license'], $expected_license);
        // MIT-licensed libraries.
        $library = $libraries['mit'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $expected_license = [
            'name' => 'MIT',
            'url' => 'https://url-to-mit-license',
            'gpl-compatible' => TRUE,
        ];
        $this->assertEquals($library['license'], $expected_license);
        // Libraries in the Public Domain.
        $library = $libraries['public-domain'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $expected_license = [
            'name' => 'Public Domain',
            'url' => 'https://url-to-public-domain-license',
            'gpl-compatible' => TRUE,
        ];
        $this->assertEquals($library['license'], $expected_license);
        // Apache-licensed libraries.
        $library = $libraries['apache'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $expected_license = [
            'name' => 'apache',
            'url' => 'https://url-to-apache-license',
            'gpl-compatible' => FALSE,
        ];
        $this->assertEquals($library['license'], $expected_license);
        // Copyrighted libraries.
        $library = $libraries['copyright'];
        $this->assertCount(1, $library['css']);
        $this->assertCount(1, $library['js']);
        $expected_license = [
            'name' => '© Some company',
            'gpl-compatible' => FALSE,
        ];
        $this->assertEquals($library['license'], $expected_license);
    }
    
    /**
     * Tests libraries with overrides.
     *
     * @covers ::applyLibrariesOverride
     */
    public function testLibraryOverride() : void {
        $mock_theme_path = 'mocked_themes/kittens';
        $this->themeManager = $this->createMock(ThemeManagerInterface::class);
        $this->activeTheme = $this->getMockBuilder(ActiveTheme::class)
            ->disableOriginalConstructor()
            ->getMock();
        $this->activeTheme
            ->expects($this->atLeastOnce())
            ->method('getLibrariesOverride')
            ->willReturn([
            $mock_theme_path => [
                'example_module/example' => [
                    'css' => [
                        'theme' => [
                            'css/example.css' => 'css/overridden.css',
                            'css/example2.css' => FALSE,
                        ],
                    ],
                ],
            ],
        ]);
        $this->themeManager
            ->expects($this->any())
            ->method('getActiveTheme')
            ->willReturn($this->activeTheme);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_module')
            ->willReturn($path);
        $this->componentPluginManager = $this->createMock(ComponentPluginManager::class);
        $this->libraryDiscoveryParser = new TestLibraryDiscoveryParser($this->root, $this->moduleHandler, $this->themeManager, $this->streamWrapperManager, $this->librariesDirectoryFileFinder, $this->extensionPathResolver, $this->componentPluginManager);
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_module')
            ->willReturn(TRUE);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_module');
        $library = $libraries['example'];
        $this->assertCount(0, $library['js']);
        $this->assertCount(1, $library['css']);
        $this->assertCount(0, $library['dependencies']);
        $this->assertEquals($mock_theme_path . '/css/overridden.css', $library['css'][0]['data']);
    }
    
    /**
     * Tests deprecated library with an override.
     *
     * @covers ::applyLibrariesOverride
     *
     * @group legacy
     */
    public function testLibraryOverrideDeprecated() : void {
        $this->expectDeprecation('Theme "deprecated" is overriding a deprecated library. The "deprecated/deprecated" asset library is deprecated in drupal:X.0.0 and is removed from drupal:Y.0.0. Use another library instead. See https://www.example.com');
        $mock_theme_path = 'mocked_themes/kittens';
        $this->themeManager = $this->createMock(ThemeManagerInterface::class);
        $this->activeTheme = $this->getMockBuilder(ActiveTheme::class)
            ->disableOriginalConstructor()
            ->getMock();
        $this->activeTheme
            ->expects($this->atLeastOnce())
            ->method('getLibrariesOverride')
            ->willReturn([
            $mock_theme_path => [
                'deprecated/deprecated' => [
                    'css' => [
                        'theme' => [
                            'css/example.css' => 'css/overridden.css',
                        ],
                    ],
                ],
            ],
        ]);
        $this->themeManager
            ->expects($this->any())
            ->method('getActiveTheme')
            ->willReturn($this->activeTheme);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'deprecated')
            ->willReturn($path);
        $this->componentPluginManager = $this->createMock(ComponentPluginManager::class);
        $this->libraryDiscoveryParser = new TestLibraryDiscoveryParser($this->root, $this->moduleHandler, $this->themeManager, $this->streamWrapperManager, $this->librariesDirectoryFileFinder, $this->extensionPathResolver, $this->componentPluginManager);
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('deprecated')
            ->willReturn(TRUE);
        $this->libraryDiscoveryParser
            ->buildByExtension('deprecated');
    }
    
    /**
     * Verifies assertions catch invalid CSS declarations.
     *
     * @dataProvider providerTestCssAssert
     */
    
    /**
     * Verify an assertion fails if CSS declarations have non-existent categories.
     *
     * @param string $extension
     *   The css extension to build.
     * @param string $exception_message
     *   The expected exception message.
     *
     * @dataProvider providerTestCssAssert
     */
    public function testCssAssert($extension, $exception_message) : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with($extension)
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', $extension)
            ->willReturn($path);
        $this->expectException(\AssertionError::class);
        $this->expectExceptionMessage($exception_message);
        $this->libraryDiscoveryParser
            ->buildByExtension($extension);
    }
    
    /**
     * Data provider for testing bad CSS declarations.
     */
    public static function providerTestCssAssert() {
        return [
            'css_bad_category' => [
                'css_bad_category',
                'See https://www.drupal.org/node/2274843.',
            ],
            'Improper CSS nesting' => [
                'css_bad_nesting',
                'CSS must be nested under a category. See https://www.drupal.org/node/2274843.',
            ],
            'Improper CSS nesting array' => [
                'css_bad_nesting_array',
                'CSS files should be specified as key/value pairs, where the values are configuration options. See https://www.drupal.org/node/2274843.',
            ],
        ];
    }
    
    /**
     * @covers ::buildByExtension
     */
    public function testNonCoreLibrariesFound() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_contrib_module')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'example_contrib_module')
            ->willReturn($path);
        $this->librariesDirectoryFileFinder
            ->expects($this->once())
            ->method('find')
            ->with('third_party_library/css/example.css')
            ->willReturn('sites/example.com/libraries/third_party_library/css/example.css');
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_contrib_module');
        $library = $libraries['third_party_library'];
        $this->assertCount(0, $library['js']);
        $this->assertCount(1, $library['css']);
        $this->assertCount(0, $library['dependencies']);
        // The location is determined by the libraries directory file finder.
        $this->assertEquals('sites/example.com/libraries/third_party_library/css/example.css', $library['css'][0]['data']);
    }
    
    /**
     * @covers ::buildByExtension
     */
    public function testNonCoreLibrariesNotFound() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('example_contrib_module')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->once())
            ->method('getPath')
            ->willReturnMap([
            [
                'module',
                'example_contrib_module',
                $path,
            ],
            [
                'profile',
                'library_testing',
                'profiles/library_testing',
            ],
        ]);
        $this->librariesDirectoryFileFinder
            ->expects($this->once())
            ->method('find')
            ->with('third_party_library/css/example.css')
            ->willReturn(FALSE);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('example_contrib_module');
        $library = $libraries['third_party_library'];
        $this->assertCount(0, $library['js']);
        $this->assertCount(1, $library['css']);
        $this->assertCount(0, $library['dependencies']);
        // The location will be the same as provided in the library definition even
        // though it does not exist.
        $this->assertEquals('libraries/third_party_library/css/example.css', $library['css'][0]['data']);
    }
    
    /**
     * @covers ::parseLibraryInfo
     */
    public function testEmptyLibraryFile() : void {
        $this->moduleHandler
            ->expects($this->atLeastOnce())
            ->method('moduleExists')
            ->with('empty')
            ->willReturn(TRUE);
        $path = __DIR__ . '/library_test_files';
        $path = substr($path, strlen($this->root) + 1);
        $this->extensionPathResolver
            ->expects($this->atLeastOnce())
            ->method('getPath')
            ->with('module', 'empty')
            ->willReturn($path);
        $libraries = $this->libraryDiscoveryParser
            ->buildByExtension('empty');
        $this->assertEquals([], $libraries);
    }

}

Members

Title Sort descending Deprecated Modifiers Object type Summary Overriden Title Overrides
LibraryDiscoveryParserTest::$activeTheme protected property The mocked active theme.
LibraryDiscoveryParserTest::$cache protected property The mocked cache backend.
LibraryDiscoveryParserTest::$componentPluginManager protected property The mocked extension path resolver.
LibraryDiscoveryParserTest::$extensionPathResolver protected property The mocked extension path resolver.
LibraryDiscoveryParserTest::$librariesDirectoryFileFinder protected property The mocked libraries directory file finder.
LibraryDiscoveryParserTest::$libraryDiscoveryParser protected property The tested library discovery parser service.
LibraryDiscoveryParserTest::$lock protected property The mocked lock backend.
LibraryDiscoveryParserTest::$moduleHandler protected property The mocked module handler.
LibraryDiscoveryParserTest::$streamWrapperManager protected property The mocked stream wrapper manager.
LibraryDiscoveryParserTest::$themeManager protected property The mocked theme manager.
LibraryDiscoveryParserTest::providerTestCssAssert public static function Data provider for testing bad CSS declarations.
LibraryDiscoveryParserTest::setUp protected function Overrides UnitTestCase::setUp
LibraryDiscoveryParserTest::testBuildByExtensionSimple public function Tests that basic functionality works for getLibraryByName.
LibraryDiscoveryParserTest::testBuildByExtensionWithMissingInformation public function Tests that an exception is thrown with only the version property specified.
LibraryDiscoveryParserTest::testBuildByExtensionWithMissingLibraryFile public function Tests that a module with a missing library file results in FALSE.
LibraryDiscoveryParserTest::testBuildByExtensionWithOnlyDependencies public function Tests that no exception is thrown when only dependencies are specified.
LibraryDiscoveryParserTest::testBuildByExtensionWithTheme public function Tests that a theme can be used instead of a module.
LibraryDiscoveryParserTest::testCssAssert public function Verify an assertion fails if CSS declarations have non-existent categories.
LibraryDiscoveryParserTest::testDefaultCssWeights public function Ensures that CSS weights are taken into account properly.
LibraryDiscoveryParserTest::testEmptyLibraryFile public function @covers ::parseLibraryInfo
LibraryDiscoveryParserTest::testExternalLibraries public function Tests that the version property of external libraries is handled.
LibraryDiscoveryParserTest::testInvalidLibrariesFile public function Tests that an exception is thrown when a libraries file couldn't be parsed.
LibraryDiscoveryParserTest::testJsWithPositiveWeight public function Ensures that you cannot provide positive weights for JavaScript libraries.
LibraryDiscoveryParserTest::testLibraryOverride public function Tests libraries with overrides.
LibraryDiscoveryParserTest::testLibraryOverrideDeprecated public function Tests deprecated library with an override.
LibraryDiscoveryParserTest::testLibraryThirdPartyWithMissingLicense public function Tests that an exception is thrown when license is missing when 3rd party.
LibraryDiscoveryParserTest::testLibraryWithCssJsSetting public function Tests a library with CSS/JavaScript and a setting.
LibraryDiscoveryParserTest::testLibraryWithDataTypes public function Tests a library with a couple of data formats like full URL.
LibraryDiscoveryParserTest::testLibraryWithDependencies public function Tests a library with dependencies.
LibraryDiscoveryParserTest::testLibraryWithJavaScript public function Tests a library with JavaScript-specific flags.
LibraryDiscoveryParserTest::testLibraryWithLicenses public function Tests a library with various licenses, some GPL-compatible, some not.
LibraryDiscoveryParserTest::testNonCoreLibrariesFound public function @covers ::buildByExtension
LibraryDiscoveryParserTest::testNonCoreLibrariesNotFound public function @covers ::buildByExtension
LibraryDiscoveryParserTest::testVersion public function Tests the version property, and how it propagates to the contained assets.
PhpUnitWarnings::$deprecationWarnings private static property Deprecation warnings from PHPUnit to raise with @trigger_error().
PhpUnitWarnings::addWarning public function Converts PHPUnit deprecation warnings to E_USER_DEPRECATED.
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.
RandomGeneratorTrait::randomStringValidate Deprecated public function Callback for random string validation.
UnitTestCase::$root protected property The app root. 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::getStringTranslationStub public function Returns a stub translation manager that just returns the passed string.
UnitTestCase::setUpBeforeClass public static function
UnitTestCase::__get public function

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