Improve exception messages

Author: nyamsprod

src/ByteSequence.php

@@ -23,12 +23,12 @@ public static function fromEncoded(Stringable|string $encodedValue): self
     {
         $encodedValue = (string) $encodedValue;
         if (1 !== preg_match('/^[a-z\d+\/=]*$/i', $encodedValue)) {
-            throw new SyntaxError('Invalid character in byte sequence');
+            throw new SyntaxError('Invalid character in byte sequence.');
         }
 
         $decoded = base64_decode($encodedValue, true);
         if (false === $decoded) {
-            throw new SyntaxError('Unable to base64 decode the byte sequence');
+            throw new SyntaxError('Unable to base64 decode the byte sequence.');
         }
 
         return new self($decoded);

src/Item.php

@@ -98,7 +98,7 @@ public static function fromToken(string|Stringable $value, iterable $parameters
     private static function filterDecimal(float $value): float
     {
         if (abs(floor($value)) > 999_999_999_999) {
-            throw new SyntaxError('Integer portion of decimals is limited to 12 digits');
+            throw new SyntaxError('Integer portion of decimals is limited to 12 digits.');
         }
 
         return $value;
@@ -126,7 +126,7 @@ private static function filterString(string $value): string
     private static function filterInteger(int $value): int
     {
         if ($value > 999_999_999_999_999 || $value < -999_999_999_999_999) {
-            throw new SyntaxError('Integers are limited to 15 digits');
+            throw new SyntaxError('Integers are limited to 15 digits.');
         }
 
         return $value;
@@ -186,7 +186,7 @@ private static function parseToken(string $string): array
     private static function parseBoolean(string $string): array
     {
         if (1 !== preg_match('/^\?[01]/', $string)) {
-            throw new SyntaxError("The HTTP textual representation \"$string\" for a boolean contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation \"$string\" for a Boolean contains invalid characters.");
         }
 
         return [$string[1] === '1', substr($string, 2)];
@@ -200,7 +200,7 @@ private static function parseBoolean(string $string): array
     private static function parseBytesSequence(string $string): array
     {
         if (1 !== preg_match('/^:(?<bytes>[a-z\d+\/=]*):/i', $string, $matches)) {
-            throw new SyntaxError("The HTTP textual representation \"$string\" for a byte sequence contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation \"$string\" for a Byte sequence contains invalid characters.");
         }
 
         return [ByteSequence::fromEncoded($matches['bytes']), substr($string, strlen($matches[0]))];
@@ -219,13 +219,13 @@ private static function parseNumber(string $string): array
         }
 
         if (1 !== preg_match('/'.$regexp.'/', $string, $found)) {
-            throw new SyntaxError("The HTTP textual representation \"$string\" for a number contains invalid characters.");
+            throw new SyntaxError("The HTTP textual representation \"$string\" for a Number contains invalid characters.");
         }
 
         $number = match (true) {
             1 === preg_match('/^-?\d{1,12}\.\d{1,3}$/', $found['number']) => (float) $found['number'],
             1 === preg_match('/^-?\d{1,15}$/', $found['number']) => (int) $found['number'],
-            default => throw new SyntaxError("The HTTP textual representation \"$string\" for a number contain too many digits."),
+            default => throw new SyntaxError("The HTTP textual representation \"$string\" for a Number contain too many digits."),
         };
 
         return [$number, substr($string, strlen($found['number']))];
@@ -256,19 +256,19 @@ private static function parseString(string $string): array
             }
 
             if ($string === '') {
-                throw new SyntaxError("The HTTP textual representation \"$originalString\" for a string contains an invalid end string.");
+                throw new SyntaxError("The HTTP textual representation \"$originalString\" for a String contains an invalid end string.");
             }
 
             $char = $string[0];
             $string = substr($string, 1);
             if (!in_array($char, ['"', '\\'], true)) {
-                throw new SyntaxError("The HTTP textual representation \"$originalString\" for a string contains invalid characters.");
+                throw new SyntaxError("The HTTP textual representation \"$originalString\" for a String contains invalid characters.");
             }
 
             $returnValue .= $char;
         }
 
-        throw new SyntaxError("The HTTP textual representation \"$originalString\" for a string contains an invalid end string.");
+        throw new SyntaxError("The HTTP textual representation \"$originalString\" for a String contains an invalid end string.");
     }
 
     /**

src/Parameters.php

@@ -115,7 +115,7 @@ public static function fromHttpValue(Stringable|string $httpValue): self
         foreach (explode(';', $httpValue) as $pair) {
             [$key, $value] = explode('=', $pair, 2) + [1 => '?1'];
             if (rtrim($key) !== $key || ltrim($value) !== $value) {
-                throw new SyntaxError('The HTTP textual representation "'.$pair.'" for a parameter pair contains invalid characters.');
+                throw new SyntaxError('The HTTP textual representation "'.$pair.'" for a Parameter pair contains invalid characters.');
             }
 
             $key = trim($key);
@@ -382,7 +382,7 @@ public function offsetUnset($offset): void
     public function offsetSet(mixed $offset, mixed $value): void
     {
         if (!is_string($offset)) {
-            throw new SyntaxError('The offset for a parameter member is expected to be a string; "'.gettype($offset).'" given.');
+            throw new SyntaxError('The offset for a Parameter member is expected to be a string; "'.gettype($offset).'" given.');
         }
 
         $this->set($offset, $value);

src/TestRecordCollection.php

@@ -30,7 +30,7 @@ private function __construct()
     public function add(TestRecord $test): void
     {
         if (isset($this->elements[$test->name])) {
-            throw new RuntimeException('Already existing test name `'.$test->name.'`');
+            throw new RuntimeException('Already existing test name `'.$test->name.'`.');
         }
 
         $this->elements[$test->name] = $test;

src/Token.php

@@ -12,7 +12,7 @@ final class Token
     private function __construct(public readonly string $value)
     {
         if (1 !== preg_match("/^([a-z*][a-z\d:\/!#\$%&'*+\-.^_`|~]*)$/i", $this->value)) {
-            throw new SyntaxError('Invalid characters in token');
+            throw new SyntaxError('Invalid characters in token.');
         }
     }