vibeqc.crash_dump_context

vibeqc.crash_dump_context(out_stem, *, enabled=True)[source]

Register a crash-dump stem for the duration of the block.

Parameters:

  • out_stem (str | PathLike | None) – Path stem to use for any dump emitted from inside the block. None disables — the contextvar is left unset.

  • enabled (bool) – When False, behaves the same as out_stem=None.

Return type:

Iterator[Path | None]

Notes

The companion env var VIBEQC_NO_CRASH_DUMP=1 also disables even when an explicit stem is passed — matches the VIBEQC_NO_HOSTNAME opt-out spelling. run_job calls crash_dump_context() automatically with the resolved opt-out semantics; advanced callers using this directly should likewise honor the env var, or let dump_on_failure() callers do so.