godot-localization-qa-guard 0.1.3

CI-friendly localization QA for Godot CSV and PO translation files.

Godot Localization QA Guard

A CI-friendly localization QA checker for Godot CSV and PO translation files. It catches missing strings, duplicate keys, broken placeholders, UTF-8 BOM issues, fuzzy PO entries, unchanged target strings, missing project keys, and unused catalog keys.

This is intentionally safe to publish as a standalone tool: examples are generic and the functionality does not reveal private game systems.

Install

python -m pip install -e .

When published:

python -m pip install godot-localization-qa-guard

Quick Start

godot-l10n-guard C:\Projects\MyGame --translations translations --require fr,es
godot-l10n-guard . --csv assets\i18n\strings.csv --scan-scripts --scan-scenes
godot-l10n-guard . --po locale --format markdown --output docs\LOCALIZATION_QA.md
godot-l10n-guard . --format json --output localization-report.json
godot-l10n-guard . --translations translations --max-expansion 1.35 --allowed-glyphs-file fonts\ui-glyphs.txt
godot-l10n-guard . --translations translations --pseudo-output reports\pseudo-localized.csv --fail-on none

Run the sample:

godot-l10n-guard examples\tiny-godot-project --translations examples\tiny-godot-project\translations --scan-scripts --fail-on none

What It Checks

• Godot CSV header starts with keys.
• Required language columns exist.
• Required target cells are not empty.
• Duplicate CSV keys and PO msgid values.
• PO fuzzy and untranslated entries.
• Placeholder sets match across source and target text.
• Target strings that are unchanged from source.
• Target strings that exceed an optional expansion ratio.
• Characters outside an optional UI-font glyph allow-list.
• tr("KEY") and TranslationServer.translate("KEY") usage.
• Uppercase key-like scene text values.
• Missing and unused keys when scanning is enabled.
• Pseudo-localized CSV previews for UI stress testing.
• Report metadata and plain-language rule explanations for easier CI review.

Documentation

• Godot CSV guide
• PO guide
• Placeholder checks
• Pseudo-localization and layout checks
• Key usage scanning
• Rule reference
• CI usage
• Troubleshooting

Development

python -m pip install -e .
python -m unittest discover -s tests -v
godot-l10n-guard examples\tiny-godot-project --translations examples\tiny-godot-project\translations --scan-scripts --fail-on none