PHPLIB-1254 Create Yaml for all operators and stages

generator/composer.json

@@ -18,6 +18,9 @@
         "mongodb/mongodb": "@dev",
         "nette/php-generator": "^4",
         "symfony/console": "^6.3",
+        "symfony/css-selector": "^6.3",
+        "symfony/dom-crawler": "^6.3",
+        "symfony/finder": "^6.3",
         "symfony/yaml": "^6.3"
     },
     "license": "Apache-2.0",

generator/config/aggregation-operators/abs.yaml

@@ -0,0 +1,15 @@
+# $schema: ../schema.json
+name: $abs
+category:
+    - 'Arithmetic Expression'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/abs/'
+type:
+    - resolvesToNumber
+encode: single
+description: |
+    Returns the absolute value of a number.
+arguments:
+    -
+        name: value
+        type:
+            - resolvesToNumber

generator/config/aggregation-operators/accumulator.yaml

@@ -0,0 +1,57 @@
+# $schema: ../schema.json
+name: $accumulator
+category:
+    - Accumulators
+    - 'Custom Aggregation Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/accumulator/'
+type:
+    - Accumulator
+encode: object
+description: |
+    Defines a custom accumulator function.
+    New in version 4.4.
+arguments:
+    -
+        name: init
+        type:
+            - string
+        description: |
+            Function used to initialize the state. The init function receives its arguments from the initArgs array expression. You can specify the function definition as either BSON type Code or String.
+    -
+        name: initArgs
+        type:
+            - resolvesToArray
+        optional: true
+        description: |
+            Arguments passed to the init function.
+    -
+        name: accumulate
+        type:
+            - string
+        description: |
+            Function used to accumulate documents. The accumulate function receives its arguments from the current state and accumulateArgs array expression. The result of the accumulate function becomes the new state. You can specify the function definition as either BSON type Code or String.
+    -
+        name: accumulateArgs
+        type:
+            - resolvesToArray
+        description: |
+            Arguments passed to the accumulate function. You can use accumulateArgs to specify what field value(s) to pass to the accumulate function.
+    -
+        name: merge
+        type:
+            - string
+        description: |
+            Function used to merge two internal states. merge must be either a String or Code BSON type. merge returns the combined result of the two merged states. For information on when the merge function is called, see Merge Two States with $merge.
+    -
+        name: finalize
+        type:
+            - string
+        optional: true
+        description: |
+            Function used to update the result of the accumulation.
+    -
+        name: lang
+        type:
+            - string
+        description: |
+            The language used in the $accumulator code.

generator/config/aggregation-operators/acos.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $acos
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/acos/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse cosine (arc cosine) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $acos takes any valid expression that resolves to a number between -1 and 1, e.g. -1 <= value <= 1.
+            $acos returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $acos returns values as a double. $acos can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/acosh.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $acosh
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/acosh/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse hyperbolic cosine (hyperbolic arc cosine) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $acosh takes any valid expression that resolves to a number between 1 and +Infinity, e.g. 1 <= value <= +Infinity.
+            $acosh returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $acosh returns values as a double. $acosh can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/add.yaml

@@ -0,0 +1,21 @@
+# $schema: ../schema.json
+name: $add
+category:
+    - 'Arithmetic Expression Operator'
+    - 'Date Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/add/'
+type:
+    - resolvesToNumber
+    - resolvesToDate
+encode: array
+description: |
+    Adds numbers to return the sum, or adds numbers and a date to return a new date. If adding numbers and a date, treats the numbers as milliseconds. Accepts any number of argument expressions, but at most, one expression can resolve to a date.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+            - resolvesToDate
+        variadic: array
+        description: |
+            The arguments can be any valid expression as long as they resolve to either all numbers or to numbers and a date.

generator/config/aggregation-operators/addToSet.yaml

@@ -0,0 +1,18 @@
+# $schema: ../schema.json
+name: $addToSet
+category:
+    - Accumulators
+    - 'Window Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/addToSet/'
+type:
+    - Accumulator
+encode: single
+description: |
+    Returns an array of unique expression values for each group. Order of the array elements is undefined.
+    Changed in version 5.0: Available in the $setWindowFields stage.
+arguments:
+    -
+        name: expression
+        type:
+            - expression
+            - fieldPath

generator/config/aggregation-operators/allElementsTrue.yaml

@@ -0,0 +1,16 @@
+# $schema: ../schema.json
+name: $allElementsTrue
+category:
+    - 'Set Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/allElementsTrue/'
+type:
+    - resolvesToBool
+encode: array
+description: |
+    Returns true if no element of a set evaluates to false, otherwise, returns false. Accepts a single argument expression.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToArray
+        variadic: array

generator/config/aggregation-operators/and.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $and
+category:
+    - 'Boolean Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/and/'
+type:
+    - resolvesToBool
+encode: single
+description: |
+    Returns true only when all its expressions evaluate to true. Accepts any number of argument expressions.
+arguments:
+    -
+        name: expression
+        type:
+            - expression
+            - resolvesToBool
+            - resolvesToNumber
+            - resolvesToString
+            - resolvesToNull
+        variadic: array

generator/config/aggregation-operators/anyElementTrue.yaml

@@ -0,0 +1,15 @@
+# $schema: ../schema.json
+name: $anyElementTrue
+category:
+    - 'Set Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/anyElementTrue/'
+type:
+    - resolvesToBool
+encode: array
+description: |
+    Returns true if any elements of a set evaluate to true; otherwise, returns false. Accepts a single argument expression.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToArray

generator/config/aggregation-operators/arrayElemAt.yaml

@@ -0,0 +1,19 @@
+# $schema: ../schema.json
+name: $arrayElemAt
+category:
+    - 'Array Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/arrayElemAt/'
+type:
+    - resolvesToAnything
+encode: array
+description: |
+    Returns the element at the specified array index.
+arguments:
+    -
+        name: array
+        type:
+            - resolvesToArray
+    -
+        name: idx
+        type:
+            - resolvesToInt

generator/config/aggregation-operators/arrayToObject.yaml

@@ -0,0 +1,15 @@
+# $schema: ../schema.json
+name: $arrayToObject
+category:
+    - 'Array Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/arrayToObject/'
+type:
+    - resolvesToObject
+encode: array
+description: |
+    Converts an array of key value pairs to a document.
+arguments:
+    -
+        name: array
+        type:
+            - resolvesToArray

generator/config/aggregation-operators/asin.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $asin
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/asin/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse sin (arc sine) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $asin takes any valid expression that resolves to a number between -1 and 1, e.g. -1 <= value <= 1.
+            $asin returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $asin returns values as a double. $asin can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/asinh.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $asinh
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/asinh/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse hyperbolic sine (hyperbolic arc sine) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $asinh takes any valid expression that resolves to a number.
+            $asinh returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $asinh returns values as a double. $asinh can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/atan.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $atan
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/atan/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse tangent (arc tangent) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $atan takes any valid expression that resolves to a number.
+            $atan returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $atan returns values as a double. $atan can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/atan2.yaml

@@ -0,0 +1,24 @@
+# $schema: ../schema.json
+name: $atan2
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/atan2/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: array
+description: |
+    Returns the inverse tangent (arc tangent) of y / x in radians, where y and x are the first and second values passed to the expression respectively.
+arguments:
+    -
+        name: 'y'
+        type:
+            - resolvesToNumber
+        description: |
+            $atan2 takes any valid expression that resolves to a number.
+            $atan2 returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $atan returns values as a double. $atan2 can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.
+    -
+        name: x
+        type:
+            - resolvesToNumber

generator/config/aggregation-operators/atanh.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $atanh
+category:
+    - 'Trigonometry Expression Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/atanh/'
+type:
+    - resolvesToDouble
+    - resolvesToDecimal
+encode: single
+description: |
+    Returns the inverse hyperbolic tangent (hyperbolic arc tangent) of a value in radians.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        description: |
+            $atanh takes any valid expression that resolves to a number between -1 and 1, e.g. -1 <= value <= 1.
+            $atanh returns values in radians. Use $radiansToDegrees operator to convert the output value from radians to degrees.
+            By default $atanh returns values as a double. $atanh can also return values as a 128-bit decimal as long as the expression resolves to a 128-bit decimal value.

generator/config/aggregation-operators/avg.yaml

@@ -0,0 +1,20 @@
+# $schema: ../schema.json
+name: $avg
+category:
+    - Accumulators
+    - 'Accumulators (in Other Stages)'
+    - 'Window Operator'
+link: 'https://www.mongodb.com/docs/manual/reference/operator/aggregation/avg/'
+type:
+    - resolvesToNumber
+    - Accumulator
+encode: single
+description: |
+    Returns an average of numerical values. Ignores non-numeric values.
+    Changed in version 5.0: Available in the $setWindowFields stage.
+arguments:
+    -
+        name: expression
+        type:
+            - resolvesToNumber
+        variadic: array