Repository navigation
Add show_backends and print show_versions as markdown - #11700
Merged
Merged
Conversation
show_backends prints the available IO backends, including those of other packages, with their description, url and providing package, in the order they are tried when no engine is given. show_versions now prints markdown tables wrapped in a <details> block, so the output can be pasted as is into GitHub issues, and displays formatted tables in Jupyter notebooks. Versions are read from the package metadata instead of importing the packages. Co-authored-by: Nick Hodgskin <VeckoTheGecko@users.noreply.github.com> Co-authored-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Terminals get the simple text output again, notebooks still display the formatted markdown and markdown=True prints it for GitHub issues. This also restores the bug report template, as old xarray versions print plain text. Co-authored-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The markdown tables rendered right aligned and squeezed together in Jupyter. Use titled, left aligned HTML tables next to each other instead. Co-authored-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Collaborator
Author
Copying the displayed show_versions or show_backends output in a notebook gives the markdown to paste into a GitHub issue. show_backends is displayed as HTML too, and the display includes the plain text for frontends without HTML support like jupyter console. Co-authored-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-authored-by: Claude <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Collaborator
Author
|
ok, this got fancy enough. Now when you copy the output of |
headtr1ck
enabled auto-merge (squash)
October 22, 2026 11:42
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> # Conflicts: # xarray/util/print_versions.py
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.


Description
Adds
xr.show_backends()and givesxr.show_versions()a formatted notebook display and a markdown option for GitHub issues. Supersedes #9821, which addedshow_backendsas an alias oflist_engines.show_backendsprints the available backends, including third-party ones, in the order they are tried when noengineis given, with description, url and the providing package.<details>withmarkdown=True.show_versionsreads versions from the package metadata instead of importing every package, and drops rows of missing packages in favour of a single "Not installed" line.Checklist
whats-new.rstapi.rstAI Disclosure
Tools: Claude Code
[This is Claude Code on behalf of Michael Niklas]
🤖 Generated with Claude Code