Authentication Usage Examples (#65)

Author: mongoKart

snooty.toml

@@ -6,6 +6,7 @@ toc_landing_pages = [
     "/read",
     "/connect",
     "/indexes",
+    "/security",
     "/aggregation-tutorials",
 ]
 

source/includes/usage-examples/sample-app-intro.rst

@@ -0,0 +1,9 @@
+Sample Application
+~~~~~~~~~~~~~~~~~~
+
+You can use the following sample application to test the code examples on this
+page. To use the sample application, perform the following steps:
+
+1. Ensure you have {+driver-short+} installed.
+#. Copy the following code and paste it into a new ``.py`` file.
+#. Copy a code example from this page and paste it on the specified lines in the file.

source/includes/usage-examples/sample-app.py

@@ -0,0 +1,19 @@
+# start sample app
+from pymongo import MongoClient
+
+try:
+    # start authentication code here
+
+    # end authentication code here
+
+    client.admin.command("ping")
+    print("Authenticated successfully")
+
+    # other application code
+
+    client.close()
+
+except Exception as e:
+    raise Exception(
+        "The following error occurred: ", e)
+# end sample app