Python Package

Testing Overview

Overview of all testing strategies supported by ManifestGuard.

Early Access: Until 2026-12-31

ManifestGuard Python combines fast packaging and manifest validation with extended quality checks so testing feedback appears before CI becomes the first signal.

Key points

  • CLI: On Windows the examples use the recommended py -3.12 -m <module> ... form (for example py -3.12 -m manifestguard ...). On Linux/macOS this usually maps to python3.12 -m ....
  • Start with check to catch packaging, manifest and dependency issues early.
  • Enable --extended once the baseline validation is stable so coverage, complexity and security signals can join the workflow.
  • Export JSON reports for dashboards, review steps and CI artifacts.

Recommended mgpy workflow

  1. Create a reproducible baseline configuration with init-config --merge.
  2. Stabilize the fast validation pass first and only then make expensive checks part of the standard gate.
  3. Use the bootstrap runner or an explicit module invocation in CI so local and pipeline runs stay aligned.

Quick start

py -3.12 -m manifestguard init-config --merge
py -3.12 -m manifestguard check --extended
py -3.12 run_manifestguard.py --ci --report .manifestguard/manifestguard-report.json