Add Node property overloads for accessing attributes

Node attributes are now also accessible as ordinary properties.
Accessing an undefined attribute throws -- the getAttribute()
default value behavior can be replicated using coalescing.
@Property declarations for all the standard attributes have been
added to the relevant nodes. Of course, whether they are actually
available depends on configuration.

Author: nikic

lib/PhpParser/Node.php

@@ -2,6 +2,20 @@
 
 namespace PhpParser;
 
+/**
+ * AST node.
+ *
+ * The following attributes are available depending on the 'usedAttributes' option passed to the
+ * lexer.
+ *
+ * @property Comment[] $comments      Comments preceding this node
+ * @property int       $startLine     Line the node starts at (1-based)
+ * @property int       $endLine       Line the node end at (1-based)
+ * @property int       $startFilePos  File offset the node starts at (0-based)
+ * @property int       $endFilePos    File offset the node ends at (0-based)
+ * @property int       $startTokenPos Token offset the node starts at (0-based)
+ * @property int       $endTokenPos   Token offset the node ends at (0-based)
+ */
 interface Node
 {
     /**
@@ -41,6 +55,15 @@ public function setLine($line);
      */
     public function getDocComment();
 
+    /**
+     * Sets the doc comment of the node.
+     *
+     * This will either replace an existing doc comment or add it to the comments array.
+     *
+     * @param Comment\Doc $docComment Doc comment to set
+     */
+    public function setDocComment(Comment\Doc $docComment);
+
     /**
      * Sets an attribute on a node.
      *
@@ -74,4 +97,37 @@ public function &getAttribute($key, $default = null);
      * @return array
      */
     public function getAttributes();
+
+    /**
+     * Get the value of an attribute.
+     *
+     * @param string $key Name of the attribute
+     *
+     * @return mixed Value of the attribute
+     */
+    public function &__get($key);
+
+    /**
+     * Sets the value of an attribute.
+     *
+     * @param string $key   Name of the attribute
+     * @param mixed  $value Value to set
+     */
+    public function __set($key, $value);
+
+    /**
+     * Check whether an attribute exists and is non-null.
+     *
+     * @param string $key Name of the attribute
+     *
+     * @return bool Whether the attribute exists and is non-null
+     */
+    public function __isset($key);
+
+    /**
+     * Removes an attribute.
+     *
+     * @param string $key Name of the attribute.
+     */
+    public function __unset($key);
 }

lib/PhpParser/Node/Const_.php

@@ -4,6 +4,10 @@
 
 use PhpParser\NodeAbstract;
 
+/**
+ * @property Name $namespacedName Namespace-prefixed name (requires NameResolver). This only applies
+ *                                to freestanding (non-class) constants.
+ */
 class Const_ extends NodeAbstract
 {
     /** @var string Name */

lib/PhpParser/Node/Expr/Array_.php

@@ -4,6 +4,9 @@
 
 use PhpParser\Node\Expr;
 
+/**
+ * @property int $kind One of the KIND_* class constants
+ */
 class Array_ extends Expr
 {
     // For use in "kind" attribute

lib/PhpParser/Node/Expr/Exit_.php

@@ -4,6 +4,9 @@
 
 use PhpParser\Node\Expr;
 
+/**
+ * @property int $kind One of the KIND_* class constants
+ */
 class Exit_ extends Expr
 {
     /* For use in "kind" attribute */

lib/PhpParser/Node/Scalar/Encapsed.php

@@ -4,6 +4,10 @@
 
 use PhpParser\Node\Scalar;
 
+/**
+ * @property int    $kind     One of the String_::KIND_* class constants
+ * @property string $docLabel Label of doc comment (only available if string defined as doc string)
+ */
 class Encapsed extends Scalar
 {
     /** @var array Encaps list */

lib/PhpParser/Node/Scalar/LNumber.php

@@ -5,6 +5,9 @@
 use PhpParser\Error;
 use PhpParser\Node\Scalar;
 
+/**
+ * @property int $kind One of the KIND_* class constants
+ */
 class LNumber extends Scalar
 {
     /* For use in "kind" attribute */

lib/PhpParser/Node/Scalar/String_.php

@@ -5,6 +5,10 @@
 use PhpParser\Error;
 use PhpParser\Node\Scalar;
 
+/**
+ * @property int    $kind     One of the KIND_* class constants
+ * @property string $docLabel Label of doc comment (only available if string defined as doc string)
+ */
 class String_ extends Scalar
 {
     /* For use in "kind" attribute */

lib/PhpParser/Node/Stmt/ClassLike.php

@@ -4,6 +4,9 @@
 
 use PhpParser\Node;
 
+/**
+ * @property Node\Name $namespacedName Namespace-prefixed name (requires NameResolver)
+ */
 abstract class ClassLike extends Node\Stmt {
     /** @var string Name */
     public $name;

lib/PhpParser/Node/Stmt/Function_.php

@@ -5,6 +5,9 @@
 use PhpParser\Node;
 use PhpParser\Node\FunctionLike;
 
+/**
+ * @property Node\Name $namespacedName Namespace-prefixed name (requires NameResolver)
+ */
 class Function_ extends Node\Stmt implements FunctionLike
 {
     /** @var bool Whether function returns by reference */

lib/PhpParser/Node/Stmt/InlineHTML.php

@@ -4,6 +4,9 @@
 
 use PhpParser\Node\Stmt;
 
+/**
+ * @property bool $hasLeadingNewline Whether the inline has a leading newline that has been ignored
+ */
 class InlineHTML extends Stmt
 {
     /** @var string String */