debug-with-valgrind

name	debug-with-valgrind
description	Debug crashes, segfaults, and memory errors using valgrind integration with nextest through pre-configured profiles

Debugging with Valgrind + Nextest

When you encounter crashes, segfaults, or memory errors in tests, use valgrind for proper debugging.

Quick Usage

# Run a specific test under valgrind
cargo nextest run --profile valgrind -p PACKAGE --test TEST_FILE TEST_NAME

# Example
cargo nextest run --profile valgrind -p facet-format-json --test jit_deserialize test_jit_option_some

How It Works

The project has valgrind pre-configured in .config/nextest.toml:

1. Wrapper script: Defined as [scripts.wrapper.valgrind]

   • Command: valgrind --leak-check=full --show-leak-kinds=all ...
   • Automatically wraps test execution

2. Profile: [profile.valgrind] applies the wrapper to all tests on Linux

3. Running: Use --profile valgrind flag with nextest

Benefits

• ✅ Automatic setup - no manual valgrind commands needed
• ✅ Proper configuration - leak checking, error codes pre-configured
• ✅ Integrated - works with nextest filtering and test selection
• ✅ Clean output - nextest captures and formats valgrind output

Don't Do This

❌ Running valgrind manually: valgrind ./target/debug/deps/test-binary ❌ Using raw + valgrind commands ❌ Playing hunt-the-segfault without proper tools