Support implicit struct array validation

Author: Seif Kamal

README.md

@@ -79,7 +79,36 @@ echo "File: {$directory['file']}" . PHP_EOL;
 // File: /Users/seifkamal/src/struct-array/README.md
 ```
 
-Here's the same one using static class methods:
+You can also just use an array directly, without creating a `Struct`:
+
+```php
+<?php
+
+use function SK\StructArray\{
+    arrayOf, optional, not, validate
+};
+
+$directory = [...];
+
+validate($directory, [
+    'path' => 'is_dir',
+    'file' => optional('is_file', __DIR__ . '/README.md'),
+    'content' => arrayOf([
+        'header' => 'is_string',
+        'line' => not('is_null'),
+    ]),
+]);
+```
+
+This is tailored for quick usage, and therefore assumes the defined interface is non-exhaustive
+(ie. the array submitted for validation is allowed to have keys that aren't defined here). It also
+means error messages will be more generic, ie you'll see:
+> Struct failed validation. ...
+
+instead of:
+> Directory failed validation. ...
+
+Here's another example directly using the static class methods:
 
 ```php
 <?php

src/Struct.php

@@ -33,6 +33,17 @@ public static function of(
         return $struct;
     }
 
+    /**
+     * @internal
+     *
+     * @param array $interface
+     * @return static
+     */
+    public static function default(array $interface): self
+    {
+        return static::of('Struct', $interface, false);
+    }
+
     public function name(): string
     {
         return $this->name;

src/Validator.php

@@ -8,13 +8,17 @@ class Validator
 {
     /**
      * @param array $data
-     * @param Struct $struct
+     * @param array|Struct $struct If an array is supplied, a generic, non-exhaustive Struct is used.
      * @return bool
      * @throws Exception\StructValidationException
      */
-    public static function validate(array &$data, Struct $struct): bool
+    public static function validate(array &$data, $struct): bool
     {
         try {
+            if (is_array($struct)) {
+                $struct = Struct::default($struct);
+            }
+
             $unexpectedProperties = array_diff_key($data, $struct->interface());
             if ($struct->isExhaustive() && !empty($unexpectedProperties)) {
                 throw new Exception\UnexpectedPropertyException(...array_keys($unexpectedProperties));
@@ -41,6 +45,9 @@ public static function validate(array &$data, Struct $struct): bool
                     throw new Exception\MissingPropertyException($field);
                 }
 
+                if (is_array($validator)) {
+                    $validator = Struct::default($validator);
+                }
                 if (is_a($validator, Struct::class)) {
                     if (!validate($value, $validator)) {
                         throw new Exception\InvalidValueException($field);

src/functions.php

@@ -91,11 +91,11 @@ function struct(string $name, array $interface, bool $exhaustive = true): Struct
  * @see Validator::validate()
  *
  * @param array $data
- * @param Struct $struct
+ * @param array|Struct $struct If an array is supplied, a generic, non-exhaustive Struct is used.
  * @return bool
  * @throws Exception\StructValidationException
  */
-function validate(array &$data, Struct $struct): bool
+function validate(array &$data, $struct): bool
 {
     return Validator::validate($data, $struct);
 }

tests/Unit/StructTest.php

@@ -3,7 +3,6 @@
 namespace SK\StructArray\Test\Unit;
 
 use PHPUnit\Framework\TestCase;
-use SK\StructArray\Exception;
 use SK\StructArray\Exception\StructValidationException;
 use SK\StructArray\Property\Type;
 use SK\StructArray\Struct;
@@ -15,42 +14,64 @@ class StructTest extends TestCase
     /**
      * @dataProvider dataProviderForTest
      */
-    public function test($data, $interface, $exhaustive, $expectedException)
+    public function test($data, $struct, $expectedException)
     {
         if ($expectedException) {
             $this->expectException(StructValidationException::class);
         }
 
-        $this->assertTrue(validate($data, Struct::of('Test', $interface, $exhaustive)));
+        $this->assertTrue(validate($data, $struct));
     }
 
     public function dataProviderForTest(): array
     {
+        $name = 'Test';
         return [
             [
                 ['name' => 'toasty',],
-                ['name' => 'invalid validator'],
-                true,
+                Struct::of($name, ['name' => 'invalid validator'], true),
                 true,
             ],
             [
                 ['name' => 10],
-                ['name' => 'is_string'],
-                true,
+                Struct::of($name, ['name' => 'is_string'], true),
                 true,
             ],
             [
                 [],
-                ['name' => 'is_string'],
-                true,
+                Struct::of($name, ['name' => 'is_string'], true),
                 true,
             ],
             [
                 ['name' => 'toasty', 'age' => 10],
-                ['name' => 'is_string'],
-                true,
+                Struct::of($name, ['name' => 'is_string'], true),
                 true,
             ],
+            [
+                [
+                    'id' => '123',
+                    'type' => 'theatre',
+                    'date' => new \DateTime(),
+                    'price' => [
+                        'value' => 20.5,
+                        'currency' => 'GBP',
+                    ],
+                    'tickets' => ['General', 10],
+                    'onSale' => true,
+                    'artist' => 'some guy',
+                ],
+                Struct::of($name, [
+                    'id' => Type::allOf('is_string', 'is_numeric'),
+                    'type' => 'is_string',
+                    'date' => Type::anyOf(Type::classOf(\DateTime::class), 'is_null'),
+                    'price' => Struct::of('Price', [
+                        'value' => 'is_float',
+                        'currency' => 'is_string'
+                    ]),
+                    'tickets' => Type::arrayOf(Type::not('is_null')),
+                ], false),
+                null
+            ],
             [
                 [
                     'id' => '123',
@@ -74,7 +95,6 @@ public function dataProviderForTest(): array
                     ]),
                     'tickets' => Type::arrayOf(Type::not('is_null')),
                 ],
-                false,
                 null
             ],
         ];