GitHub Vita Lite - Wolff's Store
Code / README | Releases | Issues
WolffsRoom/VoidStrangerVita / scripts / tools

generate-ptbr-translation.py

5958 bytes · Original / download

#!/usr/bin/env python3
"""Generate a structurally safe PT-BR draft for Void Stranger International."""

from __future__ import annotations

import json
import os
import re
import sys
from pathlib import Path


ROOT = Path(__file__).resolve().parents[2]
LANGUAGES = ROOT / "mods" / "Languages"
SOURCE = LANGUAGES / "EN"
TARGET = LANGUAGES / "PTBR"
CACHE_FILE = ROOT / ".tools" / "ptbr-translation-cache.json"

# UI and recurring lore terms get an explicit Brazilian localization.  The
# neural translator handles dialogue while this table keeps the terminology
# stable and the Vita-facing menus concise.
EXACT = {
    "ENGLISH": "PORTUGUÊS (BRASIL)",
    "English script": "Tradução PT-BR para PS Vita",
    "MENUS": "MENUS",
    "[Yes]": "[Sim]",
    "[No]": "[Não]",
    "BACK": "VOLTAR",
    "ON": "LIGADO",
    "OFF": "DESLIGADO",
    "FINNISH": "FINLANDÊS",
    "RESUME": "CONTINUAR",
    "SETTINGS": "CONFIGURAÇÕES",
    "QUIT GAME": "SAIR DO JOGO",
    "GRAPHICS": "GRÁFICOS",
    "AUDIO": "ÁUDIO",
    "CONTROLS": "CONTROLES",
    "MISC": "OUTROS",
    "MASTER": "GERAL",
    "MUSIC": "MÚSICA",
    "SOUND": "SOM",
    "RESOLUTION": "RESOLUÇÃO",
    "FULLSCREEN": "TELA CHEIA",
    "TIMER": "CRONÔMETRO",
    "COUNTER": "CONTADOR",
    "UP": "CIMA",
    "LEFT": "ESQUERDA",
    "RIGHT": "DIREITA",
    "DOWN": "BAIXO",
    "ACTION KEY": "BOTÃO DE AÇÃO",
    "LANGUAGE": "IDIOMA",
    "START": "INICIAR",
    "Skipping...": "Pulando...",
    "TEXT SPEED": "VELOCIDADE DO TEXTO",
    "MID": "MÉDIA",
    "SLOW": "LENTA",
    "FAST": "RÁPIDA",
    "PAUSE": "PAUSAR",
    "PRESS ACTION TO CONFIRM": "PRESSIONE X PARA CONFIRMAR",
    "PRESS ANY KEY/BUTTON TO CONTINUE": "PRESSIONE X PARA CONTINUAR",
    "YOU'VE FALLEN": "VOCÊ CAIU",
    "NO CONTROLLERS FOUND": "NENHUM CONTROLE ENCONTRADO",
    "CONTROLLER(S) FOUND": "CONTROLE(S) ENCONTRADO(S)",
    "MOVES": "MOVIMENTOS",
    "VOIDS": "VAZIOS",
    "TIME": "TEMPO",
    "Resetting...": "Reiniciando...",
    "FLASHING FX": "EFEITOS PISCANTES",
    "PALETTE": "PALETA",
    "Wake up": "Acordar",
    "End it all": "Acabar com tudo",
    "REST SHUTDOWN": "DESCANSO FINAL",
    "PRESENTED BY": "APRESENTADO POR",
    "STAFF": "EQUIPE",
    "SOUND LIBRARIES": "BIBLIOTECAS DE ÁUDIO",
    "PLAYTESTERS": "TESTADORES",
    "MEMORIES": "MEMÓRIAS",
    "BURDENS": "FARDOS",
    "VOID MEMORY": "MEMÓRIA DO VAZIO",
    "VOID SWORD": "ESPADA DO VAZIO",
    "VOID WINGS": "ASAS DO VAZIO",
    "MOVEMENT": "MOVIMENTO",
    "TAP": "TOCAR",
    "HOLD": "SEGURAR",
    "SCALING": "ESCALA",
    "INTEGER": "INTEIRA",
    "FIT": "AJUSTAR",
    "BORDER COLOR": "COR DA BORDA",
    "BLACK": "PRETO",
    "DARK": "ESCURO",
    "VSYNC": "VSYNC",
    "60 FPS": "60 FPS",
    "30 FPS": "30 FPS",
    "REDUCED": "REDUZIDOS",
}

DO_NOT_TRANSLATE = re.compile(
    r"^(?:\s*|[-+*/=<>_|.0-9]+|[A-Z0-9_]+\.(?:png|ogg|wav)|https?://\S+)$"
)
TOKEN = re.compile(r"(\\[nrt]|#[0-9A-Fa-f]{6}|\{[^{}]*\}|%[-+0-9.]*[a-zA-Z])")


def protect(text: str) -> tuple[str, list[str]]:
    tokens: list[str] = []

    def repl(match: re.Match[str]) -> str:
        tokens.append(match.group(0))
        return f"ZXQ{len(tokens) - 1}QXZ"

    return TOKEN.sub(repl, text), tokens


def restore(text: str, tokens: list[str]) -> str:
    for index, token in enumerate(tokens):
        text = text.replace(f"ZXQ{index}QXZ", token)
        text = text.replace(f"ZXQ {index} QXZ", token)
    return text


def main() -> int:
    tools = ROOT / ".tools" / "argostranslate"
    os.environ.setdefault("ARGOS_PACKAGES_DIR", str(ROOT / ".tools" / "argos-models"))
    sys.path.insert(0, str(tools))
    import argostranslate.translate  # type: ignore

    installed = argostranslate.translate.get_installed_languages()
    english = next(x for x in installed if x.code == "en")
    portuguese = next(x for x in installed if x.code == "pt")
    translator = english.get_translation(portuguese)
    if translator is None:
        raise RuntimeError("English to Portuguese Argos model is not installed")

    cache: dict[str, str] = {}
    if CACHE_FILE.exists():
        cache = json.loads(CACHE_FILE.read_text(encoding="utf-8"))

    TARGET.mkdir(parents=True, exist_ok=True)
    translated_count = 0
    for filename in ("included.txt", "extracted.txt"):
        source_text = (SOURCE / filename).read_text(encoding="utf-8-sig")
        trailing_newline = source_text.endswith(("\n", "\r"))
        source_lines = source_text.splitlines()
        output: list[str] = []
        for index, line in enumerate(source_lines):
            if filename == "extracted.txt" and index == 0:
                output.append("WolffsRoom")
                continue
            if line in EXACT:
                output.append(EXACT[line])
                continue
            if DO_NOT_TRANSLATE.fullmatch(line) or not re.search(r"[A-Za-z]", line):
                output.append(line)
                continue
            if line not in cache:
                safe, tokens = protect(line)
                cache[line] = restore(translator.translate(safe), tokens)
                translated_count += 1
                if translated_count % 50 == 0:
                    CACHE_FILE.parent.mkdir(parents=True, exist_ok=True)
                    CACHE_FILE.write_text(
                        json.dumps(cache, ensure_ascii=False, indent=2), encoding="utf-8"
                    )
                    print(f"translated={translated_count} cache={len(cache)}", flush=True)
            output.append(cache[line])
        result = "\n".join(output) + ("\n" if trailing_newline else "")
        (TARGET / filename).write_text(result, encoding="utf-8", newline="\n")

    CACHE_FILE.parent.mkdir(parents=True, exist_ok=True)
    CACHE_FILE.write_text(json.dumps(cache, ensure_ascii=False, indent=2), encoding="utf-8")
    print(f"done translated_now={translated_count} cached={len(cache)}")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())