Merge branch 'master' into doc-prod

Author: nicolaskruchten

.circleci/config.yml

@@ -249,6 +249,73 @@ jobs:
       - store_artifacts:
           path: packages/python/plotly/dist
 
+  full_build:
+    docker:
+      - image: continuumio/miniconda3
+        environment:
+          LANG: en_US.UTF-8
+    resource_class: large
+
+    steps:
+      - checkout
+
+      - run:
+          name: Create conda environment
+          command: |
+            conda create -n env --yes python=3.9 conda-build conda-verify
+            conda install -n env -c conda-forge jupyterlab nodejs=12
+            conda init bash
+
+      - run:
+          name: initial NPM Build
+          command: |
+            eval "$(conda shell.bash hook)"
+            conda activate env
+            cd packages/javascript/jupyterlab-plotly
+            npm install
+            npm run build:prod
+            git status
+
+      - run:
+          name: PyPI Build
+          command: |
+            eval "$(conda shell.bash hook)"
+            conda activate env
+            cd packages/python/plotly
+            python setup.py sdist bdist_wheel
+
+      - store_artifacts:
+          path: packages/python/plotly/dist
+          destination: dist
+
+      - run:
+          name: Conda Build
+          command: |
+            eval "$(conda shell.bash hook)"
+            conda activate env
+            cd packages/python/plotly
+            conda build recipe/
+            mkdir conda_dist
+            mv /opt/conda/envs/env/conda-bld/noarch/plotly*.tar.bz2 conda_dist
+
+      - store_artifacts:
+          path: packages/python/plotly/conda_dist
+          destination: conda_dist
+
+      - run:
+          name: NPM Pack
+          command: |
+            eval "$(conda shell.bash hook)"
+            conda activate env
+            cd packages/javascript/jupyterlab-plotly
+            npm pack
+            mkdir npm_dist
+            mv jupyterlab-plotly*.tgz npm_dist
+
+      - store_artifacts:
+          path: packages/javascript/jupyterlab-plotly/npm_dist
+          destination: npm_dist
+
   build-doc:
     resource_class: xlarge
     docker:
@@ -359,10 +426,8 @@ jobs:
               cd ../packages/python/plotly
               pip install -e .
               cd ../../../doc
-            fi
-            cd apidoc
-            make html
-            if [ "${CIRCLE_BRANCH}" == "doc-prod" ]; then
+              cd apidoc
+              make html
               cd _build/html
               touch .nojekyll
               git init
@@ -375,7 +440,6 @@ jobs:
               rm -rf .git
               cd ../..
             fi
-            cd ../..
 
       - store_artifacts:
           path: doc/build
@@ -387,6 +451,9 @@ workflows:
   dev_build:
     jobs:
       - plotlyjs_dev_build
+  release_build:
+    jobs:
+      - full_build
 
   build:
     jobs:

CHANGELOG.md

@@ -2,6 +2,23 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [5.8.0] - 2022-05-09
+
+### Fixed
+
+  - Improve support for type checking and IDE auto-completion by bypassing lazy-loading when type checking. [#3425](https://github.com/plotly/plotly.py/pull/3425) with thanks to [@JP-Ellis](https://github.com/JP-Ellis)
+  - line dash-style validators are now correctly used everywhere so that values like `10px 2px` are accepted [#3722](https://github.com/plotly/plotly.py/pull/3722)
+  - Resolved various deprecation warning messages and compatibility issues with upstream dependencies and Python 3.11, plus removed dependency on `six`, with thanks to [@maresb](https://github.com/maresb), [@hugovk](https://github.com/hugovk), [@tirkarthi](https://github.com/tirkarthi), [@martinRenou](https://github.com/martinRenou), and [@BjoernLudwigPTB](https://github.com/BjoernLudwigPTB)
+  - Better support for MathJax 3 [#3706](https://github.com/plotly/plotly.py/pull/3706)
+
+### Added
+
+  - Type annotations for Plotly Express functions and chainable `go.Figure` methods, for better IDE auto-completion [#3708](https://github.com/plotly/plotly.py/pull/3708)
+
+### Updated
+  - Updated Plotly.js to from version 2.11.1 to version 2.12.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/v2.12.1/CHANGELOG.md#2121----2022-05-09) for more information. Notable changes include:
+    - Add `minor` ticks to cartesian axes
+    - Add `griddash` option to most axes
 
 ##  [5.7.0] - 2022-04-05
 

README.md

@@ -33,7 +33,7 @@
 
 ## Quickstart
 
-`pip install plotly==5.7.0`
+`pip install plotly==5.8.0`
 
 Inside [Jupyter](https://jupyter.org/install) (installable with `pip install "jupyterlab>=3" "ipywidgets>=7.6"`):
 
@@ -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.7.0
+pip install plotly==5.8.0
 ```
 
 or conda.
 
 ```
-conda install -c plotly plotly=5.7.0
+conda install -c plotly plotly=5.8.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.7.0 @jupyter-widgets/jupyterlab-manager
+jupyter labextension install jupyterlab-plotly@5.8.0 @jupyter-widgets/jupyterlab-manager
 ```
 
 Please check out our [Troubleshooting guide](https://plotly.com/python/troubleshooting/) if you run into any problems with JupyterLab.

binder/requirements.txt

@@ -1,5 +1,5 @@
 jupytext
-plotly==5.7.0
+plotly==5.8.0
 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.7.0"
+release = "5.8.0"
 
 
 # -- General configuration ---------------------------------------------------

doc/python/axes.md

@@ -382,6 +382,30 @@ fig.update_layout(title_text="Apple Stock Price")
 fig.show()
 ```
 
+#### Adding minor ticks
+
+_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`.
+
+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
+
+df = px.data.tips()
+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.show()
+```
+
 ### Axis lines: grid and zerolines
 
 ##### Toggling Axis grid lines
@@ -466,6 +490,21 @@ fig.update_yaxes(showgrid=True, gridwidth=1, gridcolor='LightPink')
 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`.
+
+```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.show()
+```
+
 ##### Styling zero lines
 
 The width and color of axis zero lines are controlled by the `zerolinewidth` and `zerolinecolor` axis properties.

doc/python/colorscales.md

@@ -400,10 +400,10 @@ fig.show()
 ```python
 import plotly.graph_objects as go
 
-import six.moves.urllib
+import urllib
 import json
 
-response = six.moves.urllib.request.urlopen(
+response = urllib.request.urlopen(
     "https://raw.githubusercontent.com/plotly/datasets/master/custom_heatmap_colorscale.json"
 )
 
@@ -492,11 +492,11 @@ Like axes, you can customize the color bar ticks, labels, and values with `ticks
 ```python
 import plotly.graph_objects as go
 
-import six.moves.urllib
+import urllib
 import json
 
 # Load heatmap data
-response = six.moves.urllib.request.urlopen(
+response = urllib.request.urlopen(
     "https://raw.githubusercontent.com/plotly/datasets/master/custom_heatmap_colorscale.json")
 dataset = json.load(response)
 
@@ -525,11 +525,11 @@ By default, color bars are displayed vertically. You can change a color bar to b
 ```python
 import plotly.graph_objects as go
 
-import six.moves.urllib
+import urllib
 import json
 
 # Load heatmap data
-response = six.moves.urllib.request.urlopen(
+response = urllib.request.urlopen(
     "https://raw.githubusercontent.com/plotly/datasets/master/custom_heatmap_colorscale.json")
 dataset = json.load(response)
 

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.7.0
+$ pip install plotly==5.8.0
 ```
 
 or `conda`:
 
 ```
-$ conda install -c plotly plotly=5.7.0
+$ conda install -c plotly plotly=5.8.0
 ```
 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.7.0 @jupyter-widgets/jupyterlab-manager
+jupyter labextension install jupyterlab-plotly@5.8.0 @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/graphing-multiple-chart-types.md

@@ -85,9 +85,9 @@ import plotly.graph_objects as go
 
 # Load data
 import json
-import six.moves.urllib
+import urllib
 
-response = six.moves.urllib.request.urlopen(
+response = urllib.request.urlopen(
     "https://raw.githubusercontent.com/plotly/datasets/master/steepest.json")
 
 data = json.load(response)

doc/python/log-plot.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 make Log plots in Python with Plotly.
     display_as: scientific
@@ -60,6 +60,26 @@ fig = px.scatter(df, x="gdpPercap", y="lifeExp", hover_name="country",
 fig.show()
 ```
 
+#### Adding minor ticks
+
+_new in 5.8_
+
+You can position and style minor ticks 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`. 
+
+In this example we set the tick length with `ticklen`, add the ticks on the inside with `ticks="inside"`, and turn grid lines on with `howgrid=True`.
+
+```python
+import plotly.express as px
+df = px.data.gapminder().query("year == 2007")
+
+fig = px.scatter(df, x="gdpPercap", y="lifeExp", hover_name="country",
+                 log_x=True, range_x=[1,100000], range_y=[0,100])
+
+fig.update_xaxes(minor=dict(ticks="inside", ticklen=6, showgrid=True))# {"ticks": "inside", "ticklen": 6, "showgrid": True})
+
+fig.show()
+```
+
 ### Logarithmic Axes with Graph Objects
 
 If Plotly Express does not provide a good starting point, it is also possible to use [the more generic `go.Figure` class from `plotly.graph_objects`](/python/graph-objects/).