Skip to content

Docs: align pytest.mark.xfail and skip parameter signatures with reality (#10094)#14725

Open
Joosboy wants to merge 1 commit into
pytest-dev:mainfrom
Joosboy:docs/10094-xfail-skip-docs
Open

Docs: align pytest.mark.xfail and skip parameter signatures with reality (#10094)#14725
Joosboy wants to merge 1 commit into
pytest-dev:mainfrom
Joosboy:docs/10094-xfail-skip-docs

Conversation

@Joosboy

@Joosboy Joosboy commented Jul 19, 2026

Copy link
Copy Markdown

Closes #10094.

This PR fixes the documentation signatures and parameter descriptions for pytest.mark.xfail and pytest.mark.skip to accurately reflect the codebase.

  • pytest.mark.skip's reason defaults to "unconditional skip", not None.
  • pytest.mark.xfail's condition defaults to None instead of False.
  • pytest.mark.xfail's raises parameter explicitly allows None.

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.

Reference documentation, typing annotations and reality for pytest.mark.xfail() don’t match

1 participant