DOCSP-48166: Add async examples for Data Formats pages

source/data-formats/bson.txt

@@ -107,10 +107,10 @@ The following example reads the sample BSON document from ``file.bson``:
    .. input::
       :language: python
 
-         with open("file.bson", "rb") as file:
-             data = file.read()
-             document = bson.decode(data)
-             print(document)
+      with open("file.bson", "rb") as file:
+          data = file.read()
+          document = bson.decode(data)
+          print(document)
 
    .. output::
       :visible: false
@@ -138,25 +138,53 @@ constructor to ``RawBSONDocument``.
    first convert it to a {+language+} dictionary.
 
 The following example configures a ``MongoClient`` object to use ``RawBSONDocument`` objects
-to model the collection, then retrieves the sample document from the preceding examples:
+to model the collection, then retrieves the sample document from the preceding examples.
+Select the :guilabel:`Synchronous` or :guilabel:`Asynchronous` tab to see the corresponding
+code.
 
-.. io-code-block::
-   :copyable: true
+.. tabs::
+
+   .. tab:: Synchronous
+      :tabid: sync
 
-   .. input::
-      :language: python
-
-      from bson.raw_bson import RawBSONDocument
+      .. io-code-block::
+         :copyable: true
 
-      client = pymongo.MongoClient("<connection URI>", document_class=RawBSONDocument)
-      collection = client.sample_restaurants.restaurants
-      raw_doc = collection.find_one({"name": "Mongo's Pizza"})
-      print(type(raw_doc))
+         .. input::
+            :language: python
+            
+            from bson.raw_bson import RawBSONDocument
 
-   .. output::
-      :visible: false
+            client = pymongo.MongoClient("<connection URI>", document_class=RawBSONDocument)
+            collection = client.sample_restaurants.restaurants
+            raw_doc = collection.find_one({"name": "Mongo's Pizza"})
+            print(type(raw_doc))
+
+         .. output::
+            :visible: false
+
+            <class 'bson.raw_bson.RawBSONDocument'>
+
+   .. tab:: Asynchronous
+      :tabid: async
+
+      .. io-code-block::
+         :copyable: true
+
+         .. input::
+            :language: python
+
+            from bson.raw_bson import RawBSONDocument
+
+            client = pymongo.AsyncMongoClient("<connection URI>", document_class=RawBSONDocument)
+            collection = client.sample_restaurants.restaurants
+            raw_doc = await collection.find_one({"name": "Mongo's Pizza"})
+            print(type(raw_doc))
+
+         .. output::
+            :visible: false
 
-      <class 'bson.raw_bson.RawBSONDocument'>
+            <class 'bson.raw_bson.RawBSONDocument'>
 
 API Documentation
 -----------------