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 qtype_multichoice;

use qtype_multichoice;

use qtype_multichoice_edit_form;

use question_possible_response;

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

global $CFG;

require_once($CFG->dirroot . '/question/engine/tests/helpers.php');

require_once($CFG->dirroot . '/question/type/multichoice/questiontype.php');

require_once($CFG->dirroot . '/question/type/edit_question_form.php');

require_once($CFG->dirroot . '/question/type/multichoice/edit_multichoice_form.php');

/**

 * Unit tests for the multiple choice question definition class.

 *

 * @package   qtype_multichoice

 * @copyright 2009 The Open University

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

 * @covers    \qtype_multichoice

 */

final class question_type_test extends \advanced_testcase {

    protected $qtype;

    protected function setUp(): void {

        parent::setUp();

        $this->qtype = new qtype_multichoice();

    }

    protected function tearDown(): void {

        $this->qtype = null;

        parent::tearDown();

    }

    public function test_name(): void {

        $this->assertEquals($this->qtype->name(), 'multichoice');

    }

    protected function get_test_question_data() {

        $q = new \stdClass();

        $q->id = 1;

        $q->options = new \stdClass();

        $q->options->single = true;

        $q->options->answers[1] = (object) array('answer' => 'frog',

                'answerformat' => FORMAT_HTML, 'fraction' => 1);

        $q->options->answers[2] = (object) array('answer' => 'toad',

                'answerformat' => FORMAT_HTML, 'fraction' => 0);

        return $q;

    }

    public function test_can_analyse_responses(): void {

        $this->assertTrue($this->qtype->can_analyse_responses());

    }

    public function test_get_random_guess_score(): void {

        $q = $this->get_test_question_data();

        $this->assertEquals(0.5, $this->qtype->get_random_guess_score($q));

    }

    public function test_get_random_guess_score_broken_question(): void {

        $q = $this->get_test_question_data();

        $q->options->answers = [];

        $this->assertNull($this->qtype->get_random_guess_score($q));

    }

    public function test_get_random_guess_score_multi(): void {

        $q = $this->get_test_question_data();

        $q->options->single = false;

        $this->assertNull($this->qtype->get_random_guess_score($q));

    }

    public function test_get_possible_responses_single(): void {

        $q = $this->get_test_question_data();

        $responses = $this->qtype->get_possible_responses($q);

        $this->assertEquals(array(

            $q->id => array(

                1 => new question_possible_response('frog', 1),

                2 => new question_possible_response('toad', 0),

                null => question_possible_response::no_response(),

            )), $this->qtype->get_possible_responses($q));

    }

    public function test_get_possible_responses_multi(): void {

        $q = $this->get_test_question_data();

        $q->options->single = false;

        $this->assertEquals(array(

            1 => array(1 => new question_possible_response('frog', 1)),

            2 => array(2 => new question_possible_response('toad', 0)),

        ), $this->qtype->get_possible_responses($q));

    }

    public static function get_question_saving_which(): array {

        return array(array('two_of_four'), array('one_of_four'));

    }

    /**

     * @dataProvider get_question_saving_which

     */

    public function test_question_saving_two_of_four($which): void {

        $this->resetAfterTest(true);

        $this->setAdminUser();

        $questiondata = \test_question_maker::get_question_data('multichoice', $which);

        $formdata = \test_question_maker::get_question_form_data('multichoice', $which);

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

        $cat = $generator->create_question_category(array());

        $formdata->category = "{$cat->id},{$cat->contextid}";

        qtype_multichoice_edit_form::mock_submit((array)$formdata);

        $form = \qtype_multichoice_test_helper::get_question_editing_form($cat, $questiondata);

        $this->assertTrue($form->is_validated());

        $fromform = $form->get_data();

        $returnedfromsave = $this->qtype->save_question($questiondata, $fromform);

        $actualquestionsdata = question_load_questions([$returnedfromsave->id], 'qbe.idnumber');

        $actualquestiondata = end($actualquestionsdata);

        foreach ($questiondata as $property => $value) {

            if (!in_array($property, ['id', 'timemodified', 'timecreated', 'options', 'hints', 'stamp',

                'versionid', 'questionbankentryid'])) {

                $this->assertEquals($value, $actualquestiondata->$property);

            }

        }

        foreach ($questiondata->options as $optionname => $value) {

            if ($optionname != 'answers') {

                $this->assertEquals($value, $actualquestiondata->options->$optionname);

            }

        }

        foreach ($questiondata->hints as $hint) {

            $actualhint = array_shift($actualquestiondata->hints);

            foreach ($hint as $property => $value) {

                if (!in_array($property, array('id', 'questionid', 'options'))) {

                    $this->assertEquals($value, $actualhint->$property);

                }

            }

        }

        foreach ($questiondata->options->answers as $answer) {

            $actualanswer = array_shift($actualquestiondata->options->answers);

            foreach ($answer as $ansproperty => $ansvalue) {

                // This question does not use 'answerformat', will ignore it.

                if (!in_array($ansproperty, array('id', 'question', 'answerformat'))) {

                    $this->assertEquals($ansvalue, $actualanswer->$ansproperty);

                }

            }

        }

    }

    /**

     * Test to make sure that loading of question options works, including in an error case.

     */

    public function test_get_question_options(): void {

        global $DB;

        $this->resetAfterTest(true);

        $this->setAdminUser();

        // Create a complete, in DB question to use.

        $questiondata = \test_question_maker::get_question_data('multichoice', 'two_of_four');

        $formdata = \test_question_maker::get_question_form_data('multichoice', 'two_of_four');

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

        $cat = $generator->create_question_category(array());

        $formdata->category = "{$cat->id},{$cat->contextid}";

        qtype_multichoice_edit_form::mock_submit((array)$formdata);

        $form = \qtype_multichoice_test_helper::get_question_editing_form($cat, $questiondata);

        $this->assertTrue($form->is_validated());

        $fromform = $form->get_data();

        $returnedfromsave = $this->qtype->save_question($questiondata, $fromform);

        // Now get just the raw DB record.

        $question = $DB->get_record('question', ['id' => $returnedfromsave->id], '*', MUST_EXIST);

        // Load it.

        $this->qtype->get_question_options($question);

        $this->assertDebuggingNotCalled();

        $this->assertInstanceOf(\stdClass::class, $question->options);

        $options = $question->options;

        $this->assertEquals($question->id, $options->questionid);

        $this->assertEquals(0, $options->single);

        $this->assertCount(4, $options->answers);

        // Now we are going to delete the options record.

        $DB->delete_records('qtype_multichoice_options', ['questionid' => $question->id]);

        // Now see what happens.

        $question = $DB->get_record('question', ['id' => $returnedfromsave->id], '*', MUST_EXIST);

        $this->qtype->get_question_options($question);

        $this->assertDebuggingCalled('Question ID '.$question->id.' was missing an options record. Using default.');

        $this->assertInstanceOf(\stdClass::class, $question->options);

        $options = $question->options;

        $this->assertEquals($question->id, $options->questionid);

        $this->assertCount(4, $options->answers);

        $this->assertEquals(get_string('correctfeedbackdefault', 'question'), $options->correctfeedback);

        $this->assertEquals(FORMAT_HTML, $options->correctfeedbackformat);

        // We no longer know how many answers, so it just has to guess with the default value.

        $this->assertEquals(get_config('qtype_multichoice', 'answerhowmany'), $options->single);

        // And finally we try again with no answer either.

        $DB->delete_records('question_answers', ['question' => $question->id]);

        $question = $DB->get_record('question', ['id' => $returnedfromsave->id], '*', MUST_EXIST);

        $this->qtype->get_question_options($question);

        $this->assertDebuggingCalled('Question ID '.$question->id.' was missing an options record. Using default.');

        $this->assertInstanceOf(\stdClass::class, $question->options);

        $options = $question->options;

        $this->assertEquals($question->id, $options->questionid);

        $this->assertCount(0, $options->answers);

    }

}