godot-export-preset-doctor 0.1.0

CI-friendly release-readiness checks for Godot export_presets.cfg files.

Godot Export Preset Doctor

Release-readiness checks for Godot export_presets.cfg, focused on Android, CI export hygiene, debug flags, signing safety, package identity, ABIs, icons, and missing export paths.

The tool is a companion to export automation. It does not build the game; it catches risky preset drift before a release job runs godot --headless --export-release.

Install

python -m pip install -e .

When published:

python -m pip install godot-export-preset-doctor

Quick Start

godot-export-doctor C:\Projects\MyGame
godot-export-doctor . --platform Android
godot-export-doctor . --format sarif --output export-doctor.sarif

Use --fail-on none while exploring a report:

godot-export-doctor examples\bad-export-project --fail-on none

What It Checks

• Missing export_presets.cfg.
• Missing preset name, platform, or export path.
• Android package id, version code/name, enabled ABI, and launcher icon readiness.
• Release-like presets with debug options enabled.
• Hard-coded password, token, secret, or keystore-like values.
• JSON and SARIF output for automation.

Configuration

Create .godot-export-doctor.toml:

format = "text"
fail_on = "warning"
platform = "Android"
required_android_abis = ["arm64-v8a"]

CLI flags override config values.

Output

Text:

godot-export-doctor .

JSON:

godot-export-doctor . --format json --output export-report.json

SARIF:

godot-export-doctor . --format sarif --output export-doctor.sarif

Documentation

• Android release checklist
• Rule reference
• Security guide
• Configuration
• CI integration
• Troubleshooting

Development

python -m pip install -e .
python -m unittest discover -s tests -v
godot-export-doctor examples\bad-export-project --fail-on none

Design Notes

The checker is intentionally static. It reads Godot config files and reports conservative findings that are useful in local development and CI. It does not need the Godot editor, Android SDK, or network access.

Examples and fixtures are generic by design. They should be safe to publish without exposing private project details.