Add Method attribute

Author: carlos-granados

Diff for: README.md

@@ -95,6 +95,7 @@ These are the available attributes and their corresponding PHPDoc annotations:
 | Attribute                                             | PHPDoc Annotations        |
 |-------------------------------------------------------|---------------------------|
 | [IsReadOnly](doc/IsReadOnly.md)                       | `@readonly`               |
+| [Method](doc/Method.md)                               | `@method`                 |
 | [Param](doc/Param.md)                                 | `@param`                  |
 | [Property](doc/Property.md)                           | `@property` `@var`        |
 | [PropertyRead](doc/PropertyRead.md)                   | `@property-read`          |

Diff for: doc/Method.md

@@ -0,0 +1,31 @@
+# `Method` Attribute
+
+This attribute is the equivalent of the `@method` annotation and is used to specify the methods defined through magic `__call` methods, including methods called in a parent class. 
+
+## Arguments
+
+The attribute accepts one or more strings which describe the signature of these methods. The attribute itself does not have a knowledge of which signatures are valid and which are not and this will depend on the implementation for each particular tool.
+
+We expect that the attribute will be able to accept all the signatures accepted by static analysis tools for the `@method` annotation.
+
+The arguments need to be unnamed arguments.
+
+If the class has more than one method that we want to specify, the types for the different properties can either be declared as a list of strings for a single `Method` attribute or as a list of `Method` attributes (or even a combination of both, though we don't expect this to be actually used).
+
+## Example usage
+
+```php
+<?php
+
+use PhpStaticAnalysis\Attributes\Method;
+
+#[Method('string getString()')]
+#[Method(
+    'void setString(string $text)',
+    'static string staticGetter()',
+)]
+class MethodExample
+{
+    ...
+}
+```

Diff for: doc/PropertyRead.md

@@ -6,7 +6,7 @@ This attribute is the equivalent of the `@property-read` annotation and is used
 
 The attribute accepts one or more strings which describe the type of the properties. The attribute itself does not have a knowledge of which types are valid and which are not and this will depend on the implementation for each particular tool.
 
-We expect that the attribute will be able to accept both basic types like `string` or `array` and more advanced types like `array<string>` or `Collection<int>`. We aim to accept all the types accepted by static analysis tools for the `@property` annotation.
+We expect that the attribute will be able to accept both basic types like `string` or `array` and more advanced types like `array<string>` or `Collection<int>`. We aim to accept all the types accepted by static analysis tools for the `@property-read` annotation.
 
 The arguments can be named arguments and the type is applied to the properties with the same name in the class.
 

Diff for: doc/PropertyWrite.md

@@ -6,7 +6,7 @@ This attribute is the equivalent of the `@property-write` annotation and is used
 
 The attribute accepts one or more strings which describe the type of the properties. The attribute itself does not have a knowledge of which types are valid and which are not and this will depend on the implementation for each particular tool.
 
-We expect that the attribute will be able to accept both basic types like `string` or `array` and more advanced types like `array<string>` or `Collection<int>`. We aim to accept all the types accepted by static analysis tools for the `@property` annotation.
+We expect that the attribute will be able to accept both basic types like `string` or `array` and more advanced types like `array<string>` or `Collection<int>`. We aim to accept all the types accepted by static analysis tools for the `@property-write` annotation.
 
 The arguments can be named arguments and the type is applied to the properties with the same name in the class.
 

Diff for: src/Method.php

@@ -0,0 +1,19 @@
+<?php
+
+declare(strict_types=1);
+
+namespace PhpStaticAnalysis\Attributes;
+
+use Attribute;
+
+#[Attribute(
+    Attribute::TARGET_CLASS |
+    Attribute::IS_REPEATABLE
+)]
+final class Method
+{
+    public function __construct(
+        string ...$params
+    ) {
+    }
+}

Diff for: tests/MethodTest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+use PhpStaticAnalysis\Attributes\Method;
+use PHPUnit\Framework\TestCase;
+
+#[Method('string getString()')]
+#[Method(
+    'void setString(string $text)',
+    'static string staticGetter()',
+)]
+class MethodTest extends TestCase
+{
+    public function testClassMethods(): void
+    {
+        $reflection = new ReflectionClass($this);
+        $this->assertEquals([
+            'string getString()',
+            'void setString(string $text)',
+            'static string staticGetter()',
+        ], self::getMethodsFromReflection($reflection));
+    }
+
+    public static function getMethodsFromReflection(
+        ReflectionClass $reflection
+    ): array {
+        $attributes = $reflection->getAttributes();
+        $methods = [];
+        foreach ($attributes as $attribute) {
+            if ($attribute->getName() === Method::class) {
+                $attribute->newInstance();
+                $methods = array_merge($methods, $attribute->getArguments());
+            }
+        }
+
+        return $methods;
+    }
+}

Diff for: tests/PropertyReadTest.php

@@ -25,7 +25,7 @@ public function testClassProperties(): void
     }
 
     public static function getPropertiesFromReflection(
-        ReflectionProperty | ReflectionClass $reflection
+        ReflectionClass $reflection
     ): array {
         $attributes = $reflection->getAttributes();
         $properties = [];

Diff for: tests/PropertyWriteTest.php

@@ -25,7 +25,7 @@ public function testClassProperties(): void
     }
 
     public static function getPropertiesFromReflection(
-        ReflectionProperty | ReflectionClass $reflection
+        ReflectionClass $reflection
     ): array {
         $attributes = $reflection->getAttributes();
         $properties = [];