Merge branch 'main' into kaleido-docs-updates

Author: LiamConnors

.github/ISSUE_TEMPLATE.md

@@ -2,6 +2,6 @@ Thanks for your interest in Plotly.py!
 
 Before opening an issue, please search for existing and closed issues :)
 
-**Please** accompany bug reports with a reproducible example. Please use the [latest version](https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md) of plotly.py in your report unless not applicable.
+**Please** accompany bug reports with a reproducible example. Please use the [latest version](https://github.com/plotly/plotly.py/blob/main/CHANGELOG.md) of plotly.py in your report unless not applicable.
 
 Note that GitHub Issues are meant to be used for bug reports and feature requests only. Implementation or usage questions should be asked on [community.plotly.com](https://community.plotly.com/c/graphing-libraries/python/10) or on Stack Overflow (tagged [`plotly`](https://stackoverflow.com/questions/tagged/plotly)).

.github/pull_request_template.md

@@ -6,7 +6,7 @@ below :-).
 
 ### Documentation PR
 
-- [ ] I've [seen the `doc/README.md` file](https://github.com/plotly/plotly.py/blob/master/doc/README.md)
+- [ ] I've [seen the `doc/README.md` file](https://github.com/plotly/plotly.py/blob/main/doc/README.md)
 - [ ] This change runs in the current version of Plotly on PyPI and targets the `doc-prod` branch OR it targets the `main` branch
 - [ ] If this PR modifies the first example in a page or adds a new one, it is a `px` example if at all possible
 - [ ] Every new/modified example has a descriptive title and motivating sentence or paragraph
@@ -27,7 +27,7 @@ below :-).
 
 ## Code PR
 
-- [ ] I have read through the [contributing notes](https://github.com/plotly/plotly.py/blob/master/CONTRIBUTING.md) and understand the structure of the package. In particular, if my PR modifies code of `plotly.graph_objects`, my modifications concern the `codegen` files and not generated files.
+- [ ] I have read through the [contributing notes](https://github.com/plotly/plotly.py/blob/main/CONTRIBUTING.md) and understand the structure of the package. In particular, if my PR modifies code of `plotly.graph_objects`, my modifications concern the `codegen` files and not generated files.
 - [ ] I have added tests (if submitting a new feature or correcting a bug) or
   modified existing tests.
 - [ ] For a new feature, I have added documentation examples in an existing or

CHANGELOG.md

@@ -2,15 +2,18 @@
 All notable changes to this project will be documented in this file.
 This project adheres to [Semantic Versioning](http://semver.org/).
 
-## [6.1.0b0] - 2025-03-31
+## [6.1.0rc0] - 2025-05-01
 
 ### Updated
-- Add support for Kaleido >= v1.0.0 for image generation, and deprecate support for Kaleido<1 and Orca [[#5062](https://github.com/plotly/plotly.py/pull/5062)]
+- Add support for Kaleido>=v1.0.0 for image generation, and deprecate support for Kaleido<1 and Orca [[#5062](https://github.com/plotly/plotly.py/pull/5062)]
+- Reduce package bundle size by 18-24% via changes to code generation [[#4978](https://github.com/plotly/plotly.py/pull/4978)]
 
 ### Fixed
 - Fix third-party widget display issues in v6 [[#5102](https://github.com/plotly/plotly.py/pull/5102)]
 - Add handling for case where `jupyterlab` or `notebook` is not installed [[#5104](https://github.com/plotly/plotly.py/pull/5104/files)]
 - Fix issue causing Plotly.js script to be embedded multiple times in Jupyter notebooks [[#5112](https://github.com/plotly/plotly.py/pull/5112)]
+- Re-add MIME renderer JupyterLab extension with JupyterLab 4 support to reduce file sizes for offline notebooks [[#5096](https://github.com/plotly/plotly.py/pull/5096)]
+- Fix issue preventing plots from rendering in HTML notebook export when using 'vscode+notebook' renderer [[#5154](https://github.com/plotly/plotly.py/pull/5154)]
 
 ## [6.0.1] - 2025-03-14
 

README.md

@@ -55,7 +55,7 @@ See the [Python documentation](https://plotly.com/python/) for more examples.
 
 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 integrated into [Dash applications](https://dash.plotly.com/).
+`plotly.py` is [MIT Licensed](https://github.com/plotly/plotly.py/blob/main/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.
 
@@ -67,9 +67,9 @@ Built on top of [plotly.js](https://github.com/plotly/plotly.js), `plotly.py` is
 ---
 
 - [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)
+- [Contributing to plotly](https://github.com/plotly/plotly.py/blob/main/CONTRIBUTING.md)
+- [Changelog](https://github.com/plotly/plotly.py/blob/main/CHANGELOG.md)
+- [Code of Conduct](https://github.com/plotly/plotly.py/blob/main/CODE_OF_CONDUCT.md)
 - [Community forum](https://community.plotly.com)
 
 ---
@@ -147,7 +147,7 @@ conda install -c plotly plotly-geo=1.0.0
 
 Code and documentation copyright 2019 Plotly, Inc.
 
-Code released under the [MIT license](https://github.com/plotly/plotly.py/blob/master/LICENSE.txt).
+Code released under the [MIT license](https://github.com/plotly/plotly.py/blob/main/LICENSE.txt).
 
 Docs released under the [Creative Commons license](https://github.com/plotly/documentation/blob/source/LICENSE).
 

RELEASE.md

@@ -20,7 +20,7 @@ a link to the plotly.js CHANGELOG.
 
 ### Finalize versions
 
-**Create a branch `git checkout -b release-X.Y.Z` *from the tip of `origin/master`*.**
+**Create a 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.
 

plotly/io/_kaleido.py

@@ -14,7 +14,7 @@
 
 PLOTLY_GET_CHROME_ERROR_MSG = """
 
-Kaleido requires Google Chrome to be installed. 
+Kaleido requires Google Chrome to be installed.
 
 Either download and install Chrome yourself following Google's instructions for your operating system,
 or install it from your terminal by running:
@@ -549,47 +549,68 @@ def write_images(
     Parameters
     ----------
     fig:
-        Iterable of figure objects or dicts representing a figure
+        List of figure objects or dicts representing a figure.
+        Also accepts a single figure or dict representing a figure.
 
-    file: str or writeable
-        Iterables of strings or pathlib.Path objects representing local file paths to write to.
+    file: str, pathlib.Path, or list of (str or pathlib.Path)
+        List of str or pathlib.Path objects representing local file paths to write to.
+        Can also be a single str or pathlib.Path object if fig argument is
+        a single figure or dict representing a figure.
 
-    format: str or None
-        The desired image format. One of
+    format: str, None, or list of (str or None)
+        The image format to use for exported images.
+        Supported formats are:
           - 'png'
           - 'jpg' or 'jpeg'
           - 'webp'
           - 'svg'
           - 'pdf'
 
-        If not specified, this will default to `plotly.io.defaults.default_format`.
+        Use a list to specify formats for each figure or dict in the list
+        provided to the `fig` argument.
+        Specify format as a `str` to apply the same format to all exported images.
+        If not specified, and the corresponding `file` argument has a file extension, then `format` will default to the
+        file extension. Otherwise, will default to `plotly.io.defaults.default_format`.
 
-    width: int or None
+    width: int, None, or list of (int or None)
         The width of the exported image in layout pixels. If the `scale`
         property is 1.0, this will also be the width of the exported image
         in physical pixels.
 
+        Use a list to specify widths for each figure or dict in the list
+        provided to the `fig` argument.
+        Specify width as an `int` to apply the same width to all exported images.
         If not specified, will default to `plotly.io.defaults.default_width`.
 
-    height: int or None
+    height: int, None, or list of (int or None)
         The height of the exported image in layout pixels. If the `scale`
         property is 1.0, this will also be the height of the exported image
         in physical pixels.
 
+        Use a list to specify heights for each figure or dict in the list
+        provided to the `fig` argument.
+        Specify height as an `int` to apply the same height to all exported images.
         If not specified, will default to `plotly.io.defaults.default_height`.
 
-    scale: int or float or None
+    scale: int, float, None, or list of (int, float, or None)
         The scale factor to use when exporting the figure. A scale factor
         larger than 1.0 will increase the image resolution with respect
         to the figure's layout pixel dimensions. Whereas as scale factor of
         less than 1.0 will decrease the image resolution.
 
+        Use a list to specify scale for each figure or dict in the list
+        provided to the `fig` argument.
+        Specify scale as an `int` or `float` to apply the same scale to all exported images.
         If not specified, will default to `plotly.io.defaults.default_scale`.
 
-    validate: bool
+    validate: bool or list of bool
         True if the figure should be validated before being converted to
         an image, False otherwise.
 
+        Use a list to specify validation setting for each figure in the list
+        provided to the `fig` argument.
+        Specify validate as a boolean to apply the same validation setting to all figures.
+
     Returns
     -------
     None

pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 "HomePage" = "https://plotly.com/python/"
 "Documentation" = "https://plotly.com/python/"
 "Github" = "https://github.com/plotly/plotly.py"
-"Changelog" = "https://github.com/plotly/plotly.py/blob/master/CHANGELOG.md"
+"Changelog" = "https://github.com/plotly/plotly.py/blob/main/CHANGELOG.md"
 
 [tool.pytest.ini_options]
 markers = [
@@ -38,15 +38,15 @@ classifiers = [
 ]
 requires-python = ">=3.8"
 license = {file="LICENSE.txt"}
-version = "6.1.0b0"
+version = "6.1.0rc0"
 dependencies = [
     "narwhals>=1.15.1",
     "packaging"
 ]
 
 [project.optional-dependencies]
 express = ["numpy"]
-kaleido = ["kaleido==1.0.0rc11"]
+kaleido = ["kaleido==1.0.0rc13"]
 dev = ["black==25.1.0"]
 
 [project.scripts]

test_requirements/requirements_optional.txt

@@ -18,7 +18,7 @@ matplotlib
 scikit-image
 psutil
 # kaleido>=1.0.0  # Uncomment and delete line below once Kaleido v1 is released
-git+https://github.com/plotly/[email protected]#subdirectory=src/py
+kaleido==1.0.0rc13
 orjson
 polars[timezone]
 pyarrow