Skip to content

gh-145455: Show output of blurb & sphinx-build version commands#145457

Merged
encukou merged 1 commit intopython:mainfrom
encukou:doc-make-show-stderr
Mar 3, 2026
Merged

gh-145455: Show output of blurb & sphinx-build version commands#145457
encukou merged 1 commit intopython:mainfrom
encukou:doc-make-show-stderr

Conversation

@encukou
Copy link
Member

@encukou encukou commented Mar 3, 2026

In gh-145455, an outdated dependency caused an import error that was not printed out (2>&1); the message instead said that the tools are missing.

Don't redirect stderr, to show warnings and failures.

Also, switch blurb to output a version on a single line (--version rather than help), and, and don't redirect stdout either. This results in two version info lines being printed out. These get drowned in typical Sphinx output, and can be helpful when debugging.


📚 Documentation preview 📚: https://cpython-previews--145457.org.readthedocs.build/

In pythongh-145455, an outdated dependency caused an import error that was
not printed out	(`2>&1`); the message instead said that the tools are
missing.

Switch `blurb` to output a version on a single line (`--version` rather
than `help`), and don't redirect stderr, to show warnings and failures.
Also, don't redirect stdout. This results in two extra lines with
version info, which get drowned in typical Sphinx output, and can be
helpful when debugging.
Copy link
Member

@hugovk hugovk left a comment

Choose a reason for hiding this comment

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

Thanks!

I think this is worth backporting to security branches as well.

This first came up in a security branch, and it's more likely for their old dependencies to break, and this fix will help debug.

@encukou encukou added 3.11 only security fixes 3.10 only security fixes 3.12 only security fixes labels Mar 3, 2026
@encukou
Copy link
Member Author

encukou commented Mar 3, 2026

Yeah.
But I'd like to wait for slow CI before asking the bot to make backports there.

@encukou encukou merged commit f1de65b into python:main Mar 3, 2026
47 checks passed
@miss-islington-app
Copy link

Thanks @encukou for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

@encukou encukou deleted the doc-make-show-stderr branch March 3, 2026 10:47
miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Mar 3, 2026
…pythonGH-145457)

In pythongh-145455, an outdated dependency caused an import error that was not
printed out (`2>&1`); the message instead said that the tools are missing.

Don't redirect stderr, to show warnings and failures.

Also, switch `blurb` to output a version on a single line (`--version` rather
than `help`), and, and don't redirect stdout either.
This results in two version info lines being printed out. These get drowned
in typical Sphinx output, and can be helpful when debugging.
(cherry picked from commit f1de65b)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
@bedevere-app
Copy link

bedevere-app bot commented Mar 3, 2026

GH-145461 is a backport of this pull request to the 3.14 branch.

miss-islington pushed a commit to miss-islington/cpython that referenced this pull request Mar 3, 2026
…pythonGH-145457)

In pythongh-145455, an outdated dependency caused an import error that was not
printed out (`2>&1`); the message instead said that the tools are missing.

Don't redirect stderr, to show warnings and failures.

Also, switch `blurb` to output a version on a single line (`--version` rather
than `help`), and, and don't redirect stdout either.
This results in two version info lines being printed out. These get drowned
in typical Sphinx output, and can be helpful when debugging.
(cherry picked from commit f1de65b)

Co-authored-by: Petr Viktorin <encukou@gmail.com>
@bedevere-app bedevere-app bot removed the needs backport to 3.14 bugs and security fixes label Mar 3, 2026
@bedevere-app
Copy link

bedevere-app bot commented Mar 3, 2026

GH-145462 is a backport of this pull request to the 3.13 branch.

@bedevere-app bedevere-app bot removed the needs backport to 3.13 bugs and security fixes label Mar 3, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

3.10 only security fixes 3.11 only security fixes 3.12 only security fixes skip news

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants