utils/validate_translation.py

import argparse
import os
import yaml

from pathlib import Path

PATH_TO_COURSE = Path("chapters/")

def load_sections(language: str):
    toc = yaml.safe_load(
        open(os.path.join(PATH_TO_COURSE / language, "_toctree.yml"), "r")
    )
    sections = []
    for chapter in toc:
        for section in chapter["sections"]:
            sections.append(section["local"])
    return set(sorted(sections))


if __name__ == "__main__":
    parser = argparse.ArgumentParser()
    parser.add_argument("--language", type=str, help="Translation language to validate")
    args = parser.parse_args()

    english_sections = load_sections("en")
    translation_sections = load_sections(args.language)
    missing_sections = english_sections.difference(translation_sections)

    if len(missing_sections) > 0:
        print("Missing sections:")
        for section in missing_sections:
            print(section)
    else:
        print("✅ No missing sections - translation complete!")