Skip to content

Commit f710d69

Browse files
committed
README: Add section about test debugging
1 parent 0197980 commit f710d69

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

README.md

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -161,6 +161,23 @@ so you can run:
161161
uv run poe <command>
162162
```
163163

164+
## Debugging Tests
165+
166+
The `test` command ultimately just calls `pytest`, so you can use all of its
167+
command-line arguments. This one is commonly used to debug misbehaving tests:
168+
169+
```sh
170+
uv run poe test -x --pdb -s
171+
```
172+
173+
Here's what those flags mean:
174+
175+
* `-x`: Exit on first failed test.
176+
* `--pdb`: Drop to PDB on failure.
177+
* `-s`: Workaround [a bug] which makes PDB unresponsive to input.
178+
179+
[a bug]: https://github.com/pytest-dev/pytest/issues/12888
180+
164181
**Global install**
165182

166183
If you install the `poethepoet` package via `uv tool install` or `pipx install`,

0 commit comments

Comments
 (0)