[FEATURE] Add FixedPrefix, ApplyOnArrayValueByKey and more structure

Author: vertexvaar

README.md

@@ -36,11 +36,11 @@ $restoredInput = $encoding->reverse($output);
 
 ```php
  // Shared Library
- function getPipe(): \CoStack\Reversible\ReversiblePipe {
-    $pipe = new \CoStack\Reversible\ReversiblePipe();
-    $pipe->enqueue(new \CoStack\Reversible\Mapping\ArrayKeyMapping(['key1', 'key2', 'payload']));
-    $pipe->enqueue(new \CoStack\Reversible\RecursiveReversible(new \CoStack\Reversible\Encoding\Base64Encoding()));
-    $pipe->enqueue(new \CoStack\Reversible\Transform\ImplodeTransform());
+ function getPipe(): \CoStack\Reversible\Applicable\ReversiblePipe {
+    $pipe = new \CoStack\Reversible\Applicable\ReversiblePipe();
+    $pipe->enqueue(new \CoStack\Reversible\Operation\Mapping\ArrayKeyMapping(['key1', 'key2', 'payload']));
+    $pipe->enqueue(new \CoStack\Reversible\Applicable\ApplyOnArrayValueRecursively(new \CoStack\Reversible\Encoding\Base64Encoding()));
+    $pipe->enqueue(new \CoStack\Reversible\Operation\Transform\ImplodeTransform());
     return $pipe;
 }
 
@@ -65,8 +65,8 @@ Please notice that `ImplodeTransform` is lossy because `explode(',', implode(','
 
 ```php
 // Shared Library
-function getPipe(): \CoStack\Reversible\ReversiblePipe {
-    $pipe = new \CoStack\Reversible\ReversiblePipe();
+function getPipe(): \CoStack\Reversible\Applicable\ReversiblePipe {
+    $pipe = new \CoStack\Reversible\Applicable\ReversiblePipe();
     $pipe->enqueue(new \CoStack\Reversible\Encoding\SerializationEncoding());
     $pipe->enqueue(new \CoStack\Reversible\Encoding\UrlEncode());
     return $pipe;

src/Applicable/ApplyOnArrayValueByKey.php

@@ -0,0 +1,44 @@
+<?php
+declare(strict_types=1);
+namespace CoStack\Reversible\Applicable;
+
+use Closure;
+use CoStack\Reversible\AbstractReversible;
+use CoStack\Reversible\Reversible;
+
+class ApplyOnArrayValueByKey extends AbstractReversible
+{
+    private $reversible;
+    private $keys;
+
+    public function __construct(Reversible $reversible, array $keys)
+    {
+        $this->reversible = $reversible;
+        $this->keys = $keys;
+    }
+
+    public function getExecutionClosure(): Closure
+    {
+        return function(array $value): array {
+            foreach ($this->keys as $key) {
+                if (!empty($value[$key])) {
+                    $value[$key] = $this->reversible->execute($value[$key]);
+                }
+            }
+            return $value;
+        };
+    }
+
+    public function getReversionClosure(): Closure
+    {
+        return function(array $value): array {
+            foreach ($this->keys as $key) {
+                if (!empty($value[$key])) {
+                    $value[$key] = $this->reversible->reverse($value[$key]);
+                }
+            }
+            return $value;
+        };
+    }
+
+}

src/RecursiveReversible.php …licable/ApplyOnArrayValueRecursively.phpsrc/RecursiveReversible.php renamed to src/Applicable/ApplyOnArrayValueRecursively.php src/RecursiveReversible.php renamed to src/Applicable/ApplyOnArrayValueRecursively.php

@@ -1,12 +1,14 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible;
+namespace CoStack\Reversible\Applicable;
 
 use Closure;
+use CoStack\Reversible\AbstractReversible;
+use CoStack\Reversible\Reversible;
 use function array_map;
 use function is_array;
 
-class RecursiveReversible extends AbstractReversible
+class ApplyOnArrayValueRecursively extends AbstractReversible
 {
     /** @var Reversible */
     private $reversible;

src/ReversiblePipe.php src/Applicable/ReversiblePipe.phpsrc/ReversiblePipe.php renamed to src/Applicable/ReversiblePipe.php

@@ -1,8 +1,10 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible;
+namespace CoStack\Reversible\Applicable;
 
 use Closure;
+use CoStack\Reversible\AbstractReversible;
+use CoStack\Reversible\Reversible;
 use function array_reverse;
 
 class ReversiblePipe extends AbstractReversible

src/Encoding/Base64Encoding.php src/Operation/Encoding/Base64Encoding.phpsrc/Encoding/Base64Encoding.php renamed to src/Operation/Encoding/Base64Encoding.php

@@ -1,6 +1,6 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible\Encoding;
+namespace CoStack\Reversible\Operation\Encoding;
 
 use Closure;
 use CoStack\Reversible\AbstractReversible;

src/Encoding/JsonEncoding.php src/Operation/Encoding/JsonEncoding.phpsrc/Encoding/JsonEncoding.php renamed to src/Operation/Encoding/JsonEncoding.php

@@ -1,6 +1,6 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible\Encoding;
+namespace CoStack\Reversible\Operation\Encoding;
 
 use Closure;
 use CoStack\Reversible\AbstractReversible;

src/Encoding/RawUrlEncode.php src/Operation/Encoding/RawUrlEncode.phpsrc/Encoding/RawUrlEncode.php renamed to src/Operation/Encoding/RawUrlEncode.php

@@ -1,6 +1,6 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible\Encoding;
+namespace CoStack\Reversible\Operation\Encoding;
 
 use Closure;
 use CoStack\Reversible\AbstractReversible;

src/Encoding/SerializationEncoding.php …ation/Encoding/SerializationEncoding.phpsrc/Encoding/SerializationEncoding.php renamed to src/Operation/Encoding/SerializationEncoding.php src/Encoding/SerializationEncoding.php renamed to src/Operation/Encoding/SerializationEncoding.php

@@ -1,6 +1,6 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible\Encoding;
+namespace CoStack\Reversible\Operation\Encoding;
 
 use Closure;
 use CoStack\Reversible\AbstractReversible;

src/Encoding/UrlEncode.php src/Operation/Encoding/UrlEncode.phpsrc/Encoding/UrlEncode.php renamed to src/Operation/Encoding/UrlEncode.php

@@ -1,6 +1,6 @@
 <?php
 declare(strict_types=1);
-namespace CoStack\Reversible\Encoding;
+namespace CoStack\Reversible\Operation\Encoding;
 
 use Closure;
 use CoStack\Reversible\AbstractReversible;

src/Operation/Fixed/FixedPrefix.php

@@ -0,0 +1,33 @@
+<?php
+declare(strict_types=1);
+namespace CoStack\Reversible\Operation\Fixed;
+
+use Closure;
+use CoStack\Reversible\AbstractReversible;
+use function strlen;
+use function substr;
+
+class FixedPrefix extends AbstractReversible
+{
+    private $prefix;
+
+    public function __construct(string $prefix)
+    {
+        $this->prefix = $prefix;
+    }
+
+    public function getExecutionClosure(): Closure
+    {
+        return function(string $value): string {
+            return $this->prefix . $value;
+        };
+    }
+
+    public function getReversionClosure(): Closure
+    {
+        return function(string $value): string {
+            return substr($value, strlen($this->prefix));
+        };
+    }
+
+}