Merge pull request microsoft#341 from TysonAndre/attributes-group

Add support for PHP 8.0 `#[` attribute groups

Author: roblourens

src/FunctionLike.php

@@ -6,8 +6,12 @@
 
 namespace Microsoft\PhpParser;
 
+use Microsoft\PhpParser\Node\AttributeGroup;
+
 /**
  * Interface for recognizing functions easily.
  * Each Node that implements this interface can be considered a function.
+ *
+ * @property AttributeGroup[] $attributes
  */
 interface FunctionLike {}

src/Node/Attribute.php

@@ -0,0 +1,31 @@
+<?php
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+namespace Microsoft\PhpParser\Node;
+
+use Microsoft\PhpParser\Node;
+use Microsoft\PhpParser\Token;
+
+class Attribute extends Node {
+    /** @var Token|Node */
+    public $name;
+
+    /** @var Token|null */
+    public $openParen;
+
+    /** @var DelimitedList\ArgumentExpressionList|null  */
+    public $argumentExpressionList;
+
+    /** @var Token|null */
+    public $closeParen;
+
+    const CHILD_NAMES = [
+        'name',
+        'openParen',
+        'argumentExpressionList',
+        'closeParen'
+    ];
+}

src/Node/AttributeGroup.php

@@ -0,0 +1,28 @@
+<?php
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+namespace Microsoft\PhpParser\Node;
+
+use Microsoft\PhpParser\Node\DelimitedList\AttributeElementList;
+use Microsoft\PhpParser\Node;
+use Microsoft\PhpParser\Token;
+
+class AttributeGroup extends Node {
+    /** @var Token */
+    public $startToken;
+
+    /** @var AttributeElementList */
+    public $attributes;
+
+    /** @var Token */
+    public $endToken;
+
+    const CHILD_NAMES = [
+        'startToken',
+        'attributes',
+        'endToken'
+    ];
+}

src/Node/ClassConstDeclaration.php

@@ -14,6 +14,12 @@
 class ClassConstDeclaration extends Node implements ModifiedTypeInterface {
     use ModifiedTypeTrait;
 
+    /** @var AttributeGroup[]|null */
+    public $attributes;
+
+    /** @var Token[] */
+    public $modifiers;
+
     /** @var Token */
     public $constKeyword;
 
@@ -24,6 +30,7 @@ class ClassConstDeclaration extends Node implements ModifiedTypeInterface {
     public $semicolon;
 
     const CHILD_NAMES = [
+        'attributes',
         'modifiers',
         'constKeyword',
         'constElements',

src/Node/DelimitedList/AttributeElementList.php

@@ -0,0 +1,12 @@
+<?php
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+namespace Microsoft\PhpParser\Node\DelimitedList;
+
+use Microsoft\PhpParser\Node\DelimitedList;
+
+class AttributeElementList extends DelimitedList {
+}

src/Node/Expression/AnonymousFunctionCreationExpression.php

@@ -21,6 +21,7 @@ class AnonymousFunctionCreationExpression extends Expression implements Function
     use FunctionHeader, FunctionUseClause, FunctionReturnType, FunctionBody;
 
     const CHILD_NAMES = [
+        'attributes',
         'staticModifier',
 
         // FunctionHeader

src/Node/Expression/ArrowFunctionCreationExpression.php

@@ -26,6 +26,7 @@ class ArrowFunctionCreationExpression extends Expression implements FunctionLike
     public $resultExpression;
 
     const CHILD_NAMES = [
+        'attributes',
         'staticModifier',
 
         // FunctionHeader

src/Node/FunctionHeader.php

@@ -9,6 +9,8 @@
 use Microsoft\PhpParser\Token;
 
 trait FunctionHeader {
+    /** @var AttributeGroup[]|null */
+    public $attributes;
     /** @var Token */
     public $functionKeyword;
     /** @var Token */

src/Node/MethodDeclaration.php

@@ -20,6 +20,7 @@ class MethodDeclaration extends Node implements FunctionLike, ModifiedTypeInterf
     use FunctionHeader, FunctionReturnType, FunctionBody, ModifiedTypeTrait;
 
     const CHILD_NAMES = [
+        'attributes',
         'modifiers',
 
         // FunctionHeader

src/Node/MissingDeclaration.php

@@ -0,0 +1,23 @@
+<?php
+/*---------------------------------------------------------------------------------------------
+ * Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+
+namespace Microsoft\PhpParser\Node;
+
+use Microsoft\PhpParser\Node;
+use Microsoft\PhpParser\MissingToken;
+
+class MissingDeclaration extends Node {
+    /** @var AttributeGroup[] */
+    public $attributes;
+
+    /** @var MissingToken needed for emitting diagnostics */
+    public $declaration;
+
+    const CHILD_NAMES = [
+        'attributes',
+        'declaration',
+    ];
+}