Tool that create a digram with your code structure to show dependencies between code entities (methods, modules, classes and etc). Main advantage of CodeGraph, that is does not execute the code itself. You not need to activate any environments or install dependencies to analyse the target code. It is based only on lex and syntax parse, so it not need to install all your code dependencies.

  
    pip install codegraph

codegraph - name of command line tool for CodeGrapg

    codegraph /path/to/your_python_code
    # path must be absolute

    # or for one file

    codegraph /path/to/your_python_code

your_python_code - module with your python code

For example, if I put codegraph in my user home directory path will be:

codegraph /Users/myuser/codegraph/codegraph

Pass '-o' flag if you want only print dependencies in console and don't want graph visualisation

codegraph /path/to/your_python_code -o

If you want to change view and play with graph output - you can check 'vizualyzer.py' and play with matplotlib and networkX settings.

In default view - red line show dependencies between entities in different modules. Green - links between objects/functions inside same module.

1. Create normal readme
2. Add tests
3. Work on visual part of Graph (now it is not very user friendly)
4. Add support to variables (names) as entities
5. Split usage & inheritance as a different cases

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Interactive D3.js Visualization (New Default)

• D3.js visualization is now the default instead of matplotlib
• Zoom & Pan: Mouse wheel to zoom, drag background to pan
• Drag nodes: Reposition individual nodes by dragging
• Collapse/Expand: Click on modules or entities to collapse/expand their children
• Double-click: Focus and zoom to any node
• Tooltips: Hover over nodes to see details (type, parent module, connection count)
• Auto zoom-to-fit: Graph automatically fits to screen after loading

Module-to-Module Connections

• Orange links now show dependencies between .py files
• Visual representation of which modules depend on which
• Module connections are always visible even when entities are collapsed

Search with Autocomplete

• Search box at the top center of the visualization
• Ctrl+F (Cmd+F on Mac) to focus search
• Autocomplete dropdown with up to 10 matching results
• Results show node type (module/entity/external) with color coding
• Arrow keys to navigate, Enter to select, Esc to close
• Highlighting: Selected node and its connections are highlighted, others dimmed
• Info panel shows number of connected nodes

Visual Design

• Modules: Green squares (larger)
• Entities: Blue circles (functions/classes)
• External dependencies: Gray circles
• Module-to-Module links: Orange, thick (3px)
• Module-to-Entity links: Green, dashed
• Entity-to-Dependency links: Red
• Statistics panel showing module count, entity count, and module connections
• Legend explaining all node and link types
• Dark theme with high contrast

CLI Options

• --matplotlib flag to use legacy matplotlib visualization
• --output PATH to specify custom output path for HTML file
• Default output: ./codegraph.html (current working directory)

• Default visualization changed from matplotlib to D3.js
• draw_graph() now generates interactive HTML instead of matplotlib window
• Renamed draw_graph() to draw_graph_matplotlib() for legacy visualization

• KeyError when analyzing codebases with external imports not in the analyzed path
• Now gracefully skips modules not found in the analyzed codebase
• Comma-separated imports now properly parsed (e.g., from package import a, b, c)
• Fixed missing connections when imports use comma-separated syntax

• Added comprehensive test suite for graph generation (tests/test_graph_generation.py)
• Tests for import parsing: simple imports, comma-separated, aliased imports
• Tests for CodeGraph connections between modules
• Tests for D3.js format conversion
• Tests verifying codegraph can analyze its own codebase
• Support for Python 3.9, 3.10, 3.11, 3.12, 3.13
• Added tox.ini for multi-version testing
• Added GitHub Actions CI matrix for all supported Python versions

• Initial matplotlib visualization
• Basic dependency graph generation
• CLI interface with click
• Support for Python 3.12+