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

namespace mod_quiz\external;

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

require_once(__DIR__ . '/../../../../webservice/tests/helpers.php');

use coding_exception;

use core_question_generator;

use externallib_advanced_testcase;

use mod_quiz\quiz_attempt;

use mod_quiz\quiz_settings;

use required_capability_exception;

use stdClass;

/**

 * Test for the grade_items CRUD service.

 *

 * @package   mod_quiz

 * @category  external

 * @copyright 2023 The Open University

 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later

 * @covers \mod_quiz\external\create_grade_items

 * @covers \mod_quiz\external\delete_grade_items

 * @covers \mod_quiz\external\update_grade_items

 * @covers \mod_quiz\structure

 */

final class grade_items_test extends externallib_advanced_testcase {

    public function test_create_grade_items_service_works(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        create_grade_items::execute($quizobj->get_quizid(), [

            ['name' => 'Speaking'],

            ['name' => 'Writing'],

        ]);

        $structure = $quizobj->get_structure();

        $items = array_values($structure->get_grade_items());

        $this->assertEquals('Listening', $items[0]->name);

        $this->assertEquals('Reading', $items[1]->name);

        $this->assertEquals('Speaking', $items[2]->name);

        $this->assertEquals('Writing', $items[3]->name);

    }

    public function test_create_grade_items_service_checks_permissions(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $unprivilegeduser = $this->getDataGenerator()->create_user();

        $this->setUser($unprivilegeduser);

        $this->expectException(required_capability_exception::class);

        create_grade_items::execute($quizobj->get_quizid(), []);

    }

    public function test_update_grade_items_service_works(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $structure = $quizobj->get_structure();

        $items = array_values($structure->get_grade_items());

        update_grade_items::execute($quizobj->get_quizid(), [

            ['id' => $items[0]->id, 'name' => 'Speaking'],

            ['id' => $items[1]->id, 'name' => null],

        ]);

        $structure = $quizobj->get_structure();

        $updateditems = $structure->get_grade_items();

        $this->assertEquals('Speaking', $updateditems[$items[0]->id]->name);

        $this->assertEquals($items[1]->name, $updateditems[$items[1]->id]->name);

    }

    public function test_update_grade_items_service_checks_permissions(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $unprivilegeduser = $this->getDataGenerator()->create_user();

        $this->setUser($unprivilegeduser);

        $this->expectException(required_capability_exception::class);

        update_grade_items::execute($quizobj->get_quizid(), []);

    }

    public function test_delete_grade_items_service_works(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $structure = $quizobj->get_structure();

        $items = array_values($structure->get_grade_items());

        $structure->update_slot_grade_item($structure->get_slot_by_number(1), null);

        $structure->update_slot_grade_item($structure->get_slot_by_number(2), null);

        delete_grade_items::execute($quizobj->get_quizid(), [['id' => $items[0]->id]]);

        $structure = $quizobj->get_structure();

        $updateditems = $structure->get_grade_items();

        $this->assertCount(1, $updateditems);

        $this->assertEquals('Reading', $updateditems[$items[1]->id]->name);

    }

    public function test_cant_delete_grade_item_that_is_used(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $structure = $quizobj->get_structure();

        $items = array_values($structure->get_grade_items());

        $this->expectException(coding_exception::class);

        delete_grade_items::execute($quizobj->get_quizid(), [['id' => $items[0]->id]]);

    }

    public function test_delete_grade_items_service_checks_permissions(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $unprivilegeduser = $this->getDataGenerator()->create_user();

        $this->setUser($unprivilegeduser);

        $structure = $quizobj->get_structure();

        $items = array_values($structure->get_grade_items());

        $this->expectException(required_capability_exception::class);

        delete_grade_items::execute($quizobj->get_quizid(), [['id' => $items[0]->id]]);

    }

    public function test_get_edit_grading_page_data_service_works(): void {

        global $PAGE;

        $PAGE->set_url('/');

        $quizobj = $this->create_quiz_with_two_grade_items();

        $jsondata = get_edit_grading_page_data::execute($quizobj->get_quizid());

        $this->assertJson($jsondata);

        $data = json_decode($jsondata);

        $this->assertEquals($quizobj->get_quizid(), $data->quizid);

    }

    public function test_get_edit_grading_page_data_service_checks_permissions(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $unprivilegeduser = $this->getDataGenerator()->create_user();

        $this->setUser($unprivilegeduser);

        $this->expectException(required_capability_exception::class);

        get_edit_grading_page_data::execute($quizobj->get_quizid());

    }

    /**

     * Create a quiz of two shortanswer questions, each contributing to a different grade item.

     *

     * @return quiz_settings the newly created quiz.

     */

    protected function create_quiz_with_two_grade_items(): quiz_settings {

        global $SITE;

        $this->resetAfterTest();

        $this->setAdminUser();

        // Make a quiz.

        /** @var \mod_quiz_generator $quizgenerator */

        $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz');

        $quiz = $quizgenerator->create_instance(['course' => $SITE->id]);

        // Create two question.

        /** @var core_question_generator $questiongenerator */

        $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question');

        $cat = $questiongenerator->create_question_category();

        $saq1 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        $saq2 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        // Add them to the quiz.

        quiz_add_quiz_question($saq1->id, $quiz, 0, 1);

        quiz_add_quiz_question($saq2->id, $quiz, 0, 1);

        // Create two quiz grade items.

        $listeninggrade = $quizgenerator->create_grade_item(['quizid' => $quiz->id, 'name' => 'Listening']);

        $readinggrade = $quizgenerator->create_grade_item(['quizid' => $quiz->id, 'name' => 'Reading']);

        // Set the questions to use those grade items.

        $quizobj = quiz_settings::create($quiz->id);

        $structure = $quizobj->get_structure();

        $structure->update_slot_grade_item($structure->get_slot_by_number(1), $listeninggrade->id);

        $structure->update_slot_grade_item($structure->get_slot_by_number(2), $readinggrade->id);

        $quizobj->get_grade_calculator()->recompute_quiz_sumgrades();

        return $quizobj;

    }

    public function test_create_grade_item_per_section_works(): void {

        global $SITE;

        $this->resetAfterTest();

        $this->setAdminUser();

        // Create a quiz with no grade items yet, but two sections.

        /** @var \mod_quiz_generator $quizgenerator */

        $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz');

        $quiz = $quizgenerator->create_instance(['course' => $SITE->id]);

        // Create three questions.

        /** @var core_question_generator $questiongenerator */

        $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question');

        $cat = $questiongenerator->create_question_category();

        $saq1 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        $saq2 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        $saq3 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        // Add them to the quiz.

        quiz_add_quiz_question($saq1->id, $quiz, 1, 1);

        quiz_add_quiz_question($saq2->id, $quiz, 1, 1);

        quiz_add_quiz_question($saq3->id, $quiz, 2, 1);

        // Create two sections.

        $quizobj = quiz_settings::create($quiz->id);

        $structure = $quizobj->get_structure();

        $defaultsection = array_values($structure->get_sections())[0];

        $structure->set_section_heading($defaultsection->id, 'Listening');

        $structure->add_section_heading(2, 'Reading');

        // Call the method we are testing.

        create_grade_item_per_section::execute($quizobj->get_quizid());

        // Verify.

        $structure = $quizobj->get_structure();

        $gradeitems = array_values($structure->get_grade_items());

        $this->assertCount(2, $gradeitems);

        $this->assertEquals('Listening', $gradeitems[0]->name);

        $this->assertEquals(1, $gradeitems[0]->sortorder);

        $this->assertEquals('Reading', $gradeitems[1]->name);

        $this->assertEquals(2, $gradeitems[1]->sortorder);

        $this->assertEquals($gradeitems[0]->id, $structure->get_slot_by_number(1)->quizgradeitemid);

        $this->assertEquals($gradeitems[0]->id, $structure->get_slot_by_number(2)->quizgradeitemid);

        $this->assertEquals($gradeitems[1]->id, $structure->get_slot_by_number(3)->quizgradeitemid);

    }

    public function test_create_grade_item_per_section_with_descriptions(): void {

        global $SITE;

        $this->resetAfterTest();

        $this->setAdminUser();

        // Create a quiz with no grade items yet, but two sections.

        /** @var \mod_quiz_generator $quizgenerator */

        $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz');

        $quiz = $quizgenerator->create_instance(['course' => $SITE->id]);

        // Create three questions.

        /** @var core_question_generator $questiongenerator */

        $questiongenerator = $this->getDataGenerator()->get_plugin_generator('core_question');

        $cat = $questiongenerator->create_question_category();

        $desc1 = $questiongenerator->create_question('description', null, ['category' => $cat->id]);

        $desc2 = $questiongenerator->create_question('description', null, ['category' => $cat->id]);

        $saq1 = $questiongenerator->create_question('shortanswer', null, ['category' => $cat->id]);

        // Add them to the quiz.

        quiz_add_quiz_question($desc1->id, $quiz, 1);

        quiz_add_quiz_question($desc2->id, $quiz, 2);

        quiz_add_quiz_question($saq1->id, $quiz, 2, 7);

        // Create two sections.

        $quizobj = quiz_settings::create($quiz->id);

        $structure = $quizobj->get_structure();

        $defaultsection = array_values($structure->get_sections())[0];

        $structure->set_section_heading($defaultsection->id, 'Introduction');

        $structure->add_section_heading(2, 'The question');

        // Call the method we are testing.

        create_grade_item_per_section::execute($quizobj->get_quizid());

        // Verify.

        $structure = $quizobj->get_structure();

        $gradeitems = array_values($structure->get_grade_items());

        $this->assertCount(1, $gradeitems);

        $this->assertEquals('The question', $gradeitems[0]->name);

        $this->assertEquals(1, $gradeitems[0]->sortorder);

        $this->assertNull($structure->get_slot_by_number(1)->quizgradeitemid);

        $this->assertNull($structure->get_slot_by_number(2)->quizgradeitemid);

        $this->assertEquals($gradeitems[0]->id, $structure->get_slot_by_number(3)->quizgradeitemid);

    }

    public function test_create_grade_item_per_section_service_checks_permissions(): void {

        global $SITE;

        $this->resetAfterTest();

        // Create a quiz.

        /** @var \mod_quiz_generator $quizgenerator */

        $quizgenerator = $this->getDataGenerator()->get_plugin_generator('mod_quiz');

        $quiz = $quizgenerator->create_instance(['course' => $SITE->id]);

        $unprivilegeduser = $this->getDataGenerator()->create_user();

        $this->setUser($unprivilegeduser);

        $this->expectException(required_capability_exception::class);

        create_grade_item_per_section::execute($quiz->id);

    }

    public function test_cant_create_grade_item_per_section_if_grade_items_already_exist(): void {

        $quizobj = $this->create_quiz_with_two_grade_items();

        $this->expectException(coding_exception::class);

        create_grade_item_per_section::execute($quizobj->get_quizid());

    }

}