moodle/lib/tests/privacy/provider_test.php
2023-08-29 11:26:23 +10:00

258 lines
9.9 KiB
PHP

<?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\privacy;
use core_privacy\local\request\approved_contextlist;
use core_privacy\local\request\writer;
use core_privacy\tests\provider_testcase;
use core_privacy\local\request\approved_userlist;
use core\moodlenet\share_recorder;
/**
* Privacy provider tests class.
*
* @package core
* @category test
* @copyright 2023 David Woloszyn <david.woloszyn@moodle.com>
* @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
*/
class provider_test extends provider_testcase {
/**
* Check that a user context is returned if there is any user data for this user.
*
* @covers ::get_contexts_for_userid
*/
public function test_get_contexts_for_userid() {
$this->resetAfterTest();
$user = $this->getDataGenerator()->create_user();
// Check that there are no contexts used for the user yet.
$this->assertEmpty(provider::get_contexts_for_userid($user->id));
// Insert a record.
$this->insert_dummy_moodlenet_share_progress_record($user->id);
// Check that we only get back one context.
$contextlist = provider::get_contexts_for_userid($user->id);
$this->assertCount(1, $contextlist);
// Check that the context returned is the expected one.
$usercontext = \context_user::instance($user->id);
$this->assertEquals($usercontext->id, $contextlist->get_contextids()[0]);
}
/**
* Test that only users within a user context are fetched.
*
* @covers ::get_users_in_context
*/
public function test_get_users_in_context() {
$this->resetAfterTest();
// Create some users.
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
$usercontext1 = \context_user::instance($user1->id);
$usercontext2 = \context_user::instance($user2->id);
// Get userlists and check they are empty for now.
$userlist1 = new \core_privacy\local\request\userlist($usercontext1, 'core');
provider::get_users_in_context($userlist1);
$this->assertCount(0, $userlist1);
$userlist2 = new \core_privacy\local\request\userlist($usercontext2, 'core');
provider::get_users_in_context($userlist2);
$this->assertCount(0, $userlist2);
// Insert records for both users.
$this->insert_dummy_moodlenet_share_progress_record($user1->id);
$this->insert_dummy_moodlenet_share_progress_record($user2->id);
// Check the userlists contain the correct users.
$userlist1 = new \core_privacy\local\request\userlist($usercontext1, 'core');
provider::get_users_in_context($userlist1);
$this->assertCount(1, $userlist1);
$this->assertEquals($user1->id, $userlist1->get_userids()[0]);
$userlist2 = new \core_privacy\local\request\userlist($usercontext2, 'core');
provider::get_users_in_context($userlist2);
$this->assertCount(1, $userlist2);
$this->assertEquals($user2->id, $userlist2->get_userids()[0]);
}
/**
* Test that user data is exported correctly.
*
* @covers ::export_user_data
*/
public function test_export_user_data() {
global $DB;
$this->resetAfterTest();
// Create some users.
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
// Insert a record for each user.
$this->insert_dummy_moodlenet_share_progress_record($user1->id);
$this->insert_dummy_moodlenet_share_progress_record($user2->id);
$subcontexts = [
get_string('privacy:metadata:moodlenet_share_progress', 'moodle')
];
// Check if user1 has any exported data yet.
$usercontext1 = \context_user::instance($user1->id);
$writer = writer::with_context($usercontext1);
$this->assertFalse($writer->has_any_data());
// Export user1's data and check the count.
$approvedlist = new approved_contextlist($user1, 'core', [$usercontext1->id]);
provider::export_user_data($approvedlist);
$data = (array)$writer->get_data($subcontexts);
$this->assertCount(1, $data);
// Get the inserted data.
$userdata = $DB->get_record('moodlenet_share_progress', ['userid' => $user1->id]);
// Check exported data against the inserted data.
$this->assertEquals($userdata->id, reset($data)->id);
$this->assertEquals($userdata->type, reset($data)->type);
$this->assertEquals($userdata->courseid, reset($data)->courseid);
$this->assertEquals($userdata->cmid, reset($data)->cmid);
$this->assertEquals($userdata->userid, reset($data)->userid);
$this->assertEquals($userdata->timecreated, reset($data)->timecreated);
$this->assertEquals($userdata->resourceurl, reset($data)->resourceurl);
$this->assertEquals($userdata->status, reset($data)->status);
}
/**
* Test deleting all user data for a specific context.
*
* @covers ::delete_data_for_all_users_in_context
*/
public function test_delete_data_for_all_users_in_context() {
global $DB;
$this->resetAfterTest();
// Create some users.
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
// Insert a record for each user.
$this->insert_dummy_moodlenet_share_progress_record($user1->id);
$this->insert_dummy_moodlenet_share_progress_record($user2->id);
// Get all users' data.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(2, $usersdata);
// Delete everything for a user1 in context.
$usercontext1 = \context_user::instance($user1->id);
provider::delete_data_for_all_users_in_context($usercontext1);
// Check what is remaining belongs to user2.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(1, $usersdata);
$this->assertEquals($user2->id, reset($usersdata)->userid);
}
/**
* Test deleting a user's data for a specific context.
*
* @covers ::delete_data_for_user
*/
public function test_delete_data_for_user() {
global $DB;
$this->resetAfterTest();
// Create some users.
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
// Insert a record for each user.
$this->insert_dummy_moodlenet_share_progress_record($user1->id);
$this->insert_dummy_moodlenet_share_progress_record($user2->id);
// Get all users' data.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(2, $usersdata);
// Delete everything for user1.
$usercontext1 = \context_user::instance($user1->id);
$approvedlist = new approved_contextlist($user1, 'core', [$usercontext1->id]);
provider::delete_data_for_user($approvedlist);
// Check what is remaining belongs to user2.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(1, $usersdata);
$this->assertEquals($user2->id, reset($usersdata)->userid);
}
/**
* Test that data for users in an approved userlist is deleted.
*
* @covers ::delete_data_for_users
*/
public function test_delete_data_for_users() {
global $DB;
$this->resetAfterTest();
// Create some users.
$user1 = $this->getDataGenerator()->create_user();
$user2 = $this->getDataGenerator()->create_user();
$usercontext1 = \context_user::instance($user1->id);
$usercontext2 = \context_user::instance($user2->id);
// Insert a record for each user.
$this->insert_dummy_moodlenet_share_progress_record($user1->id);
$this->insert_dummy_moodlenet_share_progress_record($user2->id);
// Check the count on all user's data.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(2, $usersdata);
// Attempt to delete data for user1 using user2's context (should have no effect).
$approvedlist = new approved_userlist($usercontext2, 'core', [$user1->id]);
provider::delete_data_for_users($approvedlist);
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(2, $usersdata);
// Delete data for user1 using its correct context.
$approvedlist = new approved_userlist($usercontext1, 'core', [$user1->id]);
provider::delete_data_for_users($approvedlist);
// Check what is remaining belongs to user2.
$usersdata = $DB->get_records('moodlenet_share_progress', []);
$this->assertCount(1, $usersdata);
$this->assertEquals($user2->id, reset($usersdata)->userid);
}
/**
* Helper function to insert a MoodleNet share progress record for use in the tests.
*
* @param int $userid The ID of the user to link the record to.
*/
protected function insert_dummy_moodlenet_share_progress_record(int $userid): void {
$sharetype = share_recorder::TYPE_ACTIVITY;
$courseid = 123;
$cmid = 456;
share_recorder::insert_share_progress($sharetype, $userid, $courseid, $cmid);
}
}