code-node

See how Python code works, without running it.

Docs · Plugins · How it works · Changelog

Point it at a repo. Get a page showing where the code starts, who calls whom, and what each path touches: AWS, HTTP, environment variables.

Install

pip install code-node-graph        # or: uv tool install code-node-graph
cd your/repo && code-node

What you get

Usage

code-node                              # find entry points and pick one
code-node --list                       # just list them
code-node src/app/main.py:run          # start from a function
code-node src/app/store.py:Store.save  # ...or a method
code-node -e save                      # part of a name
code-node --serve                      # live page on localhost:8765
code-node --mermaid                    # print the graph as Mermaid

from code_node import code_graph, map_code, read_project

project = read_project(".")
cmap = map_code(project.files, "pkg.cli.main", libraries=project.libraries())
print([call.label for call in cmap.aws])
print(code_graph(cmap).mermaid())

Plugins that mix

One platform, any number of libraries and deploy files, checked together. On examples/cart-service:

Limits

It can't follow values from outside the code (a client a library hands back, a function picked from a registry at run time), installed libraries' own code, or getattr with a computed name. A page can miss calls, but everything it shows is in the code.

Develop

make install    # .venv with the dev tools (needs uv)
make check      # everything CI runs
make shots      # remake screenshots (needs Chrome)

python makefile.py <task> does the same on any OS.

_{Extracted from aws-analyzer's how_it_works(). Apache 2.0.}