mcp-feedback-enhanced/tests/integration/test_i18n_integration.py

#!/usr/bin/env python3
"""
I18N 集成測試
"""

import asyncio
import os

import pytest

from tests.fixtures.test_data import TestData


class TestI18NWebIntegration:
    """I18N 與 Web UI 集成測試"""

    @pytest.mark.asyncio
    async def test_i18n_in_web_templates(
        self, web_ui_manager, i18n_manager, test_project_dir
    ):
        """測試 Web 模板中的 I18N 功能"""
        # 創建會話
        web_ui_manager.create_session(
            str(test_project_dir), TestData.SAMPLE_SESSION["summary"]
        )

        # 啟動服務器
        web_ui_manager.start_server()
        await asyncio.sleep(3)

        import aiohttp

        base_url = f"http://{web_ui_manager.host}:{web_ui_manager.port}"

        # 測試不同語言的頁面渲染
        for lang in TestData.SUPPORTED_LANGUAGES:
            i18n_manager.set_language(lang)

            async with aiohttp.ClientSession() as session:
                # 測試主頁
                async with session.get(f"{base_url}/") as response:
                    assert response.status == 200
                    text = await response.text()

                    # 頁面應該包含當前語言的內容
                    assert len(text) > 0

                    # 檢查是否包含基本的 UI 元素
                    # 這些元素應該根據語言進行本地化
                    assert "MCP Feedback" in text

    def test_i18n_api_endpoints(self, web_ui_manager, i18n_manager):
        """測試 I18N API 端點"""
        import asyncio

        # 啟動服務器
        web_ui_manager.start_server()

        async def test_api():
            await asyncio.sleep(3)

            # 測試語言切換 API（如果存在）
            for lang in TestData.SUPPORTED_LANGUAGES:
                # 這裡可以測試語言切換 API
                # 例如 POST /api/set-language
                pass

        asyncio.run(test_api())


class TestI18NMCPIntegration:
    """I18N 與 MCP 集成測試"""

    def test_i18n_in_mcp_responses(self, i18n_manager):
        """測試 MCP 回應中的 I18N"""
        # 測試不同語言下的錯誤消息
        for lang in TestData.SUPPORTED_LANGUAGES:
            i18n_manager.set_language(lang)

            # 測試常見錯誤消息的本地化
            error_keys = ["error.connection", "error.timeout", "error.invalid_input"]

            for key in error_keys:
                message = i18n_manager.t(key)
                assert isinstance(message, str)
                assert len(message) > 0

                # 不同語言的消息應該不同（除非回退到同一語言）
                if lang != i18n_manager._fallback_language:
                    # 簡化測試，只檢查翻譯是否存在
                    if message != key:  # 如果不是回退到 key 本身
                        # 這裡可以進一步驗證翻譯的差異
                        pass


class TestI18NFileSystemIntegration:
    """I18N 文件系統集成測試"""

    def test_translation_files_exist(self):
        """測試翻譯文件存在"""
        # 獲取 I18N 文件目錄
        from mcp_feedback_enhanced.i18n import I18nManager

        manager = I18nManager()
        locales_dir = manager._locales_dir

        assert locales_dir.exists(), f"翻譯目錄不存在: {locales_dir}"

        # 檢查每種支援語言的翻譯文件（使用正確的路徑結構）
        for lang in TestData.SUPPORTED_LANGUAGES:
            lang_dir = locales_dir / lang
            lang_file = lang_dir / "translation.json"
            assert lang_file.exists(), f"翻譯文件不存在: {lang_file}"

            # 檢查文件內容
            import json

            try:
                with open(lang_file, encoding="utf-8") as f:
                    translations = json.load(f)
                assert isinstance(translations, dict)
                assert len(translations) > 0
            except json.JSONDecodeError as e:
                pytest.fail(f"翻譯文件 {lang_file} JSON 格式錯誤: {e}")
            except Exception as e:
                pytest.fail(f"讀取翻譯文件 {lang_file} 失敗: {e}")

    def test_translation_file_encoding(self):
        """測試翻譯文件編碼"""
        from mcp_feedback_enhanced.i18n import I18nManager

        manager = I18nManager()
        locales_dir = manager._locales_dir

        for lang in TestData.SUPPORTED_LANGUAGES:
            lang_dir = locales_dir / lang
            lang_file = lang_dir / "translation.json"

            if lang_file.exists():
                # 測試 UTF-8 編碼
                try:
                    with open(lang_file, encoding="utf-8") as f:
                        content = f.read()
                    assert len(content) > 0
                except UnicodeDecodeError:
                    pytest.fail(f"翻譯文件 {lang_file} 不是有效的 UTF-8 編碼")


class TestI18NEnvironmentIntegration:
    """I18N 環境集成測試"""

    def test_language_detection_in_different_environments(self):
        """測試不同環境下的語言檢測"""
        from mcp_feedback_enhanced.i18n import I18nManager

        # 保存原始環境變數
        original_env = {}
        env_vars = ["LANG", "LANGUAGE", "LC_ALL", "LC_MESSAGES"]
        for var in env_vars:
            original_env[var] = os.environ.get(var)

        try:
            # 測試不同的環境設置
            test_cases = [
                {"MCP_LANGUAGE": "zh-TW", "expected": "zh-TW"},
                {"MCP_LANGUAGE": "zh-CN", "expected": "zh-CN"},
                {"MCP_LANGUAGE": "en", "expected": "en"},
                {"LANG": "zh_TW.UTF-8", "expected": "zh-TW"},
                {"LANG": "zh_CN.UTF-8", "expected": "zh-CN"},
                {"LANG": "en_US.UTF-8", "expected": "en"},
                {"LANG": "ja_JP.UTF-8", "expected": "en"},  # 不支援的語言應回退
            ]

            for test_case in test_cases:
                # 清理環境變數
                for var in env_vars:
                    os.environ.pop(var, None)
                # 也清理 MCP_LANGUAGE
                os.environ.pop("MCP_LANGUAGE", None)

                # 設置測試模式，禁用系統語言檢測
                os.environ["MCP_TEST_MODE"] = "true"

                # 設置測試環境
                for key, value in test_case.items():
                    if key != "expected":
                        os.environ[key] = value

                # 創建新的管理器實例，並清理可能的保存設定
                import tempfile
                from pathlib import Path

                with tempfile.TemporaryDirectory() as temp_dir:
                    # 臨時修改配置文件路徑，避免使用真實的用戶配置
                    manager = I18nManager()
                    manager._config_file = Path(temp_dir) / "test_language.json"

                    # 修復 attr-defined 錯誤 - 使用正確的方法名
                    detected = manager._detect_language()

                    # 驗證檢測結果
                    expected = test_case["expected"]
                    assert detected == expected, (
                        f"環境 {test_case} 檢測到 {detected}，預期 {expected}"
                    )

        finally:
            # 恢復原始環境變數
            # 修復 assignment 和 unreachable 錯誤 - 明確處理類型
            for var in original_env:
                original_value: str | None = original_env.get(var)
                if original_value is not None:
                    os.environ[var] = original_value
                elif var in os.environ:
                    # 如果原始值為 None，且變數存在於環境中，則移除
                    os.environ.pop(var, None)

    def test_i18n_with_web_ui_manager(self, web_ui_manager, i18n_manager):
        """測試 I18N 與 WebUIManager 的集成"""
        # 驗證 WebUIManager 使用了 I18N 管理器
        assert hasattr(web_ui_manager, "i18n")
        assert web_ui_manager.i18n is not None

        # 測試語言切換對 WebUIManager 的影響
        original_lang = i18n_manager.get_current_language()

        for lang in TestData.SUPPORTED_LANGUAGES:
            if lang != original_lang:
                success = i18n_manager.set_language(lang)
                assert success == True

                # WebUIManager 應該能夠訪問當前語言設置
                current_lang = web_ui_manager.i18n.get_current_language()
                assert current_lang == lang
                break

        # 恢復原始語言
        i18n_manager.set_language(original_lang)