je-editor 0.0.104__py3-none-any.whl → 0.0.228__py3-none-any.whl

je_editor/pyside_ui/main_ui/menu/text_menu/build_text_menu.py

@@ -0,0 +1,135 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from PySide6.QtGui import QAction
+
+from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
+from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 啟用未來註解功能，允許型別提示使用字串前向參照
+# Enable future annotations, allowing forward references in type hints
+# TYPE_CHECKING 用於避免在執行時載入不必要的模組
+# TYPE_CHECKING prevents unnecessary imports at runtime
+# 匯入 QAction，用於建立選單動作
+# Import QAction for creating menu actions
+# 匯入編輯器元件
+# Import the Editor widget
+# 匯入使用者設定字典，用於儲存字型與字體大小
+# Import user setting dictionary to save font and size
+
+# 匯入日誌工具
+# Import logger
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+# 匯入多語言包裝器，用於多語系 UI
+# Import language wrapper for multilingual UI
+
+
+def set_text_menu(ui_we_want_to_set: EditorMain):
+    """
+    建立文字選單，包含字型與字體大小的子選單
+    Create the text menu, including font and font size submenus
+    """
+    jeditor_logger.info(f"build_text_menu.py set_text_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立 Text Menu
+    # Create Text Menu
+    ui_we_want_to_set.text_menu = ui_we_want_to_set.menu.addMenu(
+        language_wrapper.language_word_dict.get("text_menu_label"))
+
+    # === 字型選單 (Font Menu) ===
+    # === Font Menu ===
+    ui_we_want_to_set.text_menu.font_menu = ui_we_want_to_set.text_menu.addMenu(
+        language_wrapper.language_word_dict.get("text_menu_label_font"))
+
+    # 將系統支援的字型加入選單
+    # Add available system fonts into the menu
+    for family in ui_we_want_to_set.font_database.families():
+        font_action = QAction(family, parent=ui_we_want_to_set.text_menu.font_menu)
+        font_action.triggered.connect(
+            lambda checked=False, action=font_action: set_font(ui_we_want_to_set, action))
+        ui_we_want_to_set.text_menu.font_menu.addAction(font_action)
+
+    # === 字體大小選單 (Font Size Menu) ===
+    # === Font Size Menu ===
+    ui_we_want_to_set.text_menu.font_size_menu = ui_we_want_to_set.text_menu.addMenu(
+        language_wrapper.language_word_dict.get("text_menu_label_font_size"))
+
+    # 提供 12 ~ 36 pt 的字體大小選項 (每次增加 2)
+    # Provide font sizes from 12 to 36 pt (step = 2)
+    for size in range(12, 38, 2):
+        font_action = QAction(str(size), parent=ui_we_want_to_set.text_menu.font_size_menu)
+        font_action.triggered.connect(
+            lambda checked=False, action=font_action: set_font_size(ui_we_want_to_set, action))
+        ui_we_want_to_set.text_menu.font_size_menu.addAction(font_action)
+
+
+def set_font(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    """
+    設定編輯器的字型
+    Set the font family for the editor
+    """
+    jeditor_logger.info("build_text_menu.py set_font "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"action: {action}")
+
+    # 遍歷所有分頁，找到 EditorWidget 並套用字型
+    # Iterate through all tabs, apply font to EditorWidget
+    for code_editor in range(ui_we_want_to_set.tab_widget.count()):
+        widget = ui_we_want_to_set.tab_widget.widget(code_editor)
+        if isinstance(widget, EditorWidget):
+            # 設定程式碼編輯區字型
+            # Set font for code editor
+            widget.code_edit.setStyleSheet(
+                f"font-size: {widget.code_edit.font().pointSize()}pt;"
+                f"font-family: {action.text()};"
+            )
+            # 設定輸出結果區字型
+            # Set font for result display
+            widget.code_result.setStyleSheet(
+                f"font-size: {widget.code_result.font().pointSize()}pt;"
+                f"font-family: {action.text()};"
+            )
+            # 更新使用者設定
+            # Update user settings
+            user_setting_dict.update({"font": action.text()})
+
+
+def set_font_size(ui_we_want_to_set: EditorMain, action: QAction) -> None:
+    """
+    設定編輯器的字體大小
+    Set the font size for the editor
+    """
+    jeditor_logger.info("build_text_menu.py set_font_size "
+                        f"ui_we_want_to_set: {ui_we_want_to_set} "
+                        f"action: {action}")
+
+    # 遍歷所有分頁，找到 EditorWidget 並套用字體大小
+    # Iterate through all tabs, apply font size to EditorWidget
+    for code_editor in range(ui_we_want_to_set.tab_widget.count()):
+        widget = ui_we_want_to_set.tab_widget.widget(code_editor)
+        if type(widget) is EditorWidget:
+            # 設定程式碼編輯區字體大小
+            # Set font size for code editor
+            widget.code_edit.setStyleSheet(
+                f"font-size: {int(action.text())}pt;"
+                f"font-family: {widget.code_edit.font().family()};"
+            )
+            # 設定輸出結果區字體大小
+            # Set font size for result display
+            widget.code_result.setStyleSheet(
+                f"font-size: {int(action.text())}pt;"
+                f"font-family: {widget.code_result.font().family()};"
+            )
+            # 更新使用者設定
+            # Update user settings
+            user_setting_dict.update({"font_size": int(action.text())})

je_editor/pyside_ui/main_ui/save_settings/setting_utils.py

@@ -0,0 +1,33 @@
+from os import getcwd
+from pathlib import Path
+
+from je_editor.utils.json.json_file import write_json
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+
+def write_setting(save_dict: dict, file_name: str) -> None:
+    """
+    將設定資料寫入 JSON 檔案
+    Write settings dictionary into a JSON file
+    """
+    # 紀錄日誌，方便除錯與追蹤
+    # Log the action for debugging and tracking
+    jeditor_logger.info("setting_utils.py write_setting "
+                        f"save_dict: {save_dict} "
+                        f"file_name: {file_name}")
+
+    # 建立儲存設定的資料夾路徑：當前工作目錄下的 `.jeditor`
+    # Create the save directory path: `.jeditor` under current working directory
+    save_dir = Path(getcwd() + "/.jeditor")
+
+    # 如果資料夾不存在就自動建立 (parents=True 表示可遞迴建立多層資料夾)
+    # Create the directory if it does not exist (parents=True allows nested dirs)
+    save_dir.mkdir(parents=True, exist_ok=True)
+
+    # 建立完整的檔案路徑，例如 `.jeditor/settings.json`
+    # Create the full file path, e.g., `.jeditor/settings.json`
+    save_file = Path(getcwd() + f"/.jeditor/{file_name}")
+
+    # 將設定字典寫入 JSON 檔案
+    # Write the dictionary into the JSON file
+    write_json(str(save_file), save_dict)

je_editor/pyside_ui/main_ui/save_settings/user_color_setting_file.py

@@ -0,0 +1,103 @@
+from os import getcwd
+from pathlib import Path
+from typing import Dict
+
+from PySide6.QtGui import QColor
+
+from je_editor.pyside_ui.main_ui.save_settings.setting_utils import write_setting
+from je_editor.utils.json.json_file import read_json
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+
+def update_actually_color_dict():
+    """
+    更新實際使用的顏色字典 (actually_color_dict)，
+    將 user_setting_color_dict 中的 RGB 值轉換成 QColor 物件。
+    Update the actual color dictionary (actually_color_dict),
+    converting RGB values from user_setting_color_dict into QColor objects.
+    """
+    jeditor_logger.info(f"user_color_setting_file.py update_actually_color_dict")
+
+    actually_color_dict.update(
+        {
+            # 行號顏色 / Line number color
+            "line_number_color": QColor(
+                user_setting_color_dict.get("line_number_color")[0],
+                user_setting_color_dict.get("line_number_color")[1],
+                user_setting_color_dict.get("line_number_color")[2],
+            ),
+            # 行號背景顏色 / Line number background color
+            "line_number_background_color": QColor(
+                user_setting_color_dict.get("line_number_background_color")[0],
+                user_setting_color_dict.get("line_number_background_color")[1],
+                user_setting_color_dict.get("line_number_background_color")[2],
+            ),
+            # 當前行顏色 / Current line highlight color
+            "current_line_color": QColor(
+                user_setting_color_dict.get("current_line_color")[0],
+                user_setting_color_dict.get("current_line_color")[1],
+                user_setting_color_dict.get("current_line_color")[2],
+            ),
+            # 一般輸出顏色 / Normal output color
+            "normal_output_color": QColor(
+                user_setting_color_dict.get("normal_output_color")[0],
+                user_setting_color_dict.get("normal_output_color")[1],
+                user_setting_color_dict.get("normal_output_color")[2],
+            ),
+            # 錯誤輸出顏色 / Error output color
+            "error_output_color": QColor(
+                user_setting_color_dict.get("error_output_color")[0],
+                user_setting_color_dict.get("error_output_color")[1],
+                user_setting_color_dict.get("error_output_color")[2],
+            ),
+            # 警告輸出顏色 / Warning output color
+            "warning_output_color": QColor(
+                user_setting_color_dict.get("warning_output_color")[0],
+                user_setting_color_dict.get("warning_output_color")[1],
+                user_setting_color_dict.get("warning_output_color")[2],
+            )
+        }
+    )
+
+
+# 使用者設定的顏色字典 (以 RGB list 表示)
+# User-defined color dictionary (stored as RGB lists)
+user_setting_color_dict: Dict[str, list] = {
+    "line_number_color": [255, 255, 255],
+    "line_number_background_color": [179, 179, 179],
+    "current_line_color": [148, 148, 184],
+    "normal_output_color": [255, 255, 255],
+    "error_output_color": [255, 0, 0],
+    "warning_output_color": [204, 204, 0]
+}
+
+# 實際使用的顏色字典 (以 QColor 表示)
+# Actual color dictionary (stored as QColor objects)
+actually_color_dict: Dict[str, QColor] = {}
+
+# 初始化時先更新一次
+# Update once at initialization
+update_actually_color_dict()
+
+
+def write_user_color_setting() -> None:
+    """
+    將使用者顏色設定寫入 JSON 檔案
+    Write user color settings into a JSON file
+    """
+    jeditor_logger.info("user_color_setting_file.py write_user_color_setting")
+    write_setting(user_setting_color_dict, "user_color_setting.json")
+
+
+def read_user_color_setting() -> None:
+    """
+    從 JSON 檔案讀取使用者顏色設定，並更新 user_setting_color_dict
+    Read user color settings from JSON file and update user_setting_color_dict
+    """
+    jeditor_logger.info("user_color_setting_file.py read_user_color_setting")
+    user_color_setting_file = Path(getcwd() + "/.jeditor/user_color_setting.json")
+
+    # 如果檔案存在，就讀取並更新設定
+    # If the file exists, read and update the settings
+    if user_color_setting_file.exists() and user_color_setting_file.is_file():
+        user_setting_color_dict.update(read_json(str(user_color_setting_file)))

je_editor/pyside_ui/main_ui/save_settings/user_setting_file.py

@@ -0,0 +1,58 @@
+from os import getcwd
+from pathlib import Path
+
+from je_editor.pyside_ui.main_ui.save_settings.setting_utils import write_setting
+from je_editor.utils.json.json_file import read_json
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 匯入通用的設定寫入工具
+# Import utility function to write settings
+# 匯入 JSON 讀取工具
+# Import JSON reader utility
+
+# 匯入日誌工具
+# Import logger
+
+
+# 使用者設定字典，包含 UI 與編輯器的偏好
+# User settings dictionary, storing UI and editor preferences
+user_setting_dict = {
+    "ui_font": "Lato",  # UI 字型 / UI font
+    "ui_font_size": 12,  # UI 字體大小 / UI font size
+    "language": "English",  # 語言設定 / Language setting
+    "ui_style": "dark_amber.xml",  # UI 樣式檔 / UI style file
+    "font": "Lato",  # 編輯器字型 / Editor font
+    "font_size": 12,  # 編輯器字體大小 / Editor font size
+    "encoding": "utf-8",  # 檔案編碼 / File encoding
+    "last_file": None,  # 上次開啟的檔案 / Last opened file
+    "python_compiler": None,  # Python 編譯器路徑 / Python compiler path
+    "max_line_of_output": 200000,  # 最大輸出行數限制 / Max lines of output
+}
+
+
+def write_user_setting() -> None:
+    """
+    將使用者設定寫入 JSON 檔案
+    Write user settings into a JSON file
+    """
+    jeditor_logger.info("user_setting_file.py write_user_setting")
+    # 呼叫通用工具，將 user_setting_dict 寫入 `.jeditor/user_setting.json`
+    # Use utility to write user_setting_dict into `.jeditor/user_setting.json`
+    write_setting(user_setting_dict, "user_setting.json")
+
+
+def read_user_setting() -> None:
+    """
+    從 JSON 檔案讀取使用者設定，並更新 user_setting_dict
+    Read user settings from JSON file and update user_setting_dict
+    """
+    jeditor_logger.info("user_setting_file.py read_user_setting")
+
+    # 設定檔路徑：當前工作目錄下的 `.jeditor/user_setting.json`
+    # File path: `.jeditor/user_setting.json` under current working directory
+    user_setting_file = Path(getcwd() + "/.jeditor/user_setting.json")
+
+    # 如果檔案存在，就讀取並更新設定字典
+    # If the file exists, read and update the settings dictionary
+    if user_setting_file.exists() and user_setting_file.is_file():
+        user_setting_dict.update(read_json(str(user_setting_file)))

je_editor/pyside_ui/main_ui/system_tray/extend_system_tray.py

@@ -0,0 +1,90 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+# 啟用未來註解功能，允許型別提示使用字串前向參照
+# Enable future annotations, allowing forward references in type hints
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
+import sys
+
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QSystemTrayIcon, QMenu
+from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
+
+
+class ExtendSystemTray(QSystemTrayIcon):
+    """
+    擴充系統匣功能，提供隱藏、最大化、還原、關閉等操作
+    Extend system tray functionality with hide, maximize, restore, and close actions
+    """
+
+    def __init__(self, main_window: EditorMain):
+        # 初始化並記錄日誌
+        # Initialize and log
+        jeditor_logger.info(f"Init ExtendSystemTray main_window: {main_window}")
+        super().__init__(parent=main_window)
+
+        # 建立右鍵選單
+        # Create context menu
+        self.menu = QMenu()
+        self.main_window = main_window
+
+        # === 隱藏主視窗 / Hide main window ===
+        self.hide_main_window_action = QAction(
+            language_wrapper.language_word_dict.get("system_tray_hide"))
+        self.hide_main_window_action.triggered.connect(self.main_window.hide)
+        self.menu.addAction(self.hide_main_window_action)
+
+        # === 最大化主視窗 / Maximize main window ===
+        self.maximized_main_window_action = QAction(
+            language_wrapper.language_word_dict.get("system_tray_maximized"))
+        self.maximized_main_window_action.triggered.connect(self.main_window.showMaximized)
+        self.menu.addAction(self.maximized_main_window_action)
+
+        # === 還原主視窗 / Restore main window ===
+        self.normal_main_window_action = QAction(
+            language_wrapper.language_word_dict.get("system_tray_normal"))
+        self.normal_main_window_action.triggered.connect(self.main_window.showNormal)
+        self.menu.addAction(self.normal_main_window_action)
+
+        # === 關閉應用程式 / Close application ===
+        self.close_main_window_action = QAction(
+            language_wrapper.language_word_dict.get("system_tray_close"))
+        self.close_main_window_action.triggered.connect(self.close_all)
+        self.menu.addAction(self.close_main_window_action)
+
+        # 設定選單到系統匣圖示
+        # Attach menu to system tray icon
+        self.setContextMenu(self.menu)
+
+        # 綁定點擊事件 (例如雙擊)
+        # Connect click events (e.g., double-click)
+        self.activated.connect(self.clicked)
+
+    def close_all(self):
+        """
+        關閉應用程式：隱藏圖示、關閉主視窗並結束程式
+        Close the application: hide tray icon, close main window, and exit program
+        """
+        jeditor_logger.info("ExtendSystemTray close_all")
+        self.setVisible(False)
+        self.main_window.close()
+        sys.exit(0)
+
+    def clicked(self, reason):
+        """
+        處理系統匣點擊事件
+        Handle system tray click events
+        """
+        if reason == self.ActivationReason.DoubleClick:
+            # 如果是雙擊，最大化主視窗
+            # If double-click, maximize the main window
+            jeditor_logger.info("ExtendSystemTray DoubleClick")
+            self.main_window.showMaximized()

je_editor/start_editor.py

@@ -1,18 +1,42 @@
 import sys
 
+from PySide6.QtCore import QCoreApplication
 from PySide6.QtWidgets import QApplication
 from qt_material import apply_stylesheet
 
-from je_editor.pyside_ui.main_ui.editor_main_ui.main_editor import EditorMain
+from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 
-def start_editor(**kwargs):
-    new_editor = QApplication(sys.argv)
-    window = EditorMain()
+def start_editor(debug_mode: bool = False) -> None:
+    """
+    功能說明 (Function Description):
+    啟動編輯器主程式，建立 QApplication 實例，套用主題，並顯示主視窗。
+    Start the main editor application, create QApplication instance, apply theme, and show main window.
+
+    :param debug_mode: 是否啟用除錯模式 / whether to enable debug mode
+    """
+
+    # 嘗試取得現有的 QCoreApplication 實例
+    # Try to get an existing QCoreApplication instance
+    new_editor = QCoreApplication.instance()
+
+    # 如果沒有現有實例，建立新的 QApplication
+    # If no instance exists, create a new QApplication
+    if new_editor is None:
+        new_editor = QApplication(sys.argv)
+
+    # 建立主視窗，傳入 debug_mode
+    # Create the main editor window, passing debug_mode
+    window = EditorMain(debug_mode)
+
+    # 套用 qt-material 主題 (dark amber)
+    # Apply qt-material theme (dark amber)
     apply_stylesheet(new_editor, theme='dark_amber.xml')
+
+    # 最大化顯示主視窗
+    # Show the main window maximized
     window.showMaximized()
-    try:
-        window.startup_setting()
-    except Exception as error:
-        print(repr(error))
+
+    # 啟動事件迴圈，並在結束時退出程式
+    # Start the event loop and exit the program when it ends
     sys.exit(new_editor.exec())