(DOCSP-8172) - adds Rust driver content

Author: terakilobyte

source/drivers.txt

@@ -45,6 +45,7 @@ For information on MongoDB licensing, see `MongoDB Licensing
       Mongoid ODM  <https://docs.mongodb.com/mongoid/current/>
       Scala Driver </drivers/scala>
       Swift Driver </drivers/swift>
+      Rust Driver </drivers/rust>
 
 MongoDB ODM (Object-Document-Mapper)
 ------------------------------------

source/drivers/rust.txt

@@ -0,0 +1,88 @@
+.. _rust-language-center:
+
+.. include:: /includes/unicode-checkmark.rst
+
+===================
+MongoDB Rust Driver
+===================
+
+.. default-domain:: mongodb
+
+.. contents:: On this page
+   :local:
+   :backlinks: none
+   :depth: 1
+   :class: twocols
+
+Introduction
+------------
+
+This is the official MongoDB Rust Driver.
+
+.. admonition:: Alpha Release
+   :class: important
+
+   The MongoDB Rust Driver is currently in alpha.
+
+- `Usage Guide <https://github.com/mongodb/mongo-rust-driver#example-usage>`__
+
+- `API Reference <https://docs.rs/mongodb/latest/mongodb/>`__
+
+- `Changelog <https://github.com/mongodb/mongo-rust-driver/releases>`__
+
+- `Source Code <https://github.com/mongodb/mongo-rust-driver/>`__
+
+
+Installation
+------------
+
+See `Installation <https://github.com/mongodb/mongo-rust-driver#Installation>`__
+
+
+Connect to MongoDB Atlas
+------------------------
+
+To connect to a :atlas:`MongoDB Atlas </>` cluster, use the :atlas:`Atlas connection string </driver-connection>` for your cluster:
+
+.. code-block:: rust
+
+   use bson::doc;
+   use mongodb::{options::ClientOptions, Client};
+
+   fn main() -> mongodb::error::Result<()> {
+       // Parse a connection string into an options struct.
+       let mut client_options =
+           ClientOptions::parse("mongodb+srv://<username>:<password>@<cluster-url>/test?w=majority")?;
+
+       // Manually set an option.
+       client_options.app_name = Some("Rust Demo".to_string());
+
+       // Get a handle to the deployment.
+       let client = Client::with_options(client_options)?;
+
+       client
+           .database("admin")
+           .run_command(doc! {"ping": 1}, None)?;
+       println!("Connected successfully.");
+
+       // List the names of the databases in that deployment.
+       for db_name in client.list_database_names(None)? {
+           println!("{}", db_name);
+       }
+       Ok(())
+   }
+
+Compatibility
+-------------
+
+MongoDB Compatibility
+~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/mongodb-compatibility-table-rust.rst
+
+Language Compatibility
+~~~~~~~~~~~~~~~~~~~~~~
+
+.. include:: /includes/language-compatibility-table-rust.rst
+
+.. include:: /includes/help-links-rust.rst

source/includes/driver-table.rst

@@ -107,6 +107,13 @@
      - `API <https://mongodb.github.io/mongo-swift-driver/>`__
      - :issue:`JIRA <SWIFT>`
      -
+
+   * - :doc:`Rust </drivers/rust>`
+     - `Releases <https://github.com/mongodb/mongo-rust-driver/releases>`__
+     - `Source <https://github.com/mongodb/mongo-rust-driver>`__
+     - `API <https://docs.rs/mongodb/latest/mongodb/>`__
+     - :issue:`JIRA <RUST>`
+     -
 ..
    * - :doc:`Haskell </drivers/haskell>`
      - `Releases <https://github.com/mongodb/mongodb-haskell/releases>`__

source/includes/help-links-rust.rst

@@ -0,0 +1,7 @@
+How to get help
+---------------
+
+- Ask questions on our :community-forum:`MongoDB Community Forums <>`.
+- Visit our :technical-support:`Support Channels </>`.
+- See our :issue:`RUST <RUST>` JIRA project to raise issues or request
+  features.

source/includes/language-compatibility-table-rust.rst

@@ -0,0 +1 @@
+The MongoDB Rust driver requires Rust 1.39 or later.

source/includes/mongodb-compatibility-table-rust.rst

@@ -0,0 +1,22 @@
+.. list-table::
+   :header-rows: 1
+   :stub-columns: 1
+   :class: compatibility-large
+
+   * - Rust Driver
+     - MongoDB 4.2
+     - MongoDB 4.0
+     - MongoDB 3.6
+     - MongoDB 3.4
+     - MongoDB 3.2
+     - MongoDB 3.0
+     - MongoDB 2.6
+
+   * - 0.9.x
+     - |checkmark|
+     - |checkmark|
+     - |checkmark|
+     -
+     -
+     -
+     -