Merge pull request #4523 from plotly/push-5-19-docs-live

Make 5.19 docs live

Author: LiamConnors

Diff for: .circleci/config.yml

@@ -7,7 +7,7 @@ commands:
   test_core:
     parameters:
       py:
-        default: "36"
+        default: "310"
         type: string
     steps:
       - checkout
@@ -32,7 +32,7 @@ commands:
   test_optional:
     parameters:
       py:
-        default: "36"
+        default: "310"
         type: string
     steps:
       - checkout
@@ -95,7 +95,7 @@ commands:
   test_orca:
     parameters:
       py:
-        default: "36"
+        default: "310"
         type: string
     steps:
       - checkout
@@ -153,20 +153,6 @@ jobs:
             black --check . --exclude venv
 
   # Core
-  python_36_core:
-    docker:
-      - image: cimg/python:3.6-browsers
-    steps:
-      - test_core:
-          py: "36"
-
-  python_37_core:
-    docker:
-      - image: cimg/python:3.7-browsers
-    steps:
-      - test_core:
-          py: "37"
-
   python_38_core:
     docker:
       - image: cimg/python:3.8-browsers
@@ -181,20 +167,28 @@ jobs:
       - test_core:
           py: "39"
 
-  # Optional
-  python_36_optional:
+  python_310_core:
     docker:
-      - image: cimg/python:3.6-browsers
+      - image: cimg/python:3.10-browsers
     steps:
-      - test_optional:
-          py: "36"
+      - test_core:
+          py: "310"
 
-  python_37_optional:
+  python_311_core:
     docker:
-      - image: cimg/python:3.7-browsers
+      - image: cimg/python:3.11-browsers
     steps:
-      - test_optional:
-          py: "37"
+      - test_core:
+          py: "311"
+
+  python_312_core:
+    docker:
+      - image: cimg/python:3.12-browsers
+    steps:
+      - test_core:
+          py: "312"
+
+  # Optional
 
   python_38_optional:
     docker:
@@ -210,6 +204,27 @@ jobs:
       - test_optional:
           py: "39"
 
+  python_310_optional:
+    docker:
+      - image: cimg/python:3.10-browsers
+    steps:
+      - test_optional:
+          py: "310"
+
+  python_311_optional:
+    docker:
+      - image: cimg/python:3.11-browsers
+    steps:
+      - test_optional:
+          py: "311"
+
+  python_312_optional:
+    docker:
+      - image: cimg/python:3.12-browsers
+    steps:
+      - test_optional:
+          py: "312"
+
   # Pandas
 
   python_39_pandas_2_optional:
@@ -228,7 +243,7 @@ jobs:
           py: "38"
 
   # Percy
-  python_37_percy:
+  python_39_percy:
     docker:
       - image: cimg/python:3.9-browsers
         environment:
@@ -277,9 +292,9 @@ jobs:
             rm test/percy/*.html
 
   # Chart studio
-  python_37_chart_studio:
+  python_38_chart_studio:
     docker:
-      - image: cimg/python:3.7
+      - image: cimg/python:3.8
     resource_class: large
 
     steps:
@@ -291,7 +306,7 @@ jobs:
             python -m venv venv
             . venv/bin/activate
             pip install --upgrade pip wheel
-            pip install -r ./test_requirements/requirements_37.txt
+            pip install -r ./test_requirements/requirements_38.txt
       - run:
           name: Tests
           command: |
@@ -302,7 +317,7 @@ jobs:
 
   plotlyjs_dev_build:
     docker:
-      - image: cimg/python:3.7-node
+      - image: cimg/python:3.8-node
         environment:
           LANG: en_US.UTF-8
     resource_class: large
@@ -316,7 +331,7 @@ jobs:
             python -m venv venv
             . venv/bin/activate
             pip install --upgrade pip wheel
-            pip install -r ./test_requirements/requirements_37_core.txt black inflect
+            pip install -r ./test_requirements/requirements_38_core.txt black inflect
             pip install jupyterlab~=3.0
       - run:
           name: Update jupyterlab-plotly version
@@ -433,7 +448,7 @@ jobs:
     docker:
       # specify the version you desire here
       # use `-browsers` prefix for selenium tests, for example, `3.6.1-browsers`
-      - image: cimg/python:3.7-browsers
+      - image: cimg/python:3.9-browsers
 
     steps:
       - add_ssh_keys:
@@ -570,15 +585,17 @@ workflows:
 
   build:
     jobs:
-      - python_36_core
-      - python_37_core
       - python_38_core
       - python_39_core
-      - python_36_optional
-      - python_37_optional
+      - python_310_core
+      - python_311_core
+      - python_312_core
       - python_38_optional
       - python_39_optional
+      - python_310_optional
+      - python_311_optional
+      - python_312_optional
       - python_39_pandas_2_optional
       - python_38_orca
-      - python_37_percy
+      - python_39_percy
       - build-doc

Diff for: .gitignore

@@ -1,3 +1,8 @@
+0
+0.html
+iframe_figures/
+packages/python/plotly/plotly/tests/test_orca/images/linux/failed/
+
 *.egg-info
 
 *.pyc
@@ -6,6 +11,8 @@
 
 *~
 
+doc/python/raw.githubusercontent.com/
+
 # Don't ignore dataset files
 !*.csv.gz
 

Diff for: CHANGELOG.md

@@ -2,6 +2,29 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
+## [5.19.0] - 2024-02-15
+
+### Updated
+
+- Updated Plotly.js from version 2.27.0 to version 2.29.1. See the [plotly.js CHANGELOG](https://github.com/plotly/plotly.js/blob/master/CHANGELOG.md#2291----2024-02-12) for more information. These changes are reflected in the auto-generated `plotly.graph_objects` module. Notable changes include:
+  - Add `layout.barcornerradius` and `trace.marker.cornerradius` properties to support rounding the corners of bar traces [[#6761](https://github.com/plotly/plotly.js/pull/6761)],
+   with thanks to [Displayr](https://www.displayr.com) for sponsoring development!
+  - Add `autotickangles` to cartesian and radial axes [[#6790](https://github.com/plotly/plotly.js/pull/6790)], with thanks to @my-tien for the contribution!
+  - Add `align` option to sankey nodes to control horizontal alignment [[#6800](https://github.com/plotly/plotly.js/pull/6800)],
+   with thanks to @adamreeve for the contribution!
+  - Add the possibility of loading "virtual-webgl" script for WebGL 1 to help display several WebGL contexts on a page [[#6784](https://github.com/plotly/plotly.js/pull/6784)], with thanks to @greggman for the contribution!
+  - Add options to use base64 encoding (`bdata`) and `shape` (for 2 dimensional arrays) to declare various typed arrays i.e. `dtype=(float64|float32|int32|int16|int8|uint32|uint16|uint8)` [[#5230](https://github.com/plotly/plotly.js/pull/5230)]
+  -  Adjust stamen styles to point to `stadiamaps.com`, the users may also need to provide their own API_KEY via `config.mapboxAccessToken` [[#6776](https://github.com/plotly/plotly.js/pull/6776), [#6778](https://github.com/plotly/plotly.js/pull/6778)]
+- Removed Python 3.6 and Python 3.7 support [[#4492](https://github.com/plotly/plotly.py/pull/4492)]
+
+### Fixed
+- Ensure scatter `mode` is deterministic from `px` [[#4429](https://github.com/plotly/plotly.py/pull/4429)]
+- Fix issue with creating dendrogram in subplots [[#4411](https://github.com/plotly/plotly.py/pull/4411)],
+- Fix issue with px.line not accepting "spline" line shape [[#2812](https://github.com/plotly/plotly.py/issues/2812)]
+- Fix KeyError when using column of `pd.Categorical` dtype with unobserved categories [[#4437](https://github.com/plotly/plotly.py/pull/4437)]
+- Fix dataframe interchange in case `column_names` returns an unmaterialized object: generator, iterator, etc. [[#4442]](https://github.com/plotly/plotly.py/pull/4442)
+- Fix issue with `FutureWarning` being displayed when setting the `color` argument in `plotly.express` [[#4519]](https://github.com/plotly/plotly.py/pull/4519)
+
 ## [5.18.0] - 2023-10-25
 
 ### Updated

Diff for: README.md

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

Diff for: binder/requirements.txt

@@ -1,9 +1,9 @@
 jupytext
-plotly==5.18.0
+plotly==5.19.0
 jupyter
 notebook
-pandas==1.0.3
-statsmodels==0.11.1
+pandas==1.2.0
+statsmodels==0.12.1
 scipy
 patsy==0.5.1
 numpy

Diff for: doc/apidoc/conf.py

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

Diff for: doc/python/LaTeX.md

@@ -35,7 +35,7 @@ jupyter:
 
 #### LaTeX Typesetting
 
-Figure titles, axis labels and annotations all accept LaTeX directives for rendering mathematical formulas and notation, when the entire label is surrounded by dollar signs `$...$`. This rendering is handled by the [MathJax library](https://www.mathjax.org/) (version 2.7.5), which must be loaded in the environment where figures are being rendered. MathJax is included by default in Jupyter-like environments, but when embedding Plotly figures in other contexts it may be required to ensure that MathJax is separately loaded, for example via a `<script>` tag pointing to a content-delivery network (CDN).
+Figure titles, axis labels and annotations all accept LaTeX directives for rendering mathematical formulas and notation, when the entire label is surrounded by dollar signs `$...$`. This rendering is handled by the [MathJax library](https://www.mathjax.org/) (version 2.7.5), which must be loaded in the environment where figures are being rendered. MathJax is included by default in Jupyter-like environments, and LateX directives work with Jupyter Notebook version 6. LaTeX directives do not work with Jupyter Notebook version 7.  When embedding Plotly figures in other contexts it may be required to ensure that MathJax is separately loaded, for example via a `<script>` tag pointing to a content-delivery network (CDN).
 
 ```python
 import plotly.express as px

Diff for: doc/python/axes.md

@@ -6,7 +6,7 @@ jupyter:
       extension: .md
       format_name: markdown
       format_version: '1.3'
-      jupytext_version: 1.15.1
+      jupytext_version: 1.16.1
   kernelspec:
     display_name: Python 3 (ipykernel)
     language: python
@@ -20,7 +20,7 @@ jupyter:
     name: python
     nbconvert_exporter: python
     pygments_lexer: ipython3
-    version: 3.10.4
+    version: 3.10.11
   plotly:
     description: How to adjust axes properties in Python - axes titles, styling and
       coloring axes and grid lines, ticks, tick labels and more.
@@ -363,6 +363,23 @@ fig.update_xaxes(tickangle=45, tickfont=dict(family='Rockwell', color='crimson',
 fig.show()
 ```
 
+##### Auto Tick Angle Options
+
+*New in 5.19*
+
+If `tickangle` is not explicitly set, its default value is `auto`, meaning if the label needs to be rotated to avoid labels overlapping, it will rotate by either 30 or 90 degrees. Using `autotickangles`, you can also specify a list of angles for `tickangle` to use. If `tickangle` is `auto` and you provide a list of angles to `autotickangles`, the label angle will be set to the first value in the list that prevents overlap. 
+
+```python
+import plotly.express as px
+df = px.data.gapminder()
+df = df.loc[(df.continent=="Asia") & (df.year==1992)]
+fig = px.histogram(df, x=df.country, y=df.gdpPercap)
+
+fig.update_xaxes(autotickangles=[45, 60, 90])
+
+fig.show()
+```
+
 #### Enumerated Ticks with Tickvals and Ticktext
 
 The `tickvals` and `ticktext` axis properties can be used together to display custom tick label text at custom locations along an axis. They should be set to lists of the same length where the `tickvals` list contains positions along the axis, and `ticktext` contains the strings that should be displayed at the corresponding positions.