Skip to content

Commit 779aca4

Browse files
committed
docs(ci): add resolution-too-deep troubleshooting
1 parent 0964d7d commit 779aca4

1 file changed

Lines changed: 15 additions & 0 deletions

File tree

docs/CI_TROUBLESHOOTING.md

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
# CI Troubleshooting
2+
3+
## pip "resolution-too-deep"
4+
- Cause: overly broad/unconstrained dependencies force exhaustive resolution.
5+
- Fix: install with constraints to bound dependency space.
6+
```bash
7+
pip install -r requirements.txt -c constraints.txt
8+
```
9+
- Ensure critical deps (e.g., `cryptography>=39.0.0`) have minimum versions.
10+
11+
## General Tips
12+
- Re-run with `pip --verbose` to inspect resolution decisions.
13+
- Clear pip cache if resolution seems stuck: `pip cache purge`.
14+
- Keep `constraints.txt` in sync with `requirements.txt` when updating dependencies.
15+

0 commit comments

Comments
 (0)