Skip to content

docs: reference testing configuration in hatch test help#2235

Open
mvanhorn wants to merge 1 commit intopypa:masterfrom
mvanhorn:osc/2202-test-help-reference
Open

docs: reference testing configuration in hatch test help#2235
mvanhorn wants to merge 1 commit intopypa:masterfrom
mvanhorn:osc/2202-test-help-reference

Conversation

@mvanhorn
Copy link
Copy Markdown

@mvanhorn mvanhorn commented Apr 7, 2026

Summary

Adds a note to the hatch test command help text pointing users to --show and the testing configuration docs page. Right now, the help output gives no indication that default dependencies (pytest, coverage, pytest-rerunfailures) exist, leading to confusing resolution errors when users add conflicting versions via extra-dependencies.

Changes

  • src/hatch/cli/test/__init__.py: Appended a paragraph to the command docstring mentioning the --show flag and linking to the testing configuration docs.

Fixes #2202

This contribution was developed with AI assistance (Claude Code).

Add a note to the hatch test docstring pointing users to --show and
the testing configuration docs. Without this, dependency conflicts
from built-in defaults are confusing because the help output gives no
indication that default dependencies exist.

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

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs/UX: hatch test -h should reference testing configuration and default dependencies

1 participant