feat: add script to auto-generate .phpstorm.meta.php file

Signed-off-by: Hari Darshan Gorana <er.haridarshan@gmail.com>

.phpstorm.meta.stub

@@ -0,0 +1,10 @@
+<?php
+declare(strict_types=1);
+
+// see https://www.jetbrains.com/help/phpstorm/ide-advanced-metadata.html
+namespace PHPSTORM_META {
+
+    override(\Github\Client::api(0), map([
+        $METHODS$
+    ]));
+}

composer.json

@@ -29,7 +29,8 @@
         "psr/http-factory-implementation": "^1.0",
         "psr/http-message": "^1.0",
         "symfony/polyfill-php80": "^1.17",
-        "symfony/deprecation-contracts": "^2.2|^3.0"
+        "symfony/deprecation-contracts": "^2.2|^3.0",
+        "jasny/phpdoc-parser": "^1.0"
     },
     "require-dev": {
         "symfony/cache": "^5.1.8",
@@ -58,7 +59,8 @@
     "config": {
         "allow-plugins": {
             "phpstan/extension-installer": true,
-            "composer/package-versions-deprecated": true
+            "composer/package-versions-deprecated": true,
+            "php-http/discovery": true
         }
     }
 }

generate-phpstorm-meta-file.php

@@ -0,0 +1,26 @@
+<?php
+
+use Jasny\PhpdocParser\PhpdocParser;
+use Jasny\PhpdocParser\Set\PhpDocumentor;
+
+require 'vendor/autoload.php';
+
+$reflection = new ReflectionClass(\Github\Client::class);
+$parser = new PHPDocParser(PhpDocumentor::tags());
+$meta = $parser->parse($reflection->getDocComment());
+
+$replacements = "";
+foreach($meta['methods'] as $method) {
+    $replacements .= "\"{$method['name']}\" => \Github\\{$method['return_type']}::class,".PHP_EOL;
+}
+
+$str = file_get_contents('./.phpstorm.meta.stub');
+$str = str_replace('$METHODS$', $replacements, $str);
+file_put_contents('.phpstorm.meta.1.php', $str);
+
+
+
+
+
+
+