dotnet-verify

# .NET Verify Snapshot Testing

Manage [Verify](https://github.com/VerifyTests/Verify) snapshot tests using the `verify.tool` dotnet local tool.

## Discovery

To list all test files using Verify snapshots:

```bash
rg -l "Verifier\.Verify|UsesVerify|\.verified\." --type cs
```

To scope to a specific directory:

```bash
rg -l "Verifier\.Verify|UsesVerify|\.verified\." --type cs <path/to/test/directory>
```

## Update Snapshots

To update snapshots after intentional code changes:

1. Build the solution:
   ```bash
   dotnet build -p:WarningLevel=0 /clp:ErrorsOnly --verbosity minimal
   ```

2. Run affected verify tests (they fail, generating `.received.` files):
   ```bash
   dotnet test <test-project> --no-build --filter "FullyQualifiedName~<TestClass>" -v m
   ```

3. Accept all new snapshots:
   ```bash
   dotnet verify accept -y
   ```
   To scope to a specific directory:
   ```bash
   dotnet verify accept -y -w <path/to/test/directory>
   ```

4. Re-run tests to confirm they pass:
   ```bash
   dotnet test <test-project> --no-build --filter "FullyQualifiedName~<TestClass>" -v m
   ```

## File Conventions

- `ClassName.MethodName.verified.txt` — accepted snapshot (committed to git)
- `ClassName.MethodName.received.txt` — latest test output (not committed, gitignored)
- Parameterized tests: `ClassName.MethodName_param=value.verified.txt`

## Quick Reference

| Command | Purpose |
|---|---|
| `dotnet verify accept -y` | Accept all pending snapshots |
| `dotnet verify accept -y -w <dir>` | Accept snapshots in specific directory |
| `rg -l "Verifier\.Verify\|UsesVerify\|\.verified\." --type cs` | List all test files using Verify |