119 fix aliases declaration in pipeline methods

src/monggregate/pipeline.py

@@ -314,8 +314,7 @@
 
         self.stages.append(
             Bucket(
                 by = by or group_by,
-                #group_by = group_by or by,
                 boundaries = boundaries,
                 default = default,
                 output = output
@@ -371,8 +370,7 @@
 
         self.stages.append(
             BucketAuto(
                 by = by or group_by,
-                #group_by = group_by,
                 buckets = buckets,
                 output = output,
                 granularity = granularity
@@ -437,10 +435,10 @@
         """
 
         self.stages.append(
                 Unwind(
-                    path=path,
+                    path_to_array=path_to_array or path,
                     include_array_index=include_array_index,
-                    always=always
+                    always=always or preserve_null_and_empty_arrays
                     )
             )
         return self
@@ -453,7 +451,7 @@
 
         Arguments:
         ------------------------
-            - by,  str | list[str] | set[str] | dict | None : field or group of fields to group by
+            - by (_id),  str | list[str] | set[str] | dict | None : field or group of fields to group by
             - query, dict | None : Computed aggregated values (per group)
 
         Online MongoDB documentation:
@@ -473,9 +471,9 @@
         Source : https://www.mongodb.com/docs/manual/reference/operator/aggregation/group/#mongodb-pipeline-pipe.-group
         """
 
         self.stages.append(
                 Group(
-                    by=by,
+                    by=by or _id,
                     query=query
                 )
             )
@@ -568,9 +566,9 @@
             Lookup(
                 right = right,
                 on = on,
-                left_on = left_on,
-                right_on = right_on,
-                name =name
+                left_on = left_on or local_field, 
+                right_on = right_on or foreign_field,
+                name = name
             )
         )
         return self
@@ -712,8 +710,11 @@
         """
 
         query = query | kwargs
         self.stages.append(
-                Match(query=query, expression=expression)
+                Match(
+                    query=query, 
+                    expression=expression
+                )
             )
         return self
 
@@ -797,7 +798,7 @@
         -------------------------------------
 
             - statement, dict : the statement generated during instantiation after parsing the other arguments
-            - path_to_new_root, str|None : the path to the embedded document to be promoted
+            - path_to_new_root (path), str|None : the path to the embedded document to be promoted
             - document, dict|None : document being created and to be set as the new root or expression
 
         Online MongoDB documentation:
@@ -814,7 +815,10 @@
         """
 
         self.stages.append(
-                ReplaceRoot(path=path, document=document)
+                ReplaceRoot(
+                    path=path or path_to_new_root, 
+                    document=document
+                )
             )
         return self
 
@@ -826,7 +830,7 @@
         -------------------------------------
 
             - statement, dict : the statement generated during instantiation after parsing the other arguments
-            - path_to_new_root, str|None : the path to the embedded document to be promoted
+            - path_to_new_root (path), str|None : the path to the embedded document to be promoted
             - document, dict|None : document being created and to be set as the new root or expression
 
         Online MongoDB documentation:
@@ -843,7 +847,10 @@
         """
 
         self.stages.append(
-                ReplaceRoot(path=path, document=document)
+                ReplaceRoot(
+                    path=path or path_to_new_root, 
+                    document=document
+                )
             )
         return self
 
@@ -1375,8 +1382,10 @@
         Source : https://www.mongodb.com/docs/manual/reference/operator/aggregation/unionWith/#mongodb-pipeline-pipe.-unionWith
         """
 
         self.stages.append(
-            UnionWith(collection=collection, pipeline=pipeline)
+            UnionWith(
+                collection=collection or coll, 
+                pipeline=pipeline)
         )
 
         return self

src/monggregate/stages/group.py

@@ -74,7 +74,7 @@ class Group(Stage):
 
     Attributes:
     -----------
-        - by,  str | list[str] | set[str] | dict | None : field or group of fields to group by
+        - by (_id),  str | list[str] | set[str] | dict | None : field or group of fields to group by
         - query, dict | None : Computed aggregated values (per group)
 
     Online MongoDB documentation:

src/monggregate/stages/replace_root.py

@@ -77,7 +77,7 @@ class ReplaceRoot(Stage):
     -----------
 
         - statement, dict : the statement generated during instantiation after parsing the other arguments
-        - path_to_new_root, str|None : the path to the embedded document to be promoted
+        - path_to_new_root (path), str|None : the path to the embedded document to be promoted
         - document, dict|None : document being created and to be set as the new root or expression
 
     Online MongoDB documentation: