Adding missing tests for tryFrom* methods

Author: nyamsprod

CHANGELOG.md

@@ -7,6 +7,8 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 ### Added
 
 - Support for the `DisplayString` type
+- `ByteSequence::tryFromEncoded`
+- `Token::tryFromString`
 
 ### Fixed
 

src/DisplayString.php

@@ -6,6 +6,8 @@
 
 use Stringable;
 
+use Throwable;
+
 use function preg_match;
 use function preg_replace_callback;
 use function rawurldecode;
@@ -21,6 +23,15 @@ private function __construct(
     ) {
     }
 
+    public static function tryFromEncoded(Stringable|string $encodedValue): ?self
+    {
+        try {
+            return self::fromEncoded($encodedValue);
+        } catch (Throwable) {
+            return null;
+        }
+    }
+
     /**
      * Returns a new instance from a Base64 encoded string.
      */

src/Token.php

@@ -6,6 +6,8 @@
 
 use Stringable;
 
+use Throwable;
+
 use function preg_match;
 
 /**
@@ -25,6 +27,15 @@ public function toString(): string
         return $this->value;
     }
 
+    public static function tryFromString(Stringable|string $value): ?self
+    {
+        try {
+            return self::fromString($value);
+        } catch (Throwable) {
+            return null;
+        }
+    }
+
     public static function fromString(Stringable|string $value): self
     {
         return new self((string) $value);

tests/ByteSequenceTest.php

@@ -21,6 +21,13 @@ public function it_will_fail_on_invalid_decoded_string_with_inner_space(): void
         ByteSequence::fromEncoded('a a');
     }
 
+    #[Test]
+    public function it_will_return_null_on_invalid_encoded_string(): void
+    {
+        self::assertNull(ByteSequence::tryFromEncoded('a a'));
+        self::assertNull(ByteSequence::tryFromEncoded('aaaaa'));
+    }
+
     #[Test]
     public function it_will_fail_on_invalid_decoded_string(): void
     {

tests/DisplayStringTest.php

@@ -29,6 +29,13 @@ public function it_will_fail_on_invalid_decoded_string(): void
         DisplayString::fromEncoded('%c3%28"');
     }
 
+    #[Test]
+    public function it_will_return_null_on_invalid_encoded_string(): void
+    {
+        self::assertNull(DisplayString::tryFromEncoded('a %a'));
+        self::assertNull(DisplayString::tryFromEncoded('%c3%28"'));
+    }
+
     #[Test]
     public function it_can_decode_base64_field(): void
     {

tests/TokenTest.php

@@ -24,6 +24,13 @@ public function it_will_fail_on_invalid_token_string(string $httpValue): void
         Token::fromString($httpValue);
     }
 
+    #[Test]
+    #[DataProvider('invalidTokenString')]
+    public function it_will_return_null_on_invalid_encoded_string(string $httpValue): void
+    {
+        self::assertNull(Token::tryFromString($httpValue));
+    }
+
     /**
      * @return array<array{0:string}>
      */