update deleteOne usage example

Author: stephmarie17

source/crud/delete.txt

@@ -136,6 +136,43 @@ method:
    ``DeleteMany()``, the driver would delete the first of the two
    matched documents.
 
+DeleteOne() Example: Full File
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/usage-examples/example-intro.rst
+
+The following example is a fully runnable file that finds and deletes an
+existing document in the ``restaurants`` collection. Select the
+:guilabel:`Struct` or :guilabel:`bson.D` tba to see the corresponding code:
+
+.. tabs::
+
+   .. tab:: Struct
+      :tabid: structExample
+
+      The following code uses structs to define and delete a document in the
+      ``restaurants`` collection:
+
+      .. input:: /includes/usage-examples/code-snippets/deleteOne.go
+         :language: go
+         :dedent:
+
+      .. output::
+         :language: none
+         :visible: false
+
+         Documents deleted: 1
+
+      .. input:: /includes/usage-examples/code-snippets/deleteOneBson.go
+         :language: go
+         :dedent:
+
+      .. output::
+         :language: none
+         :visible: false
+
+         Documents deleted: 1
+
 Additional Information
 ----------------------
 

source/includes/usage-examples/code-snippets/deleteOne.go

@@ -13,6 +13,17 @@ import (
 	"go.mongodb.org/mongo-driver/v2/mongo/options"
 )
 
+// Defines a Restaurant struct as a model for documents in the "restaurants" collection
+type Restaurant struct {
+	ID   bson.ObjectID `bson:"_id"`
+	Name string        `bson:"name"`
+}
+
+// Creates a filter struct to specify the document to delete
+type DeleteRestaurantFilter struct {
+	Name string `bson:"name"`
+}
+
 func main() {
 	if err := godotenv.Load(); err != nil {
 		log.Println("No .env file found")
@@ -33,18 +44,16 @@ func main() {
 		}
 	}()
 
-	// begin deleteOne
-	coll := client.Database("sample_mflix").Collection("movies")
-	filter := bson.D{{"title", "Twilight"}}
+	coll := client.Database("sample_restaurants").Collection("restaurants")
+	filter := DeleteRestaurantFilter{Name: "New Corner"}
 
-	// Deletes the first document that has a "title" value of "Twilight"
+	// Deletes the first document that has a "name" value of "New Corner"
 	result, err := coll.DeleteOne(context.TODO(), filter)
 
 	// Prints a message if any errors occur during the operation
 	if err != nil {
 		panic(err)
 	}
-	// end deleteOne
 
 	// Prints the number of deleted documents
 	fmt.Printf("Documents deleted: %d\n", result.DeletedCount)

source/includes/usage-examples/code-snippets/deleteOneBson.go

@@ -0,0 +1,52 @@
+// Deletes a document from a collection by using the Go driver
+package main
+
+import (
+	"context"
+	"fmt"
+	"log"
+	"os"
+
+	"github.com/joho/godotenv"
+	"go.mongodb.org/mongo-driver/v2/bson"
+	"go.mongodb.org/mongo-driver/v2/mongo"
+	"go.mongodb.org/mongo-driver/v2/mongo/options"
+)
+
+func main() {
+	if err := godotenv.Load(); err != nil {
+		log.Println("No .env file found")
+	}
+
+	var uri string
+	if uri = os.Getenv("MONGODB_URI"); uri == "" {
+		log.Fatal("You must set your 'MONGODB_URI' environment variable. See\n\t https://www.mongodb.com/docs/drivers/go/current/connect/mongoclient/#environment-variable")
+	}
+
+	client, err := mongo.Connect(options.Client().ApplyURI(uri))
+	if err != nil {
+		panic(err)
+	}
+	defer func() {
+		if err = client.Disconnect(context.TODO()); err != nil {
+			panic(err)
+		}
+	}()
+
+	coll := client.Database("sample_restaurants").Collection("restaurants")
+	filter := bson.D{{"name", "New Corner"}}
+
+	// Deletes the first document that has a "name" value of "New Corner"
+	result, err := coll.DeleteOne(context.TODO(), filter)
+
+	// Prints a message if any errors occur during the operation
+	if err != nil {
+		panic(err)
+	}
+
+	// Prints the number of deleted documents
+	fmt.Printf("Documents deleted: %d\n", result.DeletedCount)
+
+	// When you run this file for the first time, it prints output similar to the following:
+	// Documents deleted: 1
+}