[auto-generated] Update plugin files

Check out the commits that caused these changes: moodlehq/moodleapp@2750898...55c083d

Author: github-actions[bot]

tests/behat/behat_app.php

@@ -968,6 +968,40 @@ public function the_app_should_have_opened_url(bool $not, string $urlpattern, ?s
         });
     }
 
+    /**
+     * Check that an event has been logged.
+     *
+     * @Then /^the following events should( not)? have been logged for (".+"|the system) in the app:$/
+     */
+    public function the_event_should_have_been_logged(bool $not, string $username, TableNode $data) {
+        $userid = $this->get_event_userid($username);
+
+        foreach ($data->getColumnsHash() as $event) {
+            $eventname = $event['name'];
+            $logs = $this->get_event_logs($userid, $event);
+
+            if (!$not && empty($logs)) {
+                throw new ExpectationException("Logs for event '$eventname' not found", $this->getSession()->getDriver());
+            }
+
+            if ($not && !empty($logs) && empty($event['other'])) {
+                throw new ExpectationException("Logs for event '$eventname' found, but shouldn't have", $this->getSession()->getDriver());
+            }
+
+            if (!empty($event['other'])) {
+                $log = $this->find_event_log_with_other($logs, json_decode($event['other'], true));
+
+                if (!$not && is_null($log)) {
+                    throw new ExpectationException("Other data for event '$eventname' does not match", $this->getSession()->getDriver());
+                }
+
+                if ($not && !is_null($log)) {
+                    throw new ExpectationException("Logs for event '$eventname' found, but shouldn't have", $this->getSession()->getDriver());
+                }
+            }
+        }
+    }
+
     /**
      * Switches to a newly-opened browser tab.
      *

tests/behat/behat_app_helper.php

@@ -19,6 +19,7 @@
 require_once(__DIR__ . '/../../../../lib/behat/behat_base.php');
 
 use Behat\Mink\Exception\DriverException;
+use Behat\Mink\Exception\ExpectationException;
 use Moodle\BehatExtension\Exception\SkippedException;
 
 /**
@@ -480,6 +481,106 @@ protected function get_mobile_url_scheme() {
         return !empty($mobilesettings->forcedurlscheme) ? $mobilesettings->forcedurlscheme : 'moodlemobile';
     }
 
+    /**
+     * Get user id corresponding to the given username in event logs.
+     *
+     * @param string $username User name, or "the system" to refer to a non-user actor such as the system, the cli, or a cron job.
+     * @return int Event user id.
+     */
+    protected function get_event_userid(string $username): int {
+        global $DB;
+
+        if ($username === 'the system') {
+            return \core\event\base::USER_OTHER;
+        }
+
+        if (str_starts_with($username, '"')) {
+            $username = substr($username, 1, -1);
+        }
+
+        $user = $DB->get_record('user', compact('username'));
+
+        if (is_null($user)) {
+            throw new ExpectationException("'$username' user not found", $this->getSession()->getDriver());
+        }
+
+        return $user->id;
+    }
+
+    /**
+     * Given event logs matching the given restrictions.
+     *
+     * @param array $event Event restrictions.
+     * @return array Event logs.
+     */
+    protected function get_event_logs(int $userid, array $event): array {
+        global $DB;
+
+        $filters = [
+            'origin' => 'ws',
+            'eventname' => $event['name'],
+            'userid' => $userid,
+            'courseid' => empty($event['course']) ? 0 : $this->get_course_id($event['course']),
+        ];
+
+        if (!empty($event['relateduser'])) {
+            $relateduser = $DB->get_record('user', ['username' => $event['relateduser']]);
+
+            $filters['relateduserid'] = $relateduser->id;
+        }
+
+        if (!empty($event['activity'])) {
+            $cm = $this->get_cm_by_activity_name_and_course($event['activity'], $event['activityname'], $event['course']);
+
+            $filters['contextinstanceid'] = $cm->id;
+        }
+
+        if (!empty($event['object'])) {
+            $namecolumns = [
+                'book_chapters' => 'title',
+                'glossary_entries' => 'concept',
+                'lesson_pages' => 'title',
+                'notifications' => 'subject',
+            ];
+
+            $field = $namecolumns[$event['object']] ?? 'shortname';
+            $object = $DB->get_record_select(
+                $event['object'],
+                $DB->sql_compare_text($field) . ' = ' . $DB->sql_compare_text('?'),
+                [$event['objectname']]
+            );
+
+            $filters['objectid'] = $object->id;
+        }
+
+        return $DB->get_records('logstore_standard_log', $filters);
+    }
+
+    /**
+     * Find a log matching the given other data.
+     *
+     * @param array $logs Event logs.
+     * @param array $other Other data.
+     * @return object Log matching the given other data, or null otherwise.
+     */
+    protected function find_event_log_with_other(array $logs, array $other): ?object {
+        foreach ($logs as $log) {
+            $logother = json_decode($log->other, true);
+
+            if (empty($logother)) {
+                continue;
+            }
+
+            if (!empty(array_diff_assoc($other, array_intersect_assoc($other, $logother)))) {
+                continue;
+            }
+
+            return $log;
+        }
+
+        return null;
+    }
+
     /**
      * Get a coursemodule from an activity name or idnumber with course.
      *

version.php

@@ -6,7 +6,7 @@
 
 defined('MOODLE_INTERNAL') || die;
 
-$plugin->version = 2024031200;
+$plugin->version = 2024041100;
 $plugin->requires = 2016052300;
 $plugin->maturity = MATURITY_STABLE;
 $plugin->release = '4.4.0';