language_manager.py

#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""
语言管理模块
处理多语言支持和资源管理
"""

import os
import sys
from typing import Dict, Any, Optional

# 导入语言资源
from src.utils.language_resources import LanguageManager, get_text, set_language


def setup_language(default_language: str = "zh") -> None:
    """设置全局语言"""
    set_language(default_language)


def get_localized_text(key: str, *args, **kwargs) -> str:
    """获取本地化文本"""
    return get_text(key, *args, **kwargs)


def create_language_manager(default_language: str = "zh") -> LanguageManager:
    """创建语言管理器实例"""
    return LanguageManager(default_language)


def get_available_languages() -> Dict[str, str]:
    """获取可用语言列表"""
    return {
        "zh": "中文 (Chinese)",
        "en": "English (英语)"
    }


def validate_language(language: str) -> bool:
    """验证语言代码是否有效"""
    available_languages = get_available_languages()
    return language in available_languages


def switch_language(language: str, language_manager: Optional[LanguageManager] = None) -> bool:
    """切换语言"""
    if not validate_language(language):
        return False
    
    set_language(language)
    
    if language_manager:
        language_manager.set_language(language)
    
    return True


def get_language_info(language: str) -> Dict[str, Any]:
    """获取语言信息"""
    available_languages = get_available_languages()
    
    if language not in available_languages:
        return {
            "code": language,
            "name": "Unknown",
            "available": False
        }
    
    return {
        "code": language,
        "name": available_languages[language],
        "available": True
    }


def format_language_display(language: str) -> str:
    """格式化语言显示"""
    info = get_language_info(language)
    if info["available"]:
        return f"{info['name']} ({info['code']})"
    else:
        return f"Unknown ({language})"


def get_language_config(config: Dict[str, Any]) -> Dict[str, Any]:
    """从配置中获取语言配置"""
    language_config = config.get("language", {})
    
    # 确保配置完整性
    default_language = language_config.get("default", "zh")
    available_languages = language_config.get("available", ["zh", "en"])
    auto_detect = language_config.get("auto_detect", True)
    
    # 验证默认语言是否在可用语言中
    if default_language not in available_languages:
        default_language = available_languages[0] if available_languages else "zh"
    
    return {
        "default": default_language,
        "available": available_languages,
        "auto_detect": auto_detect
    }


def detect_language_from_request(headers: Dict[str, str]) -> str:
    """从HTTP请求头检测语言"""
    accept_language = headers.get('Accept-Language', '')
    
    # 简单的语言检测逻辑
    if 'zh' in accept_language:
        return 'zh'
    elif 'en' in accept_language:
        return 'en'
    else:
        return 'zh'  # 默认中文


def get_language_aware_text(language_manager: LanguageManager, key: str, *args, **kwargs) -> str:
    """获取语言感知的文本（使用语言管理器）"""
    return language_manager.get_text(key, *args, **kwargs)


def create_language_aware_logger(logger, language_manager: LanguageManager):
    """创建语言感知的日志器"""
    class LanguageAwareLogger:
        def __init__(self, logger, language_manager):
            self.logger = logger
            self.language_manager = language_manager
        
        def debug(self, key, *args, **kwargs):
            message = self.language_manager.get_text(key, *args, **kwargs)
            self.logger.debug(message)
        
        def info(self, key, *args, **kwargs):
            message = self.language_manager.get_text(key, *args, **kwargs)
            self.logger.info(message)
        
        def warning(self, key, *args, **kwargs):
            message = self.language_manager.get_text(key, *args, **kwargs)
            self.logger.warning(message)
        
        def error(self, key, *args, **kwargs):
            message = self.language_manager.get_text(key, *args, **kwargs)
            self.logger.error(message)
        
        def critical(self, key, *args, **kwargs):
            message = self.language_manager.get_text(key, *args, **kwargs)
            self.logger.critical(message)
        
        # 传递其他方法
        def __getattr__(self, name):
            return getattr(self.logger, name)
    
    return LanguageAwareLogger(logger, language_manager)