Upgrade functional tests

Author: Kirill Nesmeyanov

composer.json

@@ -20,15 +20,17 @@
         }
     },
     "require-dev": {
-        "justinrainbow/json-schema": "^5.2",
-        "friendsofphp/php-cs-fixer": "^3.42",
+        "friendsofphp/php-cs-fixer": "^3.52",
         "jetbrains/phpstorm-attributes": "^1.0",
-        "nikic/php-parser": "^4.17",
-        "phpdocumentor/reflection-docblock": "^5.3",
+        "nikic/php-parser": "^4.17|^5.0",
         "phplrt/compiler": "^3.6",
-        "phpunit/phpunit": "^10.5",
+        "phpunit/phpunit": "^10.5|^11.0",
         "rector/rector": "^1.0",
-        "symfony/var-dumper": "^5.6|^6.0|^7.0",
+        "symfony/finder": "^5.4|^6.0|^7.0",
+        "symfony/var-dumper": "^5.4|^6.0|^7.0",
+        "type-lang/printer": "^1.0",
+        "type-lang/phpdoc": "^1.0",
+        "type-lang/phpdoc-standard-tags": "^1.0",
         "vimeo/psalm": "^5.18"
     },
     "autoload-dev": {

tests/Concern/CompileGrammarIfPossible.php

@@ -14,7 +14,7 @@
 trait CompileGrammarIfPossible
 {
     #[BeforeClass]
-    public static function setUpCompilerBeforeClass(): void
+    public static function setUpCompileGrammarIfPossible(): void
     {
         // Skip code assembly if the compiler is not available.
         if (!\class_exists(Compiler::class)) {

tests/Concern/DocBlockReader.php

@@ -0,0 +1,75 @@
+<?php
+
+declare(strict_types=1);
+
+namespace TypeLang\Parser\Tests\Concern;
+
+use PhpParser\Node;
+use PhpParser\Node\Stmt;
+use PhpParser\NodeTraverser;
+use PhpParser\NodeVisitorAbstract;
+use PHPUnit\Framework\AssertionFailedError;
+use PHPUnit\Framework\ExpectationFailedException;
+
+trait InteractWithCommentsParser
+{
+    use InteractWithPhpParser;
+
+    /**
+     * @param array<array-key, Stmt> $statements
+     * @return iterable<array-key, non-empty-string>
+     * @throws \LogicException
+     */
+    protected static function getCommentsFromStatements(array $statements): iterable
+    {
+        $comments = new \ArrayObject();
+        $traverser = new NodeTraverser();
+
+        $traverser->addVisitor(new class ($comments) extends NodeVisitorAbstract {
+            public function __construct(
+                private readonly \ArrayObject $comments,
+            ) {}
+
+            public function enterNode(Node $node): void
+            {
+                $comment = $node->getDocComment();
+
+                if ($comment === null) {
+                    return;
+                }
+
+                $this->comments['line ' . $node->getLine()] = $comment->getText();
+            }
+        });
+
+        $traverser->traverse($statements);
+
+        return $comments->getIterator();
+    }
+
+    /**
+     * @return iterable<array-key, non-empty-string>
+     * @throws \LogicException
+     * @throws ExpectationFailedException
+     */
+    protected static function getCommentsFromPhpCode(string $code): iterable
+    {
+        return self::getCommentsFromStatements(
+            statements: self::getStatementsFromPhpCode($code),
+        );
+    }
+
+    /**
+     * @param non-empty-string $pathname
+     * @return iterable<array-key, non-empty-string>
+     * @throws ExpectationFailedException
+     * @throws \LogicException
+     * @throws AssertionFailedError
+     */
+    protected static function getCommentsFromPhpFile(string $pathname): iterable
+    {
+        return self::getCommentsFromStatements(
+            statements: self::getStatementsFromPhpFile($pathname),
+        );
+    }
+}