Proyectos de Subversion Moodle

<?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/>.

/**
 * Generator testcase for the gradingforum_rubric generator.
 *
 * @package    gradingform_rubric
 * @category   test
 * @copyright  2019 Andrew Nicols <andrew@nicols.co.uk>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

namespace gradingform_rubric;

use advanced_testcase;
use context_module;
use gradingform_rubric_controller;
use gradingform_controller;

/**
 * Generator testcase for the gradingforum_rubric generator.
 *
 * @package    gradingform_rubric
 * @category   test
 * @copyright  2019 Andrew Nicols <andrew@nicols.co.uk>
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */
class generator_test extends advanced_testcase {

    /**
     * Test rubric creation.
     */
    public function test_rubric_creation(): void {
        $this->resetAfterTest(true);

        // Fetch generators.
        $generator = \testing_util::get_data_generator();
        $rubricgenerator = $generator->get_plugin_generator('gradingform_rubric');

        // Create items required for testing.
        $course = $generator->create_course();
        $module = $generator->create_module('assign', ['course' => $course]);
        $user = $generator->create_user();
        $context = context_module::instance($module->cmid);

        // Data for testing.
        $name = 'myfirstrubric';
        $description = 'My first rubric';
        $criteria = [
            'Alphabet' => [
                'Not known' => 0,
                'Letters known but out of order' => 1,
                'Letters known in order ascending' => 2,
                'Letters known and can recite forwards and backwards' => 4,
            ],
            'Times tables' => [
                'Not known' => 0,
                '2 times table known' => 2,
                '2 and 5 times table known' => 4,
                '2, 5, and 10 times table known' => 8,
            ],
        ];

        // Unit under test.
        $this->setUser($user);
        $controller = $rubricgenerator->create_instance($context, 'mod_assign', 'submission', $name, $description, $criteria);

        $this->assertInstanceOf(gradingform_rubric_controller::class, $controller);

        $definition = $controller->get_definition();
        $this->assertNotEmpty($definition->id);
        $this->assertEquals($name, $definition->name);
        $this->assertEquals($description, $definition->description);
        $this->assertEquals(gradingform_controller::DEFINITION_STATUS_READY, $definition->status);
        $this->assertNotEmpty($definition->timecreated);
        $this->assertNotEmpty($definition->timemodified);
        $this->assertEquals($user->id, $definition->usercreated);

        $this->assertNotEmpty($definition->rubric_criteria);
        $this->assertCount(2, $definition->rubric_criteria);

        // Check the alphabet criteria.
        $criteriaids = array_keys($definition->rubric_criteria);

        $alphabet = $definition->rubric_criteria[$criteriaids[0]];
        $this->assertNotEmpty($alphabet['id']);
        $this->assertEquals(1, $alphabet['sortorder']);
        $this->assertEquals('Alphabet', $alphabet['description']);

        $this->assertNotEmpty($alphabet['levels']);
        $levels = $alphabet['levels'];
        $levelids = array_keys($levels);

        $level = $levels[$levelids[0]];
        $this->assertEquals(0, $level['score']);
        $this->assertEquals('Not known', $level['definition']);

        $level = $levels[$levelids[1]];
        $this->assertEquals(1, $level['score']);
        $this->assertEquals('Letters known but out of order', $level['definition']);

        $level = $levels[$levelids[2]];
        $this->assertEquals(2, $level['score']);
        $this->assertEquals('Letters known in order ascending', $level['definition']);

        $level = $levels[$levelids[3]];
        $this->assertEquals(4, $level['score']);
        $this->assertEquals('Letters known and can recite forwards and backwards', $level['definition']);

        // Check the times tables criteria.
        $tables = $definition->rubric_criteria[$criteriaids[1]];
        $this->assertNotEmpty($tables['id']);
        $this->assertEquals(2, $tables['sortorder']);
        $this->assertEquals('Times tables', $tables['description']);

        $this->assertNotEmpty($tables['levels']);
        $levels = $tables['levels'];
        $levelids = array_keys($levels);

        $level = $levels[$levelids[0]];
        $this->assertEquals(0, $level['score']);
        $this->assertEquals('Not known', $level['definition']);

        $level = $levels[$levelids[1]];
        $this->assertEquals(2, $level['score']);
        $this->assertEquals('2 times table known', $level['definition']);

        $level = $levels[$levelids[2]];
        $this->assertEquals(4, $level['score']);
        $this->assertEquals('2 and 5 times table known', $level['definition']);

        $level = $levels[$levelids[3]];
        $this->assertEquals(8, $level['score']);
        $this->assertEquals('2, 5, and 10 times table known', $level['definition']);
    }

    /**
     * Test the get_level_and_criterion_for_values function.
     * This is used for finding criterion and level information within a rubric.
     */
    public function test_get_level_and_criterion_for_values(): void {
        $this->resetAfterTest(true);

        // Fetch generators.
        $generator = \testing_util::get_data_generator();
        $rubricgenerator = $generator->get_plugin_generator('gradingform_rubric');

        // Create items required for testing.
        $course = $generator->create_course();
        $module = $generator->create_module('assign', ['course' => $course]);
        $user = $generator->create_user();
        $context = context_module::instance($module->cmid);

        // Data for testing.
        $description = 'My first rubric';
        $criteria = [
            'Alphabet' => [
                'Not known' => 0,
                'Letters known but out of order' => 1,
                'Letters known in order ascending' => 2,
                'Letters known and can recite forwards and backwards' => 4,
            ],
            'Times tables' => [
                'Not known' => 0,
                '2 times table known' => 2,
                '2 and 5 times table known' => 4,
                '2, 5, and 10 times table known' => 8,
            ],
        ];

        $this->setUser($user);
        $controller = $rubricgenerator->create_instance($context, 'mod_assign', 'submission', 'rubric', $description, $criteria);

        // Valid criterion and level.
        $result = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Alphabet', 2);
        $this->assertEquals('Alphabet', $result['criterion']->description);
        $this->assertEquals('2', $result['level']->score);
        $this->assertEquals('Letters known in order ascending', $result['level']->definition);

        // Valid criterion. Invalid level.
        $result = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Alphabet', 3);
        $this->assertEquals('Alphabet', $result['criterion']->description);
        $this->assertNull($result['level']);

        // Invalid criterion.
        $result = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Foo', 0);
        $this->assertNull($result['criterion']);
    }

    /**
     * Tests for the get_test_rubric function.
     */
    public function test_get_test_rubric(): void {
        $this->resetAfterTest(true);

        // Fetch generators.
        $generator = \testing_util::get_data_generator();
        $rubricgenerator = $generator->get_plugin_generator('gradingform_rubric');

        // Create items required for testing.
        $course = $generator->create_course();
        $module = $generator->create_module('assign', ['course' => $course]);
        $user = $generator->create_user();
        $context = context_module::instance($module->cmid);

        $this->setUser($user);
        $rubric = $rubricgenerator->get_test_rubric($context, 'assign', 'submissions');
        $definition = $rubric->get_definition();

        $this->assertEquals('testrubric', $definition->name);
        $this->assertEquals('Description text', $definition->description);
        $this->assertEquals(gradingform_controller::DEFINITION_STATUS_READY, $definition->status);

        // Should create a rubric with 2 criterion.
        $this->assertCount(2, $definition->rubric_criteria);
    }

    /**
     * Test the get_submitted_form_data function.
     */
    public function test_get_submitted_form_data(): void {
        $this->resetAfterTest(true);

        // Fetch generators.
        $generator = \testing_util::get_data_generator();
        $rubricgenerator = $generator->get_plugin_generator('gradingform_rubric');

        // Create items required for testing.
        $course = $generator->create_course();
        $module = $generator->create_module('assign', ['course' => $course]);
        $user = $generator->create_user();
        $context = context_module::instance($module->cmid);

        $this->setUser($user);
        $controller = $rubricgenerator->get_test_rubric($context, 'assign', 'submissions');

        $result = $rubricgenerator->get_submitted_form_data($controller, 93, [
            'Spelling is important' => [
                'score' => 1,
                'remark' => 'Good speeling',
            ],
            'Pictures' => [
                'score' => 2,
                'remark' => 'Lots of nice pictures!',
            ]
        ]);

        $this->assertIsArray($result);
        $this->assertEquals(93, $result['itemid']);
        $this->assertIsArray($result['criteria']);
        $this->assertCount(2, $result['criteria']);

        $spelling = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Spelling is important', 1);
        $this->assertIsArray($result['criteria'][$spelling['criterion']->id]);
        $this->assertEquals($spelling['level']->id, $result['criteria'][$spelling['criterion']->id]['levelid']);
        $this->assertEquals('Good speeling', $result['criteria'][$spelling['criterion']->id]['remark']);

        $pictures = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Pictures', 2);
        $this->assertIsArray($result['criteria'][$pictures['criterion']->id]);
        $this->assertEquals($pictures['level']->id, $result['criteria'][$pictures['criterion']->id]['levelid']);
        $this->assertEquals('Lots of nice pictures!', $result['criteria'][$pictures['criterion']->id]['remark']);
    }

    /**
     * Test the get_test_form_data function.
     */
    public function test_get_test_form_data(): void {
        $this->resetAfterTest(true);

        // Fetch generators.
        $generator = \testing_util::get_data_generator();
        $rubricgenerator = $generator->get_plugin_generator('gradingform_rubric');

        // Create items required for testing.
        $course = $generator->create_course();
        $module = $generator->create_module('assign', ['course' => $course]);
        $user = $generator->create_user();
        $context = context_module::instance($module->cmid);

        $this->setUser($user);
        $controller = $rubricgenerator->get_test_rubric($context, 'assign', 'submissions');

        // Unit under test.
        $result = $rubricgenerator->get_test_form_data(
            $controller,
            1839,
            1, 'Propper good speling',
            0, 'ASCII art is not a picture'
        );

        $this->assertIsArray($result);
        $this->assertEquals(1839, $result['itemid']);
        $this->assertIsArray($result['criteria']);
        $this->assertCount(2, $result['criteria']);

        $spelling = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Spelling is important', 1);
        $this->assertIsArray($result['criteria'][$spelling['criterion']->id]);
        $this->assertEquals($spelling['level']->id, $result['criteria'][$spelling['criterion']->id]['levelid']);
        $this->assertEquals('Propper good speling', $result['criteria'][$spelling['criterion']->id]['remark']);

        $pictures = $rubricgenerator->get_level_and_criterion_for_values($controller, 'Pictures', 0);
        $this->assertIsArray($result['criteria'][$pictures['criterion']->id]);
        $this->assertEquals($pictures['level']->id, $result['criteria'][$pictures['criterion']->id]['levelid']);
        $this->assertEquals('ASCII art is not a picture', $result['criteria'][$pictures['criterion']->id]['remark']);
    }
}