CSHARP-1741: Added support for $bucketAuto.

Author: rstam

src/MongoDB.Driver/AggregateBucketAutoGranularity.cs

@@ -0,0 +1,109 @@
+/* Copyright 2016 MongoDB Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+using MongoDB.Driver.Core.Misc;
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents the granularity value for a $bucketAuto stage.
+    /// </summary>
+    public struct AggregateBucketAutoGranularity
+    {
+        #region static
+        /// <summary>
+        /// Gets the E6 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E6 => new AggregateBucketAutoGranularity("E6");
+
+        /// <summary>
+        /// Gets the E12 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E12 => new AggregateBucketAutoGranularity("E12");
+
+        /// <summary>
+        /// Gets the E24 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E24 => new AggregateBucketAutoGranularity("E24");
+
+        /// <summary>
+        /// Gets the E48 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E48 => new AggregateBucketAutoGranularity("E48");
+
+        /// <summary>
+        /// Gets the E96 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E96 => new AggregateBucketAutoGranularity("E96");
+
+        /// <summary>
+        /// Gets the E192 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity E192 => new AggregateBucketAutoGranularity("E192");
+
+        /// <summary>
+        /// Gets the POWERSOF2 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity PowersOf2 => new AggregateBucketAutoGranularity("POWERSOF2");
+
+        /// <summary>
+        /// Gets the R5 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity R5 => new AggregateBucketAutoGranularity("R5");
+
+        /// <summary>
+        /// Gets the R10 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity R10 => new AggregateBucketAutoGranularity("R10");
+
+        /// <summary>
+        /// Gets the R20 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity R20 => new AggregateBucketAutoGranularity("R20");
+
+        /// <summary>
+        /// Gets the R40 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity R40 => new AggregateBucketAutoGranularity("R40");
+
+        /// <summary>
+        /// Gets the R80 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity R80 => new AggregateBucketAutoGranularity("R80");
+
+        /// <summary>
+        /// Gets the 1-2-5 granularity.
+        /// </summary>
+        public static AggregateBucketAutoGranularity S1_2_5 => new AggregateBucketAutoGranularity("1-2-5");
+
+        #endregion
+
+        private readonly string _value;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AggregateBucketAutoGranularity"/> struct.
+        /// </summary>
+        /// <param name="value">The value.</param>
+        public AggregateBucketAutoGranularity(string value)
+        {
+            _value = Ensure.IsNotNull(value, nameof(value));
+        }
+
+        /// <summary>
+        /// Gets the value.
+        /// </summary>
+        public string Value => _value;
+    }
+}

src/MongoDB.Driver/AggregateBucketAutoOptions.cs

@@ -0,0 +1,28 @@
+/* Copyright 2016 MongoDB Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents options for the BucketAuto method.
+    /// </summary>
+    public class AggregateBucketAutoOptions
+    {
+        /// <summary>
+        /// Gets or sets the granularity.
+        /// </summary>
+        public Optional<AggregateBucketAutoGranularity> Granularity { get; set; }
+    }
+}

src/MongoDB.Driver/AggregateBucketAutoResult.cs

@@ -0,0 +1,79 @@
+/* Copyright 2016 MongoDB Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+using MongoDB.Bson.Serialization.Attributes;
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents the result of the $bucketAuto stage.
+    /// </summary>
+    /// <typeparam name="TValue">The type of the value.</typeparam>
+    public class AggregateBucketAutoResult<TValue>
+    {
+        // constructors
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AggregateBucketResult{TValue}"/> class.
+        /// </summary>
+        /// <param name="id">The inclusive lower boundary of the bucket.</param>
+        /// <param name="count">The count.</param>
+        public AggregateBucketAutoResult(AggregateBucketAutoResultId<TValue> id, long count)
+        {
+            Id = id;
+            Count = count;
+        }
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AggregateBucketResult{TValue}" /> class.
+        /// </summary>
+        /// <param name="min">The minimum.</param>
+        /// <param name="max">The maximum.</param>
+        /// <param name="count">The count.</param>
+        public AggregateBucketAutoResult(TValue min, TValue max, long count)
+        {
+            Id = new AggregateBucketAutoResultId<TValue>(min, max);
+            Count = count;
+        }
+
+        // public properties
+        /// <summary>
+        /// Gets the inclusive lower boundary of the bucket.
+        /// </summary>
+        /// <value>
+        /// The inclusive lower boundary of the bucket.
+        /// </value>
+        [BsonId]
+        public AggregateBucketAutoResultId<TValue> Id { get; private set; }
+
+        /// <summary>
+        /// Gets the count.
+        /// </summary>
+        /// <value>
+        /// The count.
+        /// </value>
+        [BsonElement("count")]
+        public long Count { get; private set; }
+
+        /// <summary>
+        /// Gets the maximum.
+        /// </summary>
+        public TValue Max => Id.Max;
+
+        /// <summary>
+        /// Gets the minimum.
+        /// </summary>
+        public TValue Min => Id.Min;
+    }
+}

src/MongoDB.Driver/AggregateBucketAutoResultId.cs

@@ -0,0 +1,52 @@
+/* Copyright 2016 MongoDB Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+using MongoDB.Bson.Serialization.Attributes;
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents the _id value in the result of a $bucketAuto stage.
+    /// </summary>
+    /// <typeparam name="TValue">The type of the values.</typeparam>
+    public class AggregateBucketAutoResultId<TValue>
+    {
+        private readonly TValue _min;
+        private readonly TValue _max;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="AggregateBucketAutoResultId{TValue}"/> class.
+        /// </summary>
+        /// <param name="min">The minimum.</param>
+        /// <param name="max">The maximum.</param>
+        public AggregateBucketAutoResultId(TValue min, TValue max)
+        {
+            _min = min;
+            _max = max;
+        }
+
+        /// <summary>
+        /// Gets the max value.
+        /// </summary>
+        [BsonElement("max")]
+        public TValue Max => _max;
+
+        /// <summary>
+        /// Gets the min value.
+        /// </summary>
+        [BsonElement("min")]
+        public TValue Min => _min;
+    }
+}

src/MongoDB.Driver/AggregateBucketOptions.cs

@@ -0,0 +1,28 @@
+/* Copyright 2016 MongoDB Inc.
+*
+* Licensed under the Apache License, Version 2.0 (the "License");
+* you may not use this file except in compliance with the License.
+* You may obtain a copy of the License at
+*
+* http://www.apache.org/licenses/LICENSE-2.0
+*
+* Unless required by applicable law or agreed to in writing, software
+* distributed under the License is distributed on an "AS IS" BASIS,
+* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+* See the License for the specific language governing permissions and
+* limitations under the License.
+*/
+
+namespace MongoDB.Driver
+{
+    /// <summary>
+    /// Represents options for the Bucket method.
+    /// </summary>
+    public class AggregateBucketOptions<TValue>
+    {
+        /// <summary>
+        /// Gets or sets the default bucket.
+        /// </summary>
+        public Optional<TValue> DefaultBucket { get; set; }
+    }
+}

src/MongoDB.Driver/AggregateBucketResult.cs

@@ -13,11 +13,6 @@
 * limitations under the License.
 */
 
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
 using MongoDB.Bson.Serialization.Attributes;
 
 namespace MongoDB.Driver