PHPLIB-1341 Add tests on Miscellaneous Query Operators

generator/config/query/comment.yaml

@@ -11,3 +11,21 @@ arguments:
         name: comment
         type:
             - string
+tests:
+    -
+        name: 'Attach a Comment to an Aggregation Expression'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/comment/#attach-a-comment-to-an-aggregation-expression'
+        pipeline:
+            -
+                $match:
+                    x:
+                        $gt: 0
+                    $comment: 'Don''t allow negative inputs.'
+            -
+                $group:
+                    _id:
+                        $mod:
+                            - '$x'
+                            - 2
+                    total:
+                        $sum: '$x'

generator/config/query/rand.yaml

@@ -6,3 +6,21 @@ type:
 encode: object
 description: |
     Generates a random float between 0 and 1.
+tests:
+    -
+        name: 'Select Random Items From a Collection'
+        link: 'https://www.mongodb.com/docs/manual/reference/operator/query/rand/#select-random-items-from-a-collection'
+        pipeline:
+            -
+                $match:
+                    district: 3
+                    $expr:
+                        $lt:
+                            - 0.5
+                            -
+                                $rand: {}
+            -
+                $project:
+                    _id: 0
+                    name: 1
+                    registered: 1

generator/js2yaml.html

@@ -124,7 +124,7 @@ <h1>Convert JS examples into Yaml</h1>
             case 'boolean':
                 return object ? ' true' : ' false';
             case 'string':
-                return " '" + object.replace(/'/g, "\\'") + "'";
+                return " '" + object.replace(/'/g, "''") + "'";
             case 'number':
                 return ' ' + object.toString();
             case 'object':

tests/Builder/Query/CommentOperatorTest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MongoDB\Tests\Builder\Query;
+
+use MongoDB\Builder\Accumulator;
+use MongoDB\Builder\Expression;
+use MongoDB\Builder\Pipeline;
+use MongoDB\Builder\Query;
+use MongoDB\Builder\Stage;
+use MongoDB\Tests\Builder\PipelineTestCase;
+
+/**
+ * Test $comment query
+ */
+class CommentOperatorTest extends PipelineTestCase
+{
+    public function testAttachACommentToAnAggregationExpression(): void
+    {
+        $pipeline = new Pipeline(
+            Stage::match(
+                Query::comment('Don\'t allow negative inputs.'),
+                x: Query::gt(0),
+            ),
+            Stage::group(
+                _id: Expression::mod(
+                    Expression::numberFieldPath('x'),
+                    2,
+                ),
+                total: Accumulator::sum(
+                    Expression::numberFieldPath('x'),
+                ),
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::CommentAttachACommentToAnAggregationExpression, $pipeline);
+    }
+}

tests/Builder/Query/RandOperatorTest.php

@@ -0,0 +1,39 @@
+<?php
+
+declare(strict_types=1);
+
+namespace MongoDB\Tests\Builder\Query;
+
+use MongoDB\Builder\Expression;
+use MongoDB\Builder\Pipeline;
+use MongoDB\Builder\Query;
+use MongoDB\Builder\Stage;
+use MongoDB\Tests\Builder\PipelineTestCase;
+
+/**
+ * Test $rand query
+ */
+class RandOperatorTest extends PipelineTestCase
+{
+    public function testSelectRandomItemsFromACollection(): void
+    {
+        $pipeline = new Pipeline(
+            Stage::match(
+                Query::expr(
+                    Expression::lt(
+                        0.5,
+                        Expression::rand(),
+                    ),
+                ),
+                district: 3,
+            ),
+            Stage::project(
+                _id: 0,
+                name: 1,
+                registered: 1,
+            ),
+        );
+
+        $this->assertSamePipeline(Pipelines::RandSelectRandomItemsFromACollection, $pipeline);
+    }
+}