digdep 0.0.7

A lightweight Python dependency analyzer

DigDep

A lightweight Python dependency analyzer that scans Python projects and visualizes import relationships.

---

Installation

pip install digdep

---

Quick Start (CLI)

List all imported dependencies:

digdep deps ./myproject

Show the File → Dependency tree:

digdep file-tree ./myproject

Show the Dependency → File tree:

digdep dep-tree ./myproject

Show the File → Unused Imports tree:

digdep unused-imports ./myproject

---

Sample Output

File → Dependency Tree

Root (/projects/example)

├── main.py              → requests, pathlib
├── config.py            → json
│
├── modules/
│   ├── logger.py        → logging
│   ├── parser.py        → re, typing
│
└── utils/
    └── helpers.py       → functools

Dependency → File Tree

requests
├── main.py

re
├── modules/
│   └── parser.py

logging
├── modules/
│   └── logger.py

---

Filtering

Filter dependencies by type.

Show only standard library imports:

digdep file-tree ./myproject --type stdlib

Show both standard library and third-party imports:

digdep file-tree ./myproject --type stdlib,third-party

Show only local imports:

digdep file-tree ./myproject --type local

---

Ignoring Directories

Ignore from command line

digdep file-tree ./myproject --ignore venv __pycache__ tests

Ignore from a file

Create a text file (for example, ignore.txt):

venv
.git
build
__pycache__
tests

Then run:

digdep . --ignore-file ignore.txt

Each non-empty line in the file is treated as a directory to ignore.

The --ignore and --ignore-file options can be used together.

---

Write Output to a File

Use the -o (--output) option to write command output to a file. Currently, DigDep supports JSON output.

Export the dependency list

digdep deps . -o deps.json

Output:

{
    "dependencies": [
        "argparse",
        "ast",
        "json",
        "pathlib",
        "rich"
    ]
}

Export the file-dependency tree

digdep file-tree . -o file-tree.json

Export the dependency-file tree

digdep dep-tree . -o dep-tree.json

The output format is determined by the file extension. Currently, only .json is supported.

Redirecting Output

Save the generated tree to a file:

digdep dep-tree ./myproject > dependencies.txt

---

Commands

Command	Description
deps	List all imported dependencies
file-tree	Show the File → Dependency tree
dep-tree	Show the Dependency → File tree

Run digdep <command> --help for command-specific options.

---

Using as a Python Library

from digdep import DepAnalyzer, DepType

analyzer = DepAnalyzer()

# Ignoring directories
analyzer.ignore([
    "__pycache__",
    "venv",
    "build",
    "tests"
])

analyzer.scan("./myproject")

# List imported dependencies
deps = analyzer.get_deps()

# Get the File -> Dependency tree
filedep_tree = analyzer.get_filedep_tree()

# Get the Dependency -> File tree
depfile_tree = analyzer.get_depfile_tree()

# Get the File -> Unused Import tree
unusedimports_tree = analyzer.get_unused_imports_tree()

# Write File -> Dependency to json file
analyzer.file_tree_json("file_tree.json")

# Get File -> Dependency as json
filetree_json = analyzer.file_tree_json()

Filter dependencies by type:

from digdep import DepAnalyzer, DepType

analyzer = DepAnalyzer()
analyzer.scan("./myproject")

# Show only standard library imports
filedep_tree = analyzer.get_filedep_tree(
    filters=DepType.STDLIB
)

# Show standard library and third-party imports
depfile_tree = analyzer.get_depfile_tree(
    filters=DepType.STDLIB | DepType.THIRD_PARTY
)

# Write File -> Dependency to json file
analyzer.file_tree_json(
    fpath="file_tree.json",
    filters=DepType.STDLIB | DepType.LOCAL
)

---

Roadmap

• Local module detection
• Dependency statistics
• JSON export
• Circular dependency detection
• Unused dependency detection

---

Requirements

• Python 3.11+

---

License

Released under the MIT License.

---