Merge branch 'main' into update-hexbin-map-no-mapbox

Author: ajlien

CHANGELOG.md

@@ -4,10 +4,23 @@ This project adheres to [Semantic Versioning](http://semver.org/).
 
 ## Unreleased
 
+## [6.3.1] - 2025-10-02
+
+### Updated
+- Update Plotly.js from version 3.1.0 to version 3.1.1. See the Plotly.js [release notes](https://github.com/plotly/plotly.js/releases) for more information. [[#5357](https://github.com/plotly/plotly.py/pull/5357)]. Notable changes include:
+  - Fix issue preventing Scattergl plots with text elements from rendering [[plotly.js#7563](https://github.com/plotly/plotly.js/pull/7563)]
+- Use native legends when converting from matplotlib [[#5312](https://github.com/plotly/plotly.py/pull/5312)], with thanks to @robertoffmoura to the contribution!
+- Allow `shared_yaxes` to work with secondary axes [[#5180](https://github.com/plotly/plotly.py/pull/5180)], with thanks to @gmjw for the contribution!
+
+### Fixed
+- Fix issue where width/height in plot layout were not respected during Kaleido image export [[#5325](https://github.com/plotly/plotly.py/pull/5325)]
+- Fix typo in default argument to `_ternary_contour.py` [[#5315](https://github.com/plotly/plotly.py/pull/5315)], with thanks to @Lexachoc for the contribution!
+- Fix incorrect `fig.show()` behavior when `ipython` is installed [[#5258](https://github.com/plotly/plotly.py/pull/5258)]
+
 ## [6.3.0] - 2025-08-12
 
 ### Updated
-- Updated Plotly.js from version 3.0.1 to version 3.1.0. See the plotly.js [release notes](https://github.com/plotly/plotly.js/releases) for more information. [[#5318](https://github.com/plotly/plotly.py/pull/5318)]
+- Updated Plotly.js from version 3.0.1 to version 3.1.0. See the Plotly.js [release notes](https://github.com/plotly/plotly.js/releases) for more information. [[#5318](https://github.com/plotly/plotly.py/pull/5318)]
 
 ### Added
 - Exposed `plotly.io.get_chrome()` as a function which can be called from within a Python script. [[#5282](https://github.com/plotly/plotly.py/pull/5282)]

CITATION.cff

@@ -9,8 +9,8 @@ authors:
 - family-names: "Parmer"
   given-names: "Chris"
 title: "An interactive, open-source, and browser-based graphing library for Python"
-version: 6.3.0
+version: 6.3.1
 doi: 10.5281/zenodo.14503524
-date-released: 2025-08-12
+date-released: 2025-10-02
 url: "https://github.com/plotly/plotly.py"
 

RELEASE.md

@@ -3,7 +3,7 @@
 
 ## Release process - full release of `plotly` package
 
-This is the release process for releasing `plotly.py` version `X.Y.Z`, including changelogs, Github release and forum announcement.
+This is the release process for releasing plotly.py version `X.Y.Z`, including changelogs, GitHub release and forum announcement.
 
 ### Finalize changelog
 
@@ -18,54 +18,99 @@ been updated, include this as the first `Updated` entry. Call out any
 notable changes as sub-bullets (new trace types in particular), and provide
 a link to the plotly.js CHANGELOG.
 
-### Finalize versions
+### Update version numbers
+
+**Create a release branch `git checkout -b release-X.Y.Z` _from the tip of `origin/main`_.**
+
+- Manually update the versions to `X.Y.Z` in the files specified below:
+  - `pyproject.toml`
+    - update version
+  - `CHANGELOG.md`
+    - update version and release date
+    - finalize changelog entries according to instructions above
+  - `CITATION.cff`
+    - update version and release date
+- Run `uv lock` to update the version number in the `uv.lock` file (do not update manually)
+- Commit and push your changes to the release branch:
+    ```sh
+    $ git add -u
+    $ git commit -m "version changes for vX.Y.Z"
+    $ git push
+    ```
+- Create a GitHub pull request from `release-X.Y.Z` to `main` and wait for CI to be green
+- On the release branch, create and push a tag for the release:
+    ```sh
+    $ git tag vX.Y.Z
+    $ git push origin vX.Y.Z
+    ```
+
+### Manual QA in Jupyter
+
+We don't currently have automated tests for Jupyter, so we do this QA step manually.
+
+The `full_build` job in the `release_build` workflow in CircleCI produces a tarball of artifacts `output.tgz` 
+which you should download and decompress, which will give you a directory called `output`. The filenames within 
+will contain version numbers; make sure the version numbers are correct.
+
+Set up an environment with Jupyter, AnyWidget, and Pandas installed (`pip install jupyter anywidget pandas`). Then:
+
+- unzip downloaded `output.tgz`
+- `pip uninstall plotly`
+- `pip install path/to/output/dist/plotly-X.Y.Z-py3-none-any.whl`
+
+You'll want to check, in both JupyterLab (launch with `jupyter lab`) and Jupyter Notebook (launch with `jupyter notebook`), 
+that `go.Figure()` and `go.FigureWidget()` work as expected. 
 
-**Create a branch `git checkout -b release-X.Y.Z` *from the tip of `origin/main`*.**
+Notes:
+- **Start by creating a brand new notebook each time** so that there is no caching of previous results
+- **Do not run the Jupyter commands from the root `plotly.py/` directory on your machine** because Jupyter may be confused 
+by metadata from previous plotly.py builds
 
-Manually update the versions to `X.Y.Z` in the files specified below.
+Code for testing `go.Figure()`:
+```python
+import plotly
+import plotly.graph_objects as go
 
- - `pyproject.toml`
-   + update version
- - `CHANGELOG.md`
-   + update the release date
- - Commit your changes on the branch:
-   + `git commit -a -m "version changes for vX.Y.Z"`
- - Create a tag for Github release
-   + `git tag vX.Y.Z`
-   + `git push --atomic origin release-X.Y.Z vX.Y.Z`
- - Create a Github pull request from `release-X.Y.Z` to `main` and wait for CI to be green
+print(plotly.__version__)  # Make sure version is correct
+fig = go.Figure(data=go.Scatter(x=[1, 2, 3, 4], y=[1, 3, 2, 4]))
+fig.show()  # Figure should render in notebook
+```
 
-### Download and QA CI Artifacts
+Code for testing `go.FigureWidget()`:
+```python
+import plotly
+import plotly.graph_objects as go
 
-The `full_build` job in the `release_build` workflow in CircleCI produces a tarball of artifacts `output.tgz` which you should download and decompress, which will give you a directory called `output`. The filenames contained within will contain version numbers.
+print(plotly.__version__)  # Make sure version is correct
+fig = go.Figure(data=go.Scatter(x=[1, 2, 3, 4], y=[1, 3, 2, 4]))
+figure_widget = go.FigureWidget(fig)
+figure_widget  # Figure should render in notebook
+```
 
-To locally install the PyPI dist, make sure you have an environment with JupyterLab installed (maybe one created with `conda create -n condatest python=3.10 jupyter anywidget pandas`):
+Once these are verified working, you can move on to publishing the release.
 
-- `tar xzf output.tgz`
-- `pip uninstall plotly`
-- `conda uninstall plotly` (just in case!)
-- `pip install path/to/output/dist/plotly-X.Y.X-py3-none-any.whl`
+### Merge the release PR and make a GitHub release
 
-You'll want to check, in both Lab and Notebook, **in a brand new notebook in each** so that there is no caching of previous results, that `go.Figure()` and `go.FigureWidget()` work without error.
+- Merge the pull request you created above into `main`
+- Go to https://github.com/plotly/plotly.py/releases and "Draft a new release"
+- Enter the `vX.Y.Z` tag you created already above and make "Release title" the same string as the tag.
+- Copy the changelog section for this version into "Describe this release"
+- Upload the build artifacts downloaded in the previous step (`.tar` and `.whl`)
 
-### Publishing
+### Publishing to PyPI
 
-Once you're satisfied that things render in Lab and Notebook in Widget and regular mode,
-you can publish the artifacts. **You will need special credentials from Plotly leadership to do this.**.
+The final step is to publish the release to PyPI. **You will need special permissions from Plotly leadership to do this.**.
 
+You must install first install [Twine](https://pypi.org/project/twine/) (`pip install twine`) if not already installed.
 
 Publishing to PyPI:
 ```bash
 (plotly_dev) $ cd path/to/output
 (plotly_dev) $ twine upload plotly-X.Y.Z*
 ```
 
-### Merge the PR and make a Release
-
-1. Merge the pull request you created above into `main`
-2. Go to https://github.com/plotly/plotly.py/releases and "Draft a new release"
-3. Enter the `vX.Y.Z` tag you created already above and make "Release title" the same string as the tag.
-4. Copy the changelog section for this version as the "Describe this release"
+You will be prompted to enter an API token; this can be generated in your PyPI account settings. 
+Your account must have permissions to publish to the `plotly` project on PyPI.
 
 ### Update documentation site
 
@@ -76,18 +121,18 @@ Publishing to PyPI:
 start by doing it first if not. Then merge `main` into `doc-prod` to deploy the doc related
 to features in the release.
 3. in a clone of the [`graphing-library-docs` repo](https://github.com/plotly/graphing-library-docs):
-    1. bump the version of Plotly.py in  `_data/pyversion.json`
-    2. bump the version of Plotly.js with `cd _data && python get_plotschema.py <PLOTLY.JS VERSION>` fixing any errors that come up.
-      - If Plotly.js contains any new traces or trace or layout attributes, you'll get a warning `“missing key in attributes: <attribute-name>`. To resolve, add the attribute to the relevant section in `/_data/orderings.json` in the position you want it to appear in the reference docs.
+    1. bump the version of plotly.py in  `_data/pyversion.json`
+    2. bump the version of plotly.js with `cd _data && python get_plotschema.py <PLOTLY.JS VERSION>` fixing any errors that come up.
+      - If plotly.js contains any new traces or trace or layout attributes, you'll get a warning `“missing key in attributes: <attribute-name>`. To resolve, add the attribute to the relevant section in `/_data/orderings.json` in the position you want it to appear in the reference docs.
     3. rebuild the Algolia `schema` index with `ALGOLIA_API_KEY=<key> make update_ref_search`
     4. Rebuild the Algolia `python` index with `ALGOLIA_API_KEY=<key> make update_python_search`
     5. Commit and push the changes to `master` in that repo
 
 ### Notify Stakeholders
 
-* Post an announcement to the Plotly Python forum, with links to the README installation instructions and to the CHANGELOG.
+* Post an announcement to the [Plotly Python forum](https://community.plotly.com/c/plotly-python/5), with links to the README installation instructions and to the CHANGELOG.
 * Update the previous announcement to point to this one
-* Update the Github Release entry and CHANGELOG entry to have the nice title and a link to the announcement
+* Update the GitHub Release entry and CHANGELOG entry to have the nice title and a link to the announcement
 * Follow up on issues resolved in this release or forum posts with better answers as of this release
 
 ## Release process - Release *Candidate* of `plotly` package

plotly/_subplots.py

@@ -746,8 +746,19 @@ def _check_hv_spacing(dimsize, spacing, name, dimvarname, dimname):
             )
             grid_ref[r][c] = subplot_refs
 
-    _configure_shared_axes(layout, grid_ref, specs, "x", shared_xaxes, row_dir)
-    _configure_shared_axes(layout, grid_ref, specs, "y", shared_yaxes, row_dir)
+    _configure_shared_axes(layout, grid_ref, specs, "x", shared_xaxes, row_dir, False)
+    _configure_shared_axes(layout, grid_ref, specs, "y", shared_yaxes, row_dir, False)
+
+    any_secondary_y = any(
+        spec["secondary_y"]
+        for spec_row in specs
+        for spec in spec_row
+        if spec is not None
+    )
+    if any_secondary_y:
+        _configure_shared_axes(
+            layout, grid_ref, specs, "y", shared_yaxes, row_dir, True
+        )
 
     # Build inset reference
     # ---------------------
@@ -879,7 +890,9 @@ def _check_hv_spacing(dimsize, spacing, name, dimvarname, dimname):
     return figure
 
 
-def _configure_shared_axes(layout, grid_ref, specs, x_or_y, shared, row_dir):
+def _configure_shared_axes(
+    layout, grid_ref, specs, x_or_y, shared, row_dir, secondary_y
+):
     rows = len(grid_ref)
     cols = len(grid_ref[0])
 
@@ -890,6 +903,13 @@ def _configure_shared_axes(layout, grid_ref, specs, x_or_y, shared, row_dir):
     else:
         rows_iter = range(rows)
 
+    if secondary_y:
+        cols_iter = range(cols - 1, -1, -1)
+        axis_index = 1
+    else:
+        cols_iter = range(cols)
+        axis_index = 0
+
     def update_axis_matches(first_axis_id, subplot_ref, spec, remove_label):
         if subplot_ref is None:
             return first_axis_id
@@ -913,13 +933,15 @@ def update_axis_matches(first_axis_id, subplot_ref, spec, remove_label):
         return first_axis_id
 
     if shared == "columns" or (x_or_y == "x" and shared is True):
-        for c in range(cols):
+        for c in cols_iter:
             first_axis_id = None
             ok_to_remove_label = x_or_y == "x"
             for r in rows_iter:
                 if not grid_ref[r][c]:
                     continue
-                subplot_ref = grid_ref[r][c][0]
+                if axis_index >= len(grid_ref[r][c]):
+                    continue
+                subplot_ref = grid_ref[r][c][axis_index]
                 spec = specs[r][c]
                 first_axis_id = update_axis_matches(
                     first_axis_id, subplot_ref, spec, ok_to_remove_label
@@ -929,26 +951,30 @@ def update_axis_matches(first_axis_id, subplot_ref, spec, remove_label):
         for r in rows_iter:
             first_axis_id = None
             ok_to_remove_label = x_or_y == "y"
-            for c in range(cols):
+            for c in cols_iter:
                 if not grid_ref[r][c]:
                     continue
-                subplot_ref = grid_ref[r][c][0]
+                if axis_index >= len(grid_ref[r][c]):
+                    continue
+                subplot_ref = grid_ref[r][c][axis_index]
                 spec = specs[r][c]
                 first_axis_id = update_axis_matches(
                     first_axis_id, subplot_ref, spec, ok_to_remove_label
                 )
 
     elif shared == "all":
         first_axis_id = None
-        for c in range(cols):
-            for ri, r in enumerate(rows_iter):
+        for ri, r in enumerate(rows_iter):
+            for c in cols_iter:
                 if not grid_ref[r][c]:
                     continue
-                subplot_ref = grid_ref[r][c][0]
+                if axis_index >= len(grid_ref[r][c]):
+                    continue
+                subplot_ref = grid_ref[r][c][axis_index]
                 spec = specs[r][c]
 
                 if x_or_y == "y":
-                    ok_to_remove_label = c > 0
+                    ok_to_remove_label = c < cols - 1 if secondary_y else c > 0
                 else:
                     ok_to_remove_label = ri > 0 if row_dir > 0 else r < rows - 1
 

plotly/io/_renderers.py

@@ -485,7 +485,7 @@ def show(fig, renderer=None, validate=True, **kwargs):
         )
 
     default_renderer = env_renderer
-elif ipython:
+elif ipython and ipython.get_ipython():
     # Try to detect environment so that we can enable a useful
     # default renderer
     if not default_renderer:

plotly/matplotlylib/mplexporter/tests/test_utils.py

@@ -1,5 +1,6 @@
+import matplotlib.pyplot as plt
 from numpy.testing import assert_allclose, assert_equal
-from . import plt
+
 from .. import utils
 
 

plotly/matplotlylib/tests/test_renderer.py

@@ -1,7 +1,6 @@
+import matplotlib.pyplot as plt
 import plotly.tools as tls
 
-from . import plt
-
 
 def test_native_legend_enabled_when_matplotlib_legend_present():
     """Test that when matplotlib legend is present, Plotly uses native legend."""

pyproject.toml

@@ -32,7 +32,7 @@ classifiers = [
 ]
 requires-python = ">=3.8"
 license = {file="LICENSE.txt"}
-version = "6.3.0"
+version = "6.3.1"
 dependencies = [
     "narwhals>=1.15.1",
     "packaging"