Initial commit

Author: simivar

.gitignore

@@ -0,0 +1,3 @@
+.idea/
+vendor/
+infection.log

LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2020 simivar
+
+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

@@ -0,0 +1,73 @@
+# Reverse print_r
+This library provides six different handlers for reversing output of PHP's `print_r` function back to original variables.
+If there's no handler available for a type it's returned as `string`.
+
+## Assumptions
+- all values should be type-casted, not returned as `string`
+- empty string (`""`) is treated as `null` (see `NullHandler`)
+- integers are treated as integers (no `boolean` support)
+- multi-level `array` MUST be supported with type-casting
+- `public`, `protected` and `private` properties of Objects MUST be supported with type-casting
+
+## Known issues
+- no support for Object Inheritance 
+
+# Installation
+Package is available via  [Composer](https://getcomposer.org/).
+
+```
+composer require simivar/reverse-print-r
+```
+
+# Usage
+```php
+<?php
+
+$print_r_output = print_r([
+    'string' => 'some text',
+    'integer' => 1,
+    'float' => 2.3,
+    'subArray' => [
+        'Hello World.',
+    ],
+], true);
+
+$reverser = new \ReversePrintR\ReversePrintR($print_r_output);
+echo $reverser->reverse()['float']; 
+// outputs "2.3"
+```
+
+## Changing behavior of Handlers
+All handlers are defined as `final`, but thanks to Dependency Injection it's easy to change the behavior of library 
+and it's type-casting. Let's say you want to keep all the empty strings `""` as string, not `null`. All you have to do 
+is create your own `HandlerRunner` without `NullHandler`.
+
+```php
+<?php
+
+$print_r_output = print_r([
+    'string' => '',
+    'null' => null,
+], true);
+
+$handlerRunner = new \ReversePrintR\HandlerRunner(
+    new \ReversePrintR\Handler\FloatHandler(),
+    new \ReversePrintR\Handler\IntegerHandler(),
+    new \ReversePrintR\Handler\ArrayHandler(),
+    new \ReversePrintR\Handler\ObjectHandler()
+);
+
+$reverser = new \ReversePrintR\ReversePrintR($print_r_output, $handlerRunner);
+var_dump($reverser->reverse()['null']); 
+// outputs ""
+```
+
+## Own Handlers
+The same way to removed `NullHandler` you can add your own handlers. All you have to do is make sure that it implements
+`\ReversePrintR\Handler\HandlerInterface` and you are good to go.
+
+# Versioning
+Library is following [Semver](http://semver.org/). All minor and patch updates are backwards compatible.
+ 
+# License
+Please see the [license file](https://github.com/simivar/reverse-print-r/blob/master/LICENSE) for more information.

composer.json

@@ -0,0 +1,51 @@
+{
+    "name": "simivar/reverse-print-r",
+    "description": "Library to reverse print_r output to PHP objects, arrays and scalar values.",
+    "type": "library",
+    "require-dev": {
+        "phpunit/phpunit": "^9.0",
+        "friendsofphp/php-cs-fixer": "^2.16",
+        "vimeo/psalm": "^3.9",
+        "infection/infection": "^0.15.3",
+        "ergebnis/composer-normalize": "^2.2",
+        "phpbench/phpbench": "@dev"
+    },
+    "autoload": {
+        "psr-4": {
+            "ReversePrintR\\": "src/"
+        }
+    },
+    "autoload-dev": {
+        "psr-4": {
+            "Tests\\Unit\\ReversePrintR\\": "tests/Unit",
+            "Tests\\Integration\\ReversePrintR\\": "tests/Integration"
+        }
+    },
+    "license": "MIT",
+    "authors": [
+        {
+            "name": "simivar",
+            "email": "simivar@gmail.com"
+        }
+    ],
+    "minimum-stability": "stable",
+    "require": {
+        "php": "^7.1"
+    },
+    "scripts": {
+        "psalm": "vendor/bin/psalm",
+        "infection": "vendor/bin/infection",
+        "test": "vendor/bin/phpunit",
+        "test-unit": "vendor/bin/phpunit --testsuite Unit",
+        "test-integration": "vendor/bin/phpunit --testsuite Integration",
+        "bench": [
+            "Composer\\Config::disableProcessTimeout",
+            "vendor/bin/phpbench run --report=my_report --output=my_output"
+        ],
+        "qa": [
+            "@psalm",
+            "@test",
+            "@infection"
+        ]
+    }
+}