v3.0.0

[3.0.0] - 2018-07-05

This is a major version with many exciting updates. See the Introducing plotly.py 3.0.0 post for more information.

JupyterLab plotlywidget version: 0.1.1

Plotly.js version: 1.38.3

Added

• Full Jupyter ipywidgets integration with the new graph_objs.FigureWidget class
• FigureWidget figures can be updated interactively using property assignment syntax
• The full trace and layout API is generated from the plotly schema to provide a great experience for interactive use in the notebook
• Support for setting array properties as numpy arrays. When numpy arrays are used, ipywidgets binary serialization protocol is used to avoid converting these to JSON strings.
• Context manager API for animation. Run help(go.Figure().batch_animate) for the full doc string.
• Perform automatic retries when communicating with plot.ly services. This introduces a new required dependency on the retrying library.
• 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.
• Error message for plotly.figure_factory.create_choropleth is now helpful to Anaconda users who do not have the correct modules installed for the County Choropleth figure factory.

Changed / Deprecated

Please see the migration guid for a full list of the changes and deprecations in version 3.0.0

v2.0.0

Same as the pre-release, but this one corresponds to the 2.0.0 on PyPI and is the first official 2.x release. Please note the deprecation section from the changelog (copied below for convenience).

[2.0.0] - 2017-01-25

Changed

• plotly.exceptions.PlotlyRequestException is always raised for network
  failures. Previously either a PlotlyError, PlotlyRequestException, or a
  requests.exceptions.ReqestException could be raised. In particular, scripts
  which depend on try-except blocks containing network requests should be
  revisited.
• plotly.py:sign_in now validates to the plotly server specified in your
  config. If it cannot make a successful request, it raises a PlotlyError.
• plotly.figure_factory will raise an ImportError if numpy is not
  installed.
• plotly.figure_factory.create_violin() now has a rugplot parameter which
  determines whether or not a rugplot is draw beside each violin plot.

Deprecated

• plotly.tools.FigureFactory. Use plotly.figure_factory.*.
• (optional imports) plotly.tools._*_imported It was private anyhow, but now
  it's gone. (e.g., _numpy_imported)
• (plotly v2 helper) plotly.py._api_v2 It was private anyhow, but now it's
  gone.

v2.0.0-pre

[2.0.0]

Most notably, this changes how exceptions are handled and raised for all network requests. See CHANGELOG.md for more details (copied below for convenience).

Changed

• plotly.exceptions.PlotlyRequestException is always raised for network
  failures. Previously either a PlotlyError, PlotlyRequestException, or a
  requests.exceptions.ReqestException could be raised. In particular, scripts
  which depend on try-except blocks containing network requests should be
  revisited.
• plotly.py:sign_in now validates to the plotly server specified in your
  config. If it cannot make a successful request, it raises a PlotlyError.
• plotly.figure_factory will raise an ImportError if numpy is not
  installed.

Deprecated

• plotly.tools.FigureFactory. Use plotly.figure_factory.*.
• (optional imports) plotly.tools._*_imported It was private anyhow, but now
  it's gone. (e.g., _numpy_imported)
• (plotly v2 helper) plotly.py._api_v2 It was private anyhow, but now it's
  gone.

v1.13.0

[1.13.0] - 2016-01-17

Added

• Python 3.5 has been added as a tested environment for this package.

Updated

• plotly.plotly.create_animations and plotly.plotly.icreate_animations now return appropriate error messages if the response is not successful.
• frames are now integrated into GRAPH_REFERENCE and figure validation.

Changed

• The plot-schema from https://api.plot.ly/plot-schema is no longer updated on import.

1.6.12 - stable strict json encoder, ci fixes

• Previous version (1.6.11) of custom json encoder only supported python 2.7.
• Previous PATH env variable in circle needed adjusting to properly run python versions

1.6.8 - Remove fullData from IPython widget callbacks

#196

1.6.7

Adding plotly.widget.GraphWidget.plot method for folks to use their existing graph objects with the graph widget.