DOCSP-38960: Add Atlas code to landing page (#10)

* DOCSP-38960: Add Atlas code to landing page

* wording

* source constant

Author: norareidy

source/includes/c-connection-no-stable-api.c

@@ -0,0 +1,52 @@
+#include <mongoc/mongoc.h>
+
+int main(void) {
+    mongoc_client_t *client = NULL;
+    bson_error_t error = {0};
+    mongoc_database_t *database = NULL;
+    bson_t *command = NULL;
+    bson_t reply = BSON_INITIALIZER;
+    int rc = 0;
+    bool ok = true;
+
+    // Initialize the MongoDB C Driver.
+    mongoc_init();
+
+    client = mongoc_client_new("<connection string>");
+    if (!client) {
+        fprintf(stderr, "Failed to create a MongoDB client.\n");
+        rc = 1;
+        goto cleanup;
+    }
+
+    // Get a handle on the "admin" database.
+    database = mongoc_client_get_database(client, "admin");
+    if (!database) {
+        fprintf(stderr, "Failed to get a MongoDB database handle.\n");
+        rc = 1;
+        goto cleanup;
+    }
+
+    // Ping the database.
+    command = BCON_NEW("ping", BCON_INT32(1));
+    ok = mongoc_database_command_simple(
+        database, command, NULL, &reply, &error
+    );
+    if (!ok) {
+        fprintf(stderr, "error: %s\n", error.message);
+        rc = 1;
+        goto cleanup;
+    }
+    bson_destroy(&reply);
+
+    printf("Pinged your deployment. You successfully connected to MongoDB!\n");
+
+// Perform cleanup.
+cleanup:
+    bson_destroy(command);
+    mongoc_database_destroy(database);
+    mongoc_client_destroy(client);
+    mongoc_cleanup();
+
+    return rc;
+}

source/includes/c-connection.c

@@ -0,0 +1,69 @@
+#include <mongoc/mongoc.h>
+
+int main(void) {
+    mongoc_client_t *client = NULL;
+    bson_error_t error = {0};
+    mongoc_server_api_t *api = NULL;
+    mongoc_database_t *database = NULL;
+    bson_t *command = NULL;
+    bson_t reply = BSON_INITIALIZER;
+    int rc = 0;
+    bool ok = true;
+
+    // Initialize the MongoDB C Driver.
+    mongoc_init();
+
+    client = mongoc_client_new("<connection string>");
+    if (!client) {
+        fprintf(stderr, "Failed to create a MongoDB client.\n");
+        rc = 1;
+        goto cleanup;
+    }
+
+    // Set the version of the Stable API on the client.
+    api = mongoc_server_api_new(MONGOC_SERVER_API_V1);
+    if (!api) {
+        fprintf(stderr, "Failed to create a MongoDB server API.\n");
+        rc = 1;
+        goto cleanup;
+    }
+
+    ok = mongoc_client_set_server_api(client, api, &error);
+    if (!ok) {
+        fprintf(stderr, "error: %s\n", error.message);
+        rc = 1;
+        goto cleanup;
+    }
+
+    // Get a handle on the "admin" database.
+    database = mongoc_client_get_database(client, "admin");
+    if (!database) {
+        fprintf(stderr, "Failed to get a MongoDB database handle.\n");
+        rc = 1;
+        goto cleanup;
+    }
+
+    // Ping the database.
+    command = BCON_NEW("ping", BCON_INT32(1));
+    ok = mongoc_database_command_simple(
+        database, command, NULL, &reply, &error
+    );
+    if (!ok) {
+        fprintf(stderr, "error: %s\n", error.message);
+        rc = 1;
+        goto cleanup;
+    }
+    bson_destroy(&reply);
+
+    printf("Pinged your deployment. You successfully connected to MongoDB!\n");
+
+// Perform cleanup.
+cleanup:
+    bson_destroy(command);
+    mongoc_database_destroy(database);
+    mongoc_server_api_destroy(api);
+    mongoc_client_destroy(client);
+    mongoc_cleanup();
+
+    return rc;
+}

source/index.txt

@@ -53,6 +53,39 @@ following our tutorial.
 
 - `Additional BSON Examples <https://github.com/mongodb/mongo-c-driver/tree/master/src/libbson/examples>`__
 
+Connect to MongoDB Atlas
+------------------------
+
+You can use the following connection snippet to test your connection to your
+MongoDB deployment on Atlas:
+
+.. literalinclude:: /includes/c-connection.c
+   :language: c
+
+This connection snippet uses the Stable API feature. You can access this feature
+when connecting to MongoDB Server v5.0 and later and using the C driver v1.18 and later.
+
+When you use this feature, you can update your driver or server without
+worrying about backward compatibility issues with any commands covered by the
+Stable API.
+
+.. note::
+
+   Starting from February 2022, the **Versioned API** is known as the **Stable API**.
+   All concepts and features remain the same with this naming change.
+
+.. _connect-atlas-no-stable-api-c-driver:
+
+Connect to MongoDB Atlas Without the Stable API
+-----------------------------------------------
+
+If you are using a version of MongoDB or the driver that lacks support for the
+Stable API, you can use the following code snippet to test your connection
+to your MongoDB deployment on Atlas:
+
+.. literalinclude:: /includes/c-connection-no-stable-api.c
+   :language: c
+
 Compatibility
 -------------