Feature/Implement PHP 8.x features. (#9)

Author: othercodes

.github/workflows/test.yml

@@ -12,7 +12,7 @@ jobs:
 
     strategy:
       matrix:
-        php-version: [ '8.1' ]
+        php-version: [ '8.1', '8.2', '8.3' ]
 
     steps:
       - name: Checkout source code

README.md

@@ -14,8 +14,7 @@ the functionality you need without compromising the essence of your own domain.
 Let's see a very basic example:
 
 ```php
-use ComplexHeart\Contracts\Domain\Model\ValueObject;
-use ComplexHeart\Domain\Model\Traits\IsValueObject;
+use ComplexHeart\Contracts\Domain\Model\ValueObject;use ComplexHeart\Domain\Model\IsValueObject;
 
 /**
  * Class Color

composer.json

@@ -1,30 +1,30 @@
 {
   "name": "complex-heart/domain-model",
-  "description": "Domain model toolset to properly build Value Objects, Entities, Aggregates and Services.",
+  "description": "Domain model toolset to properly build Value Objects, Entities and Aggregates.",
   "type": "library",
   "license": "Apache-2.0",
   "authors": [
     {
       "name": "Unay Santisteban",
-      "email": "usantisteban@othercode.es"
+      "email": "usantisteban@othercode.io"
     }
   ],
   "minimum-stability": "stable",
   "require": {
-    "php": "^8.1.0",
+    "php": "^8.0",
     "ext-json": "*",
     "ramsey/uuid": "^4.1",
     "nesbot/carbon": "^2.40",
-    "illuminate/collections": "^9.0.0",
+    "illuminate/collections": "^9.0.0|^10.0",
     "lambdish/phunctional": "^2.1",
-    "doctrine/instantiator": "^1.4",
-    "complex-heart/contracts": "^1.0.0"
+    "doctrine/instantiator": "^1.0|^2.0",
+    "complex-heart/contracts": "^1.0"
   },
   "require-dev": {
-    "pestphp/pest": "^1.22.3",
-    "pestphp/pest-plugin-mock": "^1.0.0",
-    "pestphp/pest-plugin-faker": "^1.0.0",
-    "phpstan/phpstan": "^1.9.0"
+    "pestphp/pest": "^1.0|^2.0",
+    "pestphp/pest-plugin-mock": "^1.0|^2.0",
+    "pestphp/pest-plugin-faker": "^1.0|^2.0",
+    "phpstan/phpstan": "^1.0"
   },
   "autoload": {
     "psr-4": {

phpunit.xml

@@ -2,12 +2,9 @@
 <phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          bootstrap="vendor/autoload.php"
          colors="true"
-         verbose="true"
-         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.3/phpunit.xsd">
-    <coverage processUncoveredFiles="true">
-        <include>
-            <directory suffix=".php">./src</directory>
-        </include>
+         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/10.5/phpunit.xsd"
+         cacheDirectory=".phpunit.cache">
+    <coverage>
         <report>
             <clover outputFile="./coverage.xml"/>
         </report>
@@ -18,4 +15,9 @@
         </testsuite>
     </testsuites>
     <logging/>
+    <source>
+        <include>
+            <directory suffix=".php">./src</directory>
+        </include>
+    </source>
 </phpunit>

src/Errors/ImmutabilityError.php

@@ -0,0 +1,18 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ComplexHeart\Domain\Model\Errors;
+
+use Error;
+
+/**
+ * Class ImmutabilityError
+ *
+ * @author Unay Santisteban <usantisteban@othercode.io>
+ * @package ComplexHeart\Domain\Model\Errors
+ */
+class ImmutabilityError extends Error
+{
+
+}

src/Exceptions/ImmutableException.php

@@ -9,7 +9,7 @@
 /**
  * Class InstantiationException
  *
- * @author Unay Santisteban <usantisteban@othercode.es>
+ * @author Unay Santisteban <usantisteban@othercode.io>
  * @package ComplexHeart\Domain\Model\Exceptions
  */
 class InstantiationException extends RuntimeException

src/Exceptions/InstantiationException.php

@@ -9,7 +9,7 @@
 /**
  * Class InvariantViolation
  *
- * @author Unay Santisteban <usantisteban@othercode.es>
+ * @author Unay Santisteban <usantisteban@othercode.io>
  * @package ComplexHeart\Domain\Model\Exceptions
  */
 class InvariantViolation extends Exception

src/Exceptions/InvariantViolation.php

@@ -2,7 +2,9 @@
 
 declare(strict_types=1);
 
-namespace ComplexHeart\Domain\Model\Traits;
+namespace ComplexHeart\Domain\Model;
+
+use ComplexHeart\Domain\Model\Traits\HasDomainEvents;
 
 /**
  * Trait IsAggregate
@@ -13,34 +15,13 @@
  * @see https://martinfowler.com/bliki/DDD_Aggregate.html
  * @see https://martinfowler.com/bliki/EvansClassification.html
  *
- * @author Unay Santisteban <usantisteban@othercode.es>
+ * @author Unay Santisteban <usantisteban@othercode.io>
  * @package ComplexHeart\Domain\Model\Traits
  */
 trait IsAggregate
 {
     use HasDomainEvents;
-    use IsEntity {
-        withOverrides as private overrideEntity;
-    }
-
-    /**
-     * Creates a new instance overriding the given attributes and
-     * propagating the domain events to the new instance.
-     *
-     * @param  array<string, mixed>  $overrides
-     *
-     * @return static
-     */
-    protected function withOverrides(array $overrides): static
-    {
-        $new = $this->overrideEntity($overrides);
-
-        foreach ($this->_domainEvents as $event) {
-            $new->registerDomainEvent($event);
-        }
-
-        return $new;
-    }
+    use IsEntity;
 
     /**
      * This method is called by var_dump() when dumping an object to

src/Traits/IsAggregate.php src/IsAggregate.phpsrc/Traits/IsAggregate.php renamed to src/IsAggregate.php

@@ -0,0 +1,28 @@
+<?php
+
+declare(strict_types=1);
+
+namespace ComplexHeart\Domain\Model;
+
+use ComplexHeart\Domain\Model\Traits\HasEquality;
+use ComplexHeart\Domain\Model\Traits\HasIdentity;
+
+/**
+ * Trait IsEntity
+ *
+ * > Objects that have a distinct identity that runs through time and different representations.
+ * > -- Martin Fowler
+ *
+ * @see https://martinfowler.com/bliki/EvansClassification.html
+ *
+ * @author Unay Santisteban <usantisteban@othercode.io>
+ * @package ComplexHeart\Domain\Model\Traits
+ */
+trait IsEntity
+{
+    use IsModel;
+    use HasIdentity;
+    use HasEquality {
+        HasIdentity::hash insteadof HasEquality;
+    }
+}