DOCSP-48162: Async examples for Write pages

Author: mcmorisi

source/crud/bulk-write.txt

@@ -266,7 +266,8 @@ Collection Bulk Write Example
 
 The following example performs multiple write operations on the 
 ``restaurants`` collection by using the ``bulk_write()`` method
-on a ``Collection`` instance:
+on a ``Collection`` instance.  Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
 .. io-code-block::
    :copyable:
@@ -291,7 +292,8 @@ Client Bulk Write Example
 The following example performs multiple write operations on the 
 ``sample_restaurants.restaurants`` and ``sample_mflix.movies``
 namespaces by using the ``bulk_write()`` method on a ``MongoClient``
-instance:
+instance.  Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
 .. io-code-block::
    :copyable:
@@ -363,14 +365,29 @@ to the ``Collection.bulk_write()`` method:
 
 The following example calls the ``bulk_write()`` method from the preceding
 :ref:`pymongo-bulk-write-collection-ex` but sets the ``ordered`` option
-to ``False``:
+to ``False``.  Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. literalinclude:: /includes/write/bulk-write.py
-   :start-after: start-bulk-write-unordered
-   :end-before: end-bulk-write-unordered
-   :language: python
-   :copyable:
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
 
+      .. literalinclude:: /includes/write/bulk-write.py
+         :start-after: start-bulk-write-unordered
+         :end-before: end-bulk-write-unordered
+         :language: python
+         :copyable:
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/write/bulk-write-async.py
+         :start-after: start-bulk-write-unordered
+         :end-before: end-bulk-write-unordered
+         :language: python
+         :copyable:
+  
 If any of the write operations in an unordered bulk write fail, {+driver-short+}
 reports the errors only after attempting all operations.
 
@@ -436,7 +453,8 @@ to the ``MongoClient.bulk_write()`` method:
 
 The following example calls the ``bulk_write()`` method from the preceding
 :ref:`pymongo-bulk-write-client-ex` but sets the ``verbose_results`` option
-to ``True``:
+to ``True``.  Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
 .. io-code-block::
    :copyable:
@@ -456,6 +474,51 @@ to ``True``:
       'nModified': 1}, acknowledged=True)}, 'deleteResults': {2: DeleteResult({'ok': 1.0,
       'idx': 2, 'n': 344}, acknowledged=True)}}, acknowledged=True, verbose=True)
 
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. io-code-block::
+         :copyable:
+
+         .. input:: /includes/write/bulk-write.py
+            :start-after: start-bulk-write-verbose
+            :end-before: end-bulk-write-verbose
+            :language: python
+
+         .. output::
+            :visible: false
+            
+            ClientBulkWriteResult({'anySuccessful': True, 'error': None, 'writeErrors': [],
+            'writeConcernErrors': [], 'nInserted': 1, 'nUpserted': 0, 'nMatched': 1, 'nModified': 1,
+            'nDeleted': 344, 'insertResults': {0: InsertOneResult(ObjectId('...'), 
+            acknowledged=True)}, 'updateResults': {1: UpdateResult({'ok': 1.0, 'idx': 1, 'n': 1,
+            'nModified': 1}, acknowledged=True)}, 'deleteResults': {2: DeleteResult({'ok': 1.0,
+            'idx': 2, 'n': 344}, acknowledged=True)}}, acknowledged=True, verbose=True)
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. io-code-block::
+         :copyable:
+
+         .. input:: /includes/write/bulk-write-async.py
+            :start-after: start-bulk-write-verbose
+            :end-before: end-bulk-write-verbose
+            :language: python
+
+         .. output::
+            :visible: false
+            
+            ClientBulkWriteResult({'anySuccessful': True, 'error': None, 'writeErrors': [],
+            'writeConcernErrors': [], 'nInserted': 1, 'nUpserted': 0, 'nMatched': 1, 'nModified': 1,
+            'nDeleted': 344, 'insertResults': {0: InsertOneResult(ObjectId('...'), 
+            acknowledged=True)}, 'updateResults': {1: UpdateResult({'ok': 1.0, 'idx': 1, 'n': 1,
+            'nModified': 1}, acknowledged=True)}, 'deleteResults': {2: DeleteResult({'ok': 1.0,
+            'idx': 2, 'n': 344}, acknowledged=True)}}, acknowledged=True, verbose=True)
+
+
 Return Values
 -------------
 

source/crud/delete.txt

@@ -64,25 +64,55 @@ Delete One Document
 ~~~~~~~~~~~~~~~~~~~
 
 The following example uses the ``delete_one()`` method to remove a document in
-the ``restaurants`` collection with a ``name`` value of ``"Ready Penny Inn"``:
+the ``restaurants`` collection with a ``name`` value of ``"Ready Penny Inn"``. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. literalinclude:: /includes/write/delete.py
-   :start-after: start-delete-one
-   :end-before: end-delete-one
-   :language: python
-   :copyable:
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/write/delete.py
+         :start-after: start-delete-one
+         :end-before: end-delete-one
+         :language: python
+         :copyable:
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/write/delete-async.py
+         :start-after: start-delete-one
+         :end-before: end-delete-one
+         :language: python
+         :copyable:
 
 Delete Multiple Documents
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following example uses the ``delete_many()`` method to remove all documents
-in the ``restaurants`` collection with a ``borough`` value of ``"Brooklyn"``:
+in the ``restaurants`` collection with a ``borough`` value of ``"Brooklyn"``. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
+
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/write/delete.py
+         :start-after: start-delete-many
+         :end-before: end-delete-many
+         :language: python
+         :copyable:
+
+   .. tab:: Asynchronous
+      :tabid: async
 
-.. literalinclude:: /includes/write/delete.py
-   :start-after: start-delete-many
-   :end-before: end-delete-many
-   :language: python
-   :copyable:
+      .. literalinclude:: /includes/write/delete-async.py
+         :start-after: start-delete-many
+         :end-before: end-delete-many
+         :language: python
+         :copyable:
 
 Customize the Delete Operation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -125,13 +155,28 @@ the delete operation.
 
 The following code uses the ``delete_many()`` method to delete all documents in
 the ``restaurants`` collection with a ``name`` value that includes the string ``"Mongo"``.
-It also uses the ``comment`` option to add a comment to the operation:
+It also uses the ``comment`` option to add a comment to the operation. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. literalinclude:: /includes/write/delete.py
-   :start-after: start-delete-options
-   :end-before: end-delete-options
-   :language: python
-   :copyable:
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/write/delete.py
+         :start-after: start-delete-options
+         :end-before: end-delete-options
+         :language: python
+         :copyable:
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. literalinclude:: /includes/write/delete-async.py
+         :start-after: start-delete-options
+         :end-before: end-delete-options
+         :language: python
+         :copyable:
 
 .. tip::
 
@@ -150,13 +195,28 @@ use.
 .. include:: /includes/collation-description.rst
 
 The following example performs the same delete operation as the previous example,
-but with a default collation of ``fr_CA``:
+but with a default collation of ``fr_CA``. Select the :guilabel:`Synchronous` or
+:guilabel:`Asynchronous` tab to see the corresponding code:
+
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. literalinclude:: /includes/write/delete.py
+         :start-after: start-delete-many-collation
+         :end-before: end-delete-many-collation
+         :language: python
+         :copyable:
+
+   .. tab:: Asynchronous
+      :tabid: async
 
-.. literalinclude:: /includes/write/delete.py
-   :start-after: start-delete-many-collation
-   :end-before: end-delete-many-collation
-   :language: python
-   :copyable:
+      .. literalinclude:: /includes/write/delete-async.py
+         :start-after: start-delete-many-collation
+         :end-before: end-delete-many-collation
+         :language: python
+         :copyable:
 
 .. include:: /includes/collation-override-note.rst