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

je_editor/pyside_ui/main_ui/menu/run_menu/under_run_menu/build_program_menu.py

@@ -1,33 +1,63 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
 from __future__ import annotations
 
+# 僅用於型別檢查，避免循環匯入
+# For type checking only (avoids circular imports)
 from typing import TYPE_CHECKING
 
+# 匯入 Qt 動作
+# Import QAction
 from PySide6.QtGui import QAction
 
+# 匯入程式執行管理器 (ExecManager)
+# Import ExecManager for running code
 from je_editor.pyside_ui.code.code_process.code_exec import ExecManager
+# 匯入檔案儲存對話框
+# Import file save dialog
 from je_editor.pyside_ui.dialog.file_dialog.save_file_dialog import choose_file_get_save_file_path
+# 匯入編輯器元件
+# Import EditorWidget
 from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
+# 匯入輸入處理 (用於程式輸入)
+# Import ProcessInput for handling program input
 from je_editor.pyside_ui.main_ui.editor.process_input import ProcessInput
+# 匯入工具函式：顯示「請先關閉目前執行中的程式」訊息框
+# Import utility: show message box if a program is already running
 from je_editor.pyside_ui.main_ui.menu.run_menu.under_run_menu.utils import please_close_current_running_messagebox
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
+# 匯入多語言包裝器
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 
+# 設定「執行程式」選單
+# Set up the "Run Program" menu
 def set_program_menu(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_program_menu.py set_program_menu ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在 Run 選單下建立 Program 子選單
+    # Create Program submenu under Run menu
     ui_we_want_to_set.run_program_menu = ui_we_want_to_set.run_menu.addMenu(
         language_wrapper.language_word_dict.get("run_menu_run_program_label"))
-    # Run program
+
+    # 建立「執行程式」動作
+    # Add "Run Program" action
     ui_we_want_to_set.run_program_menu.run_program_action = QAction(
         language_wrapper.language_word_dict.get("run_menu_run_program_label"))
     ui_we_want_to_set.run_program_menu.run_program_action.triggered.connect(
         lambda: run_program(ui_we_want_to_set)
     )
     ui_we_want_to_set.run_program_menu.addAction(ui_we_want_to_set.run_program_menu.run_program_action)
-    # Show shell input
+
+    # 建立「顯示程式輸入」動作
+    # Add "Show Program Input" action
     ui_we_want_to_set.run_program_menu.show_shell_input = QAction(
         language_wrapper.language_word_dict.get("show_program_input"))
     ui_we_want_to_set.run_program_menu.show_shell_input.triggered.connect(
@@ -36,23 +66,33 @@ def set_program_menu(ui_we_want_to_set: EditorMain) -> None:
     ui_we_want_to_set.run_program_menu.addAction(ui_we_want_to_set.run_program_menu.show_shell_input)
 
 
+# 執行程式
+# Run program
 def run_program(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_program_menu.py run_program ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
+        # 確保沒有正在執行的程式
+        # Ensure no program is already running
         if widget.exec_program is None:
             widget.python_compiler = ui_we_want_to_set.python_compiler
+            # 要求使用者選擇儲存檔案路徑
+            # Ask user to choose save file path
             if choose_file_get_save_file_path(ui_we_want_to_set):
+                # 建立程式執行管理器並執行程式
+                # Create ExecManager and run program
                 code_exec = ExecManager(widget, program_encoding=ui_we_want_to_set.encoding)
                 code_exec.later_init()
-                code_exec.exec_code(
-                    widget.current_file
-                )
+                code_exec.exec_code(widget.current_file)
                 widget.exec_program = code_exec
         else:
+            # 如果已有程式在執行，顯示提示訊息
+            # If a program is already running, show message
             please_close_current_running_messagebox(ui_we_want_to_set)
 
 
+# 顯示程式輸入介面
+# Show program input interface
 def show_program_input(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_program_menu.py show_program_input ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()

je_editor/pyside_ui/main_ui/menu/run_menu/under_run_menu/build_shell_menu.py

@@ -1,32 +1,60 @@
+# 匯入未來功能，允許延遲型別註解 (Python 3.7+ 常用)
+# Import future feature: postponed evaluation of type annotations
 from __future__ import annotations
 
+# 僅用於型別檢查，避免循環匯入
+# For type checking only (avoids circular imports)
 from typing import TYPE_CHECKING
 
+# 匯入編輯器元件與輸入處理
+# Import EditorWidget and ProcessInput
 from je_editor.pyside_ui.main_ui.editor.editor_widget import EditorWidget
 from je_editor.pyside_ui.main_ui.editor.process_input import ProcessInput
+# 匯入工具函式：顯示「請先關閉目前執行中的程式」訊息框
+# Import utility: show message box if a program is already running
 from je_editor.pyside_ui.main_ui.menu.run_menu.under_run_menu.utils import please_close_current_running_messagebox
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+
+# 匯入 Qt 動作
+# Import QAction
 from PySide6.QtGui import QAction
 
+# 匯入 ShellManager，用於執行系統命令
+# Import ShellManager for executing shell commands
 from je_editor.pyside_ui.code.shell_process.shell_exec import ShellManager
+
+# 匯入多語言包裝器
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
 
+# 設定 Shell 選單
+# Set up the Shell menu
 def set_shell_menu(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py set_shell_menu ui_we_want_to_set: {ui_we_want_to_set}")
+    # 在 Run 選單下建立 Shell 子選單
+    # Create Shell submenu under Run menu
     ui_we_want_to_set.run_shell_menu = ui_we_want_to_set.run_menu.addMenu(
         language_wrapper.language_word_dict.get("run_menu_run_on_shell_label"))
-    # Run on shell
+
+    # 建立「在 Shell 執行」動作
+    # Add "Run on Shell" action
     ui_we_want_to_set.run_shell_menu.run_on_shell_action = QAction(
         language_wrapper.language_word_dict.get("run_menu_run_on_shell_label"))
     ui_we_want_to_set.run_shell_menu.run_on_shell_action.triggered.connect(
         lambda: shell_exec(ui_we_want_to_set)
     )
     ui_we_want_to_set.run_shell_menu.addAction(ui_we_want_to_set.run_shell_menu.run_on_shell_action)
-    # Show shell input
+
+    # 建立「顯示 Shell 輸入」動作
+    # Add "Show Shell Input" action
     ui_we_want_to_set.run_shell_menu.show_shell_input = QAction(
         language_wrapper.language_word_dict.get("show_shell_input"))
     ui_we_want_to_set.run_shell_menu.show_shell_input.triggered.connect(
@@ -35,23 +63,33 @@ def set_shell_menu(ui_we_want_to_set: EditorMain) -> None:
     ui_we_want_to_set.run_shell_menu.addAction(ui_we_want_to_set.run_shell_menu.show_shell_input)
 
 
+# 在 Shell 中執行程式碼
+# Execute code in Shell
 def shell_exec(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py shell_exec ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()
     if isinstance(widget, EditorWidget):
+        # 確保沒有正在執行的 Shell 程式
+        # Ensure no shell process is already running
         if widget.exec_shell is None:
+            # 建立 ShellManager 並執行當前編輯器中的程式碼
+            # Create ShellManager and execute current editor code
             shell_command = ShellManager(
                 main_window=widget,
                 shell_encoding=ui_we_want_to_set.encoding)
             shell_command.later_init()
             shell_command.exec_shell(
-                widget.code_edit.toPlainText()
+                widget.code_edit.toPlainText()  # 直接執行編輯器中的文字
             )
             widget.exec_shell = shell_command
         else:
+            # 如果已有 Shell 在執行，顯示提示訊息
+            # If a shell process is already running, show message
             please_close_current_running_messagebox(ui_we_want_to_set)
 
 
+# 顯示 Shell 輸入介面
+# Show Shell input interface
 def show_shell_input(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_shell_menu.py show_shell_input ui_we_want_to_set: {ui_we_want_to_set}")
     widget = ui_we_want_to_set.tab_widget.currentWidget()

je_editor/pyside_ui/main_ui/menu/run_menu/under_run_menu/utils.py

@@ -2,19 +2,40 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+# 匯入 Qt 訊息框
+# Import QMessageBox for showing message dialogs
 from PySide6.QtWidgets import QMessageBox
 
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
+# 匯入多語言包裝器，用於多語言顯示
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
+# 僅在型別檢查時匯入 EditorMain，避免循環依賴
+# Import EditorMain only for type checking (avoids circular dependency)
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
 
+# 顯示「請先關閉目前執行中的程式」訊息框
+# Show a message box: "Please stop the currently running program first"
 def please_close_current_running_messagebox(ui_we_want_to_set: EditorMain):
+    # 紀錄日誌，方便除錯
+    # Log info for debugging
     jeditor_logger.info(f"utils.py please_close_current_running_messagebox ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 建立訊息框，父視窗為主編輯器
+    # Create a message box with the main editor as parent
     please_stop_current_running_program_messagebox = QMessageBox(ui_we_want_to_set)
+
+    # 設定訊息框文字，從多語言字典取得對應語言的提示
+    # Set message text, retrieved from multi-language dictionary
     please_stop_current_running_program_messagebox.setText(
         language_wrapper.language_word_dict.get("please_stop_current_running_program")
     )
+
+    # 顯示訊息框
+    # Show the message box
     please_stop_current_running_program_messagebox.show()

je_editor/pyside_ui/main_ui/menu/set_menu_bar.py

@@ -2,6 +2,8 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+# 匯入各種子選單的建構函式
+# Import functions to build different sub-menus
 from je_editor.pyside_ui.main_ui.menu.dock_menu.build_dock_menu import set_dock_menu
 from je_editor.pyside_ui.main_ui.menu.language_menu.build_language_server import set_language_menu
 from je_editor.pyside_ui.main_ui.menu.style_menu.build_style_menu import set_style_menu
@@ -9,10 +11,22 @@ from je_editor.pyside_ui.main_ui.menu.tab_menu.build_tab_menu import set_tab_men
 from je_editor.pyside_ui.main_ui.menu.text_menu.build_text_menu import set_text_menu
 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
+
 if TYPE_CHECKING:
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking
+
 from PySide6.QtWidgets import QMenuBar
+# 匯入 QMenuBar，用於建立選單列
+# Import QMenuBar to create the menu bar
 
+# 其他子選單建構函式
+# Other sub-menu builders
 from je_editor.pyside_ui.main_ui.menu.check_style_menu.build_check_style_menu import set_check_menu
 from je_editor.pyside_ui.main_ui.menu.file_menu.build_file_menu import set_file_menu
 from je_editor.pyside_ui.main_ui.menu.help_menu.build_help_menu import set_help_menu
@@ -21,17 +35,29 @@ from je_editor.pyside_ui.main_ui.menu.python_env_menu.build_venv_menu import set
 
 
 def set_menu_bar(ui_we_want_to_set: EditorMain) -> None:
+    """
+    建立主選單列，並依序加入各種子選單
+    Build the main menu bar and add all sub-menus in order
+    """
     jeditor_logger.info(f"set_menu_bar.py set_menu_bar ui_we_want_to_set: {ui_we_want_to_set}")
-    # set menu
+
+    # 建立一個新的選單列
+    # Create a new menu bar
     ui_we_want_to_set.menu = QMenuBar()
-    set_file_menu(ui_we_want_to_set)
-    set_run_menu(ui_we_want_to_set)
-    set_text_menu(ui_we_want_to_set)
-    set_check_menu(ui_we_want_to_set)
-    set_help_menu(ui_we_want_to_set)
-    set_venv_menu(ui_we_want_to_set)
-    set_tab_menu(ui_we_want_to_set)
-    set_dock_menu(ui_we_want_to_set)
-    set_style_menu(ui_we_want_to_set)
-    set_language_menu(ui_we_want_to_set)
+
+    # === 加入各種子選單 ===
+    # === Add different sub-menus ===
+    set_file_menu(ui_we_want_to_set)  # 檔案選單 / File menu
+    set_run_menu(ui_we_want_to_set)  # 執行選單 / Run menu
+    set_text_menu(ui_we_want_to_set)  # 文字設定選單 / Text menu
+    set_check_menu(ui_we_want_to_set)  # 程式碼檢查選單 / Code style check menu
+    set_help_menu(ui_we_want_to_set)  # 幫助選單 / Help menu
+    set_venv_menu(ui_we_want_to_set)  # Python 虛擬環境選單 / Python venv menu
+    set_tab_menu(ui_we_want_to_set)  # 分頁選單 / Tab menu
+    set_dock_menu(ui_we_want_to_set)  # Dock 視窗選單 / Dock menu
+    set_style_menu(ui_we_want_to_set)  # 介面樣式選單 / Style menu
+    set_language_menu(ui_we_want_to_set)  # 語言選單 / Language menu
+
+    # 將選單列設定到主視窗
+    # Attach the menu bar to the main editor window
     ui_we_want_to_set.setMenuBar(ui_we_want_to_set.menu)

je_editor/pyside_ui/main_ui/menu/style_menu/build_style_menu.py

@@ -2,36 +2,72 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING
 
+# 匯入 Qt 動作
+# Import QAction
 from PySide6.QtGui import QAction
 
+# 匯入使用者設定字典，用來保存 UI 樣式設定
+# Import user settings dictionary for saving UI style preferences
 from je_editor.pyside_ui.main_ui.save_settings.user_setting_file import user_setting_dict
+# 匯入日誌紀錄器
+# Import logger instance
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 
 if TYPE_CHECKING:
+    # 僅在型別檢查時匯入 EditorMain，避免循環依賴
+    # Import EditorMain only for type checking (avoids circular dependency)
     from je_editor.pyside_ui.main_ui.main_editor import EditorMain
 
+# 匯入多語言包裝器，用於 UI 多語言顯示
+# Import multi-language wrapper for UI localization
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
 
+# 設定 Style 選單
+# Set up the Style menu
 def set_style_menu(ui_we_want_to_set: EditorMain) -> None:
     jeditor_logger.info(f"build_style_menu.py set_style_menu ui_we_want_to_set: {ui_we_want_to_set}")
+
+    # 在主選單中新增「Style」子選單
+    # Add "Style" submenu under the main menu
     ui_we_want_to_set.menu.style_menu = ui_we_want_to_set.menu.addMenu(
         language_wrapper.language_word_dict.get("style_menu_label")
     )
-    for style in ['dark_amber.xml', 'dark_blue.xml', 'dark_cyan.xml', 'dark_lightgreen.xml',
-                  'dark_pink.xml', 'dark_purple.xml', 'dark_red.xml', 'dark_teal.xml',
-                  'dark_yellow.xml', 'light_amber.xml', 'light_blue.xml', 'light_cyan.xml',
-                  'light_cyan_500.xml', 'light_lightgreen.xml', 'light_pink.xml', 'light_purple.xml'
-                  ]:
+
+    # 預設提供的樣式清單 (深色/淺色不同配色)
+    # Predefined style list (dark/light themes with different colors)
+    for style in [
+        'dark_amber.xml', 'dark_blue.xml', 'dark_cyan.xml', 'dark_lightgreen.xml',
+        'dark_pink.xml', 'dark_purple.xml', 'dark_red.xml', 'dark_teal.xml',
+        'dark_yellow.xml', 'light_amber.xml', 'light_blue.xml', 'light_cyan.xml',
+        'light_cyan_500.xml', 'light_lightgreen.xml', 'light_pink.xml', 'light_purple.xml'
+    ]:
+        # 建立一個 QAction，名稱為樣式檔名
+        # Create an QAction with the style filename as label
         change_style_action = QAction(style, parent=ui_we_want_to_set.menu.style_menu)
+
+        # 綁定觸發事件，呼叫 set_style 來套用樣式
+        # Connect action to set_style function
         change_style_action.triggered.connect(
-            lambda checked=False, action=change_style_action: set_style(ui_we_want_to_set, action))
+            lambda checked=False, action=change_style_action: set_style(ui_we_want_to_set, action)
+        )
+
+        # 將動作加入 Style 選單
+        # Add action to the Style menu
         ui_we_want_to_set.menu.style_menu.addAction(change_style_action)
 
 
+# 套用選擇的樣式
+# Apply the selected style
 def set_style(ui_we_want_to_set: EditorMain, action: QAction) -> None:
     jeditor_logger.info("build_style_menu.py set_style "
                         f"ui_we_want_to_set: {ui_we_want_to_set} "
                         f"action: {action}")
+
+    # 呼叫主視窗的 apply_stylesheet 方法，套用選擇的樣式
+    # Call main window's apply_stylesheet method to apply the chosen style
     ui_we_want_to_set.apply_stylesheet(ui_we_want_to_set, action.text())
+
+    # 更新使用者設定，保存目前選擇的樣式
+    # Update user settings dictionary to persist the chosen style
     user_setting_dict.update({"ui_style": action.text()})