Merge branch 'master' into remove-six

Author: maresb

Diff for: .circleci/config.yml

@@ -87,7 +87,7 @@ jobs:
       - checkout
       - run:
           name: Install black
-          command: "sudo pip install black==19.10b0"
+          command: "sudo pip install black==22.3.0"
       - run:
           name: Check formatting with black
           command: "black --check ."
@@ -380,12 +380,7 @@ jobs:
       - store_artifacts:
           path: doc/build
           destination: doc/build
-      - store_artifacts:
-          path: doc/apidoc/_build/
-          destination: doc/apidoc/_build/
-
 workflows:
-
   code_formatting:
     jobs:
       - check-code-formatting

Diff for: .pre-commit-config.yaml

@@ -1,6 +1,6 @@
 repos:
--   repo: https://github.com/ambv/black
-    rev: 19.10b0
+  - repo: https://github.com/ambv/black
+    rev: 22.3.0
     hooks:
-    - id: black
-      language_version: python
+      - id: black
+        language_version: python

Diff for: CHANGELOG.md

@@ -3,6 +3,24 @@ All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
 
+##  [5.7.0] - 2022-04-05
+
+### Added
+  - added `pattern_shape` options to `px.area()` [#3668](https://github.com/plotly/plotly.py/issues/3668)
+
+### Updated
+  - Updated Plotly.js to from version 2.9.0 to version 2.11.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2111----2022-03-15) for more information. Notable changes include:
+    - Add `fillpattern` options to `scatter` trace
+    - Various JS-specific improvements such as MathJax 3.0 support
+
+##  [5.6.0] - 2022-02-09
+
+### Updated
+  - Updated Plotly.js to from version 2.8.3 to version 2.9.0. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#290----2022-02-04) for more information. Notable changes include:
+    - Implement `ticklabelstep` to reduce labels on cartesian axes and colorbars
+    - Display the version of plotly.js when hovering over the modebar
+
+
 ## [5.5.0] - 2021-12-20
 
 ### Added

Diff for: README.md

@@ -11,7 +11,7 @@
     <tr>
         <td>User forum</td>
         <td>
-            <a href="https://community.plot.ly"/>
+            <a href="https://community.plotly.com/"/>
             <img src="https://img.shields.io/badge/help_forum-discourse-blue.svg"/>
         </td>
     </tr>
@@ -33,7 +33,7 @@
 
 ## Quickstart
 
-`pip install plotly==5.5.0`
+`pip install plotly==5.7.0`
 
 Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
 
@@ -43,34 +43,34 @@ fig = px.bar(x=["a", "b", "c"], y=[1, 3, 2])
 fig.show()
 ```
 
-See the [Python documentation](https://plot.ly/python/) for more examples.
+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://plot.ly/python) is an interactive, open-source, and browser-based graphing library for Python :sparkles:
+[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](packages/python/chart-studio/LICENSE.txt). Plotly graphs can be viewed in Jupyter notebooks, standalone HTML files, or hosted online using [Chart Studio Cloud](https://chart-studio.plot.ly/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 hosted online using [Chart Studio Cloud](https://chart-studio.plotly.com/feed/).
 
-[Contact us](https://plot.ly/products/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
+[Contact us](https://plotly.com/consulting-and-oem/) for consulting, dashboard development, application integration, and feature additions.
 
 <p align="center">
-    <a href="https://plot.ly/python" target="_blank">
+    <a href="https://plotly.com/python/" target="_blank">
     <img src="https://raw.githubusercontent.com/cldougl/plot_images/add_r_img/plotly_2017.png">
 </a></p>
 
 ---
 
-- [Online Documentation](https://plot.ly/python)
-- [Contributing to plotly](contributing.md)
-- [Changelog](CHANGELOG.md)
-- [Code of Conduct](CODE_OF_CONDUCT.md)
-- [Version 4 Migration Guide](https://plot.ly/python/next/v4-migration/)
+- [Online Documentation](https://plotly.com/python/)
+- [Contributing to plotly](https://github.com/plotly/plotly.py/blob/master/contributing.md)
+- [Changelog](https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md)
+- [Code of Conduct](https://github.com/plotly/plotly.py/blob/master/CODE_OF_CONDUCT.md)
+- [Version 4 Migration Guide](https://plotly.com/python/v4-migration/)
 - [New! Announcing Dash 1.0](https://medium.com/plotly/welcoming-dash-1-0-0-f3af4b84bae)
-- [Community forum](https://community.plot.ly/c/api/python)
+- [Community forum](https://community.plotly.com)
 
 ---
 
@@ -79,13 +79,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.5.0
+pip install plotly==5.7.0
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=5.5.0
+conda install -c plotly plotly=5.7.0
 ```
 
 ### JupyterLab Support
@@ -107,7 +107,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.5.0 @jupyter-widgets/jupyterlab-manager
+jupyter labextension install jupyterlab-plotly@5.7.0 @jupyter-widgets/jupyterlab-manager
 ```
 
 Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.
@@ -205,14 +205,14 @@ 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://plot.ly/python/next/v4-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/)
 
-If you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](migration-guide.md)
+If you're migrating from plotly.py v2 to v3, please check out the [Version 3 migration guide](https://github.com/plotly/plotly.py/blob/master/migration-guide.md)
 
 ## Copyright and Licenses
 
 Code and documentation copyright 2019 Plotly, Inc.
 
-Code released under the [MIT license](packages/python/chart-studio/LICENSE.txt).
+Code released under the [MIT license](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt).
 
 Docs released under the [Creative Commons license](https://github.com/plotly/documentation/blob/source/LICENSE).

Diff for: binder/requirements.txt

@@ -1,5 +1,5 @@
 jupytext
-plotly==5.5.0
+plotly==5.7.0
 jupyter
 notebook
 pandas==1.0.3

Diff for: doc/apidoc/conf.py

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

Diff for: doc/python/3d-mesh.md

@@ -77,8 +77,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + '3d-mesh', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + '3d-mesh', width='100%', height=1200)
 ```
 
 ### Mesh Tetrahedron

Diff for: doc/python/3d-scatter-plots.md

@@ -81,8 +81,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + '3d-scatter-plots', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + '3d-scatter-plots', width='100%', height=1200)
 ```
 
 ### 3D Scatter Plot with go.Scatter3d

Diff for: doc/python/animations.md

@@ -56,8 +56,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'animations', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'animations', width='100%', height=1200)
 ```
 
 #### Animated Bar Charts with Plotly Express

Diff for: doc/python/axes.md

@@ -5,10 +5,10 @@ jupyter:
     text_representation:
       extension: .md
       format_name: markdown
-      format_version: '1.2'
-      jupytext_version: 1.4.2
+      format_version: '1.3'
+      jupytext_version: 1.13.7
   kernelspec:
-    display_name: Python 3
+    display_name: Python 3 (ipykernel)
     language: python
     name: python3
   language_info:
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.7.7
+    version: 3.9.0
   plotly:
     description: How to adjust axes properties in Python - axes titles, styling and
       coloring axes and grid lines, ticks, tick labels and more.
@@ -133,8 +133,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'axes', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'axes', width='100%', height=1200)
 ```
 
 #### Moving Tick Labels Inside the Plot
@@ -291,6 +291,20 @@ fig.update_yaxes(ticks="outside", tickwidth=2, tickcolor='crimson', ticklen=10,
 fig.show()
 ```
 
+##### Step for tick labels
+
+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
+import plotly.express as px
+df = px.data.iris()
+
+fig = px.scatter(df, x="sepal_width", y="sepal_length", facet_col="species")
+fig.update_yaxes(ticklabelstep=2)
+
+fig.show()
+```
+
 ##### Toggling axis labels
 
 The axis tick mark labels can be disabled by setting the `showticklabels` axis property to `False`.

Diff for: doc/python/bar-charts.md

@@ -96,8 +96,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'bar-charts', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'bar-charts', width='100%', height=1200)
 ```
 
 ### Colored Bars

Diff for: doc/python/bio-alignment-chart.md

@@ -58,6 +58,6 @@ fig.show()
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'bio-alignmentchart', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'bio-alignmentchart', width='100%', height=1200)
 ```

Diff for: doc/python/bio-clustergram.md

@@ -102,6 +102,6 @@ dash_bio.Clustergram(
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'bio-clustergram', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'bio-clustergram', width='100%', height=1200)
 ```

Diff for: doc/python/bio-manhattanplot.md

@@ -71,6 +71,6 @@ dash_bio.ManhattanPlot(
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'bio-manhattanplot', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'bio-manhattanplot', width='100%', height=1200)
 ```

Diff for: doc/python/bio-volcano-plot.md

@@ -71,6 +71,6 @@ dash_bio.VolcanoPlot(
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'bio-volcano', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'bio-volcano', width='100%', height=1200)
 ```

Diff for: doc/python/box-plots.md

@@ -73,8 +73,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'box-plots', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'box-plots', width='100%', height=1200)
 ```
 
 ### Display the underlying data

Diff for: doc/python/builtin-colorscales.md

@@ -83,8 +83,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'builtin-colorscales', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'builtin-colorscales', width='100%', height=1200)
 ```
 
 ### Built-In Sequential Color scales

Diff for: doc/python/candlestick-charts.md

@@ -83,8 +83,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'candlestick-charts', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'candlestick-charts', width='100%', height=1200)
 ```
 
 #### Adding Customized Text and Annotations

Diff for: doc/python/choropleth-maps.md

@@ -151,8 +151,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'choropleth-maps', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'choropleth-maps', width='100%', height=1200)
 ```
 
 ### Discrete Colors

Diff for: doc/python/colorscales.md

@@ -99,8 +99,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'colorscales', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'colorscales', width='100%', height=1200)
 ```
 
 ### Color Scales in Plotly Express

Diff for: doc/python/creating-and-updating-figures.md

@@ -136,8 +136,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'figure-structure', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'figure-structure', width='100%', height=1200)
 ```
 
 ### Creating Figures

Diff for: doc/python/discrete-color.md

@@ -107,8 +107,8 @@ Get started  with [the official Dash docs](https://dash.plotly.com/installation)
 
 ```python hide_code=true
 from IPython.display import IFrame
-snippet_url = 'https://dash-gallery.plotly.host/python-docs-dash-snippets/'
-IFrame(snippet_url + 'discrete-color', width='100%', height=630)
+snippet_url = 'https://python-docs-dash-snippets.herokuapp.com/python-docs-dash-snippets/'
+IFrame(snippet_url + 'discrete-color', width='100%', height=1200)
 ```
 
 ### Color Sequences in Plotly Express