Make the Expression $because be empty by default

This will make it easier to use in cases where we can not provide a
reason, namely in automatically built rules.
The system is already prepared to receive an empty reason, and
will not write the "because" word in the output.

Author: hgraca

src/Expression/Boolean/Andx.php

@@ -21,7 +21,7 @@ public function __construct(Expression ...$expressions)
         $this->expressions = $expressions;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         $expressionsDescriptions = [];
         foreach ($this->expressions as $expression) {
@@ -34,7 +34,7 @@ public function describe(ClassDescription $theClass, string $because): Descripti
         return new Description($expressionsDescriptionsString, $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         foreach ($this->expressions as $expression) {
             $newViolations = new Violations();

src/Expression/Boolean/Not.php

@@ -21,12 +21,12 @@ public function __construct(Expression $expression)
         $this->expression = $expression;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         return new Description('must NOT ('.$this->expression->describe($theClass, '')->toString().')', $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         $newViolations = new Violations();
         $this->expression->evaluate($theClass, $newViolations, $because);

src/Expression/Boolean/Orx.php

@@ -20,7 +20,7 @@ public function __construct(Expression ...$expressions)
         $this->expressions = $expressions;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         $expressionsDescriptions = [];
         foreach ($this->expressions as $expression) {
@@ -31,7 +31,7 @@ public function describe(ClassDescription $theClass, string $because): Descripti
         return new Description($expressionsDescriptionsString, $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         if (0 === \count($this->expressions)) {
             return;

src/Expression/Expression.php

@@ -15,14 +15,14 @@
 interface Expression
 {
     /**
-     * Returns a human readable description of the expression
+     * Returns a human-readable description of the expression
      * $theClass can be used to add contextual information.
      */
-    public function describe(ClassDescription $theClass, string $because): Description;
+    public function describe(ClassDescription $theClass, string $because = ''): Description;
 
     /**
      * Evaluates the expression for the class passed as parameter.
-     * It should adds violations if rule is violated.
+     * It should add violations if rule is violated.
      */
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void;
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void;
 }

src/Expression/ForClasses/ContainDocBlockLike.php

@@ -21,12 +21,12 @@ public function __construct(string $docBlock)
         $this->docBlock = $docBlock;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         return new Description("should have a doc block that contains {$this->docBlock}", $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         if (!$theClass->containsDocBlock($this->docBlock)) {
             $violation = Violation::create(

src/Expression/ForClasses/DependsOnlyOnTheseExpressions.php

@@ -31,7 +31,7 @@ public function __construct(Expression ...$expressions)
         }
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         $expressionsDescriptions = '';
         foreach ($this->expressions as $expression) {
@@ -45,7 +45,7 @@ public function describe(ClassDescription $theClass, string $because): Descripti
         );
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         $dependencies = $this->removeDuplicateDependencies($theClass->getDependencies());
 

src/Expression/ForClasses/DependsOnlyOnTheseNamespaces.php

@@ -22,14 +22,14 @@ public function __construct(string ...$namespace)
         $this->namespaces = $namespace;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         $desc = implode(', ', $this->namespaces);
 
         return new Description("should depend only on classes in one of these namespaces: $desc", $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         $dependencies = $theClass->getDependencies();
 

src/Expression/ForClasses/Extend.php

@@ -21,12 +21,12 @@ public function __construct(string $className)
         $this->className = $className;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         return new Description("should extend {$this->className}", $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         $extends = $theClass->getExtends();
 

src/Expression/ForClasses/HaveAttribute.php

@@ -20,12 +20,12 @@ public function __construct(string $attribute)
         $this->attribute = $attribute;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         return new Description("should have the attribute {$this->attribute}", $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         if ($theClass->hasAttribute($this->attribute)) {
             return;

src/Expression/ForClasses/HaveCorrespondingUnit.php

@@ -20,14 +20,14 @@ public function __construct(\Closure $inferFqnFunction)
         $this->inferFqnFunction = $inferFqnFunction;
     }
 
-    public function describe(ClassDescription $theClass, string $because): Description
+    public function describe(ClassDescription $theClass, string $because = ''): Description
     {
         $correspondingFqn = $this->inferCorrespondingFqn($theClass);
 
         return new Description("should have a matching unit named: '$correspondingFqn'", $because);
     }
 
-    public function evaluate(ClassDescription $theClass, Violations $violations, string $because): void
+    public function evaluate(ClassDescription $theClass, Violations $violations, string $because = ''): void
     {
         $correspondingFqn = $this->inferCorrespondingFqn($theClass);