Extend with Arguments which has a bunch of Arguments.

Author: panvid

README.md

@@ -103,4 +103,72 @@ $searchType = (new Type('search'))
 );
 
 echo (string) (new RootType('field'))->addSubType($searchType);
+```
+
+## Build complex types
+
+Its also possible to build complex types. This code examples show you how to do this.
+
+### Arguments with array of arguments
+
+Sometimes you want to have arrays with complex `Argument` types, like the following example.
+
+```graphql
+{
+  persons: [
+    {age: 30},
+    {age: 20},
+    {age: 12}
+  ]
+}
+``` 
+
+For this concept you can use the class `ArrayArgument` which give the possibility to add `Argument`s to an array.
+
+```php
+<?php
+declare(strict_types=1);
+
+use GraphQL\RequestBuilder\Argument;
+use GraphQL\RequestBuilder\ArrayArgument;
+
+$persons = new ArrayArgument(
+    'persons',
+    [new Argument('age', 30), new Argument('age', 20), new Argument('age', 12)]
+);
+```
+
+### Arrays with more than one Argument in value.
+
+The example above works if you have an `array` with only one `Argument`: every *person* only has one `Argument`, the
+*age*. If you want to have more `Argument`s you need to create an `Argument`with an empty name. 
+
+```graphql
+{
+  persons: [
+    {
+      name: "Hans",
+      age: 30
+    },
+    {
+      name: "Max",
+      age: 20
+    }
+  ]
+}
+```
+
+Your *PHP* code should look like this:
+
+```php
+<?php
+declare(strict_types=1);
+
+use GraphQL\RequestBuilder\Argument;
+use GraphQL\RequestBuilder\ArrayArgument;
+
+$person1 = new ArrayArgument('', [new Argument('name', 'Hans'), new Argument('age', 30)]);
+$person2 = new ArrayArgument('', [new Argument('name', 'Max'), new Argument('age', 20)]);
+
+$persons = new ArrayArgument('persons', [$person1, $person2]);
 ```

src/Argument.php

@@ -16,7 +16,7 @@
 class Argument implements ArgumentInterface
 {
     /** @var string Name of the argument. */
-    private $name;
+    protected $name;
 
     /** @var int|float|string|bool|Argument[]|Argument The value of the argument. */
     private $value;
@@ -67,7 +67,16 @@ public function __toString(): string
             default:
                 $value =  null;
         }
-        return $value === null ? '' : $this->name . ':' . $value;
+
+        if ($value === null) {
+            return '';
+        }
+
+        if ($this->name === '') {
+            return trim($value, '{}');
+        }
+
+        return $this->name . ':' . $value;
     }
 
     /**

src/ArrayArgument.php

@@ -18,8 +18,8 @@ protected function buildStringFromArray(array $values): ?string
     {
         $returnArray = [];
         foreach ($values as $value) {
-            $returnArray[] = '{' . (string) $value . '}';
+            $returnArray[] = $this->name === '' ? (string) $value : '{' . $value . '}';
         }
-        return '[' . implode(',', $returnArray) . ']';
+        return $this->name === '' ? implode(',', $returnArray) : '[' . implode(',', $returnArray) . ']';
     }
 }

tests/ArrayArgumentTest.php

@@ -19,6 +19,8 @@ class ArrayArgumentTest extends TestCase
     private const ARGUMENT_NAME_INNER_2 = 'argumentNameInner2';
     private const ARGUMENT_VALUE_INT_POSITIVE = 2;
     private const ARGUMENT_VALUE_STRING = 'argumentValueString';
+    private const ARGUMENT_KEY = 'argumentKey';
+    private const ARGUMENT_KEY2 = 'argumentKey2';
 
     public function testToStringArgumentArray(): void
     {
@@ -34,4 +36,24 @@ public function testToStringArgumentArray(): void
             'Setting array of Arguments should return correct string.'
         );
     }
+
+    public function testToStringArgumentAssociative(): void
+    {
+        $innerArgument = new ArrayArgument(
+            '',
+            [
+                new Argument(self::ARGUMENT_KEY, self::ARGUMENT_VALUE_INT_POSITIVE),
+                new Argument(self::ARGUMENT_KEY2, self::ARGUMENT_VALUE_STRING)
+            ]
+        );
+
+        $argument = new ArrayArgument(self::ARGUMENT_NAME, $innerArgument);
+
+        static::assertEquals(
+            self::ARGUMENT_NAME . ':[{' . self::ARGUMENT_KEY . ':' . self::ARGUMENT_VALUE_INT_POSITIVE . ','
+            . self::ARGUMENT_KEY2 . ':"' . self::ARGUMENT_VALUE_STRING . '"}]',
+            (string) $argument,
+            'Setting array of Arguments should return correct string.'
+        );
+    }
 }