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_assign\external;

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

global $CFG;

require_once($CFG->dirroot . '/mod/assign/tests/externallib_advanced_testcase.php');

/**

 * Test the start_submission external function.

 *

 * @package    mod_assign

 * @category   test

 * @covers     \mod_assign\external\start_submission

 * @author     Andrew Madden <andrewmadden@catalyst-au.net>

 * @copyright  2021 Catalyst IT

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

 */

class start_submission_test extends \mod_assign\externallib_advanced_testcase {

    /** @var \stdClass $course New course created to hold the assignments */

    protected $course = null;

    /**

     * Called before every test.

     */

    protected function setUp(): void {

        parent::setUp();

        $this->resetAfterTest();

        $this->course = $this->getDataGenerator()->create_course(array('enablecompletion' => 1));

    }

    /**

     * Test start_submission if assignment doesn't exist matching id.

     */

    public function test_start_submission_with_invalid_assign_id(): void {

        $this->expectException(\dml_exception::class);

        start_submission::execute(123);

    }

    /**

     * Test start_submission if user is not able to access activity or course.

     */

    public function test_start_submission_when_user_has_no_capability_to_view_assignment(): void {

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

        $this->setUser($user);

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

        $assign = $generator->create_instance(['course' => $this->course->id]);

        $this->expectException(\require_login_exception::class);

        start_submission::execute($assign->id);

    }

    /**

     * Test start_submission if assignment cut off date has elapsed.

     */

    public function test_start_submission_when_assignment_past_due_date(): void {

        $fiveminago = time() - 300;

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status(

                false, ['cutoffdate' => $fiveminago]);

        $result = start_submission::execute($instance->id);

        $filteredwarnings = array_filter($result['warnings'], function($warning) {

            return $warning['warningcode'] === 'submissionnotopen';

        });

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

        $this->assertEquals(0, $result['submissionid']);

        $warning = array_pop($filteredwarnings);

        $this->assertEquals($instance->id, $warning['itemid']);

        $this->assertEquals('This assignment is not open for submissions', $warning['item']);

    }

    /**

     * Test start_submission if time limit is disabled.

     */

    public function test_start_submission_when_time_limit_disabled(): void {

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status();

        $result = start_submission::execute($instance->id);

        $filteredwarnings = array_filter($result['warnings'], function($warning) {

            return $warning['warningcode'] === 'timelimitnotenabled';

        });

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

        $this->assertEquals(0, $result['submissionid']);

        $warning = array_pop($filteredwarnings);

        $this->assertEquals($instance->id, $warning['itemid']);

        $this->assertEquals('Time limit is not enabled for assignment.', $warning['item']);

    }

    /**

     * Test start_submission if time limit is not set for assignment.

     */

    public function test_start_submission_when_time_limit_not_set(): void {

        set_config('enabletimelimit', '1', 'assign');

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status();

        $result = start_submission::execute($instance->id);

        $filteredwarnings = array_filter($result['warnings'], function($warning) {

            return $warning['warningcode'] === 'timelimitnotenabled';

        });

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

        $this->assertEquals(0, $result['submissionid']);

        $warning = array_pop($filteredwarnings);

        $this->assertEquals($instance->id, $warning['itemid']);

        $this->assertEquals('Time limit is not enabled for assignment.', $warning['item']);

    }

    /**

     * Test start_submission if user already has open submission.

     */

    public function test_start_submission_when_submission_already_open(): void {

        global $DB;

        set_config('enabletimelimit', '1', 'assign');

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status(

            false, ['timelimit' => 300]);

        $submission = $assign->get_user_submission($student1->id, true);

        $submission->timestarted = time();

        $DB->update_record('assign_submission', $submission);

        $result = start_submission::execute($instance->id);

        $filteredwarnings = array_filter($result['warnings'], function($warning) {

            return $warning['warningcode'] === 'opensubmissionexists';

        });

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

        $this->assertEquals(0, $result['submissionid']);

        $warning = array_pop($filteredwarnings);

        $this->assertEquals($instance->id, $warning['itemid']);

        $this->assertEquals('Open assignment submission already exists.', $warning['item']);

    }

    /**

     * Test start_submission if user has already submitted with no additional attempts available.

     */

    public function test_start_submission_with_no_attempts_available(): void {

        global $DB;

        set_config('enabletimelimit', '1', 'assign');

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status(

            false, ['timelimit' => 300]);

        $submission = $assign->get_user_submission($student1->id, true);

        $submission->status = ASSIGN_SUBMISSION_STATUS_SUBMITTED;

        $DB->update_record('assign_submission', $submission);

        $result = start_submission::execute($instance->id);

        $filteredwarnings = array_filter($result['warnings'], function($warning) {

            return $warning['warningcode'] === 'submissionnotopen';

        });

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

        $this->assertEquals(0, $result['submissionid']);

        $warning = array_pop($filteredwarnings);

        $this->assertEquals($instance->id, $warning['itemid']);

        $this->assertEquals('This assignment is not open for submissions', $warning['item']);

    }

    /**

     * Test start_submission if user has no open submissions.

     */

    public function test_start_submission_with_new_submission(): void {

        global $DB;

        set_config('enabletimelimit', '1', 'assign');

        list($assign, $instance, $student1, $student2, $teacher, $g1, $g2) = $this->create_submission_for_testing_status(

            false, ['timelimit' => 300]);

        // Clear all current submissions.

        $DB->delete_records('assign_submission', ['assignment' => $instance->id]);

        $result = start_submission::execute($instance->id);

        $this->assertCount(0, $result['warnings']);

        $this->assertNotEmpty($result['submissionid']);

    }

}