Release Notes

• Add INSTA_PENDING_DIR environment variable for Bazel and other hermetic build systems. When set, pending snapshots are written to a separate directory while keeping the source tree read-only. We are very open to feedback on this feature. #852
• Fix documentation for test.runner_fallback config key. #853

Install cargo-insta 1.46.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.46.0/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.46.0/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.46.0

Release Notes

• Fix backward compatibility with TOML format produced by insta < 1.45.0. #849 (@chitoku-k)

Install cargo-insta 1.45.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.45.1/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.45.1/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.45.1

Release Notes

• Add external diff tool support via INSTA_DIFF_TOOL environment variable. When set, insta uses the specified tool (e.g., delta, difftastic) to display snapshot diffs instead of the built-in diff. The tool is invoked as <tool> <old_file> <new_file>. #844
• Add test.disable_nextest_doctest config option to insta.yaml, allowing users to silence the nextest doctest warning via config instead of passing --dnd every time. #842
• Skip non-insta snapshot files in unreferenced detection. Projects using both insta and other snapshot tools (like vitest or jest) can now use --unreferenced=reject without false positives on .snap files from other tools. #846
• Collect warnings from tests for display after run. Ensures deprecation warnings are visible even when nextest suppresses stdout/stderr from passing tests. #840
• Update TOML serialization to be up-to-date and backwards-compatible. #834
• Support clippy::needless_raw_strings lint by only using raw strings when content contains backslashes or quotes. #828

Install cargo-insta 1.45.0

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.45.0/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.45.0/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.45.0

Release Notes

• Fix a regression in 1.44.2 where merge conflict detection was too aggressive, incorrectly flagging snapshot content containing ====== or similar patterns as conflicts. #832
• Fix a regression in 1.42.2 where inline snapshot updates would corrupt the file when code preceded the macro (e.g., let output = assert_snapshot!(...)). #833

Install cargo-insta 1.44.3

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.44.3/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.44.3/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.44.3

Release Notes

• Fix a rare backward compatibility issue where inline snapshots using an uncommon legacy format (single-line content stored in multiline raw strings) could fail to match after 1.44.0. #830
• Handle merge conflicts in snapshot files gracefully. When a snapshot file contains git merge conflict markers, insta now detects them and treats the snapshot as missing, allowing tests to continue and create a new pending snapshot for review. #829
• Skip nextest_doctest tests when cargo-nextest is not installed. #826
• Fix functional tests failing under nextest due to inherited NEXTEST_RUN_ID environment variable. #824

Install cargo-insta 1.44.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.44.2/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.44.2/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.44.2

Release Notes

• Add --dnd alias for --disable-nextest-doctest flag to make it easier to silence the deprecation warning. #822
• Update cargo-dist to 0.30.2 and fix Windows runner to use windows-2022. #821

Install cargo-insta 1.44.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.44.1/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy Bypass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.44.1/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.44.1

Release Notes

Changes in 1.44.0

• Added non-interactive snapshot review and reject modes for use in non-TTY environments (LLMs, CI
  pipelines, scripts) #815
• Add `--disable-nextest-doctest` flag with deprecation warning #803
• Add ergonomic `--test-runner-fallback` / `--no-test-runner-fallback` flags #811
• Apply redactions to snapshot metadata #813
• Remove confusing 'previously unseen snapshot' message #812
• Speed up JSON float rendering #806 (@nyurik)
• Allow globset version up to 0.4.16 #810 (@g0hl1n)
• Improve documentation #814 (@tshepang)
• Enforce starting newlines in assertions #563

Install

```sh
cargo install [email protected]
```

(Note: Pre-built binaries are not available for this release due to CI infrastructure updates.
Version 1.44.1 with pre-built binaries will be released shortly.)

Release Notes

• Fix panics when cargo metadata fails to execute or parse (e.g., when cargo is not in PATH or returns invalid output). Now falls back to using the manifest directory as the workspace root. #798 (@adriangb)
• Fix clippy uninlined_format_args lint warnings. #801
• Changed diff line numbers to 1-based indexing. #799
• Preserve snapshot names with INSTA_GLOB_FILTER. #786
• Bumped libc crate to 0.2.174, fixing building on musl targets, and increasing the MSRV of
  insta to 1.64.0 (released Sept 2022). #784
• Fix clippy 1.88 errors. #783
• Fix source path in snapshots for non-child workspaces. #778
• Add lifetime to Selector in redaction iterator. #779

Install cargo-insta 1.43.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.43.2/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.43.2/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.43.2

Release Notes

This release in identical in rust code to 1.43.0, but reruns the GitHub Actions
workflows, which failed to create a release within GitHub for 1.43.0.

Install cargo-insta 1.43.1

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.43.1/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.43.1/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.43.1

Release Notes

• Support other indention characters than spaces in inline snapshots. #679
• Fix an issue where multiple targets with the same root would cause too many pending snapshots to be reported. #730
• Hide unseen option in CLI, as it's pending deprecation. #732
• Stop \t and \x1b (ANSI color escape) from causing snapshots to be escaped. #715
• Improved handling of inline snapshots within allow_duplicates! { .. }. #712

Install cargo-insta 1.42.2

Install prebuilt binaries via shell script

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/mitsuhiko/insta/releases/download/1.42.2/cargo-insta-installer.sh | sh

Install prebuilt binaries via powershell script

powershell -ExecutionPolicy ByPass -c "irm https://github.com/mitsuhiko/insta/releases/download/1.42.2/cargo-insta-installer.ps1 | iex"

Download cargo-insta 1.42.2