CSHARP-5323: Mark API as obsolete: Operations + Bindings (#1492)

Author: papafe

src/MongoDB.Driver.Core/Core/Bindings/ChannelReadBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read binding that is bound to a channel.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ChannelReadBinding : IReadBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/ChannelReadWriteBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read-write binding that is bound to a channel.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ChannelReadWriteBinding : IReadWriteBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/ChannelSourceReadWriteBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read-write binding to a channel source.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ChannelSourceReadWriteBinding : IReadWriteBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/IBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// Represents a read or write binding associated with a session.
     /// </summary>
     /// <seealso cref="System.IDisposable" />
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IBinding : IDisposable
     {
         /// <summary>
@@ -39,6 +40,7 @@ public interface IBinding : IDisposable
     /// <summary>
     /// Represents a binding that determines which channel source gets used for read operations.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IReadBinding : IBinding
     {
         /// <summary>
@@ -83,6 +85,7 @@ public interface IReadBinding : IBinding
     /// <summary>
     /// Represents a binding that determines which channel source gets used for write operations.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IWriteBinding : IBinding
     {
         /// <summary>
@@ -153,13 +156,15 @@ public interface IWriteBinding : IBinding
     /// <summary>
     /// Represents a binding that can be used for both read and write operations.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IReadWriteBinding : IReadBinding, IWriteBinding
     {
     }
 
     /// <summary>
     /// Represents a handle to a read binding.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IReadBindingHandle : IReadBinding
     {
         /// <summary>
@@ -172,6 +177,7 @@ public interface IReadBindingHandle : IReadBinding
     /// <summary>
     /// Represents a handle to a write binding.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IWriteBindingHandle : IWriteBinding
     {
         /// <summary>
@@ -184,6 +190,7 @@ public interface IWriteBindingHandle : IWriteBinding
     /// <summary>
     /// Represents a handle to a read-write binding.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IReadWriteBindingHandle : IReadWriteBinding, IReadBindingHandle, IWriteBindingHandle
     {
         /// <summary>
@@ -196,6 +203,7 @@ public interface IReadWriteBindingHandle : IReadWriteBinding, IReadBindingHandle
     /// <summary>
     /// Represents the criteria for using a secondary for operations that may use a secondary.
     /// </summary>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IMayUseSecondaryCriteria
     {
         /// <summary>

src/MongoDB.Driver.Core/Core/Bindings/ReadBindingHandle.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a handle to a read binding.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ReadBindingHandle : IReadBindingHandle
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/ReadPreferenceBinding.cs

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read binding to a cluster using a ReadPreference to select the server.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ReadPreferenceBinding : IReadBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/ReadWriteBindingHandle.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a handle to a read-write binding.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class ReadWriteBindingHandle : IReadWriteBindingHandle
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/SingleServerReadBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read binding to a single server;
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class SingleServerReadBinding : IReadBinding
     {
         // private constants

src/MongoDB.Driver.Core/Core/Bindings/SingleServerReadWriteBinding.cs

@@ -25,6 +25,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a read/write binding to a single server.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class SingleServerReadWriteBinding : IReadWriteBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Bindings/WritableServerBinding.cs

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Bindings
     /// <summary>
     /// Represents a write binding to a writable server.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class WritableServerBinding : IReadWriteBinding
     {
         // fields

src/MongoDB.Driver.Core/Core/Misc/IBatchableSource.cs

@@ -13,7 +13,6 @@
 * limitations under the License.
 */
 
-using System;
 using System.Collections.Generic;
 using System.Linq;
 

src/MongoDB.Driver.Core/Core/Operations/AggregateExplainOperation.cs

@@ -30,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents an aggregate explain operations.
     /// </summary>
+    [Obsolete("This class will be removed in a later release.")]
     public class AggregateExplainOperation : IReadOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/AggregateOperation.cs

@@ -34,6 +34,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents an aggregate operation.
     /// </summary>
     /// <typeparam name="TResult">The type of the result values.</typeparam>
+    [Obsolete("This class will be made internal in a later release.")]
     public class AggregateOperation<TResult> : IReadOperation<IAsyncCursor<TResult>>, IExecutableInRetryableReadContext<IAsyncCursor<TResult>>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/AggregateToCollectionOperation.cs

@@ -32,6 +32,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents an aggregate operation that writes the results to an output collection.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class AggregateToCollectionOperation : IWriteOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/BulkMixedWriteOperation.cs

@@ -30,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a mixed write bulk operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class BulkMixedWriteOperation : IWriteOperation<BulkWriteOperationResult>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/BulkWriteOperationResult.cs

@@ -22,6 +22,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents the result of a bulk write operation.
     /// </summary>
     [Serializable]
+    [Obsolete("This class will be made internal in a later release.")]
     public abstract class BulkWriteOperationResult
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/BulkWriteOperationUpsert.cs

@@ -23,6 +23,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents the information about one Upsert.
     /// </summary>
     [Serializable]
+    [Obsolete("This class will be made internal in a later release.")]
     public class BulkWriteOperationUpsert
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/ChangeStreamOperation.cs

@@ -31,6 +31,7 @@ namespace MongoDB.Driver.Core.Operations
     /// A change stream operation.
     /// </summary>
     /// <typeparam name="TResult">The type of the result.</typeparam>
+    [Obsolete("This interface will be made internal in a later release.")]
     public interface IChangeStreamOperation<TResult> : IReadOperation<IChangeStreamCursor<TResult>>
     {
         // properties
@@ -88,6 +89,7 @@ public interface IChangeStreamOperation<TResult> : IReadOperation<IChangeStreamC
     /// A change stream operation.
     /// </summary>
     /// <typeparam name="TResult">The type of the result values.</typeparam>
+    [Obsolete("This class will be made internal in a later release.")]
     public class ChangeStreamOperation<TResult> : IChangeStreamOperation<TResult>
     {
         // private fields

src/MongoDB.Driver.Core/Core/Operations/CommandOperationBase.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 using MongoDB.Bson;
@@ -29,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents the base class for a command operation.
     /// </summary>
     /// <typeparam name="TCommandResult">The type of the command result.</typeparam>
+    [Obsolete("This class will be made internal in a later release.")]
     public abstract class CommandOperationBase<TCommandResult>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/CountDocumentsOperation.cs

@@ -30,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents a count documents operation.
     /// For a fast estimate of the total documents in a collection see <see cref="CountOperation"/>.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class CountDocumentsOperation : IReadOperation<long>
     {
         // private fields

src/MongoDB.Driver.Core/Core/Operations/CountOperation.cs

@@ -29,6 +29,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a count operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class CountOperation : IReadOperation<long>, IExecutableInRetryableReadContext<long>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/CreateCollectionOperation.cs

@@ -30,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a create collection operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class CreateCollectionOperation : IWriteOperation<BsonDocument>
     {
         #region static

src/MongoDB.Driver.Core/Core/Operations/CreateIndexesOperation.cs

@@ -31,6 +31,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a create indexes operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class CreateIndexesOperation : IWriteOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/CreateSearchIndexRequest.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using MongoDB.Bson;
 using MongoDB.Driver.Core.Misc;
 
@@ -21,6 +22,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a create search index request.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class CreateSearchIndexRequest
     {
         /// <summary>Gets the index name.</summary>

src/MongoDB.Driver.Core/Core/Operations/CreateViewOperation.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Threading;
@@ -29,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a create view operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class CreateViewOperation : IWriteOperation<BsonDocument>
     {
         // private fields

src/MongoDB.Driver.Core/Core/Operations/DatabaseExistsOperation.cs

@@ -26,6 +26,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a database exists operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DatabaseExistsOperation : IReadOperation<bool>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/DeleteOpcodeOperation.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 using MongoDB.Driver.Core.Bindings;
@@ -25,6 +26,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a delete operation using the delete opcode.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DeleteOpcodeOperation : IWriteOperation<WriteConcernResult>, IExecutableInRetryableWriteContext<WriteConcernResult>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/DistinctOperation.cs

@@ -32,6 +32,7 @@ namespace MongoDB.Driver.Core.Operations
     /// Represents a distinct operation.
     /// </summary>
     /// <typeparam name="TValue">The type of the value.</typeparam>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DistinctOperation<TValue> : IReadOperation<IAsyncCursor<TValue>>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/DropCollectionOperation.cs

@@ -30,6 +30,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a drop collection operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DropCollectionOperation : IWriteOperation<BsonDocument>
     {
         #region static

src/MongoDB.Driver.Core/Core/Operations/DropDatabaseOperation.cs

@@ -28,6 +28,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a drop database operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DropDatabaseOperation : IWriteOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/DropIndexOperation.cs

@@ -28,6 +28,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a drop index operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class DropIndexOperation : IWriteOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/DropSearchIndexOperation.cs

@@ -13,6 +13,7 @@
 * limitations under the License.
 */
 
+using System;
 using System.Threading;
 using System.Threading.Tasks;
 using MongoDB.Bson;
@@ -27,6 +28,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents a drop index operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     internal sealed class DropSearchIndexOperation : IWriteOperation<BsonDocument>
     {
         // fields

src/MongoDB.Driver.Core/Core/Operations/EndTransactionOperation.cs

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Abstract base class for AbortTransactionOperation and CommitTransactionOperation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public abstract class EndTransactionOperation : IReadOperation<BsonDocument>
     {
         // private fields
@@ -143,6 +144,7 @@ private IReadOperation<BsonDocument> CreateOperation()
     /// <summary>
     /// The abort transaction operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class AbortTransactionOperation : EndTransactionOperation
     {
         // public constructors
@@ -173,6 +175,7 @@ public AbortTransactionOperation(WriteConcern writeConcern)
     /// <summary>
     /// The commit transaction operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public sealed class CommitTransactionOperation : EndTransactionOperation
     {
         // private fields

src/MongoDB.Driver.Core/Core/Operations/EstimatedDocumentCountOperation.cs

@@ -27,6 +27,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents an estimated document count operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class EstimatedDocumentCountOperation : IReadOperation<long>
     {
         // private fields

src/MongoDB.Driver.Core/Core/Operations/EvalOperation.cs

@@ -29,6 +29,7 @@ namespace MongoDB.Driver.Core.Operations
     /// <summary>
     /// Represents an eval operation.
     /// </summary>
+    [Obsolete("This class will be made internal in a later release.")]
     public class EvalOperation : IWriteOperation<BsonValue>
     {
         // fields