read and write code examples (#73)

Author: jordan-smith721

source/includes/read/distinct.py

@@ -1,11 +1,23 @@
 # start-distinct
+results = restaurants.distinct("borough")
 
+for restaurant in results:
+    print(restaurant)
 # end-distinct
 
 # start-distinct-with-query
+results = restaurants.distinct("borough", {
+    "cuisine": "Italian"
+})
 
+for restaurant in results:
+    print(restaurant)
 # end-distinct-with-query
 
 # start-distinct-with-comment
-
+results = restaurants.distinct("name", 
+    { "borough": "Bronx", 
+      "cuisine": "Pizza" }, 
+    comment="Bronx pizza restaurants"
+)
 # end-distinct-with-comment

source/includes/write/bulk-write.py

@@ -1,31 +1,80 @@
 # start-bulk-insert-one
-
+operation = pymongo.InsertOne(
+    {
+        "name": "Mongo's Deli",
+        "cuisine": "Sandwiches",
+        "borough": "Manhattan",
+        "restaurant_id": "1234"
+    }
+)
 # end-bulk-insert-one
 
 # start-bulk-update-one
-
+operation = pymongo.UpdateOne(
+    { "name": "Mongo's Deli" },
+    { "$set": { "cuisine": "Sandwiches and Salads" }},
+)
 # end-bulk-update-one
 
 # start-bulk-update-many
-
+operation = pymongo.UpdateMany(
+    { "name": "Mongo's Deli" },
+    { "$set": { "cuisine": "Sandwiches and Salads" }},
+)
 # end-bulk-update-many
 
 # start-bulk-replace-one
-
+operation = pymongo.ReplaceOne(
+    { "restaurant_id": "1234" },
+    {
+        "name": "Mongo's Pizza",
+        "cuisine": "Pizza",
+        "borough": "Brooklyn",
+        "restaurant_id": "5678"
+    }
+)
 # end-bulk-replace-one
 
 # start-bulk-delete-one
-
+operation = pymongo.DeleteOne({ "restaurant_id": "5678" })
 # end-bulk-delete-one
 
 # start-bulk-delete-many
-
+operation = pymongo.DeleteMany({ "name": "Mongo's Deli" })
 # end-bulk-delete-many
 
 # start-bulk-write-mixed
+operations = [
+    pymongo.InsertOne(
+        {
+            "name": "Mongo's Deli",
+            "cuisine": "Sandwiches",
+            "borough": "Manhattan",
+            "restaurant_id": "1234"
+        }
+    ),
+    pymongo.InsertOne(
+        {
+            "name": "Mongo's Deli",
+            "cuisine": "Sandwiches",
+            "borough": "Brooklyn",
+            "restaurant_id": "5678"
+        }
+    ),
+    pymongo.UpdateMany(
+        { "name": "Mongo's Deli" },
+        { "$set": { "cuisine": "Sandwiches and Salads" }},
+    ),
+    pymongo.DeleteOne(
+        { "restaurant_id": "1234" }
+    )
+]
 
+results = restaurants.bulk_write(operations)
+
+print(results)
 # end-bulk-write-mixed
 
 # start-bulk-write-unordered
-
+results = restaurants.bulk_write(operations, ordered=False)
 # end-bulk-write-unordered

source/includes/write/delete.py

@@ -1,11 +1,17 @@
 # start-delete-one
+query_filter = { "name": "Ready Penny Inn" }
 
+result = restaurants.delete_one(query_filter)
 # end-delete-one
 
 # start-delete-many
+query_filter = { "borough": "Brooklyn" }
 
+result = restaurants.delete_many(query_filter)
 # end-delete-many
 
 # start-delete-options
+query_filter = { 'name': {'$regex': 'Mongo' }}
 
+result = restaurants.delete_many(query_filter, comment="Deleting Mongo restaurants")
 # end-delete-options

source/read/distinct.txt

@@ -55,7 +55,12 @@ the ``restaurants`` collection:
 
    .. output:: 
 
-      <placeholder output>
+      Bronx
+      Brooklyn
+      Manhattan
+      Missing
+      Queens
+      Staten Island
 
 The results show every distinct value that appears in the ``borough`` field
 across all documents in the collection. Although several documents have the same
@@ -81,7 +86,11 @@ all documents that have a ``cuisine`` field value of ``"Italian"``:
 
    .. output:: 
 
-      <placeholder output>
+      Bronx
+      Brooklyn
+      Manhattan
+      Queens
+      Staten Island
 
 Modify Distinct Behavior
 ~~~~~~~~~~~~~~~~~~~~~~~~
@@ -118,7 +127,8 @@ The following table describes the options you can set to customize
      - | An instance of ``Collation``.
 
 The following example retrieves the distinct values of the ``name`` field for
-all documents that have a ``borough`` field value of ``"Bronx"``. It also uses
+all documents that have a ``borough`` field value of ``"Bronx"`` and a
+``cuisine`` field value of ``"Pizza"``. It also uses
 the ``comment`` option to add a comment to the operation.
 
 .. io-code-block::
@@ -130,7 +140,12 @@ the ``comment`` option to add a comment to the operation.
 
    .. output:: 
 
-      <placeholder output>
+      $1.25 Pizza
+      18 East Gunhill Pizza
+      2 Bros
+      Aenos Pizza
+      Alitalia Pizza Restaurant
+      ...
 
 API Documentation
 -----------------

source/write/bulk-write.txt

@@ -24,7 +24,15 @@ Consider a scenario in which you want to insert a document into a collection,
 update multiple other documents, then delete a document. If you use
 individual methods, each operation requires its own database call. This guide
 shows you how to use bulk write operations to perform multiple write operations
-in a single database call. 
+in a single database call.
+
+Sample Data
+~~~~~~~~~~~
+
+The examples in this guide use the ``sample_restaurants.restaurants`` collection
+from the :atlas:`Atlas sample datasets </sample-data>`. To learn how to create a
+free MongoDB Atlas cluster and load the sample datasets, see the
+:ref:`<pymongo-get-started>` tutorial.
 
 Define the Write Operations
 ---------------------------
@@ -148,11 +156,16 @@ they're defined in the list.
 The following example performs multiple write operations by using the
 ``bulk_write()`` method:
 
-.. literalinclude:: /includes/write/bulk-write.py
-   :start-after: start-bulk-write-mixed
-   :end-before: end-bulk-write-mixed
-   :language: python
-   :copyable:
+.. io-code-block::
+
+   .. input:: /includes/write/bulk-write.py
+      :start-after: start-bulk-write-mixed
+      :end-before: end-bulk-write-mixed
+      :language: python
+
+   .. output::
+      
+      BulkWriteResult({'writeErrors': [], 'writeConcernErrors': [], 'nInserted': 2, 'nUpserted': 0, 'nMatched': 2, 'nModified': 2, 'nRemoved': 1, 'upserted': []}, acknowledged=True)
 
 If any of the write operations fail, {+driver-short+} raises a
 ``BulkWriteError`` and does not perform any further operations.
@@ -212,7 +225,7 @@ the bulk write operation.
          </reference/command/delete/#std-label-delete-let-syntax>` in the
          MongoDB Server manual.
 
-The following example uses the ``bulk_write()`` method with the ``ordered`` options set
+The following example calls the ``bulk_write()`` method from the preceding example, with the ``ordered`` option set
 to ``False``:
 
 .. literalinclude:: /includes/write/bulk-write.py
@@ -221,7 +234,7 @@ to ``False``:
    :language: python
    :copyable:
 
-If any of the write operations in the preceding example fail, {+driver-short+}
+If any of the write operations in an unordered bulk write fail, {+driver-short+}
 reports the errors only after attempting all operations.
 
 .. note::