plotly.io HTML functions, modular renderers framework, future flags system

.circleci/create_conda_optional_env.sh

@@ -16,7 +16,7 @@ if [ ! -d $HOME/miniconda/envs/circle_optional ]; then
     # Create environment
     # PYTHON_VERSION=3.6
     $HOME/miniconda/bin/conda create -n circle_optional --yes python=$PYTHON_VERSION \
-requests six pytz retrying psutil pandas decorator pytest mock nose poppler xarray scikit-image
+requests six pytz retrying psutil pandas decorator pytest mock nose poppler xarray scikit-image ipython
 
     # Install orca into environment
     $HOME/miniconda/bin/conda install --yes -n circle_optional -c plotly plotly-orca

_plotly_future_/__init__.py

@@ -0,0 +1,8 @@
+_future_flags = set()
+
+
+def _assert_plotly_not_imported():
+    import sys
+    if 'plotly' in sys.modules:
+        raise ImportError("""\
+The _plotly_future_ module must be imported before the plotly module""")

_plotly_future_/renderer_defaults.py

@@ -0,0 +1,5 @@
+from __future__ import absolute_import
+from _plotly_future_ import _future_flags, _assert_plotly_not_imported
+
+_assert_plotly_not_imported()
+_future_flags.add('renderer_defaults')

_plotly_future_/template_defaults.py

@@ -0,0 +1,5 @@
+from __future__ import absolute_import
+from _plotly_future_ import _future_flags, _assert_plotly_not_imported
+
+_assert_plotly_not_imported()
+_future_flags.add('template_defaults')

_plotly_future_/v4.py

@@ -0,0 +1,2 @@
+from __future__ import absolute_import
+from _plotly_future_ import renderer_defaults, template_defaults

plotly/__init__.py

@@ -31,7 +31,13 @@
 from plotly import (plotly, dashboard_objs, graph_objs, grid_objs, tools,
                     utils, session, offline, colors, io)
 from plotly.version import __version__
+from _plotly_future_ import _future_flags
 
 from ._version import get_versions
 __version__ = get_versions()['version']
 del get_versions
+
+# Set default template here to make sure import process is complete
+if 'template_defaults' in _future_flags:
+    # Set _default to skip validation
+    io.templates._default = 'plotly'

plotly/basedatatypes.py

@@ -392,6 +392,22 @@ def __repr__(self):
 
         return repr_str
 
+    def _repr_mimebundle_(self, include, exclude, **kwargs):
+        """
+        repr_mimebundle should accept include, exclude and **kwargs
+        """
+        import plotly.io as pio
+        if pio.renderers.render_on_display:
+            data = pio.renderers._build_mime_bundle(self.to_dict())
+
+            if include:
+                data = {k: v for (k, v) in data.items() if k in include}
+            if exclude:
+                data = {k: v for (k, v) in data.items() if k not in exclude}
+            return data
+        else:
+            return None
+
     def update(self, dict1=None, **kwargs):
         """
         Update the properties of the figure with a dict and/or with

plotly/io/__init__.py

@@ -4,3 +4,9 @@
 from ._json import to_json, from_json, read_json, write_json
 
 from ._templates import templates, to_templated
+
+from ._renderers import renderers, show
+
+from . import base_renderers
+
+from ._html import to_html, write_html