Function translate_json

examples/json/translate_json.py:63–101

Translates given JSON input using DeepL Translator. Most of the arguments of the translate_text function are supported, source_lang, target_lang, glossary_id, formality, etc. :param json_input: JSON input to be translated. :param target_lang: language code to translate templat

(
    json_input: str,
    target_lang: str,
    translator: deepl.Translator,
    **kwargs,
)

def translate_json(
    json_input: str,
    target_lang: str,
    translator: deepl.Translator,
    **kwargs,
) -> str:
    """
    Translates given JSON input using DeepL Translator.

    Most of the arguments of the translate_text function are supported,
    source_lang, target_lang, glossary_id, formality, etc.

    :param json_input: JSON input to be translated.
    :param target_lang: language code to translate template into, for example
        "DE", "EN-US", "FR".
    :param translator: deepl.Translator to use for translation.
    :return: Translated JSON.
    """

    logger = logging.getLogger("deepl")
    obj = json.loads(json_input)
    # Wrap the JSON object in an array, in case the input is a string
    obj = [obj]

    # Find all text in the JSON that is to be translated
    translation_candidates: List[
        Tuple[str, Callable[[deepl.TextResult], None]]
    ] = []
    parse_json_for_translation(obj, translation_candidates)
    logger.info(
        f"Found {len(translation_candidates)} strings to be translated"
    )

    # Translate all texts
    batch_translate(translation_candidates, target_lang, translator, **kwargs)
    logger.info("Translation complete")

    # Unwrap the dummy array and convert to JSON
    return json.dumps(obj[0])