/deps¶
Audit project dependencies for outdated versions, security vulnerabilities, and consistency issues.
What It Does¶
- Identifies dependency files:
requirements.txt,pyproject.toml,package.json, etc. - Checks for outdated packages:
- Python:
pip list --outdated - Node:
npm outdated
- Python:
- Checks for security vulnerabilities:
- Python:
pip-audit(installed on demand;safety checkis no longer used — it requires a login) - Node:
npm audit
- Python:
- Verifies lock file consistency:
- Are pinned versions in
requirements.txtstill withinpyproject.tomlranges? - Are there imports in source code that reference packages not listed in requirements?
- Are pinned versions in
- Reports totals: dependency count, outdated count, security issues, missing dependencies
Example¶
Typical output:
Dependency Audit
================
Total packages: 34 (from requirements.txt)
Outdated: 3
Vulnerabilities: 1
Outdated:
Package Installed Latest Type
httpx 0.25.0 0.28.1 minor
pydantic 2.5.0 2.10.3 minor
sqlalchemy 2.0.23 2.0.36 patch
Vulnerabilities:
Package Version Advisory
certifi 2023.7 GHSA-xqr8-7jwr-rhp7 (moderate)
Fix: upgrade to >= 2024.2.2
Consistency:
OK - all imports resolve to installed packages
OK - pinned versions match pyproject.toml ranges
Security vulnerabilities
When vulnerabilities are found, the command shows the advisory ID, severity, and the minimum fixed version. Upgrade promptly for anything rated high or critical.
Phantom dependencies
The consistency check catches "phantom dependencies" -- packages your code imports that are only available as transitive dependencies of other packages. These can break silently when you upgrade or remove the parent package.
Notes¶
- Requires an active virtual environment or conda environment for accurate results
- For Python projects,
pip-auditis preferred oversafetyas it uses the PyPI advisory database directly - The command does not automatically upgrade packages; it only reports findings