Skip to content

Commit 07dcb72

Browse files
committed
docs: mention --force in common issue docs
From pantsbuild#23109
1 parent 5695230 commit 07dcb72

File tree

1 file changed

+4
-0
lines changed

1 file changed

+4
-0
lines changed

docs/docs/using-pants/troubleshooting-common-issues.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -54,6 +54,10 @@ If this resolves the issue, please report that on the ticket and attach the rece
5454

5555
If restarting pantsd is not sufficient, you can also use `--no-local-cache` to ignore the persistent caches. If this resolves the issue, then it is possible that the contents of the cache (at `~/.cache/pants`) will be useful for debugging the ticket that you filed: please try to preserve the cache contents until it can be resolved.
5656

57+
## Rerun a test that may be flaky or have side effects, not just have Pants return a cached result
58+
59+
Use `--test-force` as in `pants test --force src/foo:test` to force Pants to run a test. In contrast to the broader cache invalidation options described above, this only invalidates the final step (aka "actually running the test"). All intermediate steps remain cached.
60+
5761
## Pants cannot find a file in your project
5862

5963
Pants may complain that it cannot find a file or directory, even though the file does indeed exist.

0 commit comments

Comments
 (0)