Release 3.3.0 (#1205)

* Bump version for release candidate

* Update changelong for version 3.3.0

* Build js

* Add codegen special case for `layout.polar.bargap` and `layout.polar.barmode`

* Add bdist_wheel to release instructions

* Bump versions to final

* Update installation instruction versions to final

* Finalize changelog

Author: jonmmease

CHANGELOG.md

@@ -2,6 +2,72 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [3.3.0] - 2018-09-28
+
+### Updated
+ - Updated Plotly.js to version 1.41.3.  Select highlights included below, see
+ [the plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#1413----2018-09-25)
+ for more information.
+ - Do not create or check permissions on the `~/.plotly` configuration
+ directory until a configuration write operation is performed
+ ([#1195](https://github.com/plotly/plotly.py/pull/1195)). This change
+ avoids some concurrency problems associated with running many instances of
+ plotly.py simultaneously
+ ([#1068](https://github.com/plotly/plotly.py/issues/1068)).
+ 
+### Added
+ - Enable selection by clicking on points via new layout attribute `clickmode` and flag `'select'`
+ ([#2944](https://github.com/plotly/plotly.js/pull/2944))
+ - Added stacked area charts via new attributes `stackgroup` and `stackgaps` in scatter traces
+ ([#2960](https://github.com/plotly/plotly.js/pull/2960))
+ - Added `barpolar` trace type - which replace and augment area traces
+ ([#2954](https://github.com/plotly/plotly.js/pull/2954))
+ - Added `polar.hole` layout parameter to punch hole at the middle of polar
+ subplot offsetting the start of the radial range
+ ([#2977](https://github.com/plotly/plotly.js/pull/2977), [#2996](https://github.com/plotly/plotly.js/pull/2996))
+ - Figures may now be easily converted to and from JSON using the new
+ `to_json`, `from_json`, `read_json`, and `write_json` functions in the
+ `plotly.io` package
+ ([#1188](https://github.com/plotly/plotly.py/pull/1188))
+ - Figures and graph objects now support `deepcopy` and `pickle` operations
+ ([#1191](https://github.com/plotly/plotly.py/pull/1191))
+ - The location of the `"~/.plotly"` settings directory may now be customized
+ using the `PLOTLY_DIR` environment variable
+ ([#1195](https://github.com/plotly/plotly.py/pull/1195))
+ - Added optional `scaleratio` argument to the `create_quiver` figure factory.
+ When specified, the axes are restricted to this ratio and the quiver arrows
+ are computed to have consistent lengths across angles.
+ ([#1197](https://github.com/plotly/plotly.py/pull/1197))
+ 
+### Fixed
+ - Replace use of `pkg_resources.resource_string` with `pkgutil.get_data` to
+ improve compatibility with `cx_Freeze`
+ ([#1201](https://github.com/plotly/plotly.py/pull/1201))
+ - An exception is no longer raised when an optional dependency raises an
+ exception on import.  The exception is logged and plotly.py continues as if
+ the dependency were not installed
+ ([#1192](https://github.com/plotly/plotly.py/pull/1192))
+ - Fixed invalid dendrogram axis labels when the points being clustered contain
+ duplicate values
+ ([#1186](https://github.com/plotly/plotly.py/pull/1186))
+ - Added missing LICENSE.txt file to PyPI source distribution
+ ([#765](https://github.com/plotly/plotly.py/issues/765))
+
+### JupyterLab Versions
+For use with JupyterLab, the following versions of the following packages
+must be installed:
+
+ - Python Packages
+   - plotly==3.3.0
+   - ipywidgets>=7.2
+   - notebook>=5.3
+   - jupyterlab==0.34
+   
+ - JupyterLab Extensions
+   - plotlywidget@0.4.0
+   - @jupyter-widgets/jupyterlab-manager@0.37
+   - @jupyterlab/plotly-extension@0.17
+
 ## [3.2.1] - 2018-09-14
 This is a patch release that fixes a few bugs and reintroduces a few
 version 2 features that were not supported in version 3.

README.md

@@ -54,12 +54,12 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
 
 plotly.py may be installed using pip...
 ```
-pip install plotly==3.2.1
+pip install plotly==3.3.0
 ```
 
 or conda.
 ```
-conda install -c plotly plotly=3.2.1
+conda install -c plotly plotly=3.3.0
 ```
 
 ### Jupyter Notebook Support
@@ -102,10 +102,10 @@ set NODE_OPTIONS=--max-old-space-size=4096
 jupyter labextension install @jupyter-widgets/jupyterlab-manager@0.37 --no-build
 
 # FigureWidget support
-jupyter labextension install plotlywidget@0.3.0  --no-build
+jupyter labextension install plotlywidget@0.4.0 --no-build
 
 # offline iplot support
-jupyter labextension install @jupyterlab/plotly-extension@0.17  --no-build
+jupyter labextension install @jupyterlab/plotly-extension@0.17.2 --no-build
 
 # Build extensions (must be done to activate extensions since --no-build is used above)
 jupyter lab build

codegen/utils.py

@@ -990,7 +990,11 @@ def __init__(self, plotly_schema, node_path=(), parent=None):
         # Get list of additional layout properties for each trace
         trace_layouts = [
             plotly_schema['traces'][trace].get('layoutAttributes', {})
-            for trace in plotly_schema['traces']]
+            for trace in plotly_schema['traces'] if trace != 'barpolar']
+
+        extra_polar_nodes = (plotly_schema['traces']['barpolar']
+                             .get('layoutAttributes', {}))
+        layout['polar'].update(extra_polar_nodes)
 
         # Chain together into layout_data
         self.layout_data = ChainMap(layout, *trace_layouts)

contributing.md

@@ -290,7 +290,7 @@ And, you'll need the credentials file `~/.pypirc`. Request access from
 ```bash
 (plotly.py) $ git checkout release_X.Y.Z
 (plotly.py) $ git stash
-(plotly.py) $ python setup.py sdist
+(plotly.py) $ python setup.py sdist bdist_wheel
 (plotly.py) $ twine upload dist/plotly-X.Y.Zrc1*
 ```
 

js/package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "plotlywidget",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "The plotly.py ipywidgets library",
   "author": "The plotly.py team",
   "license": "MIT",

js/package.json

@@ -1574,6 +1574,18 @@ def polar(self):
                 angularaxis
                     plotly.graph_objs.layout.polar.AngularAxis
                     instance or dict with compatible properties
+                bargap
+                    Sets the gap between bars of adjacent location
+                    coordinates. Values are unitless, they
+                    represent fractions of the minimum difference
+                    in bar positions in the data.
+                barmode
+                    Determines how bars at the same location
+                    coordinate are displayed on the graph. With
+                    "stack", the bars are stacked on top of one
+                    another With "overlay", the bars are plotted
+                    over one another, you might need to an
+                    "opacity" to see multiple bars.
                 bgcolor
                     Set the background color of the subplot
                 domain

plotly/graph_objs/_layout.py

@@ -259,6 +259,53 @@ def angularaxis(self):
     def angularaxis(self, val):
         self['angularaxis'] = val
 
+    # bargap
+    # ------
+    @property
+    def bargap(self):
+        """
+        Sets the gap between bars of adjacent location coordinates.
+        Values are unitless, they represent fractions of the minimum
+        difference in bar positions in the data.
+    
+        The 'bargap' property is a number and may be specified as:
+          - An int or float in the interval [0, 1]
+
+        Returns
+        -------
+        int|float
+        """
+        return self['bargap']
+
+    @bargap.setter
+    def bargap(self, val):
+        self['bargap'] = val
+
+    # barmode
+    # -------
+    @property
+    def barmode(self):
+        """
+        Determines how bars at the same location coordinate are
+        displayed on the graph. With "stack", the bars are stacked on
+        top of one another With "overlay", the bars are plotted over
+        one another, you might need to an "opacity" to see multiple
+        bars.
+    
+        The 'barmode' property is an enumeration that may be specified as:
+          - One of the following enumeration values:
+                ['stack', 'overlay']
+
+        Returns
+        -------
+        Any
+        """
+        return self['barmode']
+
+    @barmode.setter
+    def barmode(self, val):
+        self['barmode'] = val
+
     # bgcolor
     # -------
     @property
@@ -723,6 +770,17 @@ def _prop_descriptions(self):
         angularaxis
             plotly.graph_objs.layout.polar.AngularAxis instance or
             dict with compatible properties
+        bargap
+            Sets the gap between bars of adjacent location
+            coordinates. Values are unitless, they represent
+            fractions of the minimum difference in bar positions in
+            the data.
+        barmode
+            Determines how bars at the same location coordinate are
+            displayed on the graph. With "stack", the bars are
+            stacked on top of one another With "overlay", the bars
+            are plotted over one another, you might need to an
+            "opacity" to see multiple bars.
         bgcolor
             Set the background color of the subplot
         domain
@@ -753,6 +811,8 @@ def __init__(
         self,
         arg=None,
         angularaxis=None,
+        bargap=None,
+        barmode=None,
         bgcolor=None,
         domain=None,
         gridshape=None,
@@ -772,6 +832,17 @@ def __init__(
         angularaxis
             plotly.graph_objs.layout.polar.AngularAxis instance or
             dict with compatible properties
+        bargap
+            Sets the gap between bars of adjacent location
+            coordinates. Values are unitless, they represent
+            fractions of the minimum difference in bar positions in
+            the data.
+        barmode
+            Determines how bars at the same location coordinate are
+            displayed on the graph. With "stack", the bars are
+            stacked on top of one another With "overlay", the bars
+            are plotted over one another, you might need to an
+            "opacity" to see multiple bars.
         bgcolor
             Set the background color of the subplot
         domain
@@ -830,6 +901,8 @@ def __init__(
         # Initialize validators
         # ---------------------
         self._validators['angularaxis'] = v_polar.AngularAxisValidator()
+        self._validators['bargap'] = v_polar.BargapValidator()
+        self._validators['barmode'] = v_polar.BarmodeValidator()
         self._validators['bgcolor'] = v_polar.BgcolorValidator()
         self._validators['domain'] = v_polar.DomainValidator()
         self._validators['gridshape'] = v_polar.GridshapeValidator()
@@ -841,6 +914,10 @@ def __init__(
         # ----------------------------------
         _v = arg.pop('angularaxis', None)
         self['angularaxis'] = angularaxis if angularaxis is not None else _v
+        _v = arg.pop('bargap', None)
+        self['bargap'] = bargap if bargap is not None else _v
+        _v = arg.pop('barmode', None)
+        self['barmode'] = barmode if barmode is not None else _v
         _v = arg.pop('bgcolor', None)
         self['bgcolor'] = bgcolor if bgcolor is not None else _v
         _v = arg.pop('domain', None)

plotly/graph_objs/layout/_polar.py

@@ -13,6 +13,18 @@ def __init__(self, plotly_name='polar', parent_name='layout', **kwargs):
             angularaxis
                 plotly.graph_objs.layout.polar.AngularAxis
                 instance or dict with compatible properties
+            bargap
+                Sets the gap between bars of adjacent location
+                coordinates. Values are unitless, they
+                represent fractions of the minimum difference
+                in bar positions in the data.
+            barmode
+                Determines how bars at the same location
+                coordinate are displayed on the graph. With
+                "stack", the bars are stacked on top of one
+                another With "overlay", the bars are plotted
+                over one another, you might need to an
+                "opacity" to see multiple bars.
             bgcolor
                 Set the background color of the subplot
             domain

plotly/validators/layout/_polar.py

@@ -4,4 +4,6 @@
 from ._gridshape import GridshapeValidator
 from ._domain import DomainValidator
 from ._bgcolor import BgcolorValidator
+from ._barmode import BarmodeValidator
+from ._bargap import BargapValidator
 from ._angularaxis import AngularAxisValidator