Issue #5: results provide node value

Author: remorhaz

CHANGELOG.md

@@ -4,6 +4,10 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [Unreleased]
+### Added
+- Issue #5: `ResultInterface::get()` method added.
+
 ## [0.6.3] - 2019-11-18
 ### Fixed
 - Issue #4: replacing document root with `add()` fixed.

src/Processor/Result/ExistingResult.php

@@ -44,4 +44,9 @@ public function decode()
             ->decoder
             ->exportValue($this->nodeValue);
     }
+
+    public function get(): NodeValueInterface
+    {
+        return $this->nodeValue;
+    }
 }

src/Processor/Result/NonExistingResult.php

@@ -3,6 +3,8 @@
 
 namespace Remorhaz\JSON\Pointer\Processor\Result;
 
+use Remorhaz\JSON\Data\Value\NodeValueInterface;
+
 final class NonExistingResult implements ResultInterface
 {
 
@@ -27,4 +29,9 @@ public function decode()
     {
         throw new Exception\ResultNotFoundException($this->source);
     }
+
+    public function get(): NodeValueInterface
+    {
+        throw new Exception\ResultNotFoundException($this->source);
+    }
 }

src/Processor/Result/ResultInterface.php

@@ -3,6 +3,8 @@
 
 namespace Remorhaz\JSON\Pointer\Processor\Result;
 
+use Remorhaz\JSON\Data\Value\NodeValueInterface;
+
 interface ResultInterface
 {
 
@@ -11,4 +13,6 @@ public function exists(): bool;
     public function encode(): string;
 
     public function decode();
+
+    public function get(): NodeValueInterface;
 }

tests/Processor/Result/ExistingResultTest.php

@@ -53,7 +53,6 @@ public function testEncode_EncoderExportsValue_ReturnsSameValue(): void
         );
 
         $encoder
-            ->expects(self::once())
             ->method('exportValue')
             ->willReturn('a');
         self::assertSame('a', $result->encode());
@@ -87,9 +86,19 @@ public function testDecode_DecoderExportsValue_ReturnsSameValue(): void
         );
 
         $decoder
-            ->expects(self::once())
             ->method('exportValue')
             ->willReturn('a');
         self::assertSame('a', $result->decode());
     }
+
+    public function testGet_ConstructedWithValue_ReturnsSameInstance(): void
+    {
+        $value = $this->createMock(NodeValueInterface::class);
+        $result = new ExistingResult(
+            $this->createMock(ValueEncoderInterface::class),
+            $this->createMock(ValueDecoderInterface::class),
+            $value
+        );
+        self::assertSame($value, $result->get());
+    }
 }

tests/Processor/Result/NonExistingResultTest.php

@@ -27,11 +27,19 @@ public function testEncode_ConstructedWithSource_ThrowsMatchingException(): void
         $result->encode();
     }
 
-    public function testDencode_ConstructedWithSource_ThrowsMatchingException(): void
+    public function testDecode_ConstructedWithSource_ThrowsMatchingException(): void
     {
         $result = new NonExistingResult('a');
         $this->expectException(ResultNotFoundException::class);
         $this->expectExceptionMessage('\'a\'');
         $result->decode();
     }
+
+    public function testGet_ConstructedWithSource_ThrowsMatchingException(): void
+    {
+        $result = new NonExistingResult('a');
+        $this->expectException(ResultNotFoundException::class);
+        $this->expectExceptionMessage('\'a\'');
+        $result->get();
+    }
 }