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

/**

 * Test data generator

 *

 * @package    core

 * @category   phpunit

 * @copyright  2012 Petr Skoda {@link http://skodak.org}

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

 * @covers \core\testing_data_generator

 */

class testing_generator_test extends \advanced_testcase {

    public function test_get_plugin_generator_good_case(): void {

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

        $this->assertInstanceOf('core_question_generator', $generator);

    }

    public function test_get_plugin_generator_sloppy_name(): void {

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

        $this->assertDebuggingCalled('Please specify the component you want a generator for as ' .

                    'mod_quiz, not quiz.', DEBUG_DEVELOPER);

        $this->assertInstanceOf('mod_quiz_generator', $generator);

    }

    public function test_get_default_generator(): void {

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

        $this->assertInstanceOf('default_block_generator', $generator);

    }

    /**

     * Test plugin generator, with no component directory.

     */

    public function test_get_plugin_generator_no_component_dir(): void {

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

        $this->expectExceptionMessage('Component core_cohort does not support generators yet. Missing tests/generator/lib.php.');

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

    }

    public function test_create_user(): void {

        global $DB, $CFG;

        require_once($CFG->dirroot.'/user/lib.php');

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        $count = $DB->count_records('user');

        $this->setCurrentTimeStart();

        $user = $generator->create_user();

        $this->assertEquals($count + 1, $DB->count_records('user'));

        $this->assertSame($user->username, \core_user::clean_field($user->username, 'username'));

        $this->assertSame($user->email, \core_user::clean_field($user->email, 'email'));

        $this->assertNotEmpty($user->firstnamephonetic);

        $this->assertNotEmpty($user->lastnamephonetic);

        $this->assertNotEmpty($user->alternatename);

        $this->assertNotEmpty($user->middlename);

        $this->assertSame('manual', $user->auth);

        $this->assertSame('en', $user->lang);

        $this->assertSame('1', $user->confirmed);

        $this->assertSame('0', $user->deleted);

        $this->assertTimeCurrent($user->timecreated);

        $this->assertSame($user->timecreated, $user->timemodified);

        $this->assertSame('0.0.0.0', $user->lastip);

        $record = array(

            'auth' => 'email',

            'firstname' => 'Žluťoučký',

            'lastname' => 'Koníček',

            'firstnamephonetic' => 'Zhlutyoucky',

            'lastnamephonetic' => 'Koniiczek',

            'middlename' => 'Hopper',

            'alternatename' => 'horse',

            'idnumber' => 'abc1',

            'mnethostid' => (string)$CFG->mnet_localhost_id,

            'username' => 'konic666',

            'password' => 'password1',

            'email' => 'email@example.com',

            'confirmed' => '1',

            'maildisplay' => '1',

            'mailformat' => '0',

            'maildigest' => '1',

            'autosubscribe' => '0',

            'trackforums' => '0',

            'deleted' => '0',

            'timecreated' => '666',

        );

        $user = $generator->create_user($record);

        $this->assertEquals($count + 2, $DB->count_records('user'));

        foreach ($record as $k => $v) {

            if ($k === 'password') {

                $this->assertTrue(password_verify($v, $user->password));

            } else {

                $this->assertSame($v, $user->{$k});

            }

        }

        $record = array(

            'firstname' => 'Some',

            'lastname' => 'User',

            'idnumber' => 'def',

            'username' => 'user666',

            'email' => 'email666@example.com',

            'deleted' => '1',

        );

        $user = $generator->create_user($record);

        $this->assertEquals($count + 3, $DB->count_records('user'));

        $this->assertSame('', $user->idnumber);

        $this->assertSame(md5($record['username']), $user->email);

        $this->assertEquals(1, $user->deleted);

        // Test generating user with interests.

        $user = $generator->create_user(array('interests' => 'Cats, Dogs'));

        $userdetails = user_get_user_details($user);

        $this->assertSame('Cats, Dogs', $userdetails['interests']);

    }

    public function test_create(): void {

        global $DB;

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        $count = $DB->count_records('course_categories');

        $category = $generator->create_category();

        $this->assertEquals($count+1, $DB->count_records('course_categories'));

        $this->assertMatchesRegularExpression('/^Course category \d/', $category->name);

        $this->assertSame('', $category->idnumber);

        $this->assertMatchesRegularExpression('/^Test course category \d/', $category->description);

        $this->assertSame(FORMAT_MOODLE, $category->descriptionformat);

        $count = $DB->count_records('cohort');

        $cohort = $generator->create_cohort();

        $this->assertEquals($count+1, $DB->count_records('cohort'));

        $this->assertEquals(\context_system::instance()->id, $cohort->contextid);

        $this->assertMatchesRegularExpression('/^Cohort \d/', $cohort->name);

        $this->assertSame('', $cohort->idnumber);

        $this->assertMatchesRegularExpression("/^Description for '{$cohort->name}' \\n/", $cohort->description);

        $this->assertSame(FORMAT_MOODLE, $cohort->descriptionformat);

        $this->assertSame('', $cohort->component);

        $this->assertLessThanOrEqual(time(), $cohort->timecreated);

        $this->assertSame($cohort->timecreated, $cohort->timemodified);

        $count = $DB->count_records('course');

        $course = $generator->create_course();

        $this->assertEquals($count+1, $DB->count_records('course'));

        $this->assertMatchesRegularExpression('/^Test course \d/', $course->fullname);

        $this->assertMatchesRegularExpression('/^tc_\d/', $course->shortname);

        $this->assertSame('', $course->idnumber);

        $this->assertSame('topics', $course->format);

        $this->assertEquals(0, $course->newsitems);

        $this->assertEquals(5, course_get_format($course)->get_last_section_number());

        $this->assertMatchesRegularExpression('/^Test course \d/', $course->summary);

        $this->assertSame(FORMAT_MOODLE, $course->summaryformat);

        $section = $generator->create_course_section(array('course'=>$course->id, 'section'=>3));

        $this->assertEquals($course->id, $section->course);

        $this->assertNull($section->name);

        $course = $generator->create_course(array('tags' => 'Cat, Dog'));

        $this->assertEquals(array('Cat', 'Dog'), array_values(\core_tag_tag::get_item_tags_array('core', 'course', $course->id)));

        $scale = $generator->create_scale();

        $this->assertNotEmpty($scale);

    }

    /**

     * Test case for the `test_create_course_initsections` method.

     *

     * This method tests the behavior of creating a course with initialized sections.

     * It checks that the sections are renamed to "Section x" when `initsections` is true,

     * and that the sections are not renamed when `initsections` is false.

     *

     * @covers ::create_course

     */

    public function test_create_course_initsections(): void {

        global $DB;

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        // Check that the sections are renamed to "Section x" when initsections is true.

        $course = $generator->create_course(['initsections' => 1]);

        $sections = course_get_format($course)->get_sections();

        foreach ($sections as $section) {

            if ($section->sectionnum > 0) {

                $this->assertEquals(get_string('section') . ' ' . $section->sectionnum, $section->name);

            }

        }

        // Check that the sections are not renamed when initsections is false.

        $course = $generator->create_course(['initsections' => 0]);

        $sections = course_get_format($course)->get_sections();

        foreach ($sections as $section) {

            if ($section->sectionnum > 0) {

                $this->assertNull($section->name);

            }

        }

    }

    public function test_create_module(): void {

        global $CFG, $SITE, $DB;

        $this->setAdminUser();

        if (!file_exists("$CFG->dirroot/mod/page/")) {

            $this->markTestSkipped('Can not find standard Page module');

        }

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        $page = $generator->create_module('page', array('course'=>$SITE->id));

        $this->assertNotEmpty($page);

        $cm = get_coursemodule_from_instance('page', $page->id, $SITE->id, true);

        $this->assertEquals(0, $cm->sectionnum);

        $page = $generator->create_module('page', array('course'=>$SITE->id), array('section'=>3));

        $this->assertNotEmpty($page);

        $cm = get_coursemodule_from_instance('page', $page->id, $SITE->id, true);

        $this->assertEquals(3, $cm->sectionnum);

        $page = $generator->create_module('page', array('course' => $SITE->id, 'tags' => 'Cat, Dog'));

        $this->assertEquals(array('Cat', 'Dog'),

            array_values(\core_tag_tag::get_item_tags_array('core', 'course_modules', $page->cmid)));

        // Prepare environment to generate modules with all possible options.

        // Enable advanced functionality.

        $CFG->enablecompletion = 1;

        $CFG->enableavailability = 1;

        $CFG->enableoutcomes = 1;

        require_once($CFG->libdir.'/gradelib.php');

        require_once($CFG->libdir.'/completionlib.php');

        require_once($CFG->dirroot.'/rating/lib.php');

        // Create a course with enabled completion.

        $course = $generator->create_course(array('enablecompletion' => true));

        // Create new grading category in this course.

        $grade_category = new \grade_category();

        $grade_category->courseid = $course->id;

        $grade_category->fullname = 'Grade category';

        $grade_category->insert();

        // Create group and grouping.

        $group = $generator->create_group(array('courseid' => $course->id));

        $grouping = $generator->create_grouping(array('courseid' => $course->id));

        $generator->create_grouping_group(array('groupid' => $group->id, 'groupingid' => $grouping->id));

        // Prepare arrays with properties that we can both use for creating modules and asserting the data in created modules.

        // General properties.

        $optionsgeneral = array(

            'visible' => 0, // Note: 'visibleold' will always be set to the same value as 'visible'.

            'section' => 3, // Note: section will be created if does not exist.

            // Module supports FEATURE_IDNUMBER.

            'cmidnumber' => 'IDNUM', // Note: alternatively can have key 'idnumber'.

            // Module supports FEATURE_GROUPS;

            'groupmode' => SEPARATEGROUPS, // Note: will be reset to 0 if course groupmodeforce is set.

            // Module supports FEATURE_GROUPINGS.

            'groupingid' => $grouping->id,

        );

        // In case completion is enabled on site and for course every module can have manual completion.

        $featurecompletionmanual = array(

            'completion' => COMPLETION_TRACKING_MANUAL, // "Students can manually mark activity as completed."

            'completionexpected' => time() + 7 * DAYSECS,

        );

        // Automatic completion is possible if module supports FEATURE_COMPLETION_TRACKS_VIEWS or FEATURE_GRADE_HAS_GRADE.

        // Note: completionusegrade is stored in DB and can be found in cm_info as 'completiongradeitemnumber' - either NULL or 0.

        // Note: module can have more autocompletion rules as defined in moodleform_mod::add_completion_rules().

        $featurecompletionautomatic = array(

            'completion' => COMPLETION_TRACKING_AUTOMATIC, // "Show activity as complete when conditions are met."

            'completionview' => 1, // "Student must view this activity to complete it"

            'completionusegrade' => 1, // "Student must receive a grade to complete this activity"

            'completionpassgrade' => 1, // "Student must receive a passing grade to complete this activity"

        );

        // Module supports FEATURE_RATE:

        $featurerate = array(

            'assessed' => RATING_AGGREGATE_AVERAGE, // "Aggregate type"

            'scale' => 100, // Either max grade or negative number for scale id.

            'ratingtime' => 1, // "Restrict ratings to items with dates in this range".

            'assesstimestart' => time() - DAYSECS, // Note: Will be ignored if neither 'assessed' nor 'ratingtime' is set.

            'assesstimefinish' => time() + DAYSECS, // Note: Will be ignored if neither 'assessed' nor 'ratingtime' is set.

        );

        // Module supports FEATURE_GRADE_HAS_GRADE:

        $featuregrade = array(

            'grade' => 10,

            'gradecat' => $grade_category->id, // Note: if $CFG->enableoutcomes is set, this can be set to -1 to automatically create new grade category.

        );

        // Now let's create several modules with different options.

        $m1 = $generator->create_module('assign',

            array('course' => $course->id) +

            $optionsgeneral);

        $m2 = $generator->create_module('data',

            array('course' => $course->id) +

            $featurecompletionmanual +

            $featurerate);

        $m3 = $generator->create_module('assign',

            array('course' => $course->id) +

            $featurecompletionautomatic +

            $featuregrade);

        // We need id of the grading item for the second module to create availability dependency in the 3rd module.

        $gradingitem = \grade_item::fetch(array('courseid'=>$course->id, 'itemtype'=>'mod', 'itemmodule' => 'assign', 'iteminstance' => $m3->id));

        // Now prepare option to create the 4th module with an availability condition.

        $optionsavailability = array(

            'availability' => '{"op":"&","showc":[true],"c":[' .

                '{"type":"date","d":">=","t":' . (time() - WEEKSECS) . '}]}',

        );

        // Create module with conditional availability.

        $m4 = $generator->create_module('assign',

                array('course' => $course->id) +

                $optionsavailability

        );

        // Verifying that everything is generated correctly.

        $modinfo = get_fast_modinfo($course->id);

        $cm1 = $modinfo->cms[$m1->cmid];

        $this->assertEquals($optionsgeneral['visible'], $cm1->visible);

        $this->assertEquals($optionsgeneral['section'], $cm1->sectionnum); // Note difference in key.

        $this->assertEquals($optionsgeneral['cmidnumber'], $cm1->idnumber); // Note difference in key.

        $this->assertEquals($optionsgeneral['groupmode'], $cm1->groupmode);

        $this->assertEquals($optionsgeneral['groupingid'], $cm1->groupingid);

        $cm2 = $modinfo->cms[$m2->cmid];

        $this->assertEquals($featurecompletionmanual['completion'], $cm2->completion);

        $this->assertEquals($featurecompletionmanual['completionexpected'], $cm2->completionexpected);

        $this->assertEquals(null, $cm2->completiongradeitemnumber);

        // Rating info is stored in the module's table (in our test {data}).

        $data = $DB->get_record('data', array('id' => $m2->id));

        $this->assertEquals($featurerate['assessed'], $data->assessed);

        $this->assertEquals($featurerate['scale'], $data->scale);

        $this->assertEquals($featurerate['assesstimestart'], $data->assesstimestart);

        $this->assertEquals($featurerate['assesstimefinish'], $data->assesstimefinish);

        // No validation for 'ratingtime'. It is only used in to enable/disable assesstime* when adding module.

        $cm3 = $modinfo->cms[$m3->cmid];

        $this->assertEquals($featurecompletionautomatic['completion'], $cm3->completion);

        $this->assertEquals($featurecompletionautomatic['completionview'], $cm3->completionview);

        $this->assertEquals($featurecompletionautomatic['completionpassgrade'], $cm3->completionpassgrade);

        $this->assertEquals(0, $cm3->completiongradeitemnumber); // Zero instead of default null since 'completionusegrade' was set.

        $gradingitem = \grade_item::fetch(array('courseid'=>$course->id, 'itemtype'=>'mod', 'itemmodule' => 'assign', 'iteminstance' => $m3->id));

        $this->assertEquals(0, $gradingitem->grademin);

        $this->assertEquals($featuregrade['grade'], $gradingitem->grademax);

        $this->assertEquals($featuregrade['gradecat'], $gradingitem->categoryid);

        $cm4 = $modinfo->cms[$m4->cmid];

        $this->assertEquals($optionsavailability['availability'], $cm4->availability);

    }

    public function test_create_block(): void {

        global $CFG;

        if (!file_exists("$CFG->dirroot/blocks/online_users/")) {

            $this->markTestSkipped('Can not find standard Online users block');

        }

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        $page = $generator->create_block('online_users');

        $this->assertNotEmpty($page);

    }

    public function test_enrol_user(): void {

        global $DB;

        $this->resetAfterTest();

        $selfplugin = enrol_get_plugin('self');

        $this->assertNotEmpty($selfplugin);

        $manualplugin = enrol_get_plugin('manual');

        $this->assertNotEmpty($manualplugin);

        // Prepare some data.

        $studentrole = $DB->get_record('role', array('shortname'=>'student'));

        $this->assertNotEmpty($studentrole);

        $teacherrole = $DB->get_record('role', array('shortname'=>'teacher'));

        $this->assertNotEmpty($teacherrole);

        $course1 = $this->getDataGenerator()->create_course();

        $course2 = $this->getDataGenerator()->create_course();

        $course3 = $this->getDataGenerator()->create_course();

        $context1 = \context_course::instance($course1->id);

        $context2 = \context_course::instance($course2->id);

        $context3 = \context_course::instance($course3->id);

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

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

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

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

        $this->assertEquals(3, $DB->count_records('enrol', array('enrol'=>'self')));

        $instance1 = $DB->get_record('enrol', array('courseid'=>$course1->id, 'enrol'=>'self'), '*', MUST_EXIST);

        $instance2 = $DB->get_record('enrol', array('courseid'=>$course2->id, 'enrol'=>'self'), '*', MUST_EXIST);

        $instance3 = $DB->get_record('enrol', array('courseid'=>$course3->id, 'enrol'=>'self'), '*', MUST_EXIST);

        $this->assertEquals($studentrole->id, $instance1->roleid);

        $this->assertEquals($studentrole->id, $instance2->roleid);

        $this->assertEquals($studentrole->id, $instance3->roleid);

        $this->assertEquals(3, $DB->count_records('enrol', array('enrol'=>'manual')));

        $maninstance1 = $DB->get_record('enrol', array('courseid'=>$course1->id, 'enrol'=>'manual'), '*', MUST_EXIST);

        $maninstance2 = $DB->get_record('enrol', array('courseid'=>$course2->id, 'enrol'=>'manual'), '*', MUST_EXIST);

        $maninstance3 = $DB->get_record('enrol', array('courseid'=>$course3->id, 'enrol'=>'manual'), '*', MUST_EXIST);

        $maninstance3->roleid = $teacherrole->id;

        $DB->update_record('enrol', $maninstance3, array('id'=>$maninstance3->id));

        $this->assertEquals($studentrole->id, $maninstance1->roleid);

        $this->assertEquals($studentrole->id, $maninstance2->roleid);

        $this->assertEquals($teacherrole->id, $maninstance3->roleid);

        $result = $this->getDataGenerator()->enrol_user($user1->id, $course1->id);

        $this->assertTrue($result);

        $this->assertTrue($DB->record_exists('user_enrolments', array('enrolid'=>$maninstance1->id, 'userid'=>$user1->id)));

        $this->assertTrue($DB->record_exists('role_assignments', array('contextid'=>$context1->id, 'userid'=>$user1->id, 'roleid'=>$studentrole->id)));

        $result = $this->getDataGenerator()->enrol_user($user1->id, $course2->id, $teacherrole->id, 'manual');

        $this->assertTrue($result);

        $this->assertTrue($DB->record_exists('user_enrolments', array('enrolid'=>$maninstance2->id, 'userid'=>$user1->id)));

        $this->assertTrue($DB->record_exists('role_assignments', array('contextid'=>$context2->id, 'userid'=>$user1->id, 'roleid'=>$teacherrole->id)));

        $result = $this->getDataGenerator()->enrol_user($user4->id, $course2->id, 'teacher', 'manual');

        $this->assertTrue($result);

        $this->assertTrue($DB->record_exists('user_enrolments',

                array('enrolid' => $maninstance2->id, 'userid' => $user4->id)));

        $this->assertTrue($DB->record_exists('role_assignments',

                array('contextid' => $context2->id, 'userid' => $user4->id, 'roleid' => $teacherrole->id)));

        $result = $this->getDataGenerator()->enrol_user($user1->id, $course3->id, 0, 'manual');

        $this->assertTrue($result);

        $this->assertTrue($DB->record_exists('user_enrolments', array('enrolid'=>$maninstance3->id, 'userid'=>$user1->id)));

        $this->assertFalse($DB->record_exists('role_assignments', array('contextid'=>$context3->id, 'userid'=>$user1->id)));

        $result = $this->getDataGenerator()->enrol_user($user2->id, $course1->id, null, 'self');

        $this->assertTrue($result);

        $this->assertTrue($DB->record_exists('user_enrolments', array('enrolid'=>$instance1->id, 'userid'=>$user2->id)));

        $this->assertTrue($DB->record_exists('role_assignments', array('contextid'=>$context1->id, 'userid'=>$user2->id, 'roleid'=>$studentrole->id)));

        $selfplugin->add_instance($course2, array('status'=>ENROL_INSTANCE_ENABLED, 'roleid'=>$teacherrole->id));

        $result = $this->getDataGenerator()->enrol_user($user2->id, $course2->id, null, 'self');

        $this->assertFalse($result);

        $DB->delete_records('enrol', array('enrol'=>'self', 'courseid'=>$course3->id));

        $result = $this->getDataGenerator()->enrol_user($user2->id, $course3->id, null, 'self');

        $this->assertFalse($result);

    }

    public function test_create_grade_category(): void {

        global $DB, $CFG;

        require_once $CFG->libdir . '/grade/constants.php';

        $this->resetAfterTest(true);

        $generator = $this->getDataGenerator();

        $course = $generator->create_course();

        // Generate category and make sure number of records in DB table increases.

        // Note we only count grade cats with depth > 1 because the course grade category

        // is lazily created.

        $count = $DB->count_records_select('grade_categories', 'depth <> 1');

        $gradecategory = $generator->create_grade_category(array('courseid'=>$course->id));

        $this->assertEquals($count+1, $DB->count_records_select('grade_categories', 'depth <> 1'));

        $this->assertEquals(2, $gradecategory->depth);

        $this->assertEquals($course->id, $gradecategory->courseid);

        $this->assertEquals('Grade category 1', $gradecategory->fullname);

        // Generate category and make sure aggregation is set.

        $gradecategory = $generator->create_grade_category(

                array('courseid' => $course->id, 'aggregation' => GRADE_AGGREGATE_MEDIAN));

        $this->assertEquals(GRADE_AGGREGATE_MEDIAN, $gradecategory->aggregation);

        // Generate category and make sure parent is set.

        $gradecategory2 = $generator->create_grade_category(

                array('courseid' => $course->id,

                    'parent' => $gradecategory->id));

        $this->assertEquals($gradecategory->id, $gradecategory2->parent);

    }

    public function test_create_custom_profile_field_category(): void {

        global $DB;

        $this->resetAfterTest();

        $generator = $this->getDataGenerator();

        // Insert first category without specified sortorder.

        $result = $generator->create_custom_profile_field_category(['name' => 'Frogs']);

        $record = $DB->get_record('user_info_category', ['name' => 'Frogs']);

        $this->assertEquals(1, $record->sortorder);

        // Also check the return value.

        $this->assertEquals(1, $result->sortorder);

        $this->assertEquals('Frogs', $result->name);

        $this->assertEquals($record->id, $result->id);

        // Insert next category without specified sortorder.

        $generator->create_custom_profile_field_category(['name' => 'Zombies']);

        $record = $DB->get_record('user_info_category', ['name' => 'Zombies']);

        $this->assertEquals(2, $record->sortorder);

        // Insert category with specified sortorder.

        $generator->create_custom_profile_field_category(['name' => 'Toads', 'sortorder' => 9]);

        $record = $DB->get_record('user_info_category', ['name' => 'Toads']);

        $this->assertEquals(9, $record->sortorder);

        // Insert another with unspecified sortorder.

        $generator->create_custom_profile_field_category(['name' => 'Werewolves']);

        $record = $DB->get_record('user_info_category', ['name' => 'Werewolves']);

        $this->assertEquals(10, $record->sortorder);

    }

    public function test_create_custom_profile_field(): void {

        global $DB;

        $this->resetAfterTest();

        $generator = $this->getDataGenerator();

        // Insert minimal field without specified category.

        $field1 = $generator->create_custom_profile_field(

                ['datatype' => 'text', 'shortname' => 'colour', 'name' => 'Colour']);

        $record = $DB->get_record('user_info_field', ['shortname' => 'colour']);

        // Check specified values.

        $this->assertEquals('Colour', $record->name);

        $this->assertEquals('text', $record->datatype);

        // Check sortorder (first in category).

        $this->assertEquals(1, $record->sortorder);

        // Check shared defaults for most datatypes.

        $this->assertEquals('', $record->description);

        $this->assertEquals(0, $record->descriptionformat);

        $this->assertEquals(0, $record->required);

        $this->assertEquals(0, $record->locked);

        $this->assertEquals(PROFILE_VISIBLE_ALL, $record->visible);

        $this->assertEquals(0, $record->forceunique);

        $this->assertEquals(0, $record->signup);

        $this->assertEquals('', $record->defaultdata);

        $this->assertEquals(0, $record->defaultdataformat);

        // Check specific defaults for text datatype.

        $this->assertEquals(30, $record->param1);

        $this->assertEquals(2048, $record->param2);

        // Check the returned value matches the database data.

        $this->assertEquals($record, $field1);

        // The category should relate to a new 'testing' category.

        $catrecord = $DB->get_record('user_info_category', ['id' => $record->categoryid]);

        $this->assertEquals('Testing', $catrecord->name);

        $this->assertEquals(1, $catrecord->sortorder);

        // Create another field, this time supplying values for a few of the fields.

        $generator->create_custom_profile_field(

                ['datatype' => 'text', 'shortname' => 'brightness', 'name' => 'Brightness',

                'required' => 1, 'forceunique' => 1]);

        $record = $DB->get_record('user_info_field', ['shortname' => 'brightness']);

        // Same testing category, next sortorder.

        $this->assertEquals($catrecord->id, $record->categoryid);

        $this->assertEquals(2, $record->sortorder);

        // Check modified fields.

        $this->assertEquals(1, $record->required);

        $this->assertEquals(1, $record->forceunique);

        // Create a field in specified category by id or name...

        $category = $generator->create_custom_profile_field_category(['name' => 'Amphibians']);

        $field3 = $generator->create_custom_profile_field(

                ['datatype' => 'text', 'shortname' => 'frog', 'name' => 'Frog',

                'categoryid' => $category->id]);

        $this->assertEquals($category->id, $field3->categoryid);

        $this->assertEquals(1, $field3->sortorder);

        $field4 = $generator->create_custom_profile_field(

                ['datatype' => 'text', 'shortname' => 'toad', 'name' => 'Toad',

                'category' => 'Amphibians', 'sortorder' => 4]);

        $this->assertEquals($category->id, $field4->categoryid);

        $this->assertEquals(4, $field4->sortorder);

        // Check defaults for menu, datetime, and checkbox.

        $field5 = $generator->create_custom_profile_field(

                ['datatype' => 'menu', 'shortname' => 'cuisine', 'name' => 'Cuisine']);

        $this->assertEquals("Yes\nNo", $field5->param1);

        $this->assertEquals('No', $field5->defaultdata);

        $field6 = $generator->create_custom_profile_field(

                ['datatype' => 'datetime', 'shortname' => 'epoch', 'name' => 'Epoch']);

        $this->assertEquals(2010, $field6->param1);

        $this->assertEquals(2015, $field6->param2);

        $this->assertEquals(1, $field6->param3);

        $field7 = $generator->create_custom_profile_field(

                ['datatype' => 'checkbox', 'shortname' => 'areyousure', 'name' => 'Are you sure?']);

        $this->assertEquals(0, $field7->defaultdata);

        // Check setting options for menu using \n work as expected.

        $field8 = $generator->create_custom_profile_field([

            'datatype' => 'menu', 'shortname' => 'cuisine', 'name' => 'Cuisine', 'param1' => 'French\nChinese\nLebanese',

            'defaultdata' => 'Chinese'

        ]);

        $this->assertEquals("French\nChinese\nLebanese", $field8->param1);

    }

}