MDL-30998: updated docblocks for backup of advanced grading
[moodle.git] / grade / grading / tests / lib_test.php
1 <?php
2 // This file is part of Moodle - http://moodle.org/
3 //
4 // Moodle is free software: you can redistribute it and/or modify
5 // it under the terms of the GNU General Public License as published by
6 // the Free Software Foundation, either version 3 of the License, or
7 // (at your option) any later version.
8 //
9 // Moodle is distributed in the hope that it will be useful,
10 // but WITHOUT ANY WARRANTY; without even the implied warranty of
11 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12 // GNU General Public License for more details.
13 //
14 // You should have received a copy of the GNU General Public License
15 // along with Moodle.  If not, see <http://www.gnu.org/licenses/>.
17 /**
18  * Unit tests for the advanced grading subsystem
19  *
20  * @package    core
21  * @subpackage grading
22  * @category   phpunit
23  * @copyright  2011 David Mudrak <david@moodle.com>
24  * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
25  */
27 defined('MOODLE_INTERNAL') || die();
29 global $CFG;
30 require_once($CFG->dirroot . '/grade/grading/lib.php'); // Include the code to test
33 /**
34  * Makes protected method accessible for testing purposes
35  */
36 class testable_grading_manager extends grading_manager {
37 }
40 /**
41  * Test cases for the grading manager API
42  */
43 class grading_manager_testcase extends advanced_testcase {
44     public function test_basic_instantiation() {
45         $manager1 = get_grading_manager();
47         $fakecontext = (object)array(
48             'id'            => 42,
49             'contextlevel'  => CONTEXT_MODULE,
50             'instanceid'    => 22,
51             'path'          => '/1/3/15/42',
52             'depth'         => 4);
54         $manager2 = get_grading_manager($fakecontext);
55         $manager3 = get_grading_manager($fakecontext, 'assignment_upload');
56         $manager4 = get_grading_manager($fakecontext, 'assignment_upload', 'submission');
57     }
59     public function test_set_and_get_grading_area() {
60         global $DB;
62         $this->resetAfterTest(true);
64         //sleep(2); // to make sure the microtime will always return unique values // No sleeping in tests!!! --skodak
65         $areaname1 = 'area1-' . (string)microtime(true);
66         $areaname2 = 'area2-' . (string)microtime(true);
67         $fakecontext = (object)array(
68             'id'            => 42,
69             'contextlevel'  => CONTEXT_MODULE,
70             'instanceid'    => 22,
71             'path'          => '/1/3/15/42',
72             'depth'         => 4);
74         // non-existing area
75         $gradingman = get_grading_manager($fakecontext, 'mod_foobar', $areaname1);
76         $this->assertNull($gradingman->get_active_method());
78         // creates area implicitly and sets active method
79         $this->assertTrue($gradingman->set_active_method('rubric'));
80         $this->assertEquals('rubric', $gradingman->get_active_method());
82         // repeat setting of already set active method
83         $this->assertFalse($gradingman->set_active_method('rubric'));
85         // switch the manager to another area
86         $gradingman->set_area($areaname2);
87         $this->assertNull($gradingman->get_active_method());
89         // switch back and ask again
90         $gradingman->set_area($areaname1);
91         $this->assertEquals('rubric', $gradingman->get_active_method());
93         // attempting to set an invalid method
94         $this->setExpectedException('moodle_exception');
95         $gradingman->set_active_method('no_one_should_ever_try_to_implement_a_method_with_this_silly_name');
96     }
98     public function test_tokenize() {
100         $UTFfailuremessage = 'A test using UTF-8 characters has failed. Consider updating PHP and PHP\'s PCRE or INTL extensions (MDL-30494)';
102         $needle = "    šašek, \n\n   \r    a král;  \t";
103         $tokens = testable_grading_manager::tokenize($needle);
104         $this->assertEquals(2, count($tokens), $UTFfailuremessage);
105         $this->assertTrue(in_array('šašek', $tokens), $UTFfailuremessage);
106         $this->assertTrue(in_array('král', $tokens), $UTFfailuremessage);
108         $needle = ' "   šašek a král "    ';
109         $tokens = testable_grading_manager::tokenize($needle);
110         $this->assertEquals(1, count($tokens));
111         $this->assertTrue(in_array('šašek a král', $tokens));
113         $needle = '""';
114         $tokens = testable_grading_manager::tokenize($needle);
115         $this->assertTrue(empty($tokens));
117         $needle = '"0"';
118         $tokens = testable_grading_manager::tokenize($needle);
119         $this->assertEquals(1, count($tokens));
120         $this->assertTrue(in_array('0', $tokens));
122         $needle = '<span>Aha</span>, then who\'s a bad guy here he?';
123         $tokens = testable_grading_manager::tokenize($needle);
124         $this->assertEquals(8, count($tokens));
125         $this->assertTrue(in_array('span', $tokens)); // Extracted the tag name
126         $this->assertTrue(in_array('Aha', $tokens));
127         $this->assertTrue(in_array('who', $tokens)); // Removed the trailing 's
128         $this->assertTrue(!in_array('a', $tokens)); //Single letter token was dropped
129         $this->assertTrue(in_array('he', $tokens)); // Removed the trailing ?
131         $needle = 'grammar, "english language"';
132         $tokens = testable_grading_manager::tokenize($needle);
133         $this->assertTrue(in_array('grammar', $tokens));
134         $this->assertTrue(in_array('english', $tokens));
135         $this->assertTrue(in_array('language', $tokens));
136         $this->assertTrue(!in_array('english language', $tokens)); // Quoting part of the string is not supported
137     }