first commit

lib/tests/fixtures/hook/callbacks.php

@@ -0,0 +1,83 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+namespace test_plugin;
+
+/**
+ * Fixture for testing of hooks.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+final class callbacks {
+    /** @var string[] list of calls */
+    public static $calls = [];
+
+    /**
+     * Callback tester.
+     *
+     * @param \test_plugin\hook\hook $hook
+     * @return void
+     */
+    public static function test1(\test_plugin\hook\hook $hook): void {
+        self::$calls[] = 'test1';
+    }
+
+    /**
+     * Callback tester.
+     *
+     * @param \test_plugin\hook\hook $hook
+     * @return void
+     */
+    public static function test2(\test_plugin\hook\hook $hook): void {
+        self::$calls[] = 'test2';
+    }
+
+    /**
+     * Callback tester.
+     *
+     * @param \test_plugin\hook\stoppablehook $hook
+     * @return void
+     */
+    public static function stop1(\test_plugin\hook\stoppablehook $hook): void {
+        self::$calls[] = 'stop1';
+        $hook->stop();
+    }
+
+    /**
+     * Callback tester.
+     *
+     * @param \test_plugin\hook\stoppablehook $hook
+     * @return void
+     */
+    public static function stop2(\test_plugin\hook\stoppablehook $hook): void {
+        self::$calls[] = 'stop2';
+        $hook->stop();
+    }
+
+    /**
+     * Callback tester for exceptions.
+     *
+     * @param \test_plugin\hook\hook $hook
+     * @return void
+     */
+    public static function exception(\test_plugin\hook\hook $hook): void {
+        self::$calls[] = 'exception';
+        throw new \Exception('grrr');
+    }
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/classes/callbacks.php

@@ -0,0 +1,44 @@
+<?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 fake_hooktest;
+
+/**
+ * Class callback container for fake_hooktest
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class callbacks {
+    /**
+     * Test callback that is not replaced by a hook.
+     *
+     * @return string
+     */
+    public static function current_class_callback(): string {
+        return 'Called current class callback';
+    }
+
+    /**
+     * Test callback that is replaced by a hook.
+     *
+     * @return string
+     */
+    public static function old_class_callback(): string {
+        return 'Called deprecated class callback';
+    }
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/classes/hook/hook_replacing_callback.php

@@ -0,0 +1,53 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+namespace fake_hooktest\hook;
+
+/**
+ * Fixture for testing of hooks.
+ *
+ * @package core
+ * @author Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @copyright 2024 Catalyst IT Europe Ltd.
+ * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+final class hook_replacing_callback implements
+    \core\hook\described_hook,
+    \core\hook\deprecated_callback_replacement {
+
+    /**
+     * Hook description.
+     */
+    public static function get_hook_description(): string {
+        return 'Test hook replacing a plugin callback function.';
+    }
+
+    /**
+     * Deprecation info.
+     */
+    public static function get_deprecated_plugin_callbacks(): array {
+        return ['old_callback'];
+    }
+
+    /**
+     * List of tags that describe this hook.
+     *
+     * @return string[]
+     */
+    public static function get_hook_tags(): array {
+        return ['test'];
+    }
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/classes/hook/hook_replacing_class_callback.php

@@ -0,0 +1,33 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+namespace fake_hooktest\hook;
+
+use core\attribute;
+
+/**
+ * Fixture for testing of hooks.
+ *
+ * @package core
+ * @author Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @copyright 2024 Catalyst IT Europe Ltd.
+ * @license https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+#[attribute\label('Test hook replacing a class callback.')]
+#[attribute\tags('test')]
+#[attribute\hook\replaces_callbacks('callbacks::old_class_callback')]
+final class hook_replacing_class_callback {
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/classes/hook_callbacks.php

@@ -0,0 +1,44 @@
+<?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 fake_hooktest;
+
+/**
+ * Hook callbacks
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class hook_callbacks {
+    /**
+     * Test callback which replaces a plugin callback.
+     *
+     * @return string
+     */
+    public function component_callback_replacement(): string {
+        return 'Called component callback replacement';
+    }
+
+    /**
+     * Test callback which replaced a plugin class callback.
+     *
+     * @return string
+     */
+    public function component_class_callback_replacement(): string {
+        return 'Called component class callback replacement';
+    }
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/classes/hooks.php

@@ -0,0 +1,41 @@
+<?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 fake_hooktest;
+
+/**
+ * Hook discovery for fake plugin.
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+class hooks implements \core\hook\discovery_agent {
+    public static function discover_hooks(): array {
+        return [
+            'fake_hooktest\hook\hook_replacing_callback' => [
+                'class' => 'fake_hooktest\hook\hook_replacing_callback',
+                'description' => 'Hook replacing callback',
+                'tags' => ['test'],
+            ],
+            'fake_hooktest\hook\hook_replacing_class_callback' => [
+                'class' => 'fake_hooktest\hook\hook_replacing_class_callback',
+                'description' => 'Hook replacing class callback',
+                'tags' => ['test'],
+            ],
+        ];
+    }
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/db/hooks.php

@@ -0,0 +1,37 @@
+<?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/>.
+/**
+ * Hook callback definitions for core
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'fake_hooktest\hook\hook_replacing_callback',
+        'callback' => 'fake_hooktest\hook_callbacks::component_callback_replacement',
+        'priority' => 500,
+    ],
+    [
+        'hook' => 'fake_hooktest\hook\hook_replacing_class_callback',
+        'callback' => 'fake_hooktest\hook_callbacks::component_class_callback_replacement',
+        'priority' => 600,
+    ],
+];

lib/tests/fixtures/hook/fakeplugins/hooktest/db/hooks_nocallbacks.php

@@ -0,0 +1,27 @@
+<?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/>.
+/**
+ * Hook callback definitions for core
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+];

lib/tests/fixtures/hook/fakeplugins/hooktest/lib.php

@@ -0,0 +1,41 @@
+<?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/>.
+/**
+ * Library functions for fake_hooktest
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+/**
+ * Test callback that is not replaced by a hook.
+ *
+ * @return string
+ */
+function fake_hooktest_current_callback() {
+    return 'Called current callback';
+}
+
+/**
+ * Test callback that is replaced by a hook.
+ *
+ * @return string
+ */
+function fake_hooktest_old_callback() {
+    return 'Called deprecated callback';
+}

lib/tests/fixtures/hook/fakeplugins/hooktest/version.php

@@ -0,0 +1,30 @@
+<?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/>.
+
+/**
+ * Fake plugin for testing hooks.
+ *
+ * @package   core
+ * @copyright 2024 onwards Catalyst IT EU {@link https://catalyst-eu.net}
+ * @author    Mark Johnson <mark.johnson@catalyst-eu.net>
+ * @license   http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$plugin->version   = 2024012200;
+$plugin->requires  = 2024011900;
+$plugin->component = 'fake_hooktest';

lib/tests/fixtures/hook/hook.php

@@ -0,0 +1,53 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+namespace test_plugin\hook;
+
+/**
+ * Fixture for testing of hooks.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+final class hook implements
+    \core\hook\described_hook,
+    \core\hook\deprecated_callback_replacement {
+
+    /**
+     * Hook description.
+     */
+    public static function get_hook_description(): string {
+        return 'Test hook 1.';
+    }
+
+    /**
+     * Deprecation info.
+     */
+    public static function get_deprecated_plugin_callbacks(): array {
+        return ['oldcallback'];
+    }
+
+    /**
+     * List of tags that describe this hook.
+     *
+     * @return string[]
+     */
+    public static function get_hook_tags(): array {
+        return ['test'];
+    }
+}

lib/tests/fixtures/hook/hooks1_broken.php

@@ -0,0 +1,42 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'callback' => 'test_plugin\\callbacks::test2',
+        'priority' => 100,
+    ],
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'priority' => 100,
+    ],
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'callback' => 'test_plugin\\callbackstest2',
+        'priority' => 100,
+    ],
+];

lib/tests/fixtures/hook/hooks1_exception.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'callback' => 'test_plugin\\callbacks::exception',
+        'priority' => 1000,
+    ],
+];

lib/tests/fixtures/hook/hooks1_missing.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'callback' => 'test_plugin\\callbacks::missing',
+        'priority' => 1000,
+    ],
+];

lib/tests/fixtures/hook/hooks1_stoppable.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\stoppablehook',
+        'callback' => 'test_plugin\\callbacks::stop1',
+        'priority' => 400,
+    ],
+];

lib/tests/fixtures/hook/hooks1_valid.php

@@ -0,0 +1,33 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'callback' => [\test_plugin\callbacks::class, 'test1'],
+    ],
+];

lib/tests/fixtures/hook/hooks2_stoppable.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\stoppablehook',
+        'callback' => 'test_plugin\\callbacks::stop2',
+        'priority' => 200,
+    ],
+];

lib/tests/fixtures/hook/hooks2_valid.php

@@ -0,0 +1,34 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+/**
+ * Fixtures for hook testing.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+
+defined('MOODLE_INTERNAL') || die();
+
+$callbacks = [
+    [
+        'hook' => 'test_plugin\\hook\\hook',
+        'callback' => 'test_plugin\\callbacks::test2',
+        'priority' => 200,
+    ],
+];

lib/tests/fixtures/hook/stoppablehook.php

@@ -0,0 +1,65 @@
+<?php
+// This file is part of Moodle - https://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 <https://www.gnu.org/licenses/>.
+
+namespace test_plugin\hook;
+
+use Psr\EventDispatcher\StoppableEventInterface;
+
+/**
+ * Fixture for testing of hooks.
+ *
+ * @package   core
+ * @author    Petr Skoda
+ * @copyright 2022 Open LMS
+ * @license   https://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
+ */
+final class stoppablehook implements
+    StoppableEventInterface,
+    \core\hook\described_hook {
+
+    /** @var bool stoppable flag */
+    private $stopped = false;
+
+    /**
+     * Hook description.
+     */
+    public static function get_hook_description(): string {
+        return 'Test hook 2.';
+    }
+
+    /**
+     * Stop other callbacks.
+     */
+    public function stop(): void {
+        $this->stopped = true;
+    }
+
+    /**
+     * Indicates if callback propagation should stop.
+     */
+    public function isPropagationStopped(): bool {
+        return $this->stopped;
+    }
+
+    /**
+     * List of tags that describe this hook.
+     *
+     * @return string[]
+     */
+    public static function get_hook_tags(): array {
+        return ['test'];
+    }
+}