DependencyDetective
DependencyDetective is a powerful tool for analyzing Python project dependencies. It scans your project to identify installed packages, compare them with requirements.txt (if it exists), and analyze usage across files. This tool helps maintain clean and efficient Python projects by providing insights into package usage and potential issues.
Features
- Scans all Python files in a project to find imported packages
- Identifies used packages and unused or nested packages
- Detects missing packages not listed in requirements.txt
- Highlights potentially outdated packages in requirements.txt
- Excludes standard library modules from analysis
- Allows exclusion of specific directories from analysis
- Generates comprehensive reports for easy dependency management
- Creates a new requirements.txt with only necessary packages
Installation
pip install dependency-detective
Usage
dependency-detective /path/to/your/project [options]
Optional arguments:
--requirements
, -r
: Specify a custom path to the requirements.txt file (default: requirements.txt)--output
, -o
: Specify an output file for the analysis report--new-requirements
, -n
: Generate a new requirements.txt with only necessary packages--exclude
, -e
: Specify directories to exclude from analysis (default: venv .venv env .env)--verbose
, -v
: Enable verbose logging
Example
dependency-detective /path/to/your/project -r custom_requirements.txt -o analysis_report.txt -n new_requirements.txt -e venv example_dir
This command will:
- Analyze the project at
/path/to/your/project
- Use
custom_requirements.txt
as the requirements file - Save the analysis report to
analysis_report.txt
- Generate a new requirements file named
new_requirements.txt
with only necessary packages - Exclude the
venv
and example_dir
directories from the analysis
Output
DependencyDetective generates a report that includes:
- Used Packages: Packages that are imported and used in your project
- Unused or Nested Packages: Packages that are installed but not directly imported in your project (they might be dependencies of other packages)
- Missing Packages: Packages that are imported in your project but not installed
- Potentially Outdated Packages: Packages listed in requirements.txt but not used in the project
The new requirements file (if requested) will contain only the packages directly used in your project, helping to minimize unnecessary dependencies.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.