You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
docs: explain model fixture and snapshot workflow #1030
The contributor documentation links to tests/_data/snapshots/README.md, but that file currently explains only how to regenerate snapshots. It does not explain how BOM model factories in tests/_data/models.py are discovered or how they feed the JSON, XML, and round-trip tests.
This gap came up in the maintainer guidance on #914: #914 (comment). The maintainer explicitly welcomed a dedicated documentation pull request.
Proposed documentation
Document the existing workflow without changing test behavior:
get_bom_* factory discovery and snapshot naming;
_invalid fixtures;
registration of deliberately incomplete dependency graphs;
regenerating snapshots, reviewing only the intended files, and rerunning tests with snapshot recreation disabled.
Acceptance
The documented paths and collector names match the current default branch.
The shared JSON/XML output and deserialization fixture tests pass.
Activity