Add: Json renderer

Author: JBlond

composer.json

@@ -39,6 +39,7 @@
         "digilive/git-changelog": "^2"
     },
     "suggest": {
+        "ext-json": "*",
         "jblond/php-cli": "^1.0"
     },
     "autoload": {

lib/jblond/Diff/Renderer/Text/Json.php

@@ -0,0 +1,61 @@
+<?php
+
+namespace jblond\Diff\Renderer\Text;
+
+use jblond\Diff\Renderer\MainRendererAbstract;
+
+/**
+ * Unified diff generator for PHP DiffLib.
+ *
+ * PHP version 7.3 or greater
+ *
+ * @package         jblond\Diff\Renderer\Text
+ * @author          Mario Brandt <[email protected]>
+ * @copyright   (c) 2023 Mario Brandt
+ * @license         New BSD License http://www.opensource.org/licenses/bsd-license.php
+ * @version         2.4.0
+ * @link            https://github.com/JBlond/php-diff
+ */
+
+/**
+ * Class Diff_Renderer_Text_Json
+ */
+class Json extends MainRendererAbstract
+{
+    /**
+     * @return false|string
+     */
+    public function render()
+    {
+        $return = [];
+        $opCodes = $this->diff->getGroupedOpCodes();
+
+        foreach ($opCodes as $key => $group) {
+            $return[] = $this->toArray($group);
+        }
+        return json_encode($return, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
+    }
+
+    /**
+     * @param $group
+     * @return array
+     */
+    protected function toArray($group): array
+    {
+        $return = [];
+        foreach ($group as [$tag, $iGroup1, $iGroup2, $jGroup1, $jGroup2]) {
+            $return[] = [
+                'tag' => $tag,
+                'old' => [
+                    'offset' => $iGroup1,
+                    'lines' => $this->diff->getArrayRange($this->diff->getVersion1(), $iGroup1, $iGroup2)
+                ],
+                'new' => [
+                    'offset' => $jGroup1,
+                    'lines' => $this->diff->getArrayRange($this->diff->getVersion2(), $jGroup1, $jGroup2)
+                ],
+            ];
+        }
+        return $return;
+    }
+}

tests/Diff/Renderer/Text/TextRenderersTest.php

@@ -130,4 +130,23 @@ public function testInlineCli(): void
         }
         $this->assertStringEqualsFile('tests/resources/textInlineCli.txt', $result);
     }
+
+    /**
+     * Test the output of the JSON text renderer
+     *
+     * @covers \jblond\Diff\Renderer\Text\Json
+     */
+    public function testJson(): void
+    {
+        $diff = new Diff(
+            file_get_contents('tests/resources/a.txt'),
+            file_get_contents('tests/resources/b.txt')
+        );
+        $renderer = new Diff\Renderer\Text\Json();
+        $result   = $diff->render($renderer);
+        if ($this->genOutputFiles) {
+            file_put_contents('results.json', $result);
+        }
+        $this->assertStringEqualsFile('tests/resources/textResult.json', $result);
+    }
 }