get_chrome() accepts one optional argument,path, which is the location to download Chrome to; if not supplied, the default location defined bychoreographer will be used.

This PR also slightly refactorsget_chrome() into two functions:

get_chrome(), which is intended to be called directly in code, and
plotly_get_chrome(), which is a CLI wrapper forget_chrome() and intended to be called via theplotly_get_chrome command from the command line.

On this branch, running the following code should work:

importplotly.ioaspiopio.get_chrome()

emilykl added2 commits

July 16, 2025 15:02

expose plotly.io.get_chrome()

5d6246b

add test to make sure plotly.io.get_chrome() is exposed

f667bc4

emilykl requested review fromLiamConnors andgvwilson

July 16, 2025 19:07

gvwilson approved these changes

Jul 16, 2025

View reviewed changes

plotly/io/_kaleido.py

		The path to the directory where Chrome should be installed.
		If None, the default download path will be used.
		"""
		ifnotkaleido_available()orkaleido_major()<1:

Copy link

Contributor

gvwilsonJul 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

why a confirmation? (not arguing, just think it's very unlikely someone would call the function by accident)

Copy link

ContributorAuthor

emilyklJul 16, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

Do you mean the one on line 837? I agree it's unlikely to be called by accident, but I mainly put it there so users could confirm that the install path makes sense.

In any case, the confirmation only appears when using the command-lineplotly_get_chrome command, not when calling theplotly.io.get_chrome() function within a script.