Add string formats and validation tests

Author: wazabii8

src/Format/Str.php

@@ -153,14 +153,14 @@ public function compare(string|int|float|bool|null $compare): bool
     }
 
     /**
-     * Checks if a string ends with a given substring
+     * Checks if a string contains a given substring
      *
      * @param string $needle
      * @return bool
      */
-    public function endsWith(string $needle): bool
+    public function contains(string $needle): bool
     {
-        return str_ends_with($this->raw, $needle);
+        return str_contains($this->raw, $needle);
     }
 
     /**
@@ -173,6 +173,17 @@ public function startsWith(string $needle): bool
     {
         return str_starts_with($this->raw, $needle);
     }
+
+    /**
+     * Checks if a string ends with a given substring
+     *
+     * @param string $needle
+     * @return bool
+     */
+    public function endsWith(string $needle): bool
+    {
+        return str_ends_with($this->raw, $needle);
+    }
 
     // Return self -->
 
@@ -313,7 +324,7 @@ public function clearWhitespace(): self
      * @param bool $double_encode
      * @return self
      */
-    public function entityEncode(int $flags = ENT_QUOTES|ENT_SUBSTITUTE, ?string $encoding, bool $double_encode = true): self
+    public function entityEncode(int $flags = ENT_QUOTES|ENT_SUBSTITUTE, ?string $encoding = null, bool $double_encode = true): self
     {
         $this->raw = htmlentities($this->strVal(), $flags, $encoding, $double_encode);
         return $this;
@@ -326,7 +337,7 @@ public function entityEncode(int $flags = ENT_QUOTES|ENT_SUBSTITUTE, ?string $en
      * @param string|null $encoding
      * @return self
      */
-    public function entityDecode(int $flags = ENT_QUOTES|ENT_SUBSTITUTE, ?string $encoding): self
+    public function entityDecode(int $flags = ENT_QUOTES|ENT_SUBSTITUTE, ?string $encoding = null): self
     {
         $this->raw = html_entity_decode($this->strVal(), $flags, $encoding);
         return $this;

tests/unitary-dto-string.php

@@ -29,10 +29,10 @@
         "equal" => 'doe'
     ], "toLower: Failed");
 
-    $this->add($obj->content->str()->excerpt(50, "...")->get(), [
-        "equal" => 'doe'
-    ], "toLower: Failed");
-
+    $this->add($obj->content->str()->excerpt(50, "---")->get(), [
+        "length" => [53, 53],
+        "endsWith" => ['---'],
+    ], "excerpt: Failed");
 
 
 });