See Release Notes
Long Term Support Release
<?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/>. /** * Tests for class core_course_category methods invoking hooks. * * @package core_course * @category test * @copyright 2020 Ruslan Kabalin * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later */< namespace tests\core_course;> namespace core_course;defined('MOODLE_INTERNAL') || die(); global $CFG; require_once($CFG->dirroot . '/course/tests/fixtures/mock_hooks.php'); use PHPUnit\Framework\MockObject\MockObject;> use core_course\test\mock_hooks;/** * Functional test for class core_course_category methods invoking hooks. */< class core_course_category_hooks_testcase extends \advanced_testcase {> class category_hooks_test extends \advanced_testcase {< protected function setUp() {> protected function setUp(): void {$this->resetAfterTest(); $this->setAdminUser(); } /** * Provides mocked category configured for named callback function. * * get_plugins_callback_function will return callable prefixed with `tool_unittest_`, * the actual callbacks are defined in mock_hooks.php fixture file. * * @param core_course_category $category Category to mock * @param string $callback Callback function used in method we test. * @return MockObject */ public function get_mock_category(\core_course_category $category, string $callback = '') : MockObject { // Setup mock object for \core_course_category. // Disable original constructor, since we can't use it directly since it is private. $mockcategory = $this->getMockBuilder(\core_course_category::class)< ->setMethods(['get_plugins_callback_function'])> ->onlyMethods(['get_plugins_callback_function'])->disableOriginalConstructor() ->getMock(); // Define get_plugins_callback_function use and return value. if (!empty($callback)) { $mockcategory->method('get_plugins_callback_function') ->with($this->equalTo($callback)) ->willReturn(['tool_unittest_' . $callback]); } // Modify constructor visibility and invoke mock object with real object. // This is used to overcome private constructor. $reflected = new \ReflectionClass(\core_course_category::class); $constructor = $reflected->getConstructor(); $constructor->setAccessible(true); $constructor->invoke($mockcategory, $category->get_db_record()); return $mockcategory; } public function test_can_course_category_delete_hook() { $category1 = \core_course_category::create(array('name' => 'Cat1')); $category2 = \core_course_category::create(array('name' => 'Cat2', 'parent' => $category1->id)); $category3 = \core_course_category::create(array('name' => 'Cat3')); $mockcategory2 = $this->get_mock_category($category2, 'can_course_category_delete'); // Add course to mocked clone of category2. $course1 = $this->getDataGenerator()->create_course(array('category' => $mockcategory2->id)); // Now configure fixture to return false for the callback. mock_hooks::set_can_course_category_delete_return(false); $this->assertFalse($mockcategory2->can_delete_full($category3->id)); // Now configure fixture to return true for the callback. mock_hooks::set_can_course_category_delete_return(true); $this->assertTrue($mockcategory2->can_delete_full($category3->id)); // Verify passed arguments. $arguments = mock_hooks::get_calling_arguments(); $this->assertCount(1, $arguments); // Argument 1 is the same core_course_category instance. $argument = array_shift($arguments); $this->assertSame($mockcategory2, $argument); } public function test_can_course_category_delete_move_hook() { $category1 = \core_course_category::create(array('name' => 'Cat1')); $category2 = \core_course_category::create(array('name' => 'Cat2', 'parent' => $category1->id)); $category3 = \core_course_category::create(array('name' => 'Cat3')); $mockcategory2 = $this->get_mock_category($category2, 'can_course_category_delete_move'); // Add course to mocked clone of category2. $course1 = $this->getDataGenerator()->create_course(array('category' => $mockcategory2->id)); // Now configure fixture to return false for the callback. mock_hooks::set_can_course_category_delete_move_return(false); $this->assertFalse($mockcategory2->can_move_content_to($category3->id)); // Now configure fixture to return true for the callback. mock_hooks::set_can_course_category_delete_move_return(true); $this->assertTrue($mockcategory2->can_move_content_to($category3->id)); // Verify passed arguments. $arguments = mock_hooks::get_calling_arguments(); $this->assertCount(2, $arguments); // Argument 1 is the same core_course_category instance. $argument = array_shift($arguments); $this->assertSame($mockcategory2, $argument); // Argument 2 is referring to category 3. $argument = array_shift($arguments); $this->assertInstanceOf(\core_course_category::class, $argument); $this->assertEquals($category3->id, $argument->id); } public function test_pre_course_category_delete_hook() { $category1 = \core_course_category::create(array('name' => 'Cat1')); $category2 = \core_course_category::create(array('name' => 'Cat2', 'parent' => $category1->id)); $mockcategory2 = $this->get_mock_category($category2, 'pre_course_category_delete'); $mockcategory2->delete_full(); // Verify passed arguments. $arguments = mock_hooks::get_calling_arguments(); $this->assertCount(1, $arguments); // Argument 1 is the category object. $argument = array_shift($arguments); $this->assertEquals($mockcategory2->get_db_record(), $argument); } public function test_pre_course_category_delete_move_hook() { $category1 = \core_course_category::create(array('name' => 'Cat1')); $category2 = \core_course_category::create(array('name' => 'Cat2', 'parent' => $category1->id)); $category3 = \core_course_category::create(array('name' => 'Cat3')); $mockcategory2 = $this->get_mock_category($category2, 'pre_course_category_delete_move'); // Add course to mocked clone of category2. $course1 = $this->getDataGenerator()->create_course(array('category' => $mockcategory2->id)); $mockcategory2->delete_move($category3->id); // Verify passed arguments. $arguments = mock_hooks::get_calling_arguments(); $this->assertCount(2, $arguments); // Argument 1 is the same core_course_category instance. $argument = array_shift($arguments); $this->assertSame($mockcategory2, $argument); // Argument 2 is referring to category 3. $argument = array_shift($arguments); $this->assertInstanceOf(\core_course_category::class, $argument); $this->assertEquals($category3->id, $argument->id); } public function test_get_course_category_contents_hook() { $category1 = \core_course_category::create(array('name' => 'Cat1')); $category2 = \core_course_category::create(array('name' => 'Cat2', 'parent' => $category1->id)); $mockcategory2 = $this->get_mock_category($category2); // Define get_plugins_callback_function use in the mock, it is called twice for different callback in the form. $mockcategory2->expects($this->exactly(2)) ->method('get_plugins_callback_function') ->withConsecutive( [$this->equalTo('can_course_category_delete')], [$this->equalTo('get_course_category_contents')] ) ->willReturn( ['tool_unittest_can_course_category_delete'], ['tool_unittest_get_course_category_contents'] ); // Now configure fixture to return string for the callback. $content = 'Bunch of test artefacts'; mock_hooks::set_get_course_category_contents_return($content); $mform = new \core_course_deletecategory_form(null, $mockcategory2); $this->expectOutputRegex("/<li>$content<\/li>/"); $mform->display(); // Verify passed arguments. $arguments = mock_hooks::get_calling_arguments(); $this->assertCount(1, $arguments); // Argument 1 is the same core_course_category instance. $argument = array_shift($arguments); $this->assertSame($mockcategory2, $argument); } }