Skip to content

Commit 5ddab8a

Browse files
committed
document Rust build and test timing
- Add guidance for cold and warm Cargo builds - Explain timeout and build-directory lock handling
1 parent bb15083 commit 5ddab8a

1 file changed

Lines changed: 16 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -131,6 +131,22 @@ docker pull neckaros/redseat-rust
131131
docker run -v redseat_config:/root/.config/redseat -p 8080:8080 neckaros/redseat-rust
132132
```
133133

134+
### Build and Test Timing
135+
136+
- Native dependencies make cold Windows builds slow. Allow at least 5 minutes for
137+
`cargo check --bin redseat-rust` and 6 minutes for the first filtered
138+
`cargo test ... --bin redseat-rust` instead of starting with a 2-minute timeout.
139+
- The `dev` and `test` profiles compile separately. A successful `cargo check`
140+
does not make the first `cargo test` fast; expect another native dependency build.
141+
- After the caches are warm, `cargo check` is typically about 10 seconds and a
142+
focused test filter about 2 seconds (machine-dependent).
143+
- If a Cargo command times out, its compiler subprocess may still be running and
144+
holding the target-directory lock. Inspect or wait for that process before
145+
retrying; an immediate retry can spend most of its time at
146+
`Blocking waiting for file lock on build directory`.
147+
- For review fixes, validate with `cargo check --bin redseat-rust` first, then run
148+
the narrowest relevant test filter to avoid unnecessary test execution.
149+
134150
## ENV VARIABLES
135151

136152
| Variable | Purpose |

0 commit comments

Comments
 (0)