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

/**
 * Privacy provider tests.
 *
 * @package   mod_bigbluebuttonbn
 * @copyright 2018 - present, Blindside Networks Inc
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @author    Jesus Federico  (jesus [at] blindsidenetworks [dt] com)
 */
namespace mod_bigbluebuttonbn\privacy;

use context_module;
use core_privacy\local\metadata\collection;
use core_privacy\local\request\approved_contextlist;
use core_privacy\local\request\approved_userlist;
use core_privacy\local\request\userlist;

/**
 * Privacy provider tests class.
 *
 * @package   mod_bigbluebuttonbn
 * @copyright 2018 - present, Blindside Networks Inc
 * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
 * @author    Jesus Federico  (jesus [at] blindsidenetworks [dt] com)
 * @covers \mod_bigbluebuttonbn\privacy\provider
 */
class provider_test extends \core_privacy\tests\provider_testcase {

    /**
     * Test for provider::get_metadata().
     */
    public function test_get_metadata(): void {
        $this->resetAfterTest(true);

        $collection = new collection('mod_bigbluebuttonbn');
        $newcollection = provider::get_metadata($collection);
        $itemcollection = $newcollection->get_collection();
        $this->assertCount(4, $itemcollection);

        $instancetable = array_shift($itemcollection);
        $this->assertEquals('bigbluebuttonbn', $instancetable->get_name());

        $instancelogstable = array_shift($itemcollection);
        $this->assertEquals('bigbluebuttonbn_logs', $instancelogstable->get_name());

        $recordings = array_shift($itemcollection);
        $this->assertEquals('bigbluebuttonbn_recordings', $recordings->get_name());

        $bigbluebuttonserver = array_shift($itemcollection);
        $this->assertEquals('bigbluebutton', $bigbluebuttonserver->get_name());

        $privacyfields = $instancetable->get_privacy_fields();
        $this->assertArrayHasKey('participants', $privacyfields);
        $this->assertEquals('privacy:metadata:bigbluebuttonbn', $instancetable->get_summary());

        $privacyfields = $instancelogstable->get_privacy_fields();
        $this->assertArrayHasKey('userid', $privacyfields);
        $this->assertArrayHasKey('timecreated', $privacyfields);
        $this->assertArrayHasKey('meetingid', $privacyfields);
        $this->assertArrayHasKey('log', $privacyfields);
        $this->assertArrayHasKey('meta', $privacyfields);
        $this->assertEquals('privacy:metadata:bigbluebuttonbn_logs', $instancelogstable->get_summary());

        $privacyfields = $bigbluebuttonserver->get_privacy_fields();
        $this->assertArrayHasKey('userid', $privacyfields);
        $this->assertArrayHasKey('fullname', $privacyfields);
        $this->assertEquals('privacy:metadata:bigbluebutton', $bigbluebuttonserver->get_summary());
    }

    /**
     * Test for provider::get_contexts_for_userid().
     */
    public function test_get_contexts_for_userid(): void {
        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();
        $bigbluebuttonbn = $e['instance'];
        $course = $e['course'];

        // Another bigbluebuttonbn activity that has no user activity.
        $this->getDataGenerator()->create_module('bigbluebuttonbn', ['course' => $course]);

        // Create a user which will make a submission.
        $user = $this->getDataGenerator()->create_user();

        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user->id]);

        // Check the contexts supplied are correct.
        $contextlist = provider::get_contexts_for_userid($user->id);
        $this->assertCount(1, $contextlist);

        $contextformodule = $contextlist->current();
        $cmcontext = context_module::instance($bigbluebuttonbn->cmid);
        $this->assertEquals($cmcontext->id, $contextformodule->id);
    }

    /**
     * Test for provider::export_user_data().
     */
    public function test_export_for_context_logs(): void {
        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();
        $bigbluebuttonbn = $e['instance'];

        // Create users which will make submissions.
        $user1 = $this->getDataGenerator()->create_user();
        $user2 = $this->getDataGenerator()->create_user();

        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user1->id]);
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user1->id]);
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user2->id]);

        // Export all of the data for the context for user 1.
        $cmcontext = context_module::instance($bigbluebuttonbn->cmid);
        $this->export_context_data_for_user($user1->id, $cmcontext, 'mod_bigbluebuttonbn');
        $writer = \core_privacy\local\request\writer::with_context($cmcontext);

        $this->assertTrue($writer->has_any_data());

        $data = $writer->get_data();
        $this->assertCount(2, $data->logs);
    }

    /**
     * Test that only users with relevant contexts are fetched.
     */
    public function test_get_users_in_context(): void {
        // For backward compatibility with old versions of Moodle.
        if (!class_exists('\core_privacy\local\request\userlist')) {
            return;
        }

        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();
        $bigbluebuttonbn = $e['instance'];

        // Users which will make submissions.
        $user1 = $e['users'][0];
        $user2 = $e['users'][1];

        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user1->id]);
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user1->id]);
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $bigbluebuttonbn->id, 'userid' => $user2->id]);

        // Export all of the data for the context for user 1.
        $cmcontext = context_module::instance($bigbluebuttonbn->cmid);

        $userlist = new userlist($cmcontext, 'mod_bigbluebuttonbn');
        provider::get_users_in_context($userlist);

        // Ensure correct users are found in relevant contexts.
        $this->assertCount(2, $userlist);
        $expected = [intval($user1->id), intval($user2->id)];
        $actual = $userlist->get_userids();
        $this->assertEquals(sort($expected), sort($actual));
    }

    /**
     * Test for provider::delete_data_for_all_users_in_context().
     */
    public function test_delete_data_for_all_users_in_context(): void {
        global $DB;

        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();

        // Before deletion, we should have 3 responses, 1 Add event and 2 Create events (1 per user).
        $count = $DB->count_records('bigbluebuttonbn_logs', ['bigbluebuttonbnid' => $e['instance']->id]);
        $this->assertEquals(3, $count);

        // Delete data based on context.
        $cmcontext = context_module::instance($e['instance']->cmid);
        provider::delete_data_for_all_users_in_context($cmcontext);

        // After deletion, the bigbluebuttonbn logs for that activity should have been deleted.
        $count = $DB->count_records('bigbluebuttonbn_logs', ['bigbluebuttonbnid' => $e['instance']->id]);
        $this->assertEquals(0, $count);
    }

    /**
     * Test for provider::delete_data_for_user().
     */
    public function test_delete_data_for_user(): void {
        global $DB;

        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();

        // Delete data for the first user.
        $context = \context_module::instance($e['instance']->cmid);
        $contextlist = new approved_contextlist($e['users'][0], 'bigbluebuttonbn',
            [$context->id]);
        provider::delete_data_for_user($contextlist);

        // After deletion the bigbluebuttonbn logs for the first user should have been deleted.
        $count = $DB->count_records('bigbluebuttonbn_logs',
            ['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][0]->id]);
        $this->assertEquals(0, $count);

        // Check the logs for the other user is still there.
        $count = $DB->count_records('bigbluebuttonbn_logs',
            ['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][1]->id]);
        $this->assertEquals(1, $count);
    }

    /**
     * Test that data for users in approved userlist is deleted.
     */
    public function test_delete_data_for_users(): void {
        global $DB;

        // For backward compatibility with old versions of Moodle.
        if (!class_exists('\core_privacy\local\request\approved_userlist')) {
            return;
        }

        $this->resetAfterTest();

        $e = $this->get_bigbluebuttonbn_environemnt();

        // Delete user 1 and 2 data from chat 1 context only.
        $context = \context_module::instance($e['instance']->cmid);
        $approveduserids = [$e['users'][0]->id];
        $approvedlist = new approved_userlist($context, 'mod_bigbluebuttonbn', $approveduserids);
        provider::delete_data_for_users($approvedlist);

        // After deletion the bigbluebuttonbn logs for the first user should have been deleted.
        $count = $DB->count_records('bigbluebuttonbn_logs',
            ['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][0]->id]);
        $this->assertEquals(0, $count);

        // Check the logs for the other user is still there.
        $count = $DB->count_records('bigbluebuttonbn_logs',
            ['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][1]->id]);
        $this->assertEquals(1, $count);
    }

    /**
     * Prepares the environment for testing.
     *
     * @return array $e
     */
    protected function get_bigbluebuttonbn_environemnt() {
        $e = [];

        // Create a course.
        $e['course'] = $this->getDataGenerator()->create_course();

        // Create a bigbluebuttonbn instance.
        $e['instance'] = $this->getDataGenerator()->create_module('bigbluebuttonbn',
            ['course' => $e['course']->id]);

        // Create users that will use the bigbluebuttonbn instance.
        $e['users'][] = $this->getDataGenerator()->create_user();
        $e['users'][] = $this->getDataGenerator()->create_user();

        // Create the bigbluebuttonbn logs.
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][0]->id]);
        $this->getDataGenerator()->get_plugin_generator('mod_bigbluebuttonbn')
            ->create_log(['bigbluebuttonbnid' => $e['instance']->id, 'userid' => $e['users'][1]->id]);

        return $e;
    }
}