feat: add new differ option: fullContextIfIdentical

When it's truthy and there is no difference, the diff output would be the whole file marked as "equal". Otherwise, it just returns null. Signed-off-by: Jack Cherng <[email protected]>
jfcherng · Mar 4, 2024 · 8e29f00 · 8e29f00
1 parent e0da986
commit 8e29f00
Show file tree

Hide file tree

Showing 3 changed files with 48 additions and 1 deletion.
diff --git a/src/Differ.php b/src/Differ.php
@@ -113,6 +113,8 @@ final class Differ
         'ignoreWhitespace' => false,
         // if the input sequence is too long, it will just gives up (especially for char-level diff)
         'lengthLimit' => 2000,
+        // if truthy, when inputs are identical, the whole inputs will be rendered in the output
+        'fullContextIfIdentical' => false,
     ];
 
     /**
@@ -312,6 +314,15 @@ public function getGroupedOpcodes(): array
 
         $old = $this->old;
         $new = $this->new;
+
+        if ($this->oldNewComparison === 0 && $this->options['fullContextIfIdentical']) {
+            return [
+                [
+                    [SequenceMatcher::OP_EQ, 0, \count($old), 0, \count($new)],
+                ],
+            ];
+        }
+
         $this->getGroupedOpcodesPre($old, $new);
 
         $opcodes = $this->sequenceMatcher
@@ -339,6 +350,15 @@ public function getGroupedOpcodesGnu(): array
 
         $old = $this->old;
         $new = $this->new;
+
+        if ($this->oldNewComparison === 0 && $this->options['fullContextIfIdentical']) {
+            return [
+                [
+                    [SequenceMatcher::OP_EQ, 0, \count($old), 0, \count($new)],
+                ],
+            ];
+        }
+
         $this->getGroupedOpcodesGnuPre($old, $new);
 
         $opcodes = $this->sequenceMatcher

diff --git a/src/Renderer/AbstractRenderer.php b/src/Renderer/AbstractRenderer.php
@@ -181,7 +181,7 @@ final public function render(Differ $differ): string
         $this->changesAreRaw = true;
 
         // the "no difference" situation may happen frequently
-        return $differ->getOldNewComparison() === 0
+        return $differ->getOldNewComparison() === 0 && !$differ->options['fullContextIfIdentical']
             ? $this->getResultForIdenticals()
             : $this->renderWorker($differ);
     }

diff --git a/tests/Renderer/RendererTest.php b/tests/Renderer/RendererTest.php
@@ -47,6 +47,33 @@ public function testSetOptionsWithLanguageArray(): void
         );
     }
 
+    /**
+     * Test the AbstractRenderer::setOptions with result for identicals.
+     *
+     * @covers \Jfcherng\Diff\Renderer\AbstractRenderer::setOptions
+     */
+    public function testSetOptionsWithFullContextIfIdentical(): void
+    {
+        $diffResult = DiffHelper::calculate(
+            "the 1st line\nthe 2nd line\nthe 3rd line",
+            "the 1st line\nthe 2nd line\nthe 3rd line",
+            'Unified',
+            ['fullContextIfIdentical' => true],
+            [],
+        );
+
+        self::assertSame(
+            '@@ -1,3 +1,3 @@
+ the 1st line
+ the 2nd line
+ the 3rd line
+\ No newline at end of file
+',
+            $diffResult,
+            'Differ options: "fullContextIfIdentical" should work.',
+        );
+    }
+
     /**
      * Test the AbstractRenderer::setOptions with result for identicals.
      *