Skip to content

Validation route map

sdetkit kits route-map answers: "this dependency changed, what is the smallest command that proves the change is safe?"

python -m sdetkit kits route-map
python -m sdetkit kits route-map httpx --format json
python -m sdetkit kits route-map --impact-area docs
python -m sdetkit kits route-map --repo-usage-tier hot-path

Each match is a declared dependency (see dependency radar for how they are found) with:

Field Meaning
package, spec, groups The dependency, its declared requirement and the groups that declare it.
locked_version The version your lockfile pins, or null.
repo_usage_tier hot-path, balanced or edge.
repo_usage_files The repository's files that import it.
test_files The test files among them that pytest collects (test_*.py, *_test.py).
primary_validation The narrowest command, chosen in this order: python -m pytest -q with those test files when there are 10 or fewer; the whole suite (python -m sdetkit gate fast --only pytest) when there are more; python -m sdetkit gate fast when no test imports the package.
alternate_validation The broader commands to escalate to.

Run the primary_validation first, and escalate only when it shows risk. Filters work as for the radar: a query, --impact-area and --repo-usage-tier.