Merge branch 'master' into non-string-flaglist-extras

Author: nicolaskruchten

.circleci/config.yml

@@ -272,7 +272,7 @@ jobs:
             eval "$(conda shell.bash hook)"
             conda activate env
             cd packages/javascript/jupyterlab-plotly
-            npm install
+            npm ci
             npm run build:prod
             git status
 
@@ -283,10 +283,12 @@ jobs:
             conda activate env
             cd packages/python/plotly
             python setup.py sdist bdist_wheel
+            mkdir pypi_dist
+            tar czf pypi_dist/all.tgz dist
 
       - store_artifacts:
-          path: packages/python/plotly/dist
-          destination: dist
+          path: packages/python/plotly/pypi_dist
+          destination: pypi_dist
 
       - run:
           name: Conda Build

CHANGELOG.md

@@ -2,12 +2,27 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-## [UNRELEASED]
+
+## UNRELEASED
+
+### Added
+
+  - `pattern_shape` options now available in `px.timeline()`
 
 ### Updated
 
   - Allow non-string extras in `flaglist` attributes, to support upcoming changes to `ax.automargin` in plotly.js [plotly.js#6193](https://github.com/plotly/plotly.js/pull/6193), [#3749](https://github.com/plotly/plotly.py/pull/3749)
 
+## [5.8.2] - 2022-06-10
+
+### Fixed
+
+  - Fixed a syntax error that caused rendering issues in Databricks notebooks and likely elsewhere. [#3763](https://github.com/plotly/plotly.py/pull/3763) with thanks to [@fwetdb](https://github.com/fwetdb)
+
+## [5.8.1] - 2022-06-08
+
+(no changes, due to a mixup with the build process!)
+
 ## [5.8.0] - 2022-05-09
 
 ### Fixed

README.md

@@ -33,7 +33,7 @@
 
 ## Quickstart
 
-`pip install plotly==5.8.0`
+`pip install plotly==5.8.2`
 
 Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
 
@@ -45,15 +45,14 @@ fig.show()
 
 See the [Python documentation](https://plotly.com/python/) for more examples.
 
-Read about what's new in [plotly.py v4](https://medium.com/plotly/plotly-py-4-0-is-here-offline-only-express-first-displayable-anywhere-fc444e5659ee)
 
 ## Overview
 
 [plotly.py](https://plotly.com/python/) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
 
 Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is a high-level, declarative charting library. plotly.js ships with over 30 chart types, including scientific charts, 3D graphs, statistical charts, SVG maps, financial charts, and more.
 
-`plotly.py` is [MIT Licensed](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online using [Chart Studio Cloud](https://chart-studio.plotly.com/feed/).
+`plotly.py` is [MIT Licensed](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or integrated into [Dash applications](https://dash.plotly.com/).
 
 [Contact us](https://plotly.com/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
 
@@ -79,13 +78,13 @@ 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==5.8.0
+pip install plotly==5.8.2
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=5.8.0
+conda install -c plotly plotly=5.8.2
 ```
 
 ### JupyterLab Support
@@ -107,7 +106,7 @@ The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**,
 
 ```
 # JupyterLab 2.x renderer support
-jupyter labextension install jupyterlab-plotly@5.8.0 @jupyter-widgets/jupyterlab-manager
+jupyter labextension install jupyterlab-plotly@5.8.2 @jupyter-widgets/jupyterlab-manager
 ```
 
 Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
@@ -188,21 +187,6 @@ or conda
 conda install -c plotly plotly-geo=1.0.0
 ```
 
-### Chart Studio support
-
-The `chart-studio` package can be used to upload plotly figures to Plotly's Chart
-Studio Cloud or On-Prem service. This package can be installed using pip...
-
-```
-pip install chart-studio==1.1.0
-```
-
-or conda
-
-```
-conda install -c plotly chart-studio=1.1.0
-```
-
 ## Migration
 
 If you're migrating from plotly.py v3 to v4, please check out the [Version 4 migration guide](https://plotly.com/python/v4-migration/)

binder/requirements.txt

@@ -1,5 +1,5 @@
 jupytext
-plotly==5.8.0
+plotly==5.8.2
 jupyter
 notebook
 pandas==1.0.3

doc/apidoc/conf.py

@@ -28,7 +28,7 @@
 # The short X.Y version
 version = ""
 # The full version, including alpha/beta/rc tags
-release = "5.8.0"
+release = "5.8.2"
 
 
 # -- General configuration ---------------------------------------------------

doc/python/annotated-heatmap.md

@@ -43,6 +43,8 @@ As of version 5.5.0 of `plotly`, the **recommended way to [display annotated hea
 
 #### Basic Annotated Heatmap for z-annotations
 
+*New in v5.5*
+
 After creating a figure with `px.imshow`, you can add z-annotations with `.update_traces(texttemplate="%{z}")`.
 
 ```python
@@ -246,7 +248,7 @@ fig = px.imshow(color, color_continuous_scale=colorscale, aspect="auto",
                title='Periodic Table')
 fig.update_traces(
     text=symbol, texttemplate="%{text}", textfont_size=12,
-    customdata=np.moveaxis([element, atomic_mass], 0,-1), 
+    customdata=np.moveaxis([element, atomic_mass], 0,-1),
     hovertemplate="%{customdata[0]}<br>Atomic Mass: %{customdata[1]:.2f}<extra></extra>"
 )
 fig.update_xaxes(visible=False)

doc/python/axes.md

@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.9.0
+    version: 3.9.7
   plotly:
     description: How to adjust axes properties in Python - axes titles, styling and
       coloring axes and grid lines, ticks, tick labels and more.
@@ -293,6 +293,8 @@ fig.show()
 
 ##### Step for tick labels
 
+*New in v5.6*
+
 You can set a step for tick labels with `ticklabelstep`. In this example, we hide labels between every `2` ticks on the y axes. Similarly, this can be used with `fig.update_xaxes` for x axes: `fig.update_xaxes(ticklabelstep=2)`.
 
 ```python
@@ -384,12 +386,10 @@ fig.show()
 
 _new in 5.8_
 
-You can position and style minor ticks on a Cartesian axis using `minor`. This takes a `dict` of properties to apply to minor ticks. Available properties include: `tickmode`, `tickvals`, `tickcolor`, `ticklen`, `tickwidth`, `dtick`, `tick0`, `nticks`, `ticks`, `showgrid`, `gridcolor`, `griddash`, and `gridwidth`.
+You can position and style minor ticks on a Cartesian axis using the `minor` attribute. This takes a `dict` of properties to apply to minor ticks. See the [figure reference](https://plotly.com/python/reference/layout/xaxis/#layout-xaxis-minor) for full details on the accepted keys in this dict.
 
 In the following example, we add minor ticks to the x-axis and then to the y-axis. For the y-axis we add ticks on the inside: `ticks="inside"`. On the x-axis we've specified some additional properties to style the minor ticks, setting the length of the ticks with `ticklen` and the color with `tickcolor`. We've also turned on grid lines for the x-axis minor ticks using `showgrid`.
 
-Note: Minor ticks and grid lines are not currently supported on color bars, ternary plots, polar charts, geo plots, or on multi-categorical, or 3D axes.
-
 ```python
 import plotly.express as px
 import pandas as pd
@@ -399,7 +399,7 @@ fig = px.scatter(df, x="total_bill", y="tip", color="sex")
 
 
 fig.update_xaxes(minor=dict(ticklen=6, tickcolor="black", showgrid=True))
-fig.update_yaxes(minor=dict(ticks="inside"))
+fig.update_yaxes(minor_ticks="inside")
 
 fig.show()
 ```
@@ -490,15 +490,14 @@ fig.show()
 
 _new in 5.8_
 
-By default grid lines are `solid`. Set the `griddash` property to change this style. In this example we display the x-axis grid lines as `dot`. It can also be set to `dash`, `longdash`, `dashdot`, or `longdashdot`.
+By default grid lines are `solid`. Set the `griddash` property to change this style. In this example we display the x-axis grid lines as `dash` and the minor grid lines as `dot`. Other allowable values are `longdash`, `dashdot`, or `longdashdot`.
 
 ```python
 import plotly.express as px
 df = px.data.iris()
 
 fig = px.scatter(df, x="sepal_width", y="sepal_length", facet_col="species")
-fig.update_xaxes(showgrid=True, gridwidth=1, gridcolor='LightPink', griddash='dot')
-fig.update_yaxes(showgrid=True, gridwidth=1, gridcolor='LightPink')
+fig.update_xaxes(gridcolor='black', griddash='dash', minor_griddash="dot")
 
 fig.show()
 ```

doc/python/filled-area-plots.md

@@ -63,7 +63,7 @@ IFrame(snippet_url + 'filled-area-plots', width='100%', height=1200)
 
 ### Pattern Fills
 
-*New in v5.0*
+*New in v5.7*
 
 Area charts afford the use of [patterns (also known as hatching or texture)](/python/pattern-hatching-texture/) in addition to color:
 

doc/python/getting-started.md

@@ -58,13 +58,13 @@ We also encourage you to join the [Plotly Community Forum](http://community.plot
 `plotly` may be installed using `pip`:
 
 ```
-$ pip install plotly==5.8.0
+$ pip install plotly==5.8.2
 ```
 
 or `conda`:
 
 ```
-$ conda install -c plotly plotly=5.8.0
+$ conda install -c plotly plotly=5.8.2
 ```
 This package contains everything you need to write figures to standalone HTML files.
 
@@ -148,7 +148,7 @@ The instructions above apply to JupyterLab 3.x. **For JupyterLab 2 or earlier**,
 
 ```
 # JupyterLab 2.x renderer support
-jupyter labextension install jupyterlab-plotly@5.8.0 @jupyter-widgets/jupyterlab-manager
+jupyter labextension install jupyterlab-plotly@5.8.2 @jupyter-widgets/jupyterlab-manager
 ```
 
 Please check out our [Troubleshooting guide](/python/troubleshooting/) if you run into any problems with JupyterLab, particularly if you are using multiple python environments inside Jupyter.

doc/python/hover-text-and-formatting.md

@@ -313,7 +313,7 @@ for continent_name, continent in continent_data.items():
         x=continent['gdpPercap'],
         y=continent['lifeExp'],
         name=continent_name,
-        text=df_2007['continent'],
+        text=continent['continent'],
         hovertemplate=
         "<b>%{text}</b><br><br>" +
         "GDP per Capita: %{x:$,.0f}<br>" +