frontengine 1.0.60__tar.gz → 1.0.62__tar.gz

{frontengine-1.0.60 → frontengine-1.0.62}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.60
+Version: 1.0.62
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.60 → frontengine-1.0.62}/frontengine/ui/main_ui.py

@@ -43,10 +43,12 @@ from frontengine.ui.page.web.web_setting_ui import WEBSettingUI
 from frontengine.ui.page.widgets.widgets_setting_ui import WidgetsSettingUI
 from frontengine.user_setting.user_setting_file import (
     get_hotkey_bindings,
+    is_stored,
     read_user_setting,
     user_setting_dict,
     write_user_setting,
 )
+from frontengine.utils.steam.steam_language import steam_language
 from frontengine.utils.critical_exit.critical_exit import CriticalExit
 from frontengine.utils.critical_exit.win32_vk import keyboard_keys_table
 from frontengine.utils.hotkey.hotkey_service import HotkeyService
@@ -129,7 +131,7 @@ class FrontEngineMainUI(QMainWindow):
         # 語言支援
         # Language support
         self.language_wrapper = language_wrapper
-        self.language_wrapper.reset_language(user_setting_dict.get("language", "English"))
+        self.language_wrapper.reset_language(self._startup_language())
 
         # 初始化 UI
         # Initialize UI
@@ -381,6 +383,24 @@ class FrontEngineMainUI(QMainWindow):
             self.control_center_ui.register_overlay_source(
                 lambda attribute=attribute: getattr(self.tools_setting_ui, attribute, []))
 
+    @staticmethod
+    def _startup_language() -> str:
+        """
+        啟動要用哪一個語言。使用者挑過就用他挑的；還沒挑過而 Steam 有裝，就跟著
+        Steam 客戶端的語言，並寫回設定——寫回之後這件事就只會發生這一次。
+        Which language to start in. The user's choice if they have made one;
+        otherwise the Steam client's language when Steam is installed, written
+        back to the settings so it happens exactly once.
+        """
+        if is_stored("language"):
+            return user_setting_dict.get("language", "English")
+        from_steam = steam_language()
+        if from_steam is None:
+            return user_setting_dict.get("language", "English")
+        front_engine_logger.info(f"[FrontEngineMainUI] first launch, following Steam: {from_steam}")
+        user_setting_dict["language"] = from_steam
+        return from_steam
+
     def _add_tabs(self) -> None:
         """
         建立左側導覽與頁面堆疊 / Build the sidebar and the page stack.

{frontengine-1.0.60 → frontengine-1.0.62}/frontengine/user_setting/user_setting_file.py

@@ -116,6 +116,26 @@ def read_user_setting() -> Path:
     return repo.path
 
 
+def is_stored(key: str) -> bool:
+    """
+    這個鍵是不是真的寫在設定檔裡（而不是這裡的預設值）。
+
+    載入是把檔案 merge 到預設值上，所以載入之後 `user_setting_dict` 分不出兩者。
+    「使用者從沒挑過語言」和「使用者挑了英文」要做的事不一樣，得問檔案本身。
+
+    Whether `key` is actually in the settings file rather than a default here.
+
+    Loading merges the file over the defaults, so afterwards `user_setting_dict`
+    cannot tell the two apart. "The user never chose a language" and "the user
+    chose English" call for different behaviour, so this asks the file itself.
+    """
+    repo = _repository()
+    if not repo.exists():
+        return False
+    data = repo.load()
+    return isinstance(data, dict) and key in data
+
+
 def export_user_setting(destination: Path) -> Path:
     """將目前所有設定寫出到指定路徑 / Write all current settings to `destination`."""
     destination = Path(destination)

frontengine-1.0.62/frontengine/utils/steam/steam_language.py

@@ -0,0 +1,118 @@
+"""
+第一次啟動時，跟著 Steam 客戶端的語言走。
+
+在 Steam 上安裝的人已經挑過一次語言了，再讓程式用英文開起來、要他自己去選單裡
+再挑一次，是白費工。這裡只讀 Steam 客戶端目前設定的語言，**不需要 Steamworks
+SDK、不需要 App ID、也不會連線**——Windows 讀登錄檔，其他平台讀 Steam 自己的
+``registry.vdf``。
+
+只在使用者還沒挑過語言時套用（設定檔裡沒有 ``language`` 這個鍵）。挑過之後就以
+使用者的選擇為準，否則選單改了語言、下次開啟又被改回去，看起來就像選單壞了。
+
+Follow the Steam client's language on first launch.
+
+Someone who installed through Steam has already chosen a language once; opening
+in English and asking them to choose again in a menu is wasted work. This reads
+the language the Steam client is set to and nothing else: **no Steamworks SDK,
+no App ID, no network**. Windows reads the registry, other platforms read
+Steam's own ``registry.vdf``.
+
+It applies only while the user has not chosen a language yet - no ``language``
+key in the settings file. After that their choice wins, otherwise changing the
+language in the menu would be undone on the next launch and the menu would look
+broken.
+"""
+from __future__ import annotations
+
+import re
+import sys
+from pathlib import Path
+from typing import Optional
+
+from frontengine.utils.logging.loggin_instance import front_engine_logger
+
+# Steam 的語言代碼 -> 這個程式註冊的語言名稱。
+# 只列本程式真的有翻譯的七種；Steam 支援的其他語言會落到 None，也就是維持預設。
+# Steam's language codes to the names this application registers. Only the seven
+# that are actually translated appear here; any other Steam language falls
+# through to None, which leaves the default in place.
+STEAM_LANGUAGE_MAP = {
+    "english": "English",
+    "tchinese": "Traditional_Chinese",
+    "schinese": "Simplified_Chinese",
+    "german": "Deutsch",
+    "russian": "Russian",
+    "french": "France",
+    "italian": "Italy",
+}
+
+_VDF_LANGUAGE = re.compile(r'"Language"\s+"([^"]+)"', re.IGNORECASE)
+
+
+def _windows_language_code() -> Optional[str]:
+    """從登錄檔讀 Steam 客戶端語言（只讀，不寫）。"""
+    if sys.platform != "win32":
+        return None
+    try:
+        import winreg
+
+        with winreg.OpenKey(winreg.HKEY_CURRENT_USER, r"SOFTWARE\Valve\Steam") as key:
+            value, _ = winreg.QueryValueEx(key, "Language")
+        return str(value).strip().lower() or None
+    except OSError:
+        # Steam 沒裝、或這台機器上沒有這個值 / Steam absent, or no such value here.
+        return None
+
+
+def _registry_vdf_paths() -> list[Path]:
+    """macOS 與 Linux 上 Steam 存 registry.vdf 的位置。"""
+    home = Path.home()
+    if sys.platform == "darwin":
+        return [home / "Library" / "Application Support" / "Steam" / "registry.vdf"]
+    return [
+        home / ".steam" / "registry.vdf",
+        home / ".steam" / "steam" / "registry.vdf",
+        home / ".local" / "share" / "Steam" / "registry.vdf",
+    ]
+
+
+def _vdf_language_code(paths=None) -> Optional[str]:
+    """
+    從 registry.vdf 撈出語言。這裡不寫 VDF 解析器：需要的只有一個字串，
+    多寫一個格式解析器就多一份要維護、會出錯的東西。
+    Pull the language out of registry.vdf. No VDF parser here: one string is all
+    this needs, and a format parser would be one more thing to maintain and get
+    wrong.
+    """
+    for path in (paths if paths is not None else _registry_vdf_paths()):
+        try:
+            if not Path(path).is_file():
+                continue
+            text = Path(path).read_text(encoding="utf-8", errors="replace")
+        except OSError:
+            continue
+        match = _VDF_LANGUAGE.search(text)
+        if match:
+            return match.group(1).strip().lower() or None
+    return None
+
+
+def steam_language_code() -> Optional[str]:
+    """Steam 客戶端目前的語言代碼，讀不到就回傳 None。"""
+    return _windows_language_code() or _vdf_language_code()
+
+
+def steam_language() -> Optional[str]:
+    """
+    對應到本程式的語言名稱；Steam 沒裝、讀不到、或那個語言沒有翻譯時回傳 None。
+    The matching language name for this application, or None when Steam is not
+    installed, could not be read, or is set to a language with no translation.
+    """
+    code = steam_language_code()
+    if not code:
+        return None
+    name = STEAM_LANGUAGE_MAP.get(code)
+    if name is None:
+        front_engine_logger.info(
+            f"[SteamLanguage] Steam is set to '{code}', which has no translation here")
+    return name

{frontengine-1.0.60 → frontengine-1.0.62}/frontengine.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: frontengine
-Version: 1.0.60
+Version: 1.0.62
 Summary: FrontEngine is use-define frontview or only use like screen saver
 Author-email: JE-Chen <jechenmailman@gmail.com>
 Project-URL: Homepage, https://github.com/Intergration-Automation-Testing/FrontEngine

{frontengine-1.0.60 → frontengine-1.0.62}/frontengine.egg-info/SOURCES.txt

@@ -232,6 +232,8 @@ frontengine/utils/signage/signage_service.py
 frontengine/utils/smart_pause/__init__.py
 frontengine/utils/smart_pause/pause_rules.py
 frontengine/utils/smart_pause/smart_pause_service.py
+frontengine/utils/steam/__init__.py
+frontengine/utils/steam/steam_language.py
 frontengine/utils/system_stats/__init__.py
 frontengine/utils/system_stats/system_stats.py
 frontengine/utils/text_source/__init__.py

{frontengine-1.0.60 → frontengine-1.0.62}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "frontengine"
-version = "1.0.60"
+version = "1.0.62"
 authors = [
     { name = "JE-Chen", email = "jechenmailman@gmail.com" },
 ]