Merge c939c80 into f12b207

CHANGELOG.md

@@ -8,6 +8,10 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 
 For a full diff see [`2.1.0...main`][2.1.0...main].
 
+## Added
+
+- Added `Specification` ([#50]), by [@localheinz]
+
 ## Removed
 
 - Removed `JsonPointers`  ([#48]), by [@localheinz]
@@ -67,5 +71,6 @@ For a full diff see [`a5ba52c...1.0.0`][a5ba52c...1.0.0].
 [#9]: https://github.com/ergebnis/json-pointer/pull/9
 [#17]: https://github.com/ergebnis/json-pointer/pull/17
 [#48]: https://github.com/ergebnis/json-pointer/pull/48
+[#50]: https://github.com/ergebnis/json-pointer/pull/50
 
 [@localheinz]: https://github.com/localheinz

src/Specification.php

@@ -0,0 +1,44 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Copyright (c) 2022 Andreas Möller
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE.md file that was distributed with this source code.
+ *
+ * @see https://github.com/ergebnis/json-pointer
+ */
+
+namespace Ergebnis\Json\Pointer;
+
+final class Specification
+{
+    /**
+     * @psalm-var \Closure(JsonPointer):bool
+     */
+    private \Closure $closure;
+
+    /**
+     * @param \Closure(JsonPointer):bool $closure
+     */
+    private function __construct(\Closure $closure)
+    {
+        $this->closure = $closure;
+    }
+
+    public function isSatisfiedBy(JsonPointer $jsonPointer): bool
+    {
+        $closure = $this->closure;
+
+        return $closure($jsonPointer);
+    }
+
+    public static function equals(JsonPointer $other): self
+    {
+        return new self(static function (JsonPointer $jsonPointer) use ($other) {
+            return $jsonPointer->equals($other);
+        });
+    }
+}

test/Unit/SpecificationTest.php

@@ -0,0 +1,54 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * Copyright (c) 2022 Andreas Möller
+ *
+ * For the full copyright and license information, please view
+ * the LICENSE.md file that was distributed with this source code.
+ *
+ * @see https://github.com/ergebnis/json-pointer
+ */
+
+namespace Ergebnis\Json\Pointer\Test\Unit;
+
+use Ergebnis\Json\Pointer\JsonPointer;
+use Ergebnis\Json\Pointer\Specification;
+use Ergebnis\Json\Pointer\Test;
+use PHPUnit\Framework;
+
+/**
+ * @internal
+ *
+ * @covers \Ergebnis\Json\Pointer\Specification
+ *
+ * @uses \Ergebnis\Json\Pointer\JsonPointer
+ * @uses \Ergebnis\Json\Pointer\ReferenceToken
+ */
+final class SpecificationTest extends Framework\TestCase
+{
+    use Test\Util\Helper;
+
+    public function testEqualsIsNotSatisifedByJsonPointerWhenJsonPointerDoesNotEqualOther(): void
+    {
+        $jsonPointer = JsonPointer::fromJsonString('/foo/bar/baz');
+
+        $other = JsonPointer::fromJsonString('/foo/bar');
+
+        $specification = Specification::equals($other);
+
+        self::assertFalse($specification->isSatisfiedBy($jsonPointer));
+    }
+
+    public function testEqualsIsSatisifedByJsonPointerWhenJsonPointerEqualsOther(): void
+    {
+        $jsonPointer = JsonPointer::fromJsonString('/foo/bar');
+
+        $other = JsonPointer::fromJsonString('/foo/bar');
+
+        $specification = Specification::equals($other);
+
+        self::assertTrue($specification->isSatisfiedBy($jsonPointer));
+    }
+}