Merge branch 'ipyplotly_integration' of https://github.com/plotly/plotly.py into ipyplotly_integration

Author: jonmmease

CHANGELOG.md

@@ -20,7 +20,7 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 ### Changed
 - Improved data validation covering the full API with clear, informative error messages. This means that incorrect properties and/or values now always raise a `ValueError` with a description of the error, the invalid property, and the available properties on the level that it was placed in the graph object. Eg. `go.Scatter(foo=123)` raises a validation error. See https://plot.ly/python/reference/ for a reference to all valid properties and values in the Python API.
 
-- Graph objs are no longer dicts, though they still provide many dict-like magic methods. Running a cell of a graph object now prints a dict-style representation of the object:
+- Graph objects are no longer dicts, though they still provide many dict-like magic methods. Running a cell of a graph object now prints a dict-style representation of the object:
 
 Eg. `plotly.graph_objs.Scatter()` prints
 

migration-guide.md

@@ -27,15 +27,37 @@ f.add_scatter(x=[1,2,3], y=[4,3,2])
 f
 ```
 
-## New __repr__ method
-plotly figures and graph objects now include the dict-like `__repr__` method that represents the object as a string
+## New Plotly Object Representation
+Plotly figures and graph objects have an updated `__repr__` method that displays objects in a pretty printed form that can be copied, pasted, and evaluated to recreate the object.
+
+Eg. `print(f)` returns
+
+```
+FigureWidget({
+    'data': [{'type': 'scatter', 'uid': '07968b11-7b0a-11e8-ba67-c869cda04ed6', 'x': [1, 2, 3], 'y': [4, 3, 2]}],
+    'layout': {}
+})
+```
+
+## New Figure.data Assignment
+- Assignment to the `Figure.data` property must contain a permutation of a subset of the existing traces. Assignment can be used to reorder and remove traces, but cannot currently add new traces.
+
+Suppose a figure, fig, has 3 traces. The following command is valid and it will move the third trace to be the first, the first trace to be the second, and it will remove the second trace.
 
 ```
-f.__repr__()
+fig.data = [fig.data[2], fig.data[0]]
 ```
 
+However this is not valid:
+```
+fig.data = [fig.data[0], go.Scatter(y=[2, 3, 1])]
+```
+
+It's not valid because it's introducing a new trace during assignment. This trace would need to be added using `add_trace` instead.
+
+
 ## FigureWidget Subplot Example
-Let's create a subplot then turn it into a FigureWidget to display in the notebook. Note that `append_trace` is no deprecated. Use `add_trace` or `add_traces` instead.
+Let's create a subplot then turn it into a FigureWidget to display in the notebook. Note that `append_trace` is now deprecated. Use `add_trace` or `add_traces` instead.
 
 ```
 import plotly
@@ -56,7 +78,7 @@ f2.layout.title = 'Age against variables relating to diabetes'
 f2
 ```
 
-## What doesn't work anymore
+## Breaking Changes
 Run the following examples to see what is now deprecated or not valid:
 
 - Data array properties may not be specified as scalars:
@@ -65,7 +87,7 @@ import plotly.graph_objs as go
 go.Bar(x=1)
 ```
 
-- Undocumented properties are no longer available. These include: `.to_string`, `.strip_style`, `.get_data`, `.validate` and `.to_dataframe`.
+- Several undocumented `Figure` methods have been removed. These include: `.to_string`, `.strip_style`, `.get_data`, `.validate` and `.to_dataframe`.
 
 - Object arrays such as `Figure.data` and `Layout.images` are now represented as tuples of graph objects, not lists. Run the following as a sanity check:
 

plotly/tests/test_core/test_file/test_file.py

@@ -20,7 +20,7 @@ class FolderAPITestCase(PlotlyTestCase):
 
     def setUp(self):
         super(FolderAPITestCase, self).setUp()
-        py.sign_in('PythonTest', '9v9f20pext')
+        py.sign_in('PythonTest', 'xnyU0DEwvAQQCwHVseIL')
 
     def _random_filename(self):
         choice_chars = string.ascii_letters + string.digits

plotly/tests/test_core/test_grid/test_grid.py

@@ -38,7 +38,7 @@ class GridTest(PlotlyTestCase):
 
     def setUp(self):
         super(GridTest, self).setUp()
-        py.sign_in('PythonTest', '9v9f20pext')
+        py.sign_in('PythonTest', 'xnyU0DEwvAQQCwHVseIL')
 
     def get_grid(self):
         c1 = Column([1, 2, 3, 4], 'first column')

plotly/tests/test_core/test_meta/test_meta.py

@@ -26,7 +26,7 @@ class MetaTest(PlotlyTestCase):
 
     def setUp(self):
         super(MetaTest, self).setUp()
-        py.sign_in('PythonTest', '9v9f20pext')
+        py.sign_in('PythonTest', 'xnyU0DEwvAQQCwHVseIL')
 
     def random_filename(self):
         random_chars = [random.choice(string.ascii_uppercase) for _ in range(5)]