Update Image renderers with engine parameter

Don't auto-start orca when image renderer is activated because now we might not end up using orca.
plotly · jonmmease · Jul 14, 2020 · Jul 3, 2020 · Jul 3, 2020 · Jul 7, 2020
commit da4cb83cf7c0ccb239c7dc7f11f3d51223c80875
diff --git a/packages/python/plotly/plotly/io/_base_renderers.py b/packages/python/plotly/plotly/io/_base_renderers.py
@@ -112,6 +112,7 @@ def __init__(
         width=None,
         height=None,
         scale=None,
+        engine="auto",
     ):
 
         self.mime_type = mime_type
@@ -120,10 +121,7 @@ def __init__(
         self.width = width
         self.height = height
         self.scale = scale
-
-    def activate(self):
-        # Start up orca server to reduce the delay on first render
-        ensure_server()
+        self.engine = engine
 
     def to_mimebundle(self, fig_dict):
         image_bytes = to_image(
@@ -133,6 +131,7 @@ def to_mimebundle(self, fig_dict):
             height=self.height,
             scale=self.scale,
             validate=False,
+            engine=self.engine,
         )
 
         if self.b64_encode:
@@ -146,83 +145,87 @@ def to_mimebundle(self, fig_dict):
 class PngRenderer(ImageRenderer):
     """
     Renderer to display figures as static PNG images.  This renderer requires
-    the orca command-line utility and is broadly compatible across IPython
-    environments (classic Jupyter Notebook, JupyterLab, QtConsole, VSCode,
-    PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
+    either the kaleido package or the orca command-line utility and is broadly
+    compatible across IPython environments (classic Jupyter Notebook, JupyterLab,
+    QtConsole, VSCode, PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
 
     mime type: 'image/png'
     """
 
-    def __init__(self, width=None, height=None, scale=None):
+    def __init__(self, width=None, height=None, scale=None, engine="auto"):
         super(PngRenderer, self).__init__(
             mime_type="image/png",
             b64_encode=True,
             format="png",
             width=width,
             height=height,
             scale=scale,
+            engine=engine,
         )
 
 
 class SvgRenderer(ImageRenderer):
     """
     Renderer to display figures as static SVG images.  This renderer requires
-    the orca command-line utility and is broadly compatible across IPython
-    environments (classic Jupyter Notebook, JupyterLab, QtConsole, VSCode,
-    PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
+    either the kaleido package or the orca command-line utility and is broadly
+    compatible across IPython environments (classic Jupyter Notebook, JupyterLab,
+    QtConsole, VSCode, PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
 
     mime type: 'image/svg+xml'
     """
 
-    def __init__(self, width=None, height=None, scale=None):
+    def __init__(self, width=None, height=None, scale=None, engine="auto"):
         super(SvgRenderer, self).__init__(
             mime_type="image/svg+xml",
             b64_encode=False,
             format="svg",
             width=width,
             height=height,
             scale=scale,
+            engine=engine,
         )
 
 
 class JpegRenderer(ImageRenderer):
     """
     Renderer to display figures as static JPEG images.  This renderer requires
-    the orca command-line utility and is broadly compatible across IPython
-    environments (classic Jupyter Notebook, JupyterLab, QtConsole, VSCode,
-    PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
+    either the kaleido package or the orca command-line utility and is broadly
+    compatible across IPython environments (classic Jupyter Notebook, JupyterLab,
+    QtConsole, VSCode, PyCharm, etc) and nbconvert targets (HTML, PDF, etc.).
 
     mime type: 'image/jpeg'
     """
 
-    def __init__(self, width=None, height=None, scale=None):
+    def __init__(self, width=None, height=None, scale=None, engine="auto"):
         super(JpegRenderer, self).__init__(
             mime_type="image/jpeg",
             b64_encode=True,
             format="jpg",
             width=width,
             height=height,
             scale=scale,
+            engine=engine,
         )
 
 
 class PdfRenderer(ImageRenderer):
     """
     Renderer to display figures as static PDF images.  This renderer requires
-    the orca command-line utility and is compatible with JupyterLab and the
-    LaTeX-based nbconvert export to PDF.
+    either the kaleido package or the orca command-line utility and is compatible
+    with JupyterLab and the LaTeX-based nbconvert export to PDF.
 
     mime type: 'application/pdf'
     """
 
-    def __init__(self, width=None, height=None, scale=None):
+    def __init__(self, width=None, height=None, scale=None, engine="auto"):
         super(PdfRenderer, self).__init__(
             mime_type="application/pdf",
             b64_encode=True,
             format="pdf",
             width=width,
             height=height,
             scale=scale,
+            engine=engine,
         )