Merge pull request #19 from maartenpaauw/feat/has-specifications-trait

Add has specifications trait

Author: maartenpaauw

CHANGELOG.md

@@ -8,6 +8,7 @@ All notable changes to `laravel-specification-pattern` will be documented in thi
 
 - Ability to make specification verbose using composite specification.
 - Exclusive or specification.
+- `HasSpecifications` trait.
 
 ## [v2.2.0] - 2024-03-13
 

src/HasSpecifications.php

@@ -0,0 +1,16 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Maartenpaauw\Specifications;
+
+trait HasSpecifications
+{
+    /**
+     * @param Specification<self> $specification
+     */
+    public function meets(Specification $specification): bool
+    {
+        return $specification->isSatisfiedBy($this);
+    }
+}

tests/HasSpecificationsTest.php

@@ -0,0 +1,27 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Maartenpaauw\Specifications\Tests;
+
+use Workbench\App\Candidate;
+use Workbench\App\NegativeSpecification;
+use Workbench\App\PositiveSpecification;
+
+/**
+ * @internal
+ *
+ * @small
+ */
+final class HasSpecificationsTest extends TestCase
+{
+    public function test_it_should_pass_the_candidate_to_the_specification(): void
+    {
+        // Arrange
+        $candidate = new Candidate();
+
+        // Act + Assert
+        $this->assertTrue($candidate->meets(new PositiveSpecification()));
+        $this->assertFalse($candidate->meets(new NegativeSpecification()));
+    }
+}

workbench/app/Candidate.php

@@ -0,0 +1,12 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Workbench\App;
+
+use Maartenpaauw\Specifications\HasSpecifications;
+
+final class Candidate
+{
+    use HasSpecifications;
+}