feat(pytest-plugin): easier assertions on error contents

[bepri]

• Have you followed the guidelines for contributing?
• Have you signed the CLA?
• Have you successfully run make lint && make test?

---

Adds a new function to the pytest plugin to make testing CraftErrors easier. Now, instead of this:

with pytest.raises(CraftError, match="the message field") as raised:
  fallible()

assert raised.details == "some details"
assert raised.retcode == 2

you can just do:

with raises_craft_error(CraftError, match="the message field", details="some details", retcode=2):
  fallible()

This should be a drop-in replacement for any block that already uses pytest.raises().

---

_{Stack created with GitHub Stacks CLI • Give Feedback 💬}

[Copilot]

🟡 Changes recommended

Regenerate and commit uv.lock so frozen documentation builds remain valid.

1 open finding

• Regenerate uv.lock for updated docs dependency group · New

What changed in this PR

Adds raises_craft_error to simplify assertions on CraftError contents.

Changes:

• Implements the new pytest helper.
• Adds comprehensive tests.
• Updates pytest requirements and changelog documentation.

File	Summary
tests/​test_pytest_plugin.py	Tests helper matching and failure behavior.
pyproject.toml	Updates the pytest requirement.
docs/​changelog.rst	Documents the new feature.
craft_cli/​pytest_plugin.py	Implements the assertion helper.

🧠 Review effort: Lite

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.