Search moodle.org's
Developer Documentation

See Release Notes

  • Bug fixes for general core bugs in 3.10.x will end 8 November 2021 (12 months).
  • Bug fixes for security issues in 3.10.x will end 9 May 2022 (18 months).
  • PHP version: minimum PHP 7.2.0 Note: minimum PHP version has increased since Moodle 3.8. PHP 7.3.x and 7.4.x are supported too.
<?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 events found in /grade/letter and /grade/scale.
 *
 * @package   core_grades
 * @category  test
 * @copyright 2017 Stephen Bourget
 * @license   http://www.gnu.org/copyleft/gpl.html GNU Public License
 */

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

global $CFG;
require_once($CFG->dirroot . '/grade/lib.php');

/**
 * Unit tests for grade events.
 *
 * @package   core_grades
 * @category  test
 * @copyright 2017 Stephen Bourget
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class core_grade_events_test extends advanced_testcase {

    /** @var stdClass the course used for testing */
    private $course;

    /**
     * Test set up.
     *
     * This is executed before running any test in this file.
     */
< public function setUp() {
> public function setUp(): void {
$this->resetAfterTest(); $this->setAdminUser(); $this->course = $this->getDataGenerator()->create_course(); } /** * Test the grade letter created event. * * There is no external API for triggering this event, so the unit test will simply * create and trigger the event and ensure the data is returned as expected. */ public function test_grade_letter_created() { // Create a grade letter created event. $event = \core\event\grade_letter_created::create(array( 'objectid' => 10, 'context' => context_course::instance($this->course->id) )); // Trigger and capture the event. $sink = $this->redirectEvents(); $event->trigger(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\grade_letter_created', $event); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } /** * Test the grade letter deleted event. * * There is no external API for triggering this event, so the unit test will simply * create and trigger the event and ensure the data is returned as expected. */ public function test_grade_letter_deleted() { // Create a grade letter deleted event. $event = \core\event\grade_letter_deleted::create(array( 'objectid' => 10, 'context' => context_course::instance($this->course->id) )); // Trigger and capture the event. $sink = $this->redirectEvents(); $event->trigger(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\grade_letter_deleted', $event); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } /** * Test the grade letter updated event. * * There is no external API for triggering this event, so the unit test will simply * create and trigger the event and ensure the data is returned as expected. */ public function test_grade_letter_updated() { // Create a grade letter updated event. $event = \core\event\grade_letter_updated::create(array( 'objectid' => 10, 'context' => context_course::instance($this->course->id) )); // Trigger and capture the event. $sink = $this->redirectEvents(); $event->trigger(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\grade_letter_updated', $event); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } /** * Test the scale created event. */ public function test_scale_created() { $gradescale = new grade_scale(); $gradescale->name = 'unittestscale3'; $gradescale->courseid = $this->course->id; $gradescale->userid = 317; $gradescale->scale = 'Distinction, Very Good, Good, Pass, Fail'; $gradescale->description = 'This scale is used to mark standard assignments.'; $url = new \moodle_url('/grade/edit/scale/index.php', array('id' => $this->course->id)); // Trigger and capture the event. $sink = $this->redirectEvents(); $id = $gradescale->insert(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\scale_created', $event); $this->assertEquals($id, $event->objectid); $this->assertEquals($url, $event->get_url()); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } /** * Test the scale deleted event. */ public function test_scale_deleted() { $gradescale = new grade_scale(); $gradescale->name = 'unittestscale3'; $gradescale->courseid = $this->course->id; $gradescale->userid = 317; $gradescale->scale = 'Distinction, Very Good, Good, Pass, Fail'; $gradescale->description = 'This scale is used to mark standard assignments.'; $gradescale->insert(); // Trigger and capture the event. $sink = $this->redirectEvents(); $gradescale->delete(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\scale_deleted', $event); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } /** * Test the scale updated event. */ public function test_scale_updated() { $gradescale = new grade_scale(); $gradescale->name = 'unittestscale3'; $gradescale->courseid = $this->course->id; $gradescale->userid = 317; $gradescale->scale = 'Distinction, Very Good, Good, Pass, Fail'; $gradescale->description = 'This scale is used to mark standard assignments.'; $id = $gradescale->insert(); $gradescale->name = 'Updated info for this unittest grade_scale'; $url = new \moodle_url('/grade/edit/scale/index.php', array('id' => $this->course->id)); // Trigger and capture the event. $sink = $this->redirectEvents(); $gradescale->update(); $events = $sink->get_events(); $event = reset($events); // Check that the event data is valid. $this->assertInstanceOf('\core\event\scale_updated', $event); $this->assertEquals($id, $event->objectid); $this->assertEquals($url, $event->get_url()); $this->assertEquals(context_course::instance($this->course->id), $event->get_context()); } }