---
id: gdtoolkit
version: "4.5.0"
license: MIT
license_treatment: permissive
maintenance: aging
---

# gdtoolkit — Independent set of tools for working with GDScript - parser, linter and formatter

License: permissive · Maintenance: aging · Downloads: 231.1K/mo

## What it is and what it does

GDToolkit is a command-line toolkit for GDScript developers working with the Godot game engine. It bundles four main tools: a parser that builds parse trees for debugging, a linter that performs static analysis against configurable rules, a formatter that standardizes code style, and a metrics calculator that measures cyclomatic complexity. The package depends on lark for parsing, docopt-ng for CLI argument handling, pyyaml for configuration, radon for complexity calculation, and setuptools for installation.

You use it by running commands like `gdlint`, `gdformat`, `gdparse`, and `gdradon` on your GDScript files. It's designed to integrate into development workflows—either as a standalone tool, a GitHub Action, or a pre-commit hook. The formatter can rewrite files in place, so version control is recommended. The linter outputs violations with line numbers and rule names; the parser prints a tree representation of code structure; the metrics calculator reports complexity grades similar to Radon's Python output.

Use it for:

- Run `gdlint` in CI/CD pipelines to enforce GDScript coding standards before merging pull requests
- Use `gdformat` with pre-commit hooks to automatically normalize code style across a team's Godot project
- Execute `gdparse` to inspect and debug the syntactic structure of GDScript files during development
- Calculate cyclomatic complexity with `gdradon` to identify overly complex functions that need refactoring
- Integrate as a GitHub Action to perform static checks on every push and pull request to a Godot repository

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

GDScript parser, linter, formatter, and code metrics calculator providing static analysis and code quality tools for Godot's GDScript language.

Yes. The package is stable (Production/Stable classifier), permissively licensed, has low install friction, and fills a clear need for GDScript developers. The aging maintenance status (309 days since last release) is a minor concern but not a blocker—the repository is active, no vulnerabilities are known, and the toolkit's core functionality remains relevant. Install it if you work with GDScript and want automated code quality checks.

## Install

pip install gdtoolkit
uv add gdtoolkit
poetry add gdtoolkit

## Installing gdtoolkit

Before you install: Low install friction with a pure Python wheel distribution. Maintenance status is aging—last release was 309 days ago—but the repository remains active with recent commits and no archived status.

License in practice: MIT license permits commercial and private use with minimal restrictions; you may use, modify, and distribute the package freely provided you include the original license notice.

Quickstart:

pip install gdtoolkit==4.5.0

# Run linter on a GDScript file
gdlint my_script.gd

# Format a file
gdformat my_script.gd

# Parse and inspect structure
gdparse my_script.gd -p

Requires Python 3.7 or later; GDScript files must be valid GDScript syntax for the parser and linter to work correctly.

Verify before relying:

- Whether the package actively supports Godot 4.x versions beyond what the version number suggests
- Performance characteristics when linting or formatting large GDScript projects
- Compatibility with recent Godot engine releases and their GDScript syntax changes

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 231.1K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

gdscript linter formatter, godot code quality tools, gdscript static analysis, gdscript parser, code formatting for godot, gdscript complexity metrics, godot development tools, godot-engine, code-quality, cli-tool

[View on SkillFed](https://skillfed.io/packages/gdtoolkit) · [View on PyPI](https://pypi.org/project/gdtoolkit/)