Add test for multiline attributes for MissingDocblockSniff

Signed-off-by: Daniel Ziegenberg <[email protected]>

moodle/Tests/Sniffs/Commenting/MissingDocblockSniffTest.php

@@ -129,6 +129,19 @@ public static function docblockCorrectnessProvider(): array {
                 'errors' => [],
                 'warnings' => [],
             ],
+            'Docblock with attributes on function (correct)' => [
+                'fixture' => 'docblock_with_multiline_attributes',
+                'fixtureFilename' => null,
+                'errors' => [],
+                'warnings' => [],
+            ],
+
+// Per PER-2.0:
+// > If a comment docblock is present on a structure that also includes an
+// > attribute, the comment block MUST come first, followed by any
+// > attributes, followed by the structure itself. There MUST NOT be any
+// > blank lines between the docblock and attributes, or the attributes and
+// > the structure.
             'Testcase' => [
                 'fixture' => 'testcase_class',
                 'fixtureFilename' => '/lib/tests/example_test.php',

moodle/Tests/Sniffs/Commenting/fixtures/MissingDocblock/docblock_with_multiline_attributes.php

@@ -0,0 +1,25 @@
+<?php
+
+namespace MoodleHQ\MoodleCS\moodle\Tests\Sniffs\PHPUnit;
+
+defined('MOODLE_INTERNAL') || die(); // Make this always the 1st line in all CS fixtures.
+
+/**
+ * Example class. 
+ */
+#[\Attribute(
+    attr1: 'asdf',
+    attr2: 'asdf',
+)]
+class class_multiline_attribute {
+
+    /**
+     * Method attribute.
+     */
+    #[\Attribute(
+        attr1: 'asdf',
+        attr2: 'asdf',
+    )]
+    function method_multiline_attribute(): void {
+    }
+}