Adding missing Item::fromString named constructor

Author: nyamsprod

CHANGELOG.md

@@ -13,6 +13,7 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 - `Item::toPair` to complement `Item::fromPair`;
 - `Item::fromDate` to improve and complete the Item Date public API;
 - `Item::fromAssociative` to improve Item public API;
+- `Item::fromString` to improve Item public API;
 - `Value` internal class to improve Item public API;
 - `Token::toString` to return the string representation of the token.
 

README.md

@@ -218,9 +218,10 @@ bare items (ie: item without parameters attached to them).
 ```php
 use Bakame\Http\StructuredFields\Item;
 
-Item::fromDecodedByteSequence(string $value): self;
-Item::fromEncodedByteSequence(string $value): self;
-Item::fromToken(string $value): self;
+Item::fromDecodedByteSequence(Stringable|string $value): self;
+Item::fromEncodedByteSequence(Stringable|string $value): self;
+Item::fromToken(Stringable|string $value): self;
+Item::fromString(Stringable|string $value): self;
 Item::fromTimestamp(int $value): self;
 Item::fromDateFormat(string $format, string $datetime): self;
 Item::fromDateString(string $datetime, DateTimeZone|string|null $timezone = null): self;

src/Item.php

@@ -97,6 +97,14 @@ private static function fromValue(Value $value): self
         return new self($value, Parameters::create());
     }
 
+    /**
+     * Returns a new instance from a string.
+     */
+    public static function fromString(Stringable|string $value): self
+    {
+        return self::fromValue(Value::fromString($value));
+    }
+
     /**
      * Returns a new instance from an encoded byte sequence and an iterable of key-value parameters.
      */

src/ItemTest.php

@@ -243,7 +243,7 @@ public function it_instantiates_a_binary(): void
     #[Test]
     public function it_instantiates_a_string(): void
     {
-        self::assertSame('"foobar"', Item::fromAssociative('foobar')->toHttpValue());
+        self::assertSame('"foobar"', Item::fromString('foobar')->toHttpValue());
     }
 
     #[Test]

src/Value.php

@@ -182,6 +182,11 @@ public static function fromInteger(int|float $value): self
         return new self((int) $value);
     }
 
+    public static function fromString(Stringable|string $value): self
+    {
+        return new self($value);
+    }
+
     public static function true(): self
     {
         return new self(true);