rename create into new named constructor

Author: nyamsprod

CHANGELOG.md

@@ -16,6 +16,7 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 - `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.
+- `Parameters::new` and `Dictionary::new` to return a new and empty instance
 
 ### Fixed
 
@@ -32,6 +33,8 @@ All Notable changes to `bakame/http-strucured-fields` will be documented in this
 - **[BC Break]** `Value` interface use a combination of `ValueAccess` **and** `ParameterAccess` instead.
 - **[BC Break]** `Token::value` is no longer public use `Token::toString` instead.
 - **[BC Break]** `Item::from` is removed use `Item::fromAssociative` instead.
+- **[BC Break]** `Parameters::create` is removed use `Parameters::new` instead.
+- **[BC Break]** `Dictionary::create` is removed use `Dictionary::new` instead.
 
 ## [0.8.0] - 2023-03-12
 

README.md

@@ -273,15 +273,15 @@ echo $value;                //;b=?0;a=bar;c=@1671800423
 ```
 
 If the preference is to use the builder pattern, the same result can be achieved with the following steps.
-We start building a `Parameters` or a `Dictionary` instance using the `create` named constructor which
+We start building a `Parameters` or a `Dictionary` instance using the `new` named constructor which
 returns a new instance with no members.
 
 ```php
 use Bakame\Http\StructuredFields\Dictionary;
 use Bakame\Http\StructuredFields\Item;
 use Bakame\Http\StructuredFields\Token;
 
-$value = Dictionary::create()
+$value = Dictionary::new()
     ->add('a', Item::fromToken('bar'))
     ->prepend('b', Item::false())
     ->append('c', Item::fromDateString('2022-12-23 13:00:23'))

src/Dictionary.php

@@ -61,7 +61,7 @@ private static function filterMember(mixed $member): object
     /**
      * Returns a new instance.
      */
-    public static function create(): self
+    public static function new(): self
     {
         return new self();
     }

src/DictionaryTest.php

@@ -84,15 +84,15 @@ public function it_can_add_or_remove_members(): void
     #[Test]
     public function it_returns_the_same_object_if_no_member_is_removed(): void
     {
-        $instance = Dictionary::create();
+        $instance = Dictionary::new();
 
         self::assertSame($instance, $instance->remove('foo', 'bar', 'baz'));
     }
 
     #[Test]
     public function it_fails_to_return_an_member_with_invalid_key(): void
     {
-        $instance = Dictionary::create();
+        $instance = Dictionary::new();
 
         self::assertFalse($instance->has('foobar'));
 
@@ -104,7 +104,7 @@ public function it_fails_to_return_an_member_with_invalid_key(): void
     #[Test]
     public function it_fails_to_return_an_member_with_invalid_index(): void
     {
-        $instance = Dictionary::create();
+        $instance = Dictionary::new();
 
         self::assertFalse($instance->hasPair(1, 2, 3));
         self::assertFalse($instance->hasPair());
@@ -125,7 +125,7 @@ public function it_fails_to_add_an_item_with_wrong_key(): void
     #[Test]
     public function it_can_prepend_a_new_member(): void
     {
-        $instance = Dictionary::create()
+        $instance = Dictionary::new()
             ->append('a', Item::fromAssociative(false))
             ->prepend('b', Item::fromAssociative(true));
 
@@ -135,7 +135,7 @@ public function it_can_prepend_a_new_member(): void
     #[Test]
     public function it_can_returns_the_container_member_keys(): void
     {
-        $instance = Dictionary::create();
+        $instance = Dictionary::new();
 
         self::assertSame([], $instance->keys());
 
@@ -228,7 +228,7 @@ public function it_can_handle_string_with_comma(): void
     #[Test]
     public function it_can_delete_a_member_via_array_access(): void
     {
-        $structuredField = Dictionary::create();
+        $structuredField = Dictionary::new();
         $newInstance = $structuredField->add('foo', 'bar');
 
         self::assertTrue($newInstance->hasMembers());
@@ -240,7 +240,7 @@ public function it_fails_to_fetch_an_value_using_an_integer(): void
     {
         $this->expectException(StructuredFieldError::class);
 
-        Dictionary::create()->get(0);
+        Dictionary::new()->get(0);
     }
 
     #[Test]

src/InnerList.php

@@ -65,7 +65,7 @@ public static function fromHttpValue(Stringable|string $httpValue): self
      */
     public static function from(StructuredField|Token|ByteSequence|DateTimeInterface|Stringable|string|int|float|bool ...$members): self
     {
-        return new self(Parameters::create(), $members);
+        return new self(Parameters::new(), $members);
     }
 
     /**
@@ -153,7 +153,7 @@ public function withoutParameter(string ...$keys): static
 
     public function withoutAnyParameter(): static
     {
-        return $this->withParameters(Parameters::create());
+        return $this->withParameters(Parameters::new());
     }
 
     public function toHttpValue(): string

src/Item.php

@@ -94,7 +94,7 @@ public static function fromPair(array $pair): self
      */
     private static function fromValue(Value $value): self
     {
-        return new self($value, Parameters::create());
+        return new self($value, Parameters::new());
     }
 
     /**
@@ -287,6 +287,6 @@ public function withoutParameter(string ...$keys): static
 
     public function withoutAnyParameter(): static
     {
-        return $this->withParameters(Parameters::create());
+        return $this->withParameters(Parameters::new());
     }
 }

src/Parameters.php

@@ -59,7 +59,7 @@ private static function filterMember(mixed $member): object
     /**
      * Returns a new instance.
      */
-    public static function create(): self
+    public static function new(): self
     {
         return new self();
     }

src/ParametersTest.php

@@ -134,7 +134,7 @@ public function it_fails_to_return_an_member_with_invalid_key(): void
     {
         $this->expectException(InvalidOffset::class);
 
-        $instance = Parameters::create();
+        $instance = Parameters::new();
 
         self::assertFalse($instance->has('foobar', 'barbaz'));
         self::assertFalse($instance->has());
@@ -145,7 +145,7 @@ public function it_fails_to_return_an_member_with_invalid_key(): void
     #[Test]
     public function it_fails_to_return_an_member_with_invalid_index(): void
     {
-        $instance = Parameters::create();
+        $instance = Parameters::new();
 
         self::assertFalse($instance->hasPair(3));
 
@@ -157,7 +157,7 @@ public function it_fails_to_return_an_member_with_invalid_index(): void
     #[Test]
     public function it_can_prepend_a_new_member(): void
     {
-        $instance = Parameters::create()
+        $instance = Parameters::new()
             ->append('a', Item::fromAssociative(false))
             ->prepend('b', Item::fromAssociative(true));
 
@@ -168,11 +168,11 @@ public function it_can_prepend_a_new_member(): void
     #[Test]
     public function it_can_returns_the_container_member_keys(): void
     {
-        $instance = Parameters::create();
+        $instance = Parameters::new();
 
         self::assertSame([], $instance->keys());
 
-        $newInstance = Parameters::create()
+        $newInstance = Parameters::new()
             ->append('a', Item::fromAssociative(false))
             ->prepend('b', Item::fromAssociative(true));
 
@@ -276,7 +276,7 @@ public function it_successfully_parse_a_parameter_value_with_optional_white_spac
     #[Test]
     public function it_can_delete_a_member_via_array_access(): void
     {
-        $instance = Parameters::create()->add('foo', 'bar');
+        $instance = Parameters::new()->add('foo', 'bar');
 
         self::assertTrue($instance->hasMembers());
         self::assertFalse($instance->remove('foo')->hasMembers());
@@ -287,7 +287,7 @@ public function it_fails_to_fetch_an_value_using_an_integer(): void
     {
         $this->expectException(InvalidOffset::class);
 
-        Parameters::create()->get(0);
+        Parameters::new()->get(0);
     }
 
     #[Test]