feat: visible language switcher (Welle-1 U1)

Add a discoverable "Sprache / Language" menu (Deutsch/English) to the
Tkinter GUI. The user test reported the DE/EN switch could not be found
even though translator.py + locales/translations.json existed but were
never wired into the UI.

- Menubar cascade with Deutsch/English radiobuttons; selection applies
  live to menu, buttons, shortcut hint and welcome text.
- Language persisted per-user in %APPDATA%/MethodenAnalyser/config.json
  (XDG fallback elsewhere), restored on next start.
- translations.json rebuilt with stable keys + full DE/EN strings.
- translator.py: isinstance-guard against corrupt entries.
- tests/test_language_switch.py: 8 headless regression tests
  (switching, persistence, restart, corrupt-config tolerance, guard).
- test_cli.py info-dialog version check updated for the i18n mechanism.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_014PYYrAKkuxD8Z4CkEP17nn

Author: Lukas Geiger

CHANGELOG.md

@@ -5,6 +5,9 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 
 ## [Unreleased]
 
+### Neue Funktionen / Features
+- **UX-002 / Welle-1 U1** (`MethodenAnalyser3.py`, `locales/translations.json`): Sichtbarer Sprachschalter in der Menüleiste („Sprache / Language" → „Deutsch" / „English"). Menü, Schaltflächen, Tastaturhinweis und Willkommenstext stellen sich sofort um; die Auswahl wird pro Benutzer in `%APPDATA%\MethodenAnalyser\config.json` (bzw. `~/.config/MethodenAnalyser/config.json`) persistiert und beim nächsten Start wiederhergestellt. Das bisher ungenutzte `translator.py` / `locales/translations.json` ist damit im UI erreichbar. Regressionstests in `tests/test_language_switch.py`.
+
 ### Build / Packaging
 - `build_exe.bat` ergänzt einen reproduzierbaren PyInstaller-Build mit lokalem Workpath (lokales Build-Verzeichnis), zentralem Build-Exclude-Scanner und Kopie der fertigen EXE nach `dist\MethodenAnalyser.exe` sowie `MethodenAnalyser.exe`.
 - `START.bat` startet unter Windows bevorzugt die gebaute EXE und fällt erst danach auf den Python-Start zurück.

MethodenAnalyser3.py

@@ -19,6 +19,11 @@
 from dataclasses import dataclass, field
 from functools import lru_cache
 
+try:
+    from translator import TranslationSystem
+except Exception:  # pragma: no cover - Uebersetzung ist optional
+    TranslationSystem = None
+
 # ============================================================================
 # KONSTANTEN
 # ============================================================================
@@ -43,6 +48,88 @@
 EXIT_FINDINGS = 2
 EXIT_PARTIAL_ERROR = 3
 
+# ============================================================================
+# SPRACHE / KONFIGURATION (Welle-1 U1: sichtbarer DE/EN-Sprachschalter)
+# ============================================================================
+
+SUPPORTED_LANGUAGES = ("de", "en")
+DEFAULT_LANGUAGE = "de"
+
+# Erste Zeile der Willkommensnachricht je Sprache (fuer Live-Neurendern beim Sprachwechsel)
+_WELCOME_HEADS = (
+    "Willkommen beim Python Code Analyzer!",
+    "Welcome to Python Code Analyzer!",
+)
+
+
+def _config_dir() -> pathlib.Path:
+    """Per-User-Konfigverzeichnis (auch bei read-only Store-Installation schreibbar)."""
+    if sys.platform.startswith("win"):
+        base = os.environ.get("APPDATA") or os.path.expanduser("~")
+    else:
+        base = os.environ.get("XDG_CONFIG_HOME") or os.path.join(
+            os.path.expanduser("~"), ".config"
+        )
+    return pathlib.Path(base) / "MethodenAnalyser"
+
+
+def _config_path() -> pathlib.Path:
+    return _config_dir() / "config.json"
+
+
+def load_app_config() -> Dict[str, Any]:
+    """Liest die persistente App-Konfiguration (leer bei Fehlen/Korruption)."""
+    try:
+        with open(_config_path(), "r", encoding="utf-8") as handle:
+            data = json.load(handle)
+        return data if isinstance(data, dict) else {}
+    except (OSError, ValueError):
+        return {}
+
+
+def save_app_config(config: Dict[str, Any]) -> bool:
+    """Speichert die App-Konfiguration; True bei Erfolg."""
+    try:
+        _config_dir().mkdir(parents=True, exist_ok=True)
+        with open(_config_path(), "w", encoding="utf-8") as handle:
+            json.dump(config, handle, indent=2, ensure_ascii=False)
+        return True
+    except OSError:
+        return False
+
+
+def get_saved_language() -> str:
+    """Gespeicherte Sprache oder Default, validiert gegen SUPPORTED_LANGUAGES."""
+    lang = load_app_config().get("language", DEFAULT_LANGUAGE)
+    return lang if lang in SUPPORTED_LANGUAGES else DEFAULT_LANGUAGE
+
+
+def set_saved_language(lang: str) -> bool:
+    """Persistiert die gewaehlte Sprache in der App-Konfiguration."""
+    if lang not in SUPPORTED_LANGUAGES:
+        return False
+    config = load_app_config()
+    config["language"] = lang
+    return save_app_config(config)
+
+
+_TRANSLATOR = None
+
+
+def get_translator():
+    """Lazy-Singleton des TranslationSystem, mit gespeicherter Sprache initialisiert."""
+    global _TRANSLATOR
+    if _TRANSLATOR is None and TranslationSystem is not None:
+        _TRANSLATOR = TranslationSystem(get_saved_language())
+    return _TRANSLATOR
+
+
+def _t(key: str) -> str:
+    """Uebersetzt key in die aktuelle Sprache (Fallback: key selbst)."""
+    translator = get_translator()
+    return translator.t(key) if translator is not None else key
+
+
 # Analyse Konfiguration
 SIMILARITY_THRESHOLD = 0.8
 
@@ -1537,6 +1624,11 @@ def progress_cb(cur, tot, fp):
         messagebox.showerror("Fehler", str(e))
 
 
+def _build_welcome_text() -> str:
+    """Baut die uebersetzte Willkommensnachricht inkl. eingesetztem Shortcut-Hinweis."""
+    return _t("welcome_body").replace("{shortcut}", _get_keyboard_shortcut_hint())
+
+
 def create_gui() -> None:
     """Erstellt und startet die GUI-Anwendung."""
     root = tk.Tk()
@@ -1555,20 +1647,13 @@ def create_gui() -> None:
     def show_info_dialog() -> None:
         messagebox.showinfo(
             "Python Code Analyzer",
-            f"Python Code Analyzer v{TOOL_VERSION}\n\n"
-            "Analysiert Python-Dateien auf:\n"
-            "• Fehlende Definitionen\n"
-            "• Ungenutzte Definitionen\n"
-            "• Ungenutzte Imports\n"
-            "• Dynamische Aufrufe\n"
-            "• Import-Scope-Probleme\n\n"
-            "© 2026 - Optimierte Version"
+            _t("info_body").replace("{version}", TOOL_VERSION),
         )
 
     # Analyse-Button
     btn = tk.Button(
         button_frame,
-        text="📂 Datei analysieren",
+        text=_t("btn_analyze_file"),
         command=lambda: run_analysis(output),
         bg="#4CAF50",
         fg="white",
@@ -1582,7 +1667,7 @@ def show_info_dialog() -> None:
     # Info-Button
     info_btn = tk.Button(
         button_frame,
-        text="ℹ️  Info",
+        text=_t("btn_info"),
         command=show_info_dialog,
         bg="#2196F3",
         fg="white",
@@ -1596,7 +1681,7 @@ def show_info_dialog() -> None:
     # Auto-Fix Button
     fix_btn = tk.Button(
         button_frame,
-        text="🔧 Auto-Fix Imports",
+        text=_t("btn_autofix"),
         command=lambda: auto_fix_unused_imports(output),
         bg="#FF9800",
         fg="white",
@@ -1610,7 +1695,7 @@ def show_info_dialog() -> None:
     # NEU: Projekt-Analyse Button
     project_btn = tk.Button(
         button_frame,
-        text="Projekt analysieren",
+        text=_t("btn_analyze_project"),
         command=lambda: run_project_analysis(output),
         bg="#9C27B0",
         fg="white",
@@ -1643,17 +1728,43 @@ def show_info_dialog() -> None:
     output.pack(fill=tk.BOTH, expand=True, padx=10, pady=(0, 10))
 
     # Willkommensnachricht
-    welcome_text = (
-        "Willkommen beim Python Code Analyzer!\n\n"
-        f"{_get_keyboard_shortcut_hint()}\n\n"
-        "Klicken Sie auf 'Datei analysieren', um eine Python-Datei zu untersuchen.\n\n"
-        "Die Analyse umfasst:\n"
-        "• Fehlende und ungenutzte Definitionen\n"
-        "• Import-Analyse und -Optimierung\n"
-        "• Dynamische Methodenaufrufe\n"
-        "• Mögliche Tippfehler\n"
+    output.insert(tk.END, _build_welcome_text())
+
+    # --- Menue "Sprache / Language" (Welle-1 U1: sichtbarer DE/EN-Schalter) ---
+    translator = get_translator()
+    current_lang = translator.get_language() if translator is not None else get_saved_language()
+    lang_var = tk.StringVar(value=current_lang)
+
+    def apply_language(lang: str) -> None:
+        """Wechselt Sprache, persistiert sie und stellt die Oberflaeche live um."""
+        if translator is not None:
+            translator.set_language(lang)
+        set_saved_language(lang)
+        lang_var.set(lang)
+        btn.config(text=_t("btn_analyze_file"))
+        info_btn.config(text=_t("btn_info"))
+        fix_btn.config(text=_t("btn_autofix"))
+        project_btn.config(text=_t("btn_analyze_project"))
+        shortcut_hint.config(text=_get_keyboard_shortcut_hint())
+        # Willkommenstext nur neu rendern, solange keine Analyse-Ausgabe angezeigt wird.
+        if output.get("1.0", "1.end").strip() in _WELCOME_HEADS:
+            output.delete("1.0", tk.END)
+            output.insert(tk.END, _build_welcome_text())
+        messagebox.showinfo("Sprache / Language", _t("lang_switched_msg"))
+
+    menubar = tk.Menu(root)
+    lang_menu = tk.Menu(menubar, tearoff=0)
+    lang_menu.add_radiobutton(
+        label="Deutsch", value="de", variable=lang_var,
+        command=lambda: apply_language("de"),
     )
-    output.insert(tk.END, welcome_text)
+    lang_menu.add_radiobutton(
+        label="English", value="en", variable=lang_var,
+        command=lambda: apply_language("en"),
+    )
+    menubar.add_cascade(label=_t("menu_language"), menu=lang_menu)
+    root.config(menu=menubar)
+
     _register_gui_shortcuts(
         root,
         analyze_file_cb=lambda: run_analysis(output),
@@ -1668,7 +1779,7 @@ def show_info_dialog() -> None:
 
 def _get_keyboard_shortcut_hint() -> str:
     """Liefert den sichtbaren Kurzhinweis für die Hauptaktionen der GUI."""
-    return "Tastatur: Alt+D Datei | Alt+P Projekt | Alt+F Auto-Fix | F1 Info"
+    return _t("shortcut_hint")
 
 
 def _register_gui_shortcuts(

locales/translations.json

@@ -1,10 +1,38 @@
 {
-  "📂 Datei analysieren": {
+  "btn_analyze_file": {
     "de": "📂 Datei analysieren",
     "en": "📂 Analyze File"
   },
-  "🔧 Auto-Fix Imports": {
+  "btn_info": {
+    "de": "ℹ️  Info",
+    "en": "ℹ️  Info"
+  },
+  "btn_autofix": {
     "de": "🔧 Auto-Fix Imports",
     "en": "🔧 Auto-Fix Imports"
+  },
+  "btn_analyze_project": {
+    "de": "Projekt analysieren",
+    "en": "Analyze Project"
+  },
+  "shortcut_hint": {
+    "de": "Tastatur: Alt+D Datei | Alt+P Projekt | Alt+F Auto-Fix | F1 Info",
+    "en": "Keyboard: Alt+D File | Alt+P Project | Alt+F Auto-Fix | F1 Info"
+  },
+  "menu_language": {
+    "de": "Sprache / Language",
+    "en": "Sprache / Language"
+  },
+  "welcome_body": {
+    "de": "Willkommen beim Python Code Analyzer!\n\n{shortcut}\n\nKlicken Sie auf 'Datei analysieren', um eine Python-Datei zu untersuchen.\n\nDie Analyse umfasst:\n• Fehlende und ungenutzte Definitionen\n• Import-Analyse und -Optimierung\n• Dynamische Methodenaufrufe\n• Mögliche Tippfehler\n",
+    "en": "Welcome to Python Code Analyzer!\n\n{shortcut}\n\nClick 'Analyze File' to inspect a Python file.\n\nThe analysis covers:\n• Missing and unused definitions\n• Import analysis and optimization\n• Dynamic method calls\n• Possible typos\n"
+  },
+  "info_body": {
+    "de": "Python Code Analyzer v{version}\n\nAnalysiert Python-Dateien auf:\n• Fehlende Definitionen\n• Ungenutzte Definitionen\n• Ungenutzte Imports\n• Dynamische Aufrufe\n• Import-Scope-Probleme\n\n© 2026 - Optimierte Version",
+    "en": "Python Code Analyzer v{version}\n\nAnalyzes Python files for:\n• Missing definitions\n• Unused definitions\n• Unused imports\n• Dynamic calls\n• Import scope issues\n\n© 2026 - Optimized version"
+  },
+  "lang_switched_msg": {
+    "de": "Sprache auf Deutsch umgestellt.",
+    "en": "Language switched to English."
   }
-}
+}

tests/test_cli.py

@@ -173,12 +173,12 @@ def test_missing_file_returns_analysis_error(self) -> None:
         self.assertIn("[FEHLER]", result.stderr)
 
     def test_info_dialog_version_matches_tool_version(self) -> None:
-        """TOOL_VERSION muss mit der Versionsangabe im Info-Dialog übereinstimmen."""
+        """Der Info-Dialog muss seine Versionsangabe aus TOOL_VERSION ableiten."""
         source = SCRIPT_PATH.read_text(encoding="utf-8")
         tree = ast.parse(source)
 
         tool_version = None
-        info_dialog_version = None
+        version_from_tool_version = False
 
         for node in ast.walk(tree):
             if isinstance(node, ast.Assign):
@@ -187,18 +187,43 @@ def test_info_dialog_version_matches_tool_version(self) -> None:
                         if isinstance(node.value, ast.Constant):
                             tool_version = node.value.value
 
-            # f-string: f"Python Code Analyzer v{TOOL_VERSION}\n\n"
+            # Variante A (f-string): f"Python Code Analyzer v{TOOL_VERSION}\n\n"
             if isinstance(node, ast.JoinedStr):
                 for part in node.values:
                     if isinstance(part, ast.FormattedValue):
                         if isinstance(part.value, ast.Name) and part.value.id == "TOOL_VERSION":
-                            info_dialog_version = "TOOL_VERSION_ref"
+                            version_from_tool_version = True
+
+            # Variante B (i18n): _t("info_body").replace("{version}", TOOL_VERSION)
+            if (
+                isinstance(node, ast.Call)
+                and isinstance(node.func, ast.Attribute)
+                and node.func.attr == "replace"
+                and any(
+                    isinstance(arg, ast.Name) and arg.id == "TOOL_VERSION"
+                    for arg in node.args
+                )
+            ):
+                version_from_tool_version = True
 
         self.assertIsNotNone(tool_version, "TOOL_VERSION nicht gefunden")
-        self.assertIsNotNone(
-            info_dialog_version,
-            "Info-Dialog referenziert TOOL_VERSION nicht als f-string — Versions-Mismatch möglich",
+        self.assertTrue(
+            version_from_tool_version,
+            "Info-Dialog leitet die Version nicht aus TOOL_VERSION ab — Versions-Mismatch möglich",
+        )
+
+        # i18n-Absicherung: die info_body-Uebersetzungen muessen den {version}-Platzhalter
+        # tragen, sonst liefe die TOOL_VERSION-Ersetzung ins Leere.
+        translations = json.loads(
+            (PROJECT_ROOT / "locales" / "translations.json").read_text(encoding="utf-8")
         )
+        info_body = translations.get("info_body", {})
+        for lang in ("de", "en"):
+            self.assertIn(
+                "{version}",
+                info_body.get(lang, ""),
+                f"info_body[{lang}] muss den Platzhalter {{version}} enthalten",
+            )
 
 
 class RegressionTests(unittest.TestCase):