Add the toyplot.hou module making it easier to display Toyplot plots in Houdini (https://sidefx.com).

Author: tshead

docs/reference.rst

@@ -19,6 +19,7 @@ Python API
     toyplot.data.rst
     toyplot.font.rst
     toyplot.format.rst
+    toyplot.hou.rst
     toyplot.html.rst
     toyplot.layout.rst
     toyplot.locator.rst

docs/toyplot.hou.rst

@@ -0,0 +1,7 @@
+toyplot.hou module
+==================
+
+.. automodule:: toyplot.hou
+    :members:
+    :undoc-members:
+    :show-inheritance:

toyplot/hou.py

@@ -0,0 +1,57 @@
+# Copyright 2014, Sandia Corporation. Under the terms of Contract
+# DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government retains certain
+# rights in this software.
+
+"""Functionality for displaying a Toyplot canvas in a Houdini help browser."""
+
+
+import collections
+
+def show(canvases, title="Toyplot Figure"):
+    """Display one or more canvases in a Houdini (https://sidefx.com) help browser.
+
+    Uses Toyplot's preferred HTML+SVG+Javascript backend to display one-or-more
+    interactive canvases in a floating help browser in Houdini (https://sidefx.com).
+
+    Because the canvases are displayed in a separate web browser process, this
+    function returns immediately.
+
+    Parameters
+    ----------
+    canvases: :class:`toyplot.canvas.Canvas` instance or sequence of :class:`toyplot.canvas.Canvas` instances.
+      The canvases to be displayed.
+
+    title: string, optional
+      Optional page title to be displayed by the browser.
+    """
+
+    import os
+    import tempfile
+    import xml.etree.ElementTree as xml
+
+    import hou
+
+    import toyplot.canvas
+    import toyplot.html
+
+    if not isinstance(canvases, (toyplot.canvas.Canvas, collections.abc.Iterable)):
+        raise ValueError("Expected one or more instances of %s, received %s." % (toyplot.canvas.Canvas, type(canvases))) # pragma: no cover
+
+    if isinstance(canvases, toyplot.canvas.Canvas):
+        canvases = [canvases]
+
+    html = xml.Element("html")
+    head = xml.SubElement(html, "head")
+    xml.SubElement(head, "title").text = title
+    body = xml.SubElement(html, "body")
+    for canvas in canvases:
+        body.append(toyplot.html.render(canvas))
+
+    fd, path = tempfile.mkstemp(suffix=".html")
+    with os.fdopen(fd, "wb") as stream:
+        stream.write(xml.tostring(html, method="html"))
+
+    browser = hou.ui.curDesktop().createFloatingPaneTab(hou.paneTabType.HelpBrowser)
+    browser.setUrl(f"file://{path}")
+
+    return browser