.github/dependabot.yml

@@ -0,0 +1,8 @@
+version: 2
+updates:
+- package-ecosystem: composer
+  directory: "/"
+  schedule:
+    interval: daily
+    time: "22:00"
+  open-pull-requests-limit: 10

.github/workflows/phpunit.yml

@@ -0,0 +1,58 @@
+name: "PHPUnit tests"
+
+on:
+  pull_request:
+  push:
+
+jobs:
+  phpunit:
+    name: "PHPUnit tests"
+
+    runs-on: ${{ matrix.operating-system }}
+
+    strategy:
+      matrix:
+        dependencies:
+          - "lowest"
+          - "highest"
+        php-version:
+          - "8.2"
+          - "8.3"
+        operating-system:
+          - "ubuntu-latest"
+
+    steps:
+      - name: "Checkout"
+        uses: "actions/checkout@v2"
+
+      - name: "Install PHP"
+        uses: "shivammathur/setup-php@v2"
+        with:
+          coverage: "pcov"
+          php-version: "${{ matrix.php-version }}"
+          ini-values: memory_limit=-1
+          tools: composer:v2, cs2pr
+
+      - name: "Cache dependencies"
+        uses: "actions/cache@v2"
+        with:
+          path: |
+            ~/.composer/cache
+            vendor
+          key: "php-${{ matrix.php-version }}-${{ matrix.dependencies }}"
+          restore-keys: "php-${{ matrix.php-version }}-${{ matrix.dependencies }}"
+
+      - name: "Install lowest dependencies"
+        if: ${{ matrix.dependencies == 'lowest' }}
+        run: "composer update --prefer-lowest --no-interaction --no-progress --no-suggest"
+
+      - name: "Install highest dependencies"
+        if: ${{ matrix.dependencies == 'highest' }}
+        run: "composer update --no-interaction --no-progress --no-suggest"
+
+      - name: "Install locked dependencies"
+        if: ${{ matrix.dependencies == 'locked' }}
+        run: "composer install --no-interaction --no-progress --no-suggest"
+
+      - name: "Tests"
+        run: "vendor/bin/phpunit"

.gitignore

@@ -1,2 +1,3 @@
 /vendor/
 composer.lock
+/.phpunit.result.cache

LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2015-2024 Alexander Lisachenko
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is furnished
+to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

README.md

@@ -1,16 +1,17 @@
 Parser Reflection API Library
 -----------------
+This library is **deprecated**. Please use [BetterReflection](https://github.com/Roave/BetterReflection).
 
 Parser Reflection API library provides a set of classes that extend original internal Reflection classes, but powered by [PHP-Parser](https://github.com/nikic/PHP-Parser) library thus allowing to create a reflection instance without loading classes into the memory.
 
-This library can be used for analysing the source code for PHP versions 5.5, 5.6, 7.0; for automatic proxy creation and much more.
+This library can be used for analysing the source code; for automatic proxy creation and much more.
 
 [![Build Status](https://scrutinizer-ci.com/g/goaop/parser-reflection/badges/build.png?b=master)](https://scrutinizer-ci.com/g/goaop/parser-reflection/build-status/master)
 [![Code Coverage](https://scrutinizer-ci.com/g/goaop/parser-reflection/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/goaop/parser-reflection/?branch=master)
 [![Total Downloads](https://img.shields.io/packagist/dt/goaop/parser-reflection.svg)](https://packagist.org/packages/goaop/parser-reflection)
 [![Daily Downloads](https://img.shields.io/packagist/dd/goaop/parser-reflection.svg)](https://packagist.org/packages/goaop/parser-reflection)
 [![Scrutinizer Code Quality](https://scrutinizer-ci.com/g/goaop/parser-reflection/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/goaop/parser-reflection/?branch=master)
-[![SensioLabs Insight](https://img.shields.io/sensiolabs/i/1fdfee9c-839a-4209-a2f2-42dadc859621.svg)](https://insight.sensiolabs.com/projects/1fdfee9c-839a-4209-a2f2-42dadc859621)[![Minimum PHP Version](http://img.shields.io/badge/php-%3E%3D%205.5-8892BF.svg)](https://php.net/)
+[![PHP Version](https://img.shields.io/badge/php-%3E%3D%208.2-8892BF.svg)](https://php.net/)
 [![License](https://img.shields.io/packagist/l/goaop/parser-reflection.svg)](https://packagist.org/packages/goaop/parser-reflection)
 
 Installation
@@ -29,46 +30,48 @@ Usage
 
 ### Initialization
 
-Prior to first use library can be optionally initialized.
-
-Following example uses the Composer autoloader from the project, where library is used, as a dependency:
-
-```php
-$locator = new \Go\ParserReflection\Locator\ComposerLocator();
-\Go\ParserReflection\ReflectionEngine::init($locator);
-```
-
-Following example uses Composer's autoloader located at a given path:
-
-```php
-$composerLoader = require_once '/path/to/vendor/autoload.php';
-$composerLoader->unregister();
-
-$locator = new \Go\ParserReflection\Locator\ComposerLocator($composerLoader);
-\Go\ParserReflection\ReflectionEngine::init($locator);
-```
+Prior to the first use library can be optionally initialized. If you use Composer for installing packages and loading classes, 
+then you shouldn't worry about initialization, library will be initialized automatically.
 
 If project uses a custom autoloader then you should follow the next steps:
 
-1. Create a class, that implements `\Go\ParserReflection\LocatorInterface`
+1. Create a new class that implements `\Go\ParserReflection\LocatorInterface`
 2. Create an instance of that class and pass it to the `ReflectionEngine::init()` method for initial configuration
 
-### Actual Usage
+### Reflecting concrete classes/methods/properties without loading them
 
 Just use `Go\ParserReflection` package reflection classes like traditional ones:
 
 ```php
 $parsedClass = new \Go\ParserReflection\ReflectionClass(SomeClass::class);
 var_dump($parsedClass->getMethods());
+
+$parsedMethod = new \Go\ParserReflection\ReflectionMethod(SomeClass::class, 'someMethod');
+echo (string)$parsedMethod;
 ```
 
 Or you can use an additional classes [`ReflectionFile`][0] and [`ReflectionFileNamespace`][1] to analyse a raw PHP files:
 
 ```php
 $parsedFile     = new \Go\ParserReflection\ReflectionFile('SomeClass.php');
 $fileNameSpaces = $parsedFile->getFileNamespaces();
-var_dump($fileNameSpaces);
-var_dump($fileNameSpaces[0]->getClass(SomeClass::class)->getMethods());
+// We can iterate over namespaces in the file
+foreach ($fileNameSpaces as $namespace) {
+    $classes = $namespace->getClasses();
+    // Iterate over the classes in the namespace
+    foreach ($classes as $class) {
+        echo "Found class: ", $class->getName(), PHP_EOL;
+        // Now let's show all methods in the class
+        foreach ($class->getMethods() as $method) {
+            echo "Found class method: ", $class->getName(), '::', $method->getName(), PHP_EOL;
+        }
+
+        // ...all properties in the class
+        foreach ($class->getProperties() as $property) {
+            echo "Found class property: ", $class->getName(), '->', $property->getName(), PHP_EOL;
+        }
+    }
+}
 ```
 
 How it works?
@@ -81,12 +84,12 @@ To understand how library works let's look at what happens during the call to th
  * `ComposerLocator` instance asks the Composer to find a filename for the given class and returns this result back to the reflection engine
  * Reflection engine loads the content of file and passes it to the [PHP-Parser](https://github.com/nikic/PHP-Parser) for tokenization and processing
  * PHP-Parser returns an AST (Abstract Syntax Tree)
- * Reflection engine then analyse this AST to extract specific nodes an wrap them into corresponding reflection classes.
+ * Reflection engine then analyse this AST to extract specific nodes and wrap them into corresponding reflection classes.
 
 Compatibility
 ------------
 
-All parser reflection classes extend PHP internal reflection classes, this means that you can use `\Go\ParserReflection\ReflectionClass` instance in any place that asks for `\ReflectionClass` instance. All reflection methods should be compatible with original ones, providing an  except methods that requires object manipulation, such as `invoke()`, `invokeArgs()`, `setAccessible()`, etc. These methods will trigger the autoloading of class and switching to the internal reflection.
+All parser reflection classes extend PHP internal reflection classes, this means that you can use `\Go\ParserReflection\ReflectionClass` instance in any place that asks for `\ReflectionClass` instance. All reflection methods should be compatible with original ones, providing an  except methods that requires object manipulation, such as `invoke()`, `invokeArgs()`, `setAccessible()`, etc. These methods will trigger the process of class loading and switching to the internal reflection.
 
 [0]: docs/reflection_file.md
 [1]: docs/reflection_file_namespace.md

composer.json

@@ -22,15 +22,18 @@
     }
   },
   "require": {
-    "php": ">=5.5.0",
-    "nikic/php-parser": "^1.2|^2.0"
+    "php": ">=8.2",
+    "nikic/php-parser": "^5.0"
   },
   "require-dev": {
-    "phpunit/phpunit": "~4.0"
+    "phpunit/phpunit": "^11.0.7",
+    "tracy/tracy": "^2.10",
+    "rector/rector": "^1.0",
+    "rector/rector-php-parser": "^0.14.0"
   },
   "extra": {
     "branch-alias": {
-      "dev-master": "1.x-dev"
+      "dev-master": "4.x-dev"
     }
   }
 }

docs/README.md

@@ -5,9 +5,9 @@ Introduction
 --------
 PHP comes with a complete reflection API that adds the ability to reverse-engineer classes, interfaces, functions, methods and extensions. Additionally, the reflection API offers ways to retrieve doc comments for functions, classes and methods.
 
-But this reflection API requires concrete element to be loaded into the memory. Once element is loaded, it can not be changed, modified or updated without special extensions. 
+However, this reflection API requires concrete element to be loaded into the memory. Once element is loaded, it cannot be changed, modified or updated without special extensions.
 
-`goaop\parser-reflection` packet is a userland implementation of reflection API that is fully compatible with internal one, but doesn't require element (e.g. class or function) to be loaded into the PHP. Only the source code is required for performing the raw analysis.
+`goaop\parser-reflection` packet is a user-land implementation of reflection API that is fully compatible with internal one, but doesn't require an element (e.g. class or function) to be loaded into the PHP. Only the source code is required for performing the raw analysis.
 
 Reference
 ---------

docs/reflection_file.md

@@ -14,6 +14,7 @@ class ReflectionFile
     public function getFileNamespaces() {}
     public function getName() {}
     public function hasFileNamespace($namespaceName) {}
+    public function isStrictMode() {}
 }
 ```
 
@@ -40,5 +41,7 @@ Methods
 
   Checks if requested namespace is present in the file or not. Returns `true` if present.
 
-
+- `ReflectionFile::isStrictMode()`
+
+  Checks if current file has enabled strict mode via `declare(strict_types=1)` for PHP>=7.0
 [0]: reflection_file_namespace.md

nitpick.json

@@ -0,0 +1,7 @@
+{
+    "ignore": [
+        "src/*",
+        "tests/*",
+        "docs/*"
+    ]
+}

phpunit.xml.dist

@@ -1,36 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
-
-<phpunit backupGlobals="false"
-         backupStaticAttributes="false"
-         colors="true"
-         convertErrorsToExceptions="true"
-         convertNoticesToExceptions="true"
-         convertWarningsToExceptions="true"
-         processIsolation="false"
-         stopOnFailure="false"
-         syntaxCheck="false"
-         bootstrap="./tests/bootstrap.php"
-        >
-    <php>
-        <!--Path to the autoload file that should be used. Use a composer autoloader by default-->
-        <const name="AUTOLOAD_PATH" value="./vendor/autoload.php"/>
-    </php>
-
-    <testsuites>
-        <testsuite name="Parser Reflection Test Suite">
-            <directory>./tests/</directory>
-        </testsuite>
-    </testsuites>
-
-    <filter>
-        <whitelist>
-            <directory>./src/</directory>
-        </whitelist>
-    </filter>
-
-    <groups>
-        <exclude>
-            <group>performance</group>
-        </exclude>
-    </groups>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd" colors="true" bootstrap="./vendor/autoload.php">
+  <testsuites>
+    <testsuite name="Parser Reflection Test Suite">
+      <directory>./tests/</directory>
+    </testsuite>
+  </testsuites>
+  <source>
+    <include>
+      <directory>./src/</directory>
+    </include>
+  </source>
+  <php>
+    <ini name="memory_limit" value="1536M" />
+  </php>
 </phpunit>

rector.php

@@ -0,0 +1,32 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\DeadCode\Rector\ClassMethod\RemoveUselessParamTagRector;
+use Rector\DeadCode\Rector\ClassMethod\RemoveUselessReturnTagRector;
+use Rector\Php71\Rector\ClassConst\PublicConstantVisibilityRector;
+use Rector\Php74\Rector\Closure\ClosureToArrowFunctionRector;
+use Rector\PhpParser\Set\PhpParserSetList;
+use Rector\PHPUnit\Set\PHPUnitSetList;
+use Rector\TypeDeclaration\Rector\ClassMethod\AddVoidReturnTypeWhereNoReturnRector;
+
+return RectorConfig::configure()
+    ->withPaths([
+        __DIR__ . '/src',
+        __DIR__ . '/tests',
+    ])
+    // uncomment to reach your current PHP version
+    // ->withPhpSets()
+    ->withRules([
+        AddVoidReturnTypeWhereNoReturnRector::class,
+        RemoveUselessParamTagRector::class,
+        RemoveUselessReturnTagRector::class,
+        PublicConstantVisibilityRector::class,
+        ClosureToArrowFunctionRector::class,
+    ])
+    ->withSets([
+        PHPUnitSetList::ANNOTATIONS_TO_ATTRIBUTES,
+        PHPUnitSetList::PHPUNIT_CODE_QUALITY,
+        PhpParserSetList::PHP_PARSER_50
+    ]);