Coordinating docs with new logging

doc/conf.py

@@ -26,6 +26,7 @@
 # All configuration values have a default; values that are commented out
 # serve to show the default.
 
+import logging
 import pathlib
 import re
 import warnings
@@ -173,6 +174,9 @@ def setup(app):
 # The full version, including alpha/beta/rc tags.
 release = armi.__version__
 
+# from here on out, we use the std library default logging
+logging.setLoggerClass(logging.Logger)
+
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
 # language = None

doc/gallery-src/analysis/run_hexBlockToRZConversion.py

@@ -21,19 +21,24 @@
 the design in real geometry while still performing appropriate approximations for
 efficient analysis.
 
-.. warning:: 
+.. warning::
     This uses :py:mod:`armi.reactor.converters.blockConverters`, which
     currently only works on a constrained set of hex-based geometries. For your systems,
     consider these an example and starting point and build your own converters as
     appropriate.
 
 """
+import logging
 
 from armi.reactor.tests import test_reactors
 from armi.reactor.flags import Flags
 from armi.reactor.converters import blockConverters
-from armi import configure
+from armi import configure, runLog
 
+# init ARMI logging tools
+logging.setLoggerClass(runLog.RunLogger)
+
+# configure ARMI
 configure(permissive=True)
 
 _o, r = test_reactors.loadTestReactor()
@@ -45,3 +50,6 @@
 )
 converter.convert()
 converter.plotConvertedBlock()
+
+# revert back to std library logging
+logging.setLoggerClass(logging.Logger)

setup.py

@@ -83,7 +83,7 @@ def collectExtraFiles():
             "pytest-html",
             "pylint",
             "docutils",
-            "sphinx>=2.2",
+            "sphinx==2.2",
             "sphinx-rtd-theme",
             "black",
             # for running jupyter dynamically in docs