DOCSP-48168: Async examples for Databases and Collections/Run Command

Author: mcmorisi

source/crud/configure.txt

@@ -123,14 +123,28 @@ By default, the driver uses only those members whose ping times are within 15 mi
 of the nearest member for queries. To distribute reads between members with
 higher latencies, pass the ``localThresholdMS`` option to the ``MongoClient()`` constructor.
 
-The following example specifies a local threshold of 35 milliseconds:
+The following example specifies a local threshold of 35 milliseconds. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. code-block:: python
-   :emphasize-lines: 3
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. code-block:: python
+
+         client = MongoClient(replicaSet='repl0',
+                              readPreference=ReadPreference.SECONDARY_PREFERRED,
+                              localThresholdMS=35)
+
+   .. tab:: Asynchronous
+      :tabid: async
 
-   client = MongoClient(replicaSet='repl0',
-                        readPreference=ReadPreference.SECONDARY_PREFERRED,
-                        localThresholdMS=35)
+      .. code-block:: python
+
+         client = AsyncMongoClient(replicaSet='repl0',
+                                   readPreference=ReadPreference.SECONDARY_PREFERRED,
+                                   localThresholdMS=35)
 
 In the preceding example, {+driver-short+} distributes reads between matching members
 within 35 milliseconds of the closest member's ping time.
@@ -150,12 +164,27 @@ if they fail due to a network or server error.
 
 You can explicitly disable retryable reads or retryable writes by setting the ``retryReads`` or
 ``retryWrites`` option to ``False`` in the ``MongoClient()`` constructor. The following
-example disables retryable reads and writes for a client:
+example disables retryable reads and writes for a client. Select the
+:guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding code:
 
-.. code-block:: python
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
+
+      .. code-block:: python
+
+         client = MongoClient("<connection string>",
+                              retryReads=False, retryWrites=False)
+   
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. code-block:: python
+
+         client = AsyncMongoClient("<connection string>",
+                                   retryReads=False, retryWrites=False)
 
-   client = MongoClient("<connection string>",
-                        retryReads=False, retryWrites=False)
 
 To learn more about supported retryable read operations, see :manual:`Retryable Reads </core/retryable-reads/>`
 in the {+mdb-server+} manual. To learn more about supported retryable write
@@ -170,12 +199,27 @@ you perform on the collection.
 .. include:: /includes/collation-description.rst
 
 The following example creates the same collection 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:
 
-.. code-block:: python
-   :emphasize-lines: 4
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
 
-   from pymongo.collation import Collation
+      .. code-block:: python
+
+         from pymongo.collation import Collation
+
+         database = client["test_database"]
+         database.create_collection("example_collection", collation=Collation(locale='fr_CA'))
 
-   database = client["test_database"]
-   database.create_collection("example_collection", collation=Collation(locale='fr_CA'))
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. code-block:: python
+
+         from pymongo.collation import Collation
+
+         database = client["test_database"]
+         await database.create_collection("example_collection", collation=Collation(locale='fr_CA'))