gdscript-code-graph

CLI tool that analyzes GDScript codebases and produces a structured JSON graph of files, metrics, and relationships.


Keywords
code-analysis, gdscript, godot, metrics, static-analysis
License
MIT
Install
pip install gdscript-code-graph==1.0.1

Documentation

gdscript-code-graph

CI PyPI version Python versions license

CLI tool that statically analyzes GDScript (Godot Engine) projects and outputs a structured JSON graph of files, code metrics, and inter-file relationships.

Installation

Requires Python 3.10+.

pip install gdscript-code-graph

Usage

# Analyze a Godot project (output to stdout)
gdscript-code-graph analyze <project-dir>

# Write output to a file
gdscript-code-graph analyze <project-dir> -o graph.json

# Custom repo name and directory exclusions
gdscript-code-graph analyze <project-dir> -o graph.json --repo-name my-game -e addons -e test

Options

Flag Description
-o, --out Output file path (default: stdout)
--repo-name Repository name in output (default: directory name)
-e, --exclude Directory names to exclude (repeatable)

Output

The output format is documented in simple-code-graph-viewer/docs/schema.md.