feat: add orNot and andNot method

Author: maartenpaauw

src/CompositeSpecification.php

@@ -31,6 +31,16 @@ public function or(Specification $specification): CompositeSpecification
         ]);
     }
 
+    /**
+     * @param Specification<TCandidate> $specification
+     *
+     * @return CompositeSpecification<TCandidate>
+     */
+    public function orNot(Specification $specification): CompositeSpecification
+    {
+        return $this->or(new NotSpecification($specification));
+    }
+
     /**
      * @param Specification<TCandidate> $specification
      *
@@ -43,4 +53,14 @@ public function and(Specification $specification): CompositeSpecification
             $specification,
         ]);
     }
+
+    /**
+     * @param Specification<TCandidate> $specification
+     *
+     * @return CompositeSpecification<TCandidate>
+     */
+    public function andNot(Specification $specification): CompositeSpecification
+    {
+        return $this->and(new NotSpecification($specification));
+    }
 }

tests/CompositeSpecificationTest.php

@@ -44,7 +44,7 @@ public function it_should_return_true_when_chaining_the_specification_twice(): v
     }
 
     /** @test */
-    public function it_should_return_true_when_chaining_a_satisied_and_a_dissatisfied_or_specification(): void
+    public function it_should_return_true_when_chaining_a_satisfied_and_a_dissatisfied_or_specification(): void
     {
         // Act
         $satisfied = $this->specification
@@ -70,7 +70,19 @@ public function it_should_return_true_when_combining_an_inverting_not_method_wit
     }
 
     /** @test */
-    public function it_should_return_true_when_chaining_multiple_satisied_and_specifications(): void
+    public function it_should_be_possible_to_chain_the_or_not_specification(): void
+    {
+        // Act
+        $satisfied = (new NegativeSpecification())
+            ->orNot(new NegativeSpecification())
+            ->isSatisfiedBy(null);
+
+        // Assert
+        $this->assertTrue($satisfied);
+    }
+
+    /** @test */
+    public function it_should_return_true_when_chaining_multiple_satisfied_and_specifications(): void
     {
         // Act
         $satisfied = $this->specification
@@ -82,4 +94,16 @@ public function it_should_return_true_when_chaining_multiple_satisied_and_specif
         // Assert
         $this->assertTrue($satisfied);
     }
+
+    /** @test */
+    public function it_should_be_possible_to_chain_the_and_not_specification(): void
+    {
+        // Act
+        $satisfied = $this->specification
+            ->andNot(new NegativeSpecification())
+            ->isSatisfiedBy(null);
+
+        // Assert
+        $this->assertTrue($satisfied);
+    }
 }