From d3da4b03123ba6702433c2d3de3bce76bdada973 2013-12-04 19:40:51
From: Thomas Kluyver <takowl@gmail.com>
Date: 2013-12-04 19:40:51
Subject: [PATCH] Allow docs to build without PyQt installed.

PyQt/PySide is needed to list the config options for the Qt console. But
some environments and contributors may not have it, and it's not always
easy to install. This prints a warning and skips the list of Qt console
options if the import fails.

---

diff --git a/docs/autogen_config.py b/docs/autogen_config.py
index a2538b4..0995a46 100644
--- a/docs/autogen_config.py
+++ b/docs/autogen_config.py
@@ -3,7 +3,6 @@ from IPython.utils.text import indent, wrap_paragraphs
 from IPython.terminal.ipapp import TerminalIPythonApp
 from IPython.kernel.zmq.kernelapp import IPKernelApp
 from IPython.html.notebookapp import NotebookApp
-from IPython.qt.console.qtconsoleapp import IPythonQtConsoleApp
 
 def document_config_options(classes):
     lines = []
@@ -66,9 +65,16 @@ if __name__ == '__main__':
     nbclasses = set(NotebookApp().classes) - set(kernel_classes)
     write_doc('notebook', 'IPython notebook options', nbclasses,
               preamble="Any of the :doc:`kernel` can also be used.")
-    qtclasses = set(IPythonQtConsoleApp().classes) - set(kernel_classes)
-    write_doc('qtconsole', 'IPython Qt console options', qtclasses,
-              preamble="Any of the :doc:`kernel` can also be used.")
+
+    try:
+        from IPython.qt.console.qtconsoleapp import IPythonQtConsoleApp
+    except ImportError:
+        print("WARNING: Could not import qtconsoleapp. Config options for the "
+              "Qt Console will not be documented.")
+    else:
+        qtclasses = set(IPythonQtConsoleApp().classes) - set(kernel_classes)
+        write_doc('qtconsole', 'IPython Qt console options', qtclasses,
+                  preamble="Any of the :doc:`kernel` can also be used.")
 
     with open('source/config/options/generated', 'w'):
         pass
\ No newline at end of file