PYTHON-3146 Test Failure - Could not import extension sphinxcontrib.shellcheck (#889)

Author: blink1073

doc/conf.py

@@ -21,9 +21,18 @@
     "sphinx.ext.coverage",
     "sphinx.ext.todo",
     "sphinx.ext.intersphinx",
-    "sphinxcontrib.shellcheck",
 ]
 
+
+# Add optional extensions
+try:
+    import sphinxcontrib.shellcheck  # noqa
+
+    extensions += ["sphinxcontrib.shellcheck"]
+except ImportError:
+    pass
+
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
 

doc/examples/bulk.rst

@@ -145,7 +145,7 @@ and fourth operations succeed.
                     'index': 0,...
                     'op': {'_id': 1}},
                    {'code': 11000,
-                    'errmsg': '...E11000...duplicate key error...',
+                    'errmsg': '...',
                     'index': 2,...
                     'op': {'_id': 3}}]}
 

doc/examples/geo.rst

@@ -36,7 +36,7 @@ insert a couple of example locations:
   >>> result = db.places.insert_many([{"loc": [2, 5]},
   ...                                 {"loc": [30, 5]},
   ...                                 {"loc": [1, 2]},
-  ...                                 {"loc": [4, 4]}])  # doctest: +ELLIPSIS
+  ...                                 {"loc": [4, 4]}])
   >>> result.inserted_ids
   [ObjectId('...'), ObjectId('...'), ObjectId('...'), ObjectId('...')]
 

doc/faq.rst

@@ -264,12 +264,7 @@ collection, configured to use :class:`~bson.son.SON` instead of dict:
   >>> from bson import CodecOptions, SON
   >>> opts = CodecOptions(document_class=SON)
   >>> opts
-  CodecOptions(document_class=<class 'bson.son.SON'>,
-               tz_aware=False,
-               uuid_representation=UuidRepresentation.UNSPECIFIED,
-               unicode_decode_error_handler='strict',
-               tzinfo=None, type_registry=TypeRegistry(type_codecs=[],
-                                                       fallback_encoder=None))
+  CodecOptions(document_class=...SON..., tz_aware=False, uuid_representation=UuidRepresentation.UNSPECIFIED, unicode_decode_error_handler='strict', tzinfo=None, type_registry=TypeRegistry(type_codecs=[], fallback_encoder=None))
   >>> collection_son = collection.with_options(codec_options=opts)
 
 Now, documents and subdocuments in query results are represented with