`pfg snapshot write`

Capabilities

pfg snapshot write regenerates artifacts and writes them back to disk, refreshing stored snapshots in place. (pfg snapshot update is an exact alias for this command.) It uses the same configuration as pfg snapshot verify but sets the update mode to UPDATE, so unchanged files remain untouched while drifted files are atomically rewritten.

Typical use cases

Refresh JSON/fixture/schema snapshots after intentional model changes.
Provide a single command for contributors to run locally before pushing updates.
Automate snapshot refreshes inside release pipelines after bumping presets/profiles.

Inputs & outputs

Target: module path (positional argument).
Outputs: one or more of --json-out, --fixtures-out, --schema-out. These files are regenerated on disk when drift is detected.
Result: prints “Snapshots refreshed.” when files were updated, or “Snapshots already up to date.” if nothing changed.

Flag reference

Same as pfg snapshot verify:

Discovery/determinism flags (--include, --seed, --preset, --profile, --link, etc.).
JSON snapshot knobs (--json-count, --json-jsonl, --json-indent, --json-orjson, --json-shard-size).
Fixture knobs (--fixtures-style, --fixtures-scope, --fixtures-cases, --fixtures-return-type).
Schema knobs (--schema-indent).

Example workflows

Refresh everything after a model change

pfg snapshot write ./app/models.py \

  --json-out artifacts/users.json \

  --fixtures-out tests/fixtures/test_users.py \

  --schema-out schema/users.json \

  --seed 42 --preset boundary

Regenerates all three artifacts, overwriting the files with the new deterministic output.

Sample output

Updated artifacts/users.json

Updated tests/fixtures/test_users.py

schema/users.json already up to date

Snapshots refreshed.

Refresh fixtures only with custom style

pfg snapshot write ./app/models.py \

  --fixtures-out tests/fixtures/test_users.py \

  --fixtures-style class \

  --fixtures-scope module \

  --fixtures-cases 2