moodle/course/tests/course_delete_modules_test.php
Eloy Lafuente (stronk7) ad5fe71868
MDL-82207 phpunit: fix various @covers annotations (take#1)
This fixes various (not all) wrong @covers annotations that
are reported as warnings by PHPUnit when it's run with
code-coverage enabled.

When possible, the preferred solution is to change to
@covers at class level, that is the recommended way.

If multiple classes are involved, then a mix of @coversDefaultClass
and @covers at method level are used (always trying to use the
minimum needed patch).

This is the first of a series of issues created as sub-tasks
of MDL-82142.
2024-06-24 12:07:39 +02:00

129 lines
5.1 KiB
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/>.
/**
* Tests for the \core_course\task\course_delete_modules class.
*
* @package core
* @subpackage course
* @copyright 2021 Tomo Tsuyuki <tomotsuyuki@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
* @covers \core_course\task\course_delete_modules
*/
namespace core_course;
/**
* Tests for the \core_course\task\course_delete_modules class.
*
* @package core
* @subpackage course
* @copyright 2021 Tomo Tsuyuki <tomotsuyuki@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class course_delete_modules_test extends \advanced_testcase {
/**
* Test to have a no message for usual process.
*/
public function test_delete_module_execution(): void {
$this->resetAfterTest();
// Generate test data.
$generator = $this->getDataGenerator();
$user = $generator->create_user();
$course = $generator->create_course();
$assign = $generator->create_module('assign', ['course' => $course]);
$assigncm = get_coursemodule_from_id('assign', $assign->cmid);
// The module exists in the course.
$coursedmodules = get_course_mods($course->id);
$this->assertCount(1, $coursedmodules);
// Execute the task.
$removaltask = new \core_course\task\course_delete_modules();
$data = [
'cms' => [$assigncm],
'userid' => $user->id,
'realuserid' => $user->id,
];
$removaltask->set_custom_data($data);
$removaltask->execute();
// The module has deleted from the course.
$coursedmodules = get_course_mods($course->id);
$this->assertCount(0, $coursedmodules);
}
/**
* Test with failed and successful cms
*/
public function test_delete_module_exception(): void {
global $DB;
$this->resetAfterTest();
// Generate test data.
$generator = $this->getDataGenerator();
$user = $generator->create_user();
$course = $generator->create_course();
$assign = $generator->create_module('assign', ['course' => $course]);
$assigncm = get_coursemodule_from_id('assign', $assign->cmid);
// Modify module name to make an exception in the course_delete_modules task.
$module = $DB->get_record('modules', ['id' => $assigncm->module], 'id, name', MUST_EXIST);
$module->name = 'TestModuleToDelete';
$DB->update_record('modules', $module);
// Generate successful test data.
$quiz1 = $generator->create_module('quiz', ['course' => $course]);
$quizcm1 = get_coursemodule_from_id('quiz', $quiz1->cmid);
$quiz2 = $generator->create_module('quiz', ['course' => $course]);
$quizcm2 = get_coursemodule_from_id('quiz', $quiz2->cmid);
// Execute the task.
$removaltask = new \core_course\task\course_delete_modules();
$data = [
'cms' => [$quizcm1, $assigncm, $quizcm2],
'userid' => $user->id,
'realuserid' => $user->id,
];
$removaltask->set_custom_data($data);
try {
$removaltask->execute();
} catch (\coding_exception $e) {
// Assert exception.
$this->assertInstanceOf(\coding_exception::class, $e);
$errormsg = str_replace('\\', '/', $e->getMessage()); // Normalise dir separator.
$this->assertStringContainsString('cannotdeletemodulemissinglib', $errormsg);
$this->assertStringContainsString('course/lib.php', $errormsg);
$this->assertStringContainsString('mod/TestModuleToDelete/lib.php is missing', $errormsg);
// Get line numbers array which contains the exception name.
$lines = array_keys(preg_grep("/cannotdeletemodulemissinglib/", file('course/lib.php')));
// Increase 1 to keys to convert to actual line number.
$lines = array_map(function($key) {
return ++$key;
}, $lines);
$regex = "/(\(" . implode('\))|(\(', $lines) . "\))/";
// Assert the error message has correct line number.
$this->assertMatchesRegularExpression($regex, $errormsg);
}
// The success modules have been deleted from the course, and only the failed module is in the course.
$coursedmodules = get_course_mods($course->id);
$this->assertCount(1, $coursedmodules);
}
}