Skip to content

Widen return type of pyplot.subplot_tool to Any #31997

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
karlhillx wants to merge 5 commits into
base: main
Choose a base branch
from
+6 −4
Open

Widen return type of pyplot.subplot_tool to Any #31997

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
ed03cea
Widen return type of pyplot.subplot_tool / NavigationToolbar2.configu…
karlhillx Jul 4, 2026
709e9f2
Fix ruff F811: remove Any from inner TYPE_CHECKING block
karlhillx Jul 4, 2026
f4fe5a7
Potential fix for pull request finding
karlhillx Jul 4, 2026
d2b90f0
Format subplot_tool Returns section per numpydoc
karlhillx Jul 4, 2026
e1e96ec
Use object return type for subplot_tool; generalize docstring
karlhillx Jul 6, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion lib/matplotlib/backend_bases.pyi
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -484,7 +484,7 @@ class NavigationToolbar2:
def release_zoom(self, event: Event) -> None: ...
def push_current(self) -> None: ...
subplot_tool: widgets.SubplotTool
def configure_subplots(self, *args: Any) -> widgets.SubplotTool: ...
def configure_subplots(self, *args: Any) -> object: ...
def save_figure(self, *args) -> str | None | object: ...
def update(self) -> None: ...
def set_history_buttons(self) -> None: ...
Expand Down
8 changes: 5 additions & 3 deletions lib/matplotlib/pyplot.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,6 @@
ResizeEventType,
LogLevel
)
from matplotlib.widgets import SubplotTool
from matplotlib._api import _Unset


Expand Down Expand Up @@ -2152,13 +2151,16 @@ def twiny(ax: matplotlib.axes.Axes | None = None) -> _AxesBase:
return ax1


def subplot_tool(targetfig: Figure | None = None) -> SubplotTool | None:
def subplot_tool(targetfig: Figure | None = None) -> object | None:
"""
Launch a subplot tool window for a figure.

Returns
-------
`matplotlib.widgets.SubplotTool`
object or None
The subplot tool window: a `~matplotlib.widgets.SubplotTool` for the
widgets backend, an implementation-specific value for other backends
(e.g. a Qt dialog), or `None` for backends using the toolmanager.
"""
if targetfig is None:
targetfig = gcf()
Expand Down
Loading