DOCSP-19088 code snippet updates (#70)

* updated all code snippets

Author: kyuan-mongodb

source/fundamentals/crud/read-operations/sort.txt

@@ -74,7 +74,6 @@ The following example specifies an ascending sort on the ``rating`` field:
    :dedent:
    :start-after: begin ascending sort
    :end-before: end ascending sort
-   :emphasize-lines: 2-3, 5
 
 After running this example, the output resembles the following:
 
@@ -111,7 +110,6 @@ The following example specifies a descending sort on the ``rating`` field:
    :dedent:
    :start-after: begin descending sort
    :end-before: end descending sort
-   :emphasize-lines: 2-3, 5
 
 After running this example, the output resembles the following:
 
@@ -154,7 +152,6 @@ then a descending sort on the ``type`` field:
    :dedent:
    :start-after: begin multi sort
    :end-before: end multi sort
-   :emphasize-lines: 2-3, 5
 
 After running this example, the output resembles the following:
 

source/fundamentals/crud/write-operations/change-a-document.txt

@@ -287,8 +287,8 @@ For more information on update operators,
 see the :manual:`MongoDB update operator reference documentation
 </reference/operator/update/#update-operators>`.
 
-For runnable examples of the update operations, see the following usage
-examples:
+For runnable examples of the update and replace operations, see the
+following usage examples:
 
 - :doc:`Update a Document </usage-examples/updateOne>`
 - :doc:`Update Multiple Documents </usage-examples/updateMany>`

source/includes/fundamentals/code-snippets/CRUD/compoundOperations.go

@@ -14,7 +14,7 @@ import (
 func main() {
 	var uri string
 	if uri = os.Getenv("MONGODB_URI"); uri == "" {
-		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/")
+		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/#environment-variable")
 	}
 
 	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
@@ -40,9 +40,9 @@ func main() {
 		bson.D{{"type", "English Breakfast"}, {"rating", 5}},
 	}
 
-	result, insertErr := coll.InsertMany(context.TODO(), docs)
-	if insertErr != nil {
-		panic(insertErr)
+	result, err := coll.InsertMany(context.TODO(), docs)
+	if err != nil {
+		panic(err)
 	}
 	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 	//end insertDocs

source/includes/fundamentals/code-snippets/CRUD/delete.go

@@ -14,7 +14,7 @@ import (
 func main() {
 	var uri string
 	if uri = os.Getenv("MONGODB_URI"); uri == "" {
-		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/")
+		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/#environment-variable")
 	}
 
 	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
@@ -39,21 +39,25 @@ func main() {
 		bson.D{{"type", "Assam"}, {"rating", 7}},
 	}
 
-	result, insertErr := coll.InsertMany(context.TODO(), docs)
-	if insertErr != nil {
-		panic(insertErr)
+	result, err := coll.InsertMany(context.TODO(), docs)
+	if err != nil {
+		panic(err)
 	}
 	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 	// end insertDocs
 
-	// begin deleteMany
-	deleteManyFilter := bson.D{{"rating", bson.D{{"$gt", 8}}}}
-	deleteOptions := options.Delete().SetHint(bson.D{{"_id", 1}})
+	fmt.Println("Delete Many:")
+	{
+		// begin deleteMany
+		filter := bson.D{{"rating", bson.D{{"$gt", 8}}}}
+		opts := options.Delete().SetHint(bson.D{{"_id", 1}})
+
+		result, err := coll.DeleteMany(context.TODO(), filter, opts)
+		if err != nil {
+			panic(err)
+		}
 
-	deleteManyResult, deleteManyErr := coll.DeleteMany(context.TODO(), deleteManyFilter, deleteOptions)
-	fmt.Printf("Number of documents deleted: %d\n", deleteManyResult.DeletedCount)
-	// end deleteMany
-	if deleteManyErr != nil {
-		panic(deleteManyErr)
+		fmt.Printf("Number of documents deleted: %d\n", result.DeletedCount)
+		// end deleteMany
 	}
 }

source/includes/fundamentals/code-snippets/CRUD/limit.go

@@ -14,7 +14,7 @@ import (
 func main() {
 	var uri string
 	if uri = os.Getenv("MONGODB_URI"); uri == "" {
-		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/")
+		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/#environment-variable")
 	}
 
 	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
@@ -40,60 +40,66 @@ func main() {
 		bson.D{{"type", "English Breakfast"}, {"rating", 5}},
 	}
 
-	result, insertErr := coll.InsertMany(context.TODO(), docs)
-	if insertErr != nil {
-		panic(insertErr)
+	result, err := coll.InsertMany(context.TODO(), docs)
+	if err != nil {
+		panic(err)
 	}
 	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 	//end insertDocs
 
 	fmt.Println("Limit:")
-	//begin limit
-	limitFilter := bson.D{}
-	limitOptions := options.Find().SetLimit(2)
+	{
+		//begin limit
+		filter := bson.D{}
+		opts := options.Find().SetLimit(2)
 
-	limitCursor, limitErr := coll.Find(context.TODO(), limitFilter, limitOptions)
+		cursor, err := coll.Find(context.TODO(), filter, opts)
 
-	var limitResults []bson.D
-	if limitErr = limitCursor.All(context.TODO(), &limitResults); limitErr != nil {
-		panic(limitErr)
-	}
-	for _, result := range limitResults {
-		fmt.Println(result)
+		var results []bson.D
+		if err = cursor.All(context.TODO(), &results); err != nil {
+			panic(err)
+		}
+		for _, result := range results {
+			fmt.Println(result)
+		}
+		//end limit
 	}
-	//end limit
 
 	fmt.Println("Limit, Skip and Sort:")
-	//begin multi options
-	multiFilter := bson.D{}
-	multiOptions := options.Find().SetSort(bson.D{{"rating", -1}}).SetLimit(2).SetSkip(1)
+	{
+		//begin multi options
+		filter := bson.D{}
+		opts := options.Find().SetSort(bson.D{{"rating", -1}}).SetLimit(2).SetSkip(1)
 
-	multiCursor, multiErr := coll.Find(context.TODO(), multiFilter, multiOptions)
+		cursor, err := coll.Find(context.TODO(), filter, opts)
 
-	var multiResults []bson.D
-	if multiErr = multiCursor.All(context.TODO(), &multiResults); multiErr != nil {
-		panic(multiErr)
-	}
-	for _, result := range multiResults {
-		fmt.Println(result)
+		var results []bson.D
+		if err = cursor.All(context.TODO(), &results); err != nil {
+			panic(err)
+		}
+		for _, result := range results {
+			fmt.Println(result)
+		}
+		//end multi options
 	}
-	//end multi options
 
 	fmt.Println("Aggregation Limit:")
-	// begin aggregate limit
-	limitStage := bson.D{{"$limit", 3}}
+	{
+		// begin aggregate limit
+		limitStage := bson.D{{"$limit", 3}}
 
-	aggCursor, aggErr := coll.Aggregate(context.TODO(), mongo.Pipeline{limitStage})
-	if aggErr != nil {
-		panic(aggErr)
-	}
+		cursor, err := coll.Aggregate(context.TODO(), mongo.Pipeline{limitStage})
+		if err != nil {
+			panic(err)
+		}
 
-	var aggResults []bson.D
-	if aggErr = aggCursor.All(context.TODO(), &aggResults); aggErr != nil {
-		panic(aggErr)
-	}
-	for _, result := range aggResults {
-		fmt.Println(result)
+		var results []bson.D
+		if err = cursor.All(context.TODO(), &results); err != nil {
+			panic(err)
+		}
+		for _, result := range results {
+			fmt.Println(result)
+		}
+		// end aggregate limit
 	}
-	// end aggregate limit
-}
+}

source/includes/fundamentals/code-snippets/CRUD/retrieve.go

@@ -14,7 +14,7 @@ import (
 func main() {
 	var uri string
 	if uri = os.Getenv("DRIVER_REF_URI"); uri == "" {
-		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/")
+		log.Fatal("You must set your 'MONGODB_URI' environmental variable. See\n\t https://docs.mongodb.com/drivers/go/current/usage-examples/#environment-variable")
 	}
 
 	client, err := mongo.Connect(context.TODO(), options.Client().ApplyURI(uri))
@@ -43,76 +43,78 @@ func main() {
 	if err != nil {
 		panic(err)
 	}
-	fmt.Printf("%d documents inserted with IDs:\n", len(result.InsertedIDs))
+	fmt.Printf("Number of documents inserted: %d\n", len(result.InsertedIDs))
 	// end insert docs
 
-	for _, id := range result.InsertedIDs {
-		fmt.Printf("\t%s\n", id)
-	}
-
 	fmt.Println("Find:")
-	// begin find docs
-	findFilter := bson.D{
-		{"$and",
-			bson.A{
-				bson.D{{"rating", bson.D{{"$gt", 5}}}},
-				bson.D{{"rating", bson.D{{"$lt", 10}}}},
-			}},
-	}
-	findProjection := bson.D{{"type", 1}, {"rating", 1}, {"_id", 0}}
-	findOptions := options.Find().SetProjection(findProjection)
+	{
+		// begin find docs
+		filter := bson.D{
+			{"$and",
+				bson.A{
+					bson.D{{"rating", bson.D{{"$gt", 5}}}},
+					bson.D{{"rating", bson.D{{"$lt", 10}}}},
+				}},
+		}
+		projection := bson.D{{"type", 1}, {"rating", 1}, {"_id", 0}}
+		opts := options.Find().SetProjection(projection)
 
-	findCursor, findErr := coll.Find(context.TODO(), findFilter, findOptions)
-	if findErr != nil {
-		panic(findErr)
-	}
+		cursor, err := coll.Find(context.TODO(), filter, opts)
+		if err != nil {
+			panic(err)
+		}
 
-	var findResults []bson.D
-	if findErr = findCursor.All(context.TODO(), &findResults); findErr != nil {
-		panic(findErr)
-	}
-	for _, result := range findResults {
-		fmt.Println(result)
+		var results []bson.D
+		if err = cursor.All(context.TODO(), &results); err != nil {
+			panic(err)
+		}
+		for _, result := range results {
+			fmt.Println(result)
+		}
+		// end find docs
 	}
-	// end find docs
 
 	fmt.Println("Find One:")
-	// begin find one docs
-	findOneFilter := bson.D{}
-	findOnesort := bson.D{{"rating", -1}}
-	findOneprojection := bson.D{{"type", 1}, {"rating", 1}, {"_id", 0}}
-	findOneOptions := options.FindOne().SetSort(findOnesort).SetProjection(findOneprojection)
-
-	var findOneResult bson.D
-	findOneErr := coll.FindOne(context.TODO(), findOneFilter, findOneOptions).Decode(&findOneResult)
-	if findOneErr != nil {
-		panic(findOneErr)
+	{
+		// begin find one docs
+		filter := bson.D{}
+		sort := bson.D{{"rating", -1}}
+		projection := bson.D{{"type", 1}, {"rating", 1}, {"_id", 0}}
+		opts := options.FindOne().SetSort(sort).SetProjection(projection)
+
+		var result bson.D
+		err := coll.FindOne(context.TODO(), filter, opts).Decode(&result)
+		if err != nil {
+			panic(err)
+		}
+
+		fmt.Println(result)
+		// end find one docs
 	}
-	
-	fmt.Println(findOneResult)
-	// end find one docs	
 
 	fmt.Println("Aggregation:")
-	// begin aggregate docs
-	groupStage := bson.D{
-		{"$group", bson.D{
-			{"_id", "$type"},
-			{"average", bson.D{
-				{"$avg", "$rating"},
-			}},
-		}}}
-
-	aggCursor, aggErr := coll.Aggregate(context.TODO(), mongo.Pipeline{groupStage})
-	if aggErr != nil {
-		panic(aggErr)
-	}
+	{
+		// begin aggregate docs
+		groupStage := bson.D{
+			{"$group", bson.D{
+				{"_id", "$type"},
+				{"average", bson.D{
+					{"$avg", "$rating"},
+				}},
+			}}}
+
+		cursor, err := coll.Aggregate(context.TODO(), mongo.Pipeline{groupStage})
+		if err != nil {
+			panic(err)
+		}
 
-	var aggResults []bson.M
-	if aggErr = aggCursor.All(context.TODO(), &aggResults); aggErr != nil {
-		panic(aggErr)
-	}
-	for _, result := range aggResults {
-		fmt.Printf("%v has an average rating of %v \n", result["_id"], result["average"])
+		var results []bson.M
+		if err = cursor.All(context.TODO(), &results); err != nil {
+			panic(err)
+		}
+		for _, result := range results {
+			fmt.Printf("%v has an average rating of %v \n", result["_id"], result["average"])
+		}
+		// end aggregate docs
 	}
-	// end aggregate docs
 }