Skip to content

docs: clarify subtests progress output#14467

Merged
nicoddemus merged 1 commit into
pytest-dev:mainfrom
1Utkarsh1:docs/clarify-subtests-progress-output
May 12, 2026
Merged

docs: clarify subtests progress output#14467
nicoddemus merged 1 commit into
pytest-dev:mainfrom
1Utkarsh1:docs/clarify-subtests-progress-output

Conversation

@1Utkarsh1
Copy link
Copy Markdown

@1Utkarsh1 1Utkarsh1 commented May 12, 2026

Summary

  • Render the subtests example output as plain text so the docs do not color every u progress marker as passing.
  • Add a short note explaining that the compact u marker is used for both passed and failed subtests, and that the summary shows which subtests failed.
  • Add a short changelog fragment for the documentation clarification.

Closes #13902.

Testing

  • git diff --check
  • uv run --python 3.14 --with tox tox -e docs -- -q

Notes

  • The commit includes an AI co-author trailer, per the project PR template.

Co-authored-by: OpenAI Codex <codex@openai.com>
@1Utkarsh1 1Utkarsh1 force-pushed the docs/clarify-subtests-progress-output branch from 1b4e0ad to 12c74d2 Compare May 12, 2026 07:57
@psf-chronographer psf-chronographer Bot added the bot:chronographer:provided (automation) changelog entry is part of PR label May 12, 2026
@1Utkarsh1 1Utkarsh1 marked this pull request as ready for review May 12, 2026 08:09
Copilot AI review requested due to automatic review settings May 12, 2026 08:09
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates pytest’s subtests documentation to avoid misleading syntax highlighting in the rendered example output, and adds a brief explanation of the u progress marker behavior, with a corresponding changelog note (closes #13902).

Changes:

  • Switch the subtests example output block to plain text rendering to prevent all u markers from being colored as “passing”.
  • Add a note explaining that u is used for both passed and failed subtests and to consult the short summary for failures.
  • Add a documentation changelog fragment describing the clarification.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated no comments.

File Description
doc/en/how-to/subtests.rst Renders the sample output as plain text and explains the u marker semantics to avoid misleading coloration.
changelog/13902.doc.rst Adds a newsfragment noting the documentation clarification.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copy link
Copy Markdown
Member

@nicoddemus nicoddemus left a comment

Choose a reason for hiding this comment

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

Thanks!

@nicoddemus nicoddemus added the backport 9.0.x apply to PRs at any point; backports the changes to the 9.0.x branch label May 12, 2026
@nicoddemus nicoddemus merged commit 7df5d80 into pytest-dev:main May 12, 2026
60 of 66 checks passed
@patchback
Copy link
Copy Markdown

patchback Bot commented May 12, 2026

Backport to 9.0.x: 💚 backport PR created

✅ Backport PR branch: patchback/backports/9.0.x/7df5d80ff3a98714a1d3cdbe82941229e511f4b3/pr-14467

Backported as #14468

🤖 @patchback
I'm built with octomachinery and
my source is open — https://github.com/sanitizers/patchback-github-app.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

backport 9.0.x apply to PRs at any point; backports the changes to the 9.0.x branch bot:chronographer:provided (automation) changelog entry is part of PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Documentation shows incorrect pytest output color for subtests

3 participants