Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
behat	[ DIR ]	drwxr-sr-x	2017-06-22 15:51
fixtures	[ DIR ]	drwxr-sr-x	2017-06-22 15:52
other	[ DIR ]	drwxr-sr-x	2017-06-22 15:52
performance	[ DIR ]	drwxr-sr-x	2017-06-22 15:52
accesslib_test.php	155.23 KB	-rw-r--r--	2017-06-22 15:51
adhoc_task_test.php	3.6 KB	-rw-r--r--	2017-06-22 15:51
admintree_test.php	12.62 KB	-rw-r--r--	2017-06-22 15:51
ajaxlib_test.php	4.35 KB	-rw-r--r--	2017-06-22 15:51
antivirus_test.php	3.63 KB	-rw-r--r--	2017-06-22 15:51
authlib_test.php	11.49 KB	-rw-r--r--	2017-06-22 15:51
blocklib_test.php	24.65 KB	-rw-r--r--	2017-06-22 15:51
collator_test.php	11.98 KB	-rw-r--r--	2017-06-22 15:51
completionlib_test.php	37.83 KB	-rw-r--r--	2017-06-22 15:51
component_test.php	37.04 KB	-rw-r--r--	2017-06-22 15:51
componentlib_test.php	6.64 KB	-rw-r--r--	2017-06-22 15:51
configonlylib_test.php	6.15 KB	-rw-r--r--	2017-06-22 15:51
coursecatlib_test.php	39.89 KB	-rw-r--r--	2017-06-22 15:51
cronlib_test.php	6.44 KB	-rw-r--r--	2017-06-22 15:51
csslib_test.php	8.57 KB	-rw-r--r--	2017-06-22 15:51
csvclass_test.php	5.56 KB	-rw-r--r--	2017-06-22 15:51
curl_security_helper_test.php	12.96 KB	-rw-r--r--	2017-06-22 15:51
customcontext_test.php	3.66 KB	-rw-r--r--	2017-06-22 15:51
datalib_test.php	28.64 KB	-rw-r--r--	2017-06-22 15:51
datalib_update_with_unique_index_test.php	6.31 KB	-rw-r--r--	2017-06-22 15:51
date_legacy_test.php	13.9 KB	-rw-r--r--	2017-06-22 15:51
date_test.php	24.13 KB	-rw-r--r--	2017-06-22 15:51
editorlib_test.php	2.01 KB	-rw-r--r--	2017-06-22 15:51
environment_test.php	7.66 KB	-rw-r--r--	2017-06-22 15:51
event_course_module_instance_list_viewed.php	2.7 KB	-rw-r--r--	2017-06-22 15:51
event_course_module_viewed.php	3.31 KB	-rw-r--r--	2017-06-22 15:51
event_deprecated_test.php	1.49 KB	-rw-r--r--	2017-06-22 15:51
event_grade_deleted_test.php	3.25 KB	-rw-r--r--	2017-06-22 15:51
event_test.php	40.93 KB	-rw-r--r--	2017-06-22 15:51
event_unknown_logged_test.php	1.92 KB	-rw-r--r--	2017-06-22 15:51
event_user_graded_test.php	10.06 KB	-rw-r--r--	2017-06-22 15:51
event_user_password_updated_test.php	2.89 KB	-rw-r--r--	2017-06-22 15:51
events_test.php	15.29 KB	-rw-r--r--	2017-06-22 15:51
eventslib_test.php	11.8 KB	-rw-r--r--	2017-06-22 15:51
externallib_test.php	22.73 KB	-rw-r--r--	2017-06-22 15:51
filelib_test.php	50.67 KB	-rw-r--r--	2017-06-22 15:51
filetypes_test.php	9.99 KB	-rw-r--r--	2017-06-22 15:51
filter_manager_test.php	3.1 KB	-rw-r--r--	2017-06-22 15:51
filterlib_test.php	28.43 KB	-rw-r--r--	2017-06-22 15:51
formslib_test.php	39.82 KB	-rw-r--r--	2017-06-22 15:52
gdlib_test.php	5.91 KB	-rw-r--r--	2017-06-22 15:52
gradelib_test.php	2.05 KB	-rw-r--r--	2017-06-22 15:52
grades_externallib_test.php	20.79 KB	-rw-r--r--	2017-06-22 15:52
grading_externallib_test.php	26.27 KB	-rw-r--r--	2017-06-22 15:52
grouplib_test.php	62.33 KB	-rw-r--r--	2017-06-22 15:52
html2text_test.php	7.56 KB	-rw-r--r--	2017-06-22 15:52
html_writer_test.php	8.74 KB	-rw-r--r--	2017-06-22 15:52
htmlpurifier_test.php	21.25 KB	-rw-r--r--	2017-06-22 15:52
ip_utils_test.php	13.4 KB	-rw-r--r--	2017-06-22 15:52
jquery_test.php	1.77 KB	-rw-r--r--	2017-06-22 15:52
ldaplib_test.php	7.14 KB	-rw-r--r--	2017-06-22 15:52
lock_config_test.php	2.33 KB	-rw-r--r--	2017-06-22 15:52
lock_test.php	3.96 KB	-rw-r--r--	2017-06-22 15:52
markdown_test.php	2.2 KB	-rw-r--r--	2017-06-22 15:52
mathslib_test.php	8.14 KB	-rw-r--r--	2017-06-22 15:52
medialib_test.php	20.95 KB	-rw-r--r--	2017-06-22 15:52
message_test.php	10.32 KB	-rw-r--r--	2017-06-22 15:52
messageinbound_test.php	5.92 KB	-rw-r--r--	2017-06-22 15:52
messagelib_test.php	39.51 KB	-rw-r--r--	2017-06-22 15:52
minify_test.php	3.13 KB	-rw-r--r--	2017-06-22 15:52
modinfolib_test.php	44.04 KB	-rw-r--r--	2017-06-22 15:52
moodle_page_test.php	25.52 KB	-rw-r--r--	2017-06-22 15:52
moodlelib_test.php	153.62 KB	-rw-r--r--	2017-06-22 15:52
mustache_template_finder_test.php	3.35 KB	-rw-r--r--	2017-06-22 15:52
myprofilelib_test.php	10.7 KB	-rw-r--r--	2017-06-22 15:52
navigationlib_test.php	26.04 KB	-rw-r--r--	2017-06-22 15:52
notification_test.php	4.18 KB	-rw-r--r--	2017-06-22 15:52
outputcomponents_test.php	19.33 KB	-rw-r--r--	2017-06-22 15:52
outputfactories_test.php	6.8 KB	-rw-r--r--	2017-06-22 15:52
outputrequirementslib_test.php	4.05 KB	-rw-r--r--	2017-06-22 15:52
plugin_manager_test.php	22.2 KB	-rw-r--r--	2017-06-22 15:52
portfoliolib_test.php	8.41 KB	-rw-r--r--	2017-06-22 15:52
progress_display_test.php	3.68 KB	-rw-r--r--	2017-06-22 15:52
progress_test.php	14.5 KB	-rw-r--r--	2017-06-22 15:52
questionlib_test.php	19.87 KB	-rw-r--r--	2017-06-22 15:52
regex_test.php	1.88 KB	-rw-r--r--	2017-06-22 15:52
requirejs_test.php	3.7 KB	-rw-r--r--	2017-06-22 15:52
rsslib_test.php	6.7 KB	-rw-r--r--	2017-06-22 15:52
scheduled_task_test.php	19.09 KB	-rw-r--r--	2017-06-22 15:52
scss_test.php	2.53 KB	-rw-r--r--	2017-06-22 15:52
session_manager_test.php	25.54 KB	-rw-r--r--	2017-06-22 15:52
session_redis_test.php	10.77 KB	-rw-r--r--	2017-06-22 15:52
sessionlib_test.php	12.57 KB	-rw-r--r--	2017-06-22 15:52
setuplib_test.php	18.57 KB	-rw-r--r--	2017-06-22 15:52
statslib_test.php	24.88 KB	-rw-r--r--	2017-06-22 15:52
string_manager_standard_test.php	6.91 KB	-rw-r--r--	2017-06-22 15:52
tablelib_test.php	18.07 KB	-rw-r--r--	2017-06-22 15:52
text_test.php	20.06 KB	-rw-r--r--	2017-06-22 15:52
theme_config_test.php	7.45 KB	-rw-r--r--	2017-06-22 15:52
unoconv_test.php	4 KB	-rw-r--r--	2017-06-22 15:52
update_api_test.php	6.75 KB	-rw-r--r--	2017-06-22 15:52
update_checker_test.php	10.92 KB	-rw-r--r--	2017-06-22 15:52
update_code_manager_test.php	9.11 KB	-rw-r--r--	2017-06-22 15:52
update_validator_test.php	18.47 KB	-rw-r--r--	2017-06-22 15:52
upgrade_util_test.php	5.65 KB	-rw-r--r--	2017-06-22 15:52
upgradelib_test.php	43.23 KB	-rw-r--r--	2017-06-22 15:52
user_menu_test.php	3.73 KB	-rw-r--r--	2017-06-22 15:52
user_test.php	17.23 KB	-rw-r--r--	2017-06-22 15:52
useragent_test.php	79.88 KB	-rw-r--r--	2017-06-22 15:52
weblib_format_text_test.php	8.43 KB	-rw-r--r--	2017-06-22 15:52
weblib_test.php	27.29 KB	-rw-r--r--	2017-06-22 15:52
xhtml_container_stack_test.php	4.16 KB	-rw-r--r--	2017-06-22 15:52

Rename

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

/**
 * Unit tests for /lib/externallib.php.
 *
 * @package    core
 * @subpackage phpunit
 * @copyright  2009 Petr Skoda {@link http://skodak.org}
 * @license    http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 */

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

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

class core_externallib_testcase extends advanced_testcase {
    protected $DB;

public function setUp() {
        $this->DB = null;
    }

public function tearDown() {
        global $DB;
        if ($this->DB !== null) {
            $DB = $this->DB;
        }
    }

public function test_validate_params() {
        $params = array('text'=>'aaa', 'someid'=>'6');
        $description = new external_function_parameters(array('someid' => new external_value(PARAM_INT, 'Some int value'),
            'text'   => new external_value(PARAM_ALPHA, 'Some text value')));
        $result = external_api::validate_parameters($description, $params);
        $this->assertCount(2, $result);
        reset($result);
        $this->assertSame('someid', key($result));
        $this->assertSame(6, $result['someid']);
        $this->assertSame('aaa', $result['text']);

$params = array('someids'=>array('1', 2, 'a'=>'3'), 'scalar'=>666);
        $description = new external_function_parameters(array('someids' => new external_multiple_structure(new external_value(PARAM_INT, 'Some ID')),
            'scalar'  => new external_value(PARAM_ALPHANUM, 'Some text value')));
        $result = external_api::validate_parameters($description, $params);
        $this->assertCount(2, $result);
        reset($result);
        $this->assertSame('someids', key($result));
        $this->assertEquals(array(0=>1, 1=>2, 2=>3), $result['someids']);
        $this->assertSame('666', $result['scalar']);

$params = array('text'=>'aaa');
        $description = new external_function_parameters(array('someid' => new external_value(PARAM_INT, 'Some int value', false),
            'text'   => new external_value(PARAM_ALPHA, 'Some text value')));
        $result = external_api::validate_parameters($description, $params);
        $this->assertCount(2, $result);
        reset($result);
        $this->assertSame('someid', key($result));
        $this->assertNull($result['someid']);
        $this->assertSame('aaa', $result['text']);

$params = array('text'=>'aaa');
        $description = new external_function_parameters(array('someid' => new external_value(PARAM_INT, 'Some int value', false, 6),
            'text'   => new external_value(PARAM_ALPHA, 'Some text value')));
        $result = external_api::validate_parameters($description, $params);
        $this->assertCount(2, $result);
        reset($result);
        $this->assertSame('someid', key($result));
        $this->assertSame(6, $result['someid']);
        $this->assertSame('aaa', $result['text']);
    }

public function test_external_format_text() {
        $settings = external_settings::get_instance();

$currentraw = $settings->get_raw();
        $currentfilter = $settings->get_filter();

$settings->set_raw(true);
        $settings->set_filter(false);
        $context = context_system::instance();

$test = '$$ \pi $$';
        $testformat = FORMAT_MARKDOWN;
        $correct = array($test, $testformat);
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0), $correct);

$settings->set_raw(false);
        $settings->set_filter(true);

$test = '$$ \pi $$';
        $testformat = FORMAT_MARKDOWN;
        $correct = array('<span class="filter_mathjaxloader_equation"><p><span class="nolink">$$ \pi $$</span></p>
</span>', FORMAT_HTML);
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0), $correct);

// Filters can be opted out from by the developer.
        $test = '$$ \pi $$';
        $testformat = FORMAT_MARKDOWN;
        $correct = array('<p>$$ \pi $$</p>
', FORMAT_HTML);
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, ['filter' => false]), $correct);

$test = '<p><a id="test"></a><a href="#test">Text</a></p>';
        $testformat = FORMAT_HTML;
        $correct = array($test, FORMAT_HTML);
        $options = array('allowid' => true);
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, $options), $correct);

$test = '<p><a id="test"></a><a href="#test">Text</a></p>';
        $testformat = FORMAT_HTML;
        $correct = array('<p><a></a><a href="#test">Text</a></p>', FORMAT_HTML);
        $options = new StdClass();
        $options->allowid = false;
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, $options), $correct);

$test = '<p><a id="test"></a><a href="#test">Text</a></p>'."\n".'Newline';
        $testformat = FORMAT_MOODLE;
        $correct = array('<p><a id="test"></a><a href="#test">Text</a></p> Newline', FORMAT_HTML);
        $options = new StdClass();
        $options->newlines = false;
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, $options), $correct);

$test = '<p><a id="test"></a><a href="#test">Text</a></p>';
        $testformat = FORMAT_MOODLE;
        $correct = array('<div class="text_to_html">'.$test.'</div>', FORMAT_HTML);
        $options = new StdClass();
        $options->para = true;
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, $options), $correct);

$test = '<p><a id="test"></a><a href="#test">Text</a></p>';
        $testformat = FORMAT_MOODLE;
        $correct = array($test, FORMAT_HTML);
        $options = new StdClass();
        $options->context = $context;
        $this->assertSame(external_format_text($test, $testformat, $context->id, 'core', '', 0, $options), $correct);

$settings->set_raw($currentraw);
        $settings->set_filter($currentfilter);
    }

public function test_external_format_string() {
        $this->resetAfterTest();
        $settings = external_settings::get_instance();
        $currentraw = $settings->get_raw();
        $currentfilter = $settings->get_filter();

// Enable multilang filter to on content and heading.
        filter_set_global_state('multilang', TEXTFILTER_ON);
        filter_set_applies_to_strings('multilang', 1);
        $filtermanager = filter_manager::instance();
        $filtermanager->reset_caches();

$settings->set_raw(true);
        $settings->set_filter(true);
        $context = context_system::instance();

$test = '<span lang="en" class="multilang">EN</span><span lang="fr" class="multilang">FR</span> ' .
            '<script>hi</script> <h3>there</h3>!';
        $correct = $test;
        $this->assertSame($correct, external_format_string($test, $context->id));

$settings->set_raw(false);
        $settings->set_filter(false);

$test = '<span lang="en" class="multilang">EN</span><span lang="fr" class="multilang">FR</span> ' .
            '<script>hi</script> <h3>there</h3>?';
        $correct = 'ENFR hi there?';
        $this->assertSame($correct, external_format_string($test, $context->id));

$settings->set_filter(true);

$test = '<span lang="en" class="multilang">EN</span><span lang="fr" class="multilang">FR</span> ' .
            '<script>hi</script> <h3>there</h3>@';
        $correct = 'EN hi there@';
        $this->assertSame($correct, external_format_string($test, $context->id));

// Filters can be opted out.
        $test = '<span lang="en" class="multilang">EN</span><span lang="fr" class="multilang">FR</span> ' .
            '<script>hi</script> <h3>there</h3>%';
        $correct = 'ENFR hi there%';
        $this->assertSame($correct, external_format_string($test, $context->id, false, ['filter' => false]));

$this->assertSame("& < > \" '", format_string("& < > \" '", true, ['escape' => false]));

$settings->set_raw($currentraw);
        $settings->set_filter($currentfilter);
    }

/**
     * Test for clean_returnvalue().
     */
    public function test_clean_returnvalue() {

// Build some return value decription.
        $returndesc = new external_multiple_structure(
            new external_single_structure(
                array(
                    'object' => new external_single_structure(
                                array('value1' => new external_value(PARAM_INT, 'this is a int'))),
                    'value2' => new external_value(PARAM_TEXT, 'some text', VALUE_OPTIONAL))
            ));

// Clean an object (it should be cast into an array).
        $object = new stdClass();
        $object->value1 = 1;
        $singlestructure['object'] = $object;
        $singlestructure['value2'] = 'Some text';
        $testdata = array($singlestructure);
        $cleanedvalue = external_api::clean_returnvalue($returndesc, $testdata);
        $cleanedsinglestructure = array_pop($cleanedvalue);
        $this->assertSame($object->value1, $cleanedsinglestructure['object']['value1']);
        $this->assertSame($singlestructure['value2'], $cleanedsinglestructure['value2']);

// Missing VALUE_OPTIONAL.
        $object = new stdClass();
        $object->value1 = 1;
        $singlestructure = new stdClass();
        $singlestructure->object = $object;
        $testdata = array($singlestructure);
        $cleanedvalue = external_api::clean_returnvalue($returndesc, $testdata);
        $cleanedsinglestructure = array_pop($cleanedvalue);
        $this->assertSame($object->value1, $cleanedsinglestructure['object']['value1']);
        $this->assertArrayNotHasKey('value2', $cleanedsinglestructure);

// Unknown attribute (the value should be ignored).
        $object = array();
        $object['value1'] = 1;
        $singlestructure = array();
        $singlestructure['object'] = $object;
        $singlestructure['value2'] = 'Some text';
        $singlestructure['unknownvalue'] = 'Some text to ignore';
        $testdata = array($singlestructure);
        $cleanedvalue = external_api::clean_returnvalue($returndesc, $testdata);
        $cleanedsinglestructure = array_pop($cleanedvalue);
        $this->assertSame($object['value1'], $cleanedsinglestructure['object']['value1']);
        $this->assertSame($singlestructure['value2'], $cleanedsinglestructure['value2']);
        $this->assertArrayNotHasKey('unknownvalue', $cleanedsinglestructure);

// Missing required value (an exception is thrown).
        $object = array();
        $singlestructure = array();
        $singlestructure['object'] = $object;
        $singlestructure['value2'] = 'Some text';
        $testdata = array($singlestructure);
        $this->expectException('invalid_response_exception');
        $cleanedvalue = external_api::clean_returnvalue($returndesc, $testdata);
    }
    /*
     * Test external_api::get_context_from_params().
     */
    public function test_get_context_from_params() {
        $this->resetAfterTest(true);
        $course = $this->getDataGenerator()->create_course();
        $realcontext = context_course::instance($course->id);

// Use context id.
        $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextid" => $realcontext->id));
        $this->assertEquals($realcontext, $fetchedcontext);

// Use context level and instance id.
        $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextlevel" => "course", "instanceid" => $course->id));
        $this->assertEquals($realcontext, $fetchedcontext);

// Passing empty values.
        try {
            $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextid" => 0));
            $this->fail('Exception expected from get_context_wrapper()');
        } catch (moodle_exception $e) {
            $this->assertInstanceOf('invalid_parameter_exception', $e);
        }

try {
            $fetchedcontext = test_exernal_api::get_context_wrapper(array("instanceid" => 0));
            $this->fail('Exception expected from get_context_wrapper()');
        } catch (moodle_exception $e) {
            $this->assertInstanceOf('invalid_parameter_exception', $e);
        }

try {
            $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextid" => null));
            $this->fail('Exception expected from get_context_wrapper()');
        } catch (moodle_exception $e) {
            $this->assertInstanceOf('invalid_parameter_exception', $e);
        }

// Tests for context with instanceid equal to 0 (System context).
        $realcontext = context_system::instance();
        $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextlevel" => "system", "instanceid" => 0));
        $this->assertEquals($realcontext, $fetchedcontext);

// Passing wrong level.
        $this->expectException('invalid_parameter_exception');
        $fetchedcontext = test_exernal_api::get_context_wrapper(array("contextlevel" => "random", "instanceid" => $course->id));
    }

/*
     * Test external_api::get_context()_from_params parameter validation.
     */
    public function test_get_context_params() {
        global $USER;

// Call without correct context details.
        $this->expectException('invalid_parameter_exception');
        test_exernal_api::get_context_wrapper(array('roleid' => 3, 'userid' => $USER->id));
    }

/*
     * Test external_api::get_context()_from_params parameter validation.
     */
    public function test_get_context_params2() {
        global $USER;

/*
     * Test external_api::get_context()_from_params parameter validation.
     */
    public function test_get_context_params3() {
        global $USER;

// Call without correct context details.
        $this->resetAfterTest(true);
        $course = self::getDataGenerator()->create_course();
        $this->expectException('invalid_parameter_exception');
        test_exernal_api::get_context_wrapper(array('roleid' => 3, 'userid' => $USER->id, 'instanceid' => $course->id));
    }

public function all_external_info_provider() {
        global $DB;

// We are testing here that all the external function descriptions can be generated without
        // producing warnings. E.g. misusing optional params will generate a debugging message which
        // will fail this test.
        $functions = $DB->get_records('external_functions', array(), 'name');
        $return = array();
        foreach ($functions as $f) {
            $return[$f->name] = array($f);
        }
        return $return;
    }

/**
     * @dataProvider all_external_info_provider
     */
    public function test_all_external_info($f) {
        $desc = external_api::external_function_info($f);
        $this->assertNotEmpty($desc->name);
        $this->assertNotEmpty($desc->classname);
        $this->assertNotEmpty($desc->methodname);
        $this->assertEquals($desc->component, clean_param($desc->component, PARAM_COMPONENT));
        $this->assertInstanceOf('external_function_parameters', $desc->parameters_desc);
        if ($desc->returns_desc != null) {
            $this->assertInstanceOf('external_description', $desc->returns_desc);
        }
    }

public function test_validate_courses() {
        $this->resetAfterTest(true);

$c1 = $this->getDataGenerator()->create_course();
        $c2 = $this->getDataGenerator()->create_course();
        $c3 = $this->getDataGenerator()->create_course();
        $u1 = $this->getDataGenerator()->create_user();
        $this->getDataGenerator()->enrol_user($u1->id, $c1->id);
        $courseids = array($c1->id, $c2->id, $c3->id);

$this->setAdminUser();
        list($courses, $warnings) = external_util::validate_courses($courseids);
        $this->assertEmpty($warnings);
        $this->assertCount(3, $courses);
        $this->assertArrayHasKey($c1->id, $courses);
        $this->assertArrayHasKey($c2->id, $courses);
        $this->assertArrayHasKey($c3->id, $courses);
        $this->assertEquals($c1->id, $courses[$c1->id]->id);
        $this->assertEquals($c2->id, $courses[$c2->id]->id);
        $this->assertEquals($c3->id, $courses[$c3->id]->id);

$this->setUser($u1);
        list($courses, $warnings) = external_util::validate_courses($courseids);
        $this->assertCount(2, $warnings);
        $this->assertEquals($c2->id, $warnings[0]['itemid']);
        $this->assertEquals($c3->id, $warnings[1]['itemid']);
        $this->assertCount(1, $courses);
        $this->assertArrayHasKey($c1->id, $courses);
        $this->assertArrayNotHasKey($c2->id, $courses);
        $this->assertArrayNotHasKey($c3->id, $courses);
        $this->assertEquals($c1->id, $courses[$c1->id]->id);
    }

/**
     * Validate courses can re-use an array of prefetched courses.
     */
    public function test_validate_courses_prefetch() {
        $this->resetAfterTest(true);

$c1 = $this->getDataGenerator()->create_course();
        $c2 = $this->getDataGenerator()->create_course();
        $c3 = $this->getDataGenerator()->create_course();
        $c4 = $this->getDataGenerator()->create_course();
        $u1 = $this->getDataGenerator()->create_user();
        $this->getDataGenerator()->enrol_user($u1->id, $c1->id);
        $this->getDataGenerator()->enrol_user($u1->id, $c2->id);

$courseids = array($c1->id, $c2->id, $c3->id);
        $courses = array($c2->id => $c2, $c3->id => $c3, $c4->id => $c4);

$this->setUser($u1);
        list($courses, $warnings) = external_util::validate_courses($courseids, $courses);
        $this->assertCount(2, $courses);
        $this->assertCount(1, $warnings);
        $this->assertArrayHasKey($c1->id, $courses);
        $this->assertSame($c2, $courses[$c2->id]);
        $this->assertArrayNotHasKey($c3->id, $courses);
        // The extra course passed is not returned.
        $this->assertArrayNotHasKey($c4->id, $courses);
    }

public function test_call_external_function() {
        global $PAGE, $COURSE;

$this->resetAfterTest(true);

// Call some webservice functions and verify they are correctly handling $PAGE and $COURSE.
        // First test a function that calls validate_context outside a course.
        $this->setAdminUser();
        $category = $this->getDataGenerator()->create_category();
        $params = array(
            'contextid' => context_coursecat::instance($category->id)->id,
            'name' => 'aaagrrryyy',
            'idnumber' => '',
            'description' => ''
        );
        $cohort1 = $this->getDataGenerator()->create_cohort($params);
        $cohort2 = $this->getDataGenerator()->create_cohort();

$beforepage = $PAGE;
        $beforecourse = $COURSE;
        $params = array('cohortids' => array($cohort1->id, $cohort2->id));
        $result = external_api::call_external_function('core_cohort_get_cohorts', $params);

$this->assertSame($beforepage, $PAGE);
        $this->assertSame($beforecourse, $COURSE);

// Now test a function that calls validate_context inside a course.
        $course = $this->getDataGenerator()->create_course();

$beforepage = $PAGE;
        $beforecourse = $COURSE;
        $params = array('courseid' => $course->id, 'options' => array());
        $result = external_api::call_external_function('core_enrol_get_enrolled_users', $params);

$this->assertSame($beforepage, $PAGE);
        $this->assertSame($beforecourse, $COURSE);
    }

/**
     * Text external_util::get_area_files
     */
    public function test_external_util_get_area_files() {
        global $CFG, $DB;

$this->DB = $DB;
        $DB = $this->getMockBuilder('moodle_database')->getMock();

$content = base64_encode("Let us create a nice simple file.");
        $timemodified = 102030405;
        $itemid = 42;
        $filesize = strlen($content);

$DB->method('get_records_sql')->willReturn([
            (object) [
                'filename'      => 'example.txt',
                'filepath'      => '/',
                'mimetype'      => 'text/plain',
                'filesize'      => $filesize,
                'timemodified'  => $timemodified,
                'itemid'        => $itemid,
                'pathnamehash'  => sha1('/example.txt'),
            ],
        ]);

$component = 'mod_foo';
        $filearea = 'area';
        $context = 12345;

$expectedfiles[] = array(
            'filename' => 'example.txt',
            'filepath' => '/',
            'fileurl' => "{$CFG->wwwroot}/webservice/pluginfile.php/{$context}/{$component}/{$filearea}/{$itemid}/example.txt",
            'timemodified' => $timemodified,
            'filesize' => $filesize,
            'mimetype' => 'text/plain',
        );
        // Get all the files for the area.
        $files = external_util::get_area_files($context, $component, $filearea, false);
        $this->assertEquals($expectedfiles, $files);

// Get just the file indicated by $itemid.
        $files = external_util::get_area_files($context, $component, $filearea, $itemid);
        $this->assertEquals($expectedfiles, $files);

}

/**
     * Text external files structure.
     */
    public function test_external_files() {

$description = new external_files();

// First check that the expected default values and keys are returned.
        $expectedkeys = array_flip(array('filename', 'filepath', 'filesize', 'fileurl', 'timemodified', 'mimetype'));
        $returnedkeys = array_flip(array_keys($description->content->keys));
        $this->assertEquals($expectedkeys, $returnedkeys);
        $this->assertEquals('List of files.', $description->desc);
        $this->assertEquals(VALUE_REQUIRED, $description->required);
        foreach ($description->content->keys as $key) {
            $this->assertEquals(VALUE_OPTIONAL, $key->required);
        }

}

/*
 * Just a wrapper to access protected apis for testing
 */
class test_exernal_api extends external_api {

public static function get_context_wrapper($params) {
        return self::get_context_from_params($params);
    }
}