PHPLIB-1335 Add tests on Element Query Operators (mongodb#23)

* PHPLIB-1335 Add tests on Element Query Operators

* Make $type query operator variadic

Author: GromNaN

generator/config/query/exists.yaml

@@ -11,3 +11,21 @@ arguments:
         name: exists
         type:
             - bool
+tests:
+    -
+        name: 'Exists and Not Equal To'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/exists/#exists-and-not-equal-to'
+        pipeline:
+            -
+                $match:
+                    qty:
+                        $exists: true
+                        $nin: [5, 15]
+    -
+        name: 'Null Values'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/exists/#null-values'
+        pipeline:
+            -
+                $match:
+                    qty:
+                        $exists: true

generator/config/query/type.yaml

@@ -12,4 +12,77 @@ arguments:
         type:
             - int
             - string
-            - array # of int or string
+        variadic: array
+tests:
+    -
+        name: 'Querying by Data Type'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/type/#querying-by-data-type'
+        pipeline:
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 2
+                        $type: [2]
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'string'
+                        $type: ['string']
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 1
+                        $type: [1]
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'double'
+                        $type: ['double']
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'number'
+                        $type: ['number']
+    -
+        name: 'Querying by Multiple Data Type'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/type/#querying-by-multiple-data-type'
+        pipeline:
+            -
+                $match:
+                    zipCode:
+                        $type: [2, 1]
+            -
+                $match:
+                    zipCode:
+                        $type: ['string', 'double']
+    -
+        name: 'Querying by MinKey and MaxKey'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/type/#querying-by-minkey-and-maxkey'
+        pipeline:
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'minKey'
+                        $type: ['minKey']
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'maxKey'
+                        $type: ['maxKey']
+    -
+        name: 'Querying by Array Type'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/type/#querying-by-array-type'
+        pipeline:
+            -
+                $match:
+                    zipCode:
+                        # Example uses the short form, the builder always generated the verbose form
+                        # $type: 'array'
+                        $type: ['array']

src/Builder/Query/FactoryTrait.php

@@ -0,0 +1,43 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MongoDB\Tests\Builder\Query;
+
+use MongoDB\Builder\Pipeline;
+use MongoDB\Builder\Query;
+use MongoDB\Builder\Stage;
+use MongoDB\Tests\Builder\PipelineTestCase;
+
+/**
+ * Test $exists query
+ */
+class ExistsOperatorTest extends PipelineTestCase
+{
+    public function testExistsAndNotEqualTo(): void
+    {
+        $pipeline = new Pipeline(
+            Stage::match(
+                qty: [
+                    Query::exists(true),
+                    Query::nin([5, 15]),
+                ],
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::ExistsExistsAndNotEqualTo, $pipeline);
+    }
+
+    public function testNullValues(): void
+    {
+        $pipeline = new Pipeline(
+            Stage::match(
+                qty: [
+                    Query::exists(true),
+                ],
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::ExistsNullValues, $pipeline);
+    }
+}