feat: add dissatisfies method to has specifications trait

Author: maartenpaauw

src/HasSpecifications.php

@@ -14,6 +14,14 @@ public function satisfies(Specification $specification): bool
         return $specification->isSatisfiedBy($this);
     }
 
+    /**
+     * @param Specification<self> $specification
+     */
+    public function dissatisfies(Specification $specification): bool
+    {
+        return (new NotSpecification($specification))->isSatisfiedBy($this);
+    }
+
     /**
      * @deprecated use `satisfies()` instead
      *

tests/HasSpecificationsTest.php

@@ -23,5 +23,8 @@ public function test_it_should_pass_the_candidate_to_the_specification(): void
         // Act + Assert
         $this->assertTrue($candidate->satisfies(new PositiveSpecification()));
         $this->assertFalse($candidate->satisfies(new NegativeSpecification()));
+
+        $this->assertFalse($candidate->dissatisfies(new PositiveSpecification()));
+        $this->assertTrue($candidate->dissatisfies(new NegativeSpecification()));
     }
 }