issuetest 1.0.0rc3

IssueTest framework — reusable functional test scaffolding and pytest plugin

IssueTest

IssueTest is a repo-agnostic functional test framework that treats GitHub Issues as the test specification, syncs them into YAML case files, scaffolds test stubs, runs those tests with pytest, and prepares status comments back to the originating issues.

What works now

• issuetest init bootstraps a consumer repository with config, templates, workflows, and labels.
• issuetest matrix builds an automation matrix from case YAMLs and discovered tests.
• issuetest scaffold <case_id> creates discoverable pytest stubs with embedded case_id metadata.
• issuetest run executes pytest and writes .issuetest/run_report.json.
• issuetest report --dry-run renders the exact comment bodies that would be posted to GitHub issues.
• The reusable composite Actions for sync, validate, run, and report exist under action/*.

Install

Until the package is published to PyPI, install from the local package directory or a built wheel.

python -m pip install ./tools/issuetest

Or build and install the wheel:

python -m build tools/issuetest -o tools/issuetest/dist
python -m pip install --no-deps tools/issuetest/dist/issuetest-1.0.0rc1-py3-none-any.whl

After PyPI publication, the intended install is:

python -m pip install issuetest

Commands

issuetest init
issuetest sync --dry-run
issuetest validate
issuetest matrix
issuetest scaffold SUB-PLAN-001
issuetest run
issuetest report --dry-run
issuetest doctor

Docs

• docs/quickstart.md for setup.
• docs/ci-recipes.md for reusable GitHub Actions.
• docs/commercex-subscriptions.md for the worked CommerceX subscriptions example.
• docs/threat_model.md for the security and trust model.