moodle/lib/tests/mustache_template_finder_test.php

<?php
// This file is part of Moodle - http://moodle.org/
//
// Moodle is free software: you can redistribute it and/or modify
// it under the terms of the GNU General Public License as published by
// the Free Software Foundation, either version 3 of the License, or
// (at your option) any later version.
//
// Moodle is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with Moodle.  If not, see <http://www.gnu.org/licenses/>.

/**
 * Unit tests for lib/classes/output/mustache_template_finder.php
 *
 * @package   core
 * @category  phpunit
 * @copyright 2015 Damyon Wiese
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

defined('MOODLE_INTERNAL') || die();

use core\output\mustache_template_finder;

/**
 * Unit tests for the Mustache template finder class (contains logic about
 * resolving mustache template locations.
 */
class core_output_mustache_template_finder_testcase extends advanced_testcase {

    /**
     * Data provider which reutrns a set of valid template directories to be used when testing
     * get_template_directories_for_component.
     *
     * @return array
     */
    public function valid_template_directories_provider(): array {
        return [
            'plugin: mod_assign' => [
                'component' => 'mod_assign',
                'theme' => '',
                'paths' => [
                    'theme/boost/templates/mod_assign/',
                    'mod/assign/templates/'
                ],
            ],
            'plugin: mod_assign with classic' => [
                'component' => 'mod_assign',
                'theme' => 'classic',
                'paths' => [
                    'theme/classic/templates/mod_assign/',
                    'theme/boost/templates/mod_assign/',
                    'mod/assign/templates/'
                ],
            ],
            'subsystem: core_user' => [
                'component' => 'core_user',
                'theme' => 'classic',
                'paths' => [
                    'theme/classic/templates/core_user/',
                    'theme/boost/templates/core_user/',
                    'user/templates/'
                ],
            ],
            'core' => [
                'component' => 'core',
                'theme' => 'classic',
                'paths' => [
                    'theme/classic/templates/core/',
                    'theme/boost/templates/core/',
                    'lib/templates/'
                ],
            ],
        ];
    }

    /**
     * Tests for get_template_directories_for_component.
     *
     * @dataProvider valid_template_directories_provider
     * @param   string $component
     * @param   string $theme
     * @param   array $paths
     */
    public function test_get_template_directories_for_component(string $component, string $theme, array $paths): void {
        global $CFG;

        // Test a plugin.
        $dirs = mustache_template_finder::get_template_directories_for_component($component, $theme, $paths);

        $correct = array_map(function($path) use ($CFG) {
            return implode('/', [$CFG->dirroot, $path]);
        }, $paths);

        $this->assertEquals($correct, $dirs);
    }

    /**
     * Tests for get_template_directories_for_component when dealing with an invalid component.
     */
    public function test_invalid_component_get_template_directories_for_component() {
        // Test something invalid.
        $this->expectException(coding_exception::class);
        mustache_template_finder::get_template_directories_for_component('octopus', 'classic');
    }

    /**
     * Data provider which reutrns a set of valid template directories to be used when testing
     * get_template_directories_for_component.
     *
     * @return array
     */
    public function valid_template_filepath_provider(): array {
        return [
            'Standard core template' => [
                'template' => 'core/modal',
                'theme' => '',
                'location' => 'lib/templates/modal.mustache',
            ],
            'Template overridden by theme' => [
                'template' => 'core_form/element-float-inline',
                'theme' => '',
                'location' => 'theme/boost/templates/core_form/element-float-inline.mustache',
            ],
            'Template overridden by theme but child theme selected' => [
                'template' => 'core_form/element-float-inline',
                'theme' => 'classic',
                'location' => 'theme/boost/templates/core_form/element-float-inline.mustache',
            ],
            'Template overridden by child theme' => [
                'template' => 'core/full_header',
                'theme' => 'classic',
                'location' => 'theme/classic/templates/core/full_header.mustache',
            ],
            'Template overridden by child theme but tested against defualt theme' => [
                'template' => 'core/full_header',
                'theme' => '',
                'location' => 'lib/templates/full_header.mustache',
            ],
            'Standard plugin template' => [
                'template' => 'mod_assign/grading_panel',
                'theme' => '',
                'location' => 'mod/assign/templates/grading_panel.mustache',
            ],
            'Subsystem template' => [
                'template' => 'core_user/status_details',
                'theme' => '',
                'location' => 'user/templates/status_details.mustache',
            ],
            'Theme own template' => [
                'template' => 'theme_classic/columns',
                'theme' => '',
                'location' => 'theme/classic/templates/columns.mustache',
            ],
            'Theme overridden template against that theme' => [
                'template' => 'theme_classic/navbar',
                'theme' => 'classic',
                'location' => 'theme/classic/templates/navbar.mustache',
            ],
            // Note: This one looks strange but is correct. It is legitimate to request theme's component template in
            // the context of another theme. For example, this is used by child themes making use of parent theme
            // templates.
            'Theme overridden template against the default theme' => [
                'template' => 'theme_classic/navbar',
                'theme' => '',
                'location' => 'theme/classic/templates/navbar.mustache',
            ],
        ];
    }

    /**
     * Tests for get_template_filepath.
     *
     * @dataProvider valid_template_filepath_provider
     * @param   string $template
     * @param   string $theme
     * @param   string $location
     */
    public function test_get_template_filepath(string $template, string $theme, string $location) {
        global $CFG;

        $filename = mustache_template_finder::get_template_filepath($template, $theme);
        $this->assertEquals("{$CFG->dirroot}/{$location}", $filename);
    }

    /**
     * Tests for get_template_filepath when dealing with an invalid component.
     */
    public function test_invalid_component_get_template_filepath() {
        $this->expectException(moodle_exception::class);
        mustache_template_finder::get_template_filepath('core/octopus', 'classic');
    }
}