DOCSP-30513: Insert Many Usage Example (#74)

(cherry picked from commit 9e6416c)

Author: norareidy

source/includes/usage-examples/code-snippets/insert-many-async.rs

@@ -0,0 +1,41 @@
+use mongodb::{ 
+    bson::doc,
+    Client,
+    Collection 
+};
+use serde::{ Deserialize, Serialize };
+
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    cuisine: String,
+}
+
+#[tokio::main]
+async fn main() -> mongodb::error::Result<()> {
+    let uri = "<connection string>";
+    let client = Client::with_uri_str(uri).await?;
+
+    let my_coll: Collection<Restaurant> = client
+        .database("sample_restaurants")
+        .collection("restaurants");
+
+    let docs = vec! [
+        Restaurant {
+            name: "While in Kathmandu".to_string(),
+            cuisine: "Nepalese".to_string(),
+        },
+        Restaurant {
+            name: "Cafe Himalaya".to_string(),
+            cuisine: "Nepalese".to_string(),
+        }
+    ];
+    
+    let insert_many_result = my_coll.insert_many(docs, None).await?;
+    println!("Inserted documents with _ids:");
+    for (_key, value) in &insert_many_result.inserted_ids {
+        println!("{}", value);
+    }
+        
+    Ok(())
+}

source/includes/usage-examples/code-snippets/insert-many-sync.rs

@@ -0,0 +1,39 @@
+use mongodb::{
+    bson::doc,
+    sync::{Client, Collection}
+};
+use serde::{ Deserialize, Serialize };
+
+#[derive(Serialize, Deserialize, Debug)]
+struct Restaurant {
+    name: String,
+    cuisine: String,
+}
+
+fn main() -> mongodb::error::Result<()> {
+    let uri = "<connection string>";
+    let client = Client::with_uri_str(uri)?;
+
+    let my_coll: Collection<Restaurant> = client
+        .database("sample_restaurants")
+        .collection("restaurants");
+
+    let docs = vec! [
+        Restaurant {
+            name: "While in Kathmandu".to_string(),
+            cuisine: "Nepalese".to_string(),
+        },
+        Restaurant {
+            name: "Cafe Himalaya".to_string(),
+            cuisine: "Nepalese".to_string(),
+        }
+    ];
+    
+    let insert_many_result = my_coll.insert_many(docs, None)?;
+    println!("Inserted documents with _ids:");
+    for (_key, value) in &insert_many_result.inserted_ids {
+        println!("{}", value);
+    }
+
+    Ok(())
+}

source/usage-examples/insertMany.txt

@@ -0,0 +1,79 @@
+.. _rust-insert-many-usage:
+
+=========================
+Insert Multiple Documents
+=========================
+
+You can insert multiple documents into a collection by calling the
+`insert_many() <{+api+}/struct.Collection.html#method.insert_many>`__ method
+on a ``Collection`` instance.
+
+Pass a vector containing one or more documents to the ``insert_many()`` method
+to insert them into your collection. These documents must be instances of the type
+that you parameterized your ``Collection`` instance with. For example, if you
+parameterized your collection with the ``MyStruct`` struct, pass a vector of ``MyStruct``
+instances as a parameter to the ``insert_many()`` method. 
+
+.. tip:: 
+
+   To insert a single document, consider using the `insert_one() 
+   <{+api+}/struct.Collection.html#method.insert_one>`__ method instead. For a
+   runnable code example that uses this method, see the :ref:`rust-insert-one-usage`
+   usage example.
+
+The ``insert_many()`` method returns an `InsertManyResult <{+api+}/results/struct.InsertManyResult.html>`__
+type that references the ``_id`` values of the inserted documents.
+
+To learn more about inserting documents into a collection, see the
+:ref:`rust-insert-guide` guide.
+
+Example
+-------
+
+This example inserts documents into the ``restaurants`` collection of the
+``sample_restaurants`` database. The example uses a ``Restaurant`` struct containing
+``name`` and ``cuisine`` fields to model the documents being inserted into the
+collection.
+
+This example passes a vector of documents as a parameter to the ``insert_many()``
+method.
+
+Select the **Asynchronous** or **Synchronous** tab to see corresponding code for each runtime:
+
+.. tabs::
+
+   .. tab:: Asynchronous
+      :tabid: find-async
+
+      .. io-code-block::
+         :copyable: true
+
+        .. input:: /includes/usage-examples/code-snippets/insert-many-async.rs
+            :language: rust
+            :dedent:
+
+        .. output::
+            :language: console
+            :visible: false
+
+            Inserted documents with _ids:
+            ObjectId("...")
+            ObjectId("...")
+
+   .. tab:: Synchronous
+      :tabid: find-sync
+
+      .. io-code-block::
+         :copyable: true
+
+        .. input:: /includes/usage-examples/code-snippets/insert-many-sync.rs
+            :language: rust
+            :dedent:
+
+        .. output::
+            :language: console
+            :visible: false
+
+            Inserted documents with _ids:
+            ObjectId("...")
+            ObjectId("...")