<?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/>.
/**
* Automated backup tests.
*
* @package core_backup
* @copyright 2019 John Yao <johnyao@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
> namespace core_backup;
defined('MOODLE_INTERNAL') || die();
>
> use backup_cron_automated_helper;
global $CFG;
>
require_once($CFG->dirroot . '/backup/util/helper/backup_cron_helper.class.php');
< require_once($CFG->libdir.'/cronlib.php');
require_once($CFG->libdir . '/completionlib.php');
/**
* Automated backup tests.
*
> * @package core_backup
* @copyright 2019 John Yao <johnyao@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
< class core_backup_automated_backup_testcase extends advanced_testcase {
> class automated_backup_test extends \advanced_testcase {
/**
* @var \backup_cron_automated_helper
*/
protected $backupcronautomatedhelper;
/**
< * @var stdClass $course
> * @var \stdClass $course
*/
protected $course;
< protected function setUp() {
> protected function setUp(): void {
global $DB, $CFG;
$this->resetAfterTest(true);
$this->setAdminUser();
$CFG->enableavailability = true;
$CFG->enablecompletion = true;
// Getting a testable backup_cron_automated_helper class.
$this->backupcronautomatedhelper = new test_backup_cron_automated_helper();
$generator = $this->getDataGenerator();
$this->course = $generator->create_course(
array('format' => 'topics', 'numsections' => 3,
'enablecompletion' => COMPLETION_ENABLED),
array('createsections' => true));
$forum = $generator->create_module('forum', array(
'course' => $this->course->id));
$forum2 = $generator->create_module('forum', array(
'course' => $this->course->id, 'completion' => COMPLETION_TRACKING_MANUAL));
// We need a grade, easiest is to add an assignment.
$assignrow = $generator->create_module('assign', array(
'course' => $this->course->id));
< $assign = new assign(context_module::instance($assignrow->cmid), false, false);
> $assign = new \assign(\context_module::instance($assignrow->cmid), false, false);
$item = $assign->get_grade_item();
// Make a test grouping as well.
$grouping = $generator->create_grouping(array('courseid' => $this->course->id,
'name' => 'Grouping!'));
$availability = '{"op":"|","show":false,"c":[' .
'{"type":"completion","cm":' . $forum2->cmid .',"e":1},' .
'{"type":"grade","id":' . $item->id . ',"min":4,"max":94},' .
'{"type":"grouping","id":' . $grouping->id . '}' .
']}';
$DB->set_field('course_modules', 'availability', $availability, array(
'id' => $forum->cmid));
$DB->set_field('course_sections', 'availability', $availability, array(
'course' => $this->course->id, 'section' => 1));
}
/**
* Tests the automated backup run when the there is course backup should be skipped.
*/
public function test_automated_backup_skipped_run() {
global $DB;
// Enable automated back up.
set_config('backup_auto_active', true, 'backup');
set_config('backup_auto_weekdays', '1111111', 'backup');
// Start backup process.
$admin = get_admin();
// Backup entry should not exist.
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
$this->assertFalse($backupcourse);
$this->assertInstanceOf(
backup_cron_automated_helper::class,
$this->backupcronautomatedhelper->return_this()
);
$classobject = $this->backupcronautomatedhelper->return_this();
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'get_courses');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'get_courses');
$method->setAccessible(true); // Allow accessing of private method.
$courses = $method->invoke($classobject);
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'check_and_push_automated_backups');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'check_and_push_automated_backups');
$method->setAccessible(true); // Allow accessing of private method.
$emailpending = $method->invokeArgs($classobject, [$courses, $admin]);
< $coursename = $this->course->fullname;
< $this->expectOutputRegex("/Skipping $coursename \(Not scheduled for backup until/");
> $this->expectOutputRegex('/Skipping course id ' . $this->course->id . ': Not scheduled for backup until/');
$this->assertFalse($emailpending);
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
$this->assertNotNull($backupcourse->laststatus);
}
/**
* Tests the automated backup run when the there is course backup can be pushed to adhoc task.
*/
public function test_automated_backup_push_run() {
global $DB;
// Enable automated back up.
set_config('backup_auto_active', true, 'backup');
set_config('backup_auto_weekdays', '1111111', 'backup');
$admin = get_admin();
$classobject = $this->backupcronautomatedhelper->return_this();
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'get_courses');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'get_courses');
$method->setAccessible(true); // Allow accessing of private method.
$courses = $method->invoke($classobject);
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_NOTYETRUN;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
// We now manually trigger a backup pushed to adhoc task.
// Make sure is in the past, which means should run now.
$backupcourse->nextstarttime = time() - 10;
$DB->update_record('backup_courses', $backupcourse);
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'check_and_push_automated_backups');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'check_and_push_automated_backups');
$method->setAccessible(true); // Allow accessing of private method.
$emailpending = $method->invokeArgs($classobject, [$courses, $admin]);
$this->assertTrue($emailpending);
< $coursename = $this->course->fullname;
< $this->expectOutputRegex("/Putting backup of $coursename in adhoc task queue/");
> $this->expectOutputRegex('/Putting backup of course id ' . $this->course->id. ' in adhoc task queue/');
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
// Now this backup course status should be queued.
$this->assertEquals(backup_cron_automated_helper::BACKUP_STATUS_QUEUED, $backupcourse->laststatus);
}
/**
* Tests the automated backup inactive run.
*/
public function test_inactive_run() {
backup_cron_automated_helper::run_automated_backup();
$this->expectOutputString("Checking automated backup status...INACTIVE\n");
}
/**
* Tests the invisible course being skipped.
*/
public function test_should_skip_invisible_course() {
global $DB;
set_config('backup_auto_active', true, 'backup');
set_config('backup_auto_skip_hidden', true, 'backup');
set_config('backup_auto_weekdays', '1111111', 'backup');
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
// This is the status we believe last run was OK.
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_SKIPPED;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
$this->assertTrue(course_change_visibility($this->course->id, false));
$course = $DB->get_record('course', array('id' => $this->course->id));
$this->assertEquals('0', $course->visible);
$classobject = $this->backupcronautomatedhelper->return_this();
$nextstarttime = backup_cron_automated_helper::calculate_next_automated_backup(null, time());
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
$method->setAccessible(true); // Allow accessing of private method.
$skipped = $method->invokeArgs($classobject, [$backupcourse, $course, $nextstarttime]);
$this->assertTrue($skipped);
< $this->expectOutputRegex("/Skipping $course->fullname \(Not visible\)/");
> $this->expectOutputRegex('/Skipping course id ' . $this->course->id. ': Not visible/');
}
/**
* Tests the not modified course being skipped.
*/
public function test_should_skip_not_modified_course_in_days() {
global $DB;
set_config('backup_auto_active', true, 'backup');
// Skip if not modified in two days.
set_config('backup_auto_skip_modif_days', 2, 'backup');
set_config('backup_auto_weekdays', '1111111', 'backup');
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
// This is the status we believe last run was OK.
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_SKIPPED;
$backupcourse->laststarttime = time() - 2 * DAYSECS;
$backupcourse->lastendtime = time() - 1 * DAYSECS;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
$course = $DB->get_record('course', array('id' => $this->course->id));
$course->timemodified = time() - 2 * DAYSECS - 1;
$classobject = $this->backupcronautomatedhelper->return_this();
$nextstarttime = backup_cron_automated_helper::calculate_next_automated_backup(null, time());
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
$method->setAccessible(true); // Allow accessing of private method.
$skipped = $method->invokeArgs($classobject, [$backupcourse, $course, $nextstarttime]);
$this->assertTrue($skipped);
< $this->expectOutputRegex("/Skipping $course->fullname \(Not modified in the past 2 days\)/");
> $this->expectOutputRegex('/Skipping course id ' . $this->course->id . ': Not modified in the past 2 days/');
}
/**
* Tests the backup not modified course being skipped.
*/
public function test_should_skip_not_modified_course_since_prev() {
global $DB;
set_config('backup_auto_active', true, 'backup');
// Skip if not modified in two days.
set_config('backup_auto_skip_modif_prev', 2, 'backup');
set_config('backup_auto_weekdays', '1111111', 'backup');
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
// This is the status we believe last run was OK.
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_SKIPPED;
$backupcourse->laststarttime = time() - 2 * DAYSECS;
$backupcourse->lastendtime = time() - 1 * DAYSECS;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', array('courseid' => $this->course->id));
$course = $DB->get_record('course', array('id' => $this->course->id));
$course->timemodified = time() - 2 * DAYSECS - 1;
$classobject = $this->backupcronautomatedhelper->return_this();
$nextstarttime = backup_cron_automated_helper::calculate_next_automated_backup(null, time());
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'should_skip_course_backup');
$method->setAccessible(true); // Allow accessing of private method.
$skipped = $method->invokeArgs($classobject, [$backupcourse, $course, $nextstarttime]);
$this->assertTrue($skipped);
< $this->expectOutputRegex("/Skipping $course->fullname \(Not modified since previous backup\)/");
> $this->expectOutputRegex('/Skipping course id ' . $this->course->id . ': Not modified since previous backup/');
}
/**
* Test the task completes when coureid is missing.
*/
public function test_task_complete_when_courseid_is_missing() {
global $DB;
$admin = get_admin();
$classobject = $this->backupcronautomatedhelper->return_this();
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_NOTYETRUN;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', ['courseid' => $this->course->id]);
// Create a backup task.
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'push_course_backup_adhoc_task');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'push_course_backup_adhoc_task');
$method->setAccessible(true); // Allow accessing of private method.
$method->invokeArgs($classobject, [$backupcourse, $admin]);
// Delete course for this test.
delete_course($this->course->id, false);
< $task = core\task\manager::get_next_adhoc_task(time());
> $task = \core\task\manager::get_next_adhoc_task(time());
ob_start();
$task->execute();
$output = ob_get_clean();
$this->assertStringContainsString('Invalid course id: ' . $this->course->id . ', task aborted.', $output);
< core\task\manager::adhoc_task_complete($task);
> \core\task\manager::adhoc_task_complete($task);
}
/**
* Test the task completes when backup course is missing.
*/
public function test_task_complete_when_backup_course_is_missing() {
global $DB;
$admin = get_admin();
$classobject = $this->backupcronautomatedhelper->return_this();
// Create this backup course.
< $backupcourse = new stdClass;
> $backupcourse = new \stdClass;
$backupcourse->courseid = $this->course->id;
$backupcourse->laststatus = backup_cron_automated_helper::BACKUP_STATUS_NOTYETRUN;
$DB->insert_record('backup_courses', $backupcourse);
$backupcourse = $DB->get_record('backup_courses', ['courseid' => $this->course->id]);
// Create a backup task.
< $method = new ReflectionMethod('\backup_cron_automated_helper', 'push_course_backup_adhoc_task');
> $method = new \ReflectionMethod('\backup_cron_automated_helper', 'push_course_backup_adhoc_task');
$method->setAccessible(true); // Allow accessing of private method.
$method->invokeArgs($classobject, [$backupcourse, $admin]);
// Delete backup course for this test.
$DB->delete_records('backup_courses', ['courseid' => $this->course->id]);
< $task = core\task\manager::get_next_adhoc_task(time());
> $task = \core\task\manager::get_next_adhoc_task(time());
ob_start();
$task->execute();
$output = ob_get_clean();
$this->assertStringContainsString('Automated backup for course: ' . $this->course->fullname . ' encounters an error.',
$output);
< core\task\manager::adhoc_task_complete($task);
> \core\task\manager::adhoc_task_complete($task);
}
}
/**
* New backup_cron_automated_helper class for testing.
*
* This class extends the helper backup_cron_automated_helper class
* in order to utilise abstract class for testing.
*
* @package core
* @copyright 2019 John Yao <johnyao@catalyst-au.net>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class test_backup_cron_automated_helper extends backup_cron_automated_helper {
/**
* Returning this for testing.
*/
public function return_this() {
return $this;
}
}