wip

Author: remcotolsma

composer.json

@@ -45,7 +45,7 @@
 	},
 	"require": {
 		"php": ">=8.2",
-		"phpdocumentor/reflection": "^4.0",
+		"phpdocumentor/reflection": "^6.4",
 		"phpdocumentor/reflection-docblock": "^5.6",
 		"symfony/console": "^5.0 || ^6.0 || ^6.1 || ^6.2",
 		"symfony/filesystem": "^5.0 || ^6.0 || ^6.1 || ^6.2",
@@ -56,7 +56,7 @@
 		"dealerdirect/phpcodesniffer-composer-installer": "^1.2",
 		"phpcompatibility/php-compatibility": "^9.3",
 		"phpcompatibility/phpcompatibility-wp": "^2.1",
-		"phpdocumentor/phpdocumentor": "^3.0",
+		"phpdocumentor/phpdocumentor": "^3.9",
 		"rector/rector": "^2.3",
 		"roots/wordpress": "^5.9",
 		"squizlabs/php_codesniffer": "^3.13",

composer.lock

@@ -199,7 +199,7 @@ private function get_statement_doc_comment( Node $statement ) {
 	public function parse( $file ) {
 		$parser_factory = new ParserFactory();
 
-		$parser = $parser_factory->create( ParserFactory::PREFER_PHP7 );
+		$parser = $parser_factory->createForNewestSupportedVersion();
 
 		$node_finder = new NodeFinder();
 

src/Documentor.php

@@ -24,10 +24,10 @@ class TagPrinter {
 	 * Print PHP Parser epxression.
 	 *
 	 * @throws \Exception Throws exception when epxression can not be transformed to string.
-	 * @param Expr $expr PHP Parser epxression.
+	 * @param Expr|mixed $expr PHP Parser epxression or string part.
 	 * @return string
 	 */
-	public function print( Expr $expr ) {
+	public function print( $expr ) {
 		/**
 		 * String.
 		 *
@@ -80,6 +80,30 @@ public function print( Expr $expr ) {
 			return $expr->value;
 		}
 
+		/**
+		 * Interpolated String (PHP-Parser 5.x).
+		 *
+		 * @link https://github.com/nikic/PHP-Parser/blob/v5.0.0/lib/PhpParser/Node/Scalar/InterpolatedString.php
+		 */
+		if ( $expr instanceof \PhpParser\Node\Scalar\InterpolatedString ) {
+			return implode(
+				'',
+				\array_map(
+					__METHOD__,
+					$expr->parts
+				)
+			);
+		}
+
+		/**
+		 * Interpolated String Part (PHP-Parser 5.x).
+		 *
+		 * @link https://github.com/nikic/PHP-Parser/blob/v5.0.0/lib/PhpParser/Node/InterpolatedStringPart.php
+		 */
+		if ( $expr instanceof \PhpParser\Node\InterpolatedStringPart ) {
+			return $expr->value;
+		}
+
 		/**
 		 * Function Call.
 		 *
@@ -102,8 +126,10 @@ public function print( Expr $expr ) {
 		 * @todo What todo with method call arguments?
 		 * @link https://github.com/nikic/PHP-Parser/blob/v4.10.4/lib/PhpParser/Node/Expr/MethodCall.php
 		 */
-		if ( $expr instanceof \PhpParser\Node\Expr\MethodCall ) { // phpcs:ignore Generic.CodeAnalysis.EmptyStatement.DetectedIf
-			// Currently not supported.
+		if ( $expr instanceof \PhpParser\Node\Expr\MethodCall ) {
+			if ( $expr->var instanceof \PhpParser\Node\Expr\Variable ) {
+				return '{$' . $expr->var->name . '->' . $expr->name . '()}';
+			}
 		}
 
 		/**

src/TagPrinter.php

@@ -16,8 +16,6 @@ Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliqu
 
 Argument | Type | Description
 -------- | ---- | -----------
-
-Deprecated: Non-canonical cast (double) is deprecated, use the (float) cast instead in /Users/remco/Projects/wp-hooks-documentor/vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.php on line 226
 `$option` | `string` | Name of the option to update.
 `$old_value` | `mixed` | The old option value.
 `$value` | `mixed` | The new option value.

tests/docs/hooks.md

@@ -16,9 +16,7 @@ Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliqu
 +----------+------+-------------+
 | Argument | Type | Description |
 +==========+======+=============+
-| 
-Deprecated: Non-canonical cast (double) is deprecated, use the (float) cast instead in /Users/remco/Projects/wp-hooks-documentor/vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.php on line 226
-$option | string | Name of the option to update. |
+| $option | string | Name of the option to update. |
 | $old_value | mixed | The old option value. |
 | $value | mixed | The new option value. |
 +----------+------+-------------+

tests/docs/phpdocumentor-actions.rst

@@ -16,9 +16,7 @@ Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliqu
 +----------+------+-------------+
 | Argument | Type | Description |
 +==========+======+=============+
-| 
-Deprecated: Non-canonical cast (double) is deprecated, use the (float) cast instead in /Users/remco/Projects/wp-hooks-documentor/vendor/nikic/php-parser/lib/PhpParser/PrettyPrinter/Standard.php on line 226
-$mce_translation | array | Key/value pairs of strings. |
+| $mce_translation | array | Key/value pairs of strings. |
 | $mce_locale | string | Locale. |
 +----------+------+-------------+