[graphql] ModelHelper moved into new namaspace + tests.

Author: LastDragon-ru

src/ModelHelper.php renamed to src/Helpers/ModelHelper.php

@@ -1,6 +1,6 @@
 <?php declare(strict_types = 1);
 
-namespace LastDragon_ru\LaraASP\GraphQL;
+namespace LastDragon_ru\LaraASP\GraphQL\Helpers;
 
 use Illuminate\Database\Eloquent\Builder;
 use Illuminate\Database\Eloquent\Model;

src/Helpers/ModelHelperTest.php

@@ -0,0 +1,121 @@
+<?php declare(strict_types = 1);
+
+namespace LastDragon_ru\LaraASP\GraphQL\Helpers;
+
+use Closure;
+use Exception;
+use Illuminate\Database\Eloquent\Builder;
+use Illuminate\Database\Eloquent\Model;
+use Illuminate\Database\Eloquent\Relations\BelongsTo;
+use Illuminate\Database\Eloquent\Relations\HasOne;
+use LastDragon_ru\LaraASP\GraphQL\Testing\TestCase;
+use LastDragon_ru\LaraASP\Testing\Providers\ArrayDataProvider;
+use LastDragon_ru\LaraASP\Testing\Providers\CompositeDataProvider;
+use LastDragon_ru\LaraASP\Testing\Providers\Unknown;
+use LogicException;
+use stdClass;
+
+use function sprintf;
+
+/**
+ * @internal
+ * @coversDefaultClass \LastDragon_ru\LaraASP\GraphQL\Helpers\ModelHelper
+ */
+class ModelHelperTest extends TestCase {
+    // <editor-fold desc="Tests">
+    // =========================================================================
+    /**
+     * @covers ::getRelation
+     *
+     * @dataProvider dataProviderGetRelation
+     */
+    public function testGetRelation(Exception|string $expected, Closure $model, string $name): void {
+        if ($expected instanceof Exception) {
+            $this->expectExceptionObject($expected);
+        }
+
+        $this->assertInstanceOf($expected, (new ModelHelper($model()))->getRelation($name));
+    }
+    // </editor-fold>
+
+    // <editor-fold desc="DataProviders">
+    // =========================================================================
+    /**
+     * @return array<mixed>
+     */
+    public function dataProviderGetRelation(): array {
+        return (new CompositeDataProvider(
+            new ArrayDataProvider([
+                'model'   => [
+                    new Unknown(),
+                    static function (): Model {
+                        return new ModelHelperTest__Model();
+                    },
+                ],
+                'builder' => [
+                    new Unknown(),
+                    static function (): Builder {
+                        return (new ModelHelperTest__Model())->query();
+                    },
+                ],
+            ]),
+            new ArrayDataProvider([
+                'noTypeHint'  => [
+                    new LogicException(sprintf(
+                        'Property `%s` is not a relation.',
+                        'noTypeHint',
+                    )),
+                    'noTypeHint',
+                ],
+                'notRelation' => [
+                    new LogicException(sprintf(
+                        'Property `%s` is not a relation.',
+                        'notRelation',
+                    )),
+                    'notRelation',
+                ],
+                'union'       => [
+                    new LogicException(sprintf(
+                        'Property `%s` is not a relation.',
+                        'union',
+                    )),
+                    'union',
+                ],
+                'ok'          => [
+                    BelongsTo::class,
+                    'ok',
+                ],
+            ]),
+        ))->getData();
+    }
+    // </editor-fold>
+}
+
+// @phpcs:disable PSR1.Classes.ClassDeclaration.MultipleClasses
+// @phpcs:disable Squiz.Classes.ValidClassName.NotCamelCaps
+
+/**
+ * @internal
+ * @noinspection PhpMultipleClassesDeclarationsInOneFile
+ */
+class ModelHelperTest__Model extends Model {
+    /**
+     * @noinspection  PhpMissingReturnTypeInspection
+     * @phpcsSuppress SlevomatCodingStandard.TypeHints.ReturnTypeHint.MissingAnyTypeHint
+     */
+    public function noTypeHint() {
+        return $this->belongsTo(self::class);
+    }
+
+    public function notRelation(): stdClass {
+        return new stdClass();
+    }
+
+    public function union(): BelongsTo|HasOne {
+        return $this->belongsTo(self::class);
+    }
+
+    public function ok(): BelongsTo {
+        return $this->belongsTo(self::class);
+    }
+}

src/SearchBy/Operators/Complex/Relation.php

@@ -4,7 +4,7 @@
 
 use Illuminate\Database\Eloquent\Builder as EloquentBuilder;
 use Illuminate\Database\Query\Builder as QueryBuilder;
-use LastDragon_ru\LaraASP\GraphQL\ModelHelper;
+use LastDragon_ru\LaraASP\GraphQL\Helpers\ModelHelper;
 use LastDragon_ru\LaraASP\GraphQL\SearchBy\Contracts\OperatorNegationable;
 use LastDragon_ru\LaraASP\GraphQL\SearchBy\Operators\BaseOperator;
 use LastDragon_ru\LaraASP\GraphQL\SearchBy\SearchBuilder;

src/SortBy/SortBuilder.php

@@ -7,7 +7,7 @@
 use Illuminate\Database\Eloquent\Relations\HasOne;
 use Illuminate\Database\Eloquent\Relations\Relation;
 use Illuminate\Database\Query\Builder as QueryBuilder;
-use LastDragon_ru\LaraASP\GraphQL\ModelHelper;
+use LastDragon_ru\LaraASP\GraphQL\Helpers\ModelHelper;
 use LogicException;
 
 use function array_keys;