je-editor 0.0.221__py3-none-any.whl → 0.0.223__py3-none-any.whl

je_editor/pyside_ui/browser/browser_widget.py

@@ -1,60 +1,90 @@
-from PySide6.QtGui import QAction, Qt
-from PySide6.QtWidgets import QWidget, QGridLayout, QPushButton, QInputDialog
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from je_editor.pyside_ui.browser.main_browser_widget import MainBrowserWidget
+
+from PySide6.QtCore import Qt
+from PySide6.QtGui import QAction
+from PySide6.QtWidgets import QWidget, QPushButton, QGridLayout, QInputDialog
 
 from je_editor.pyside_ui.browser.browser_serach_lineedit import BrowserLineSearch
-from je_editor.pyside_ui.browser.browser_view import BrowserView
 from je_editor.utils.logging.loggin_instance import jeditor_logger
 from je_editor.utils.multi_language.multi_language_wrapper import language_wrapper
 
+from je_editor.pyside_ui.browser.browser_view import BrowserView
 
-class BrowserWidget(QWidget):
 
+class BrowserWidget(QWidget):
     def __init__(self, start_url: str = "https://www.google.com/",
-                 search_prefix: str = "https://www.google.com.tw/search?q="):
+                 search_prefix: str = "https://www.google.com.tw/search?q=",
+                 main_widget: MainBrowserWidget = None, browser_view: BrowserView = None):
+        # --- Browser setting / 瀏覽器設定 ---
         super().__init__()
-        jeditor_logger.info("Init BrowserWidget "
-                            f"start_url: {start_url} "
-                            f"search_prefix: {search_prefix}")
-        # Browser setting
-        self.browser = BrowserView(start_url)
-        self.search_prefix = search_prefix
+        self.main_widget = main_widget
+        if browser_view:
+            self.browser = browser_view
+        else:
+            self.browser = BrowserView(start_url, main_widget=main_widget)  # 內嵌的瀏覽器視圖
+        self.search_prefix = search_prefix  # 搜尋引擎前綴字串
         self.setAttribute(Qt.WidgetAttribute.WA_DeleteOnClose)
-        # Top bar
+
+        # --- Top bar buttons / 上方工具列按鈕 ---
         self.back_button = QPushButton(language_wrapper.language_word_dict.get("browser_back_button"))
-        self.back_button.clicked.connect(self.browser.back)
+        self.back_button.clicked.connect(self.browser.back)  # 返回上一頁
+
         self.forward_button = QPushButton(language_wrapper.language_word_dict.get("browser_forward_button"))
-        self.forward_button.clicked.connect(self.browser.forward)
+        self.forward_button.clicked.connect(self.browser.forward)  # 前往下一頁
+
         self.reload_button = QPushButton(language_wrapper.language_word_dict.get("browser_reload_button"))
-        self.reload_button.clicked.connect(self.browser.reload)
+        self.reload_button.clicked.connect(self.browser.reload)  # 重新整理
+
         self.search_button = QPushButton(language_wrapper.language_word_dict.get("browser_search_button"))
-        self.search_button.clicked.connect(self.search)
+        self.search_button.clicked.connect(self.search)  # 搜尋按鈕
+
+        # URL / Search input line (custom QLineEdit)
         self.url_input = BrowserLineSearch(self)
-        # Action
+
+        # --- Action: Ctrl+F to find text / 快捷鍵 Ctrl+F 搜尋文字 ---
         self.find_action = QAction()
         self.find_action.setShortcut("Ctrl+f")
         self.find_action.triggered.connect(self.find_text)
         self.addAction(self.find_action)
-        # Layout
+
+        # --- Layout / 版面配置 ---
         self.grid_layout = QGridLayout()
         self.grid_layout.addWidget(self.back_button, 0, 0)
         self.grid_layout.addWidget(self.forward_button, 0, 1)
         self.grid_layout.addWidget(self.reload_button, 0, 2)
         self.grid_layout.addWidget(self.url_input, 0, 3)
         self.grid_layout.addWidget(self.search_button, 0, 4)
-        self.grid_layout.addWidget(self.browser, 1, 0, -1, -1)
+        self.grid_layout.addWidget(self.browser, 1, 0, -1, -1)  # 瀏覽器視圖佔滿下方
         self.setLayout(self.grid_layout)
 
     def search(self):
+        """
+        Perform a search using the text in the input line.
+        使用輸入框的文字進行搜尋，將字串附加到 search_prefix 後送出。
+        """
         jeditor_logger.info("BrowserWidget Search")
         self.browser.setUrl(f"{self.search_prefix}{self.url_input.text()}")
 
     def find_text(self):
+        """
+        Open a dialog to find text in the current page.
+        開啟輸入對話框，在當前頁面中搜尋文字。
+        - 如果按下 OK，搜尋輸入的文字
+        - 如果取消，清除搜尋
+        """
         jeditor_logger.info("BrowserWidget Find Text")
         search_box = QInputDialog(self)
         search_text, press_ok = search_box.getText(
-            self, language_wrapper.language_word_dict.get("browser_find_text"),
-            language_wrapper.language_word_dict.get("browser_find_text_input"))
+            self,
+            language_wrapper.language_word_dict.get("browser_find_text"),
+            language_wrapper.language_word_dict.get("browser_find_text_input")
+        )
         if press_ok:
             self.browser.findText(search_text)
         else:
-            self.browser.findText("")
+            self.browser.findText("")

je_editor/pyside_ui/browser/main_browser_widget.py

@@ -0,0 +1,72 @@
+from PySide6.QtWidgets import QWidget, QGridLayout, QTabWidget, QTabBar
+
+from je_editor.pyside_ui.browser.browser_widget import BrowserWidget
+from je_editor.utils.logging.loggin_instance import jeditor_logger
+
+
+class MainBrowserWidget(QWidget):
+    """
+    瀏覽器元件：包含分頁，並在最右方固定一個「+」分頁。
+    """
+
+    def __init__(self, start_url: str = "https://www.google.com/",
+                 search_prefix: str = "https://www.google.com.tw/search?q="):
+        super().__init__()
+        jeditor_logger.info("Init BrowserWidget "
+                            f"start_url: {start_url} "
+                            f"search_prefix: {search_prefix}")
+
+        grid_layout = QGridLayout()
+
+        self.browser_tab = QTabWidget()
+        self.browser_tab.setTabsClosable(True)
+        self.browser_tab.tabCloseRequested.connect(self.close_tab)
+
+        self.search_prefix = search_prefix
+
+        # 預設第一個分頁
+        self.add_browser_tab(BrowserWidget(start_url=start_url,
+                                           search_prefix=search_prefix),
+                             "Google")
+
+        # 固定一個「+」分頁
+        self.add_plus_tab()
+
+        grid_layout.addWidget(self.browser_tab)
+        self.setLayout(grid_layout)
+
+    def add_browser_tab(self, browser_widget: BrowserWidget, title: str = "New Tab"):
+        # 在「+」分頁前插入新分頁
+        plus_index = self.browser_tab.count() - 1
+        index = self.browser_tab.insertTab(plus_index, browser_widget, title)
+        self.browser_tab.setCurrentIndex(index)
+
+        # 更新分頁標題
+        browser_widget.browser.titleChanged.connect(
+            lambda t, i=index: self.browser_tab.setTabText(i, t)
+        )
+
+    def add_plus_tab(self):
+        """新增一個固定的「+」分頁"""
+        add_new_page_widget = QWidget()
+        self.browser_tab.addTab(add_new_page_widget, "+")
+        # 禁止關閉「+」分頁
+        self.browser_tab.tabBar().setTabButton(self.browser_tab.count() - 1,
+                                               QTabBar.ButtonPosition.RightSide, None)
+        self.browser_tab.tabBar().tabBarClicked.connect(self.handle_tab_changed)
+
+    def handle_tab_changed(self, index: int):
+        """如果點到「+」分頁，就開新分頁"""
+        if self.browser_tab.tabText(index) == "+": # 最後一個是「+」
+                # 建立新分頁（會自動切換到新分頁）
+                self.add_browser_tab(
+                    BrowserWidget(start_url="https://www.google.com/",
+                                  search_prefix=self.search_prefix),
+                    "Google"
+                )
+
+    def close_tab(self, index: int):
+        """關閉指定分頁，但保留「+」"""
+        widget = self.browser_tab.widget(index)
+        self.browser_tab.removeTab(index)
+        widget.deleteLater()

je_editor/pyside_ui/git_ui/code_diff_compare/code_diff_viewer_widget.py

@@ -0,0 +1,90 @@
+from PySide6.QtGui import QAction, QActionGroup
+from PySide6.QtWidgets import (
+    QWidget, QVBoxLayout, QMenuBar, QFileDialog, QMessageBox
+)
+from git import Repo
+
+from je_editor.pyside_ui.git_ui.code_diff_compare.multi_file_diff_viewer import MultiFileDiffViewer
+
+
+class DiffViewerWidget(QWidget):
+    """
+    Git Diff Viewer Application
+    Git 差異檢視器應用程式
+    """
+
+    def __init__(self):
+        super().__init__()
+        self.setWindowTitle("Git Diff Viewer")
+
+        # === Main diff viewer widget / 主要的差異檢視元件 ===
+        self.viewer = MultiFileDiffViewer()
+
+        # === Menu bar / 選單列 ===
+        self.menubar = QMenuBar(self)
+        file_menu = self.menubar.addMenu("File")  # File 選單
+        view_menu = self.menubar.addMenu("View")  # View 選單
+
+        # --- File → Open Git Repo ---
+        # Action to open a Git repository
+        # 開啟 Git 專案的動作
+        open_repo_action = QAction("Open Git Repo", self)
+        open_repo_action.triggered.connect(self.open_repo)
+        file_menu.addAction(open_repo_action)
+
+        # === View → Theme switching (exclusive) / 主題切換（單選模式） ===
+        theme_group = QActionGroup(self)
+        theme_group.setExclusive(True)  # 確保只能選擇一個主題
+
+        dark_action = QAction("Dark Mode", self, checkable=True)  # 深色模式
+        light_action = QAction("Light Mode", self, checkable=True)  # 淺色模式
+
+        theme_group.addAction(dark_action)
+        theme_group.addAction(light_action)
+
+        # Default to dark mode / 預設為深色模式
+        dark_action.setChecked(True)
+        self.viewer.set_dark_theme()
+
+        # Connect theme actions / 綁定主題切換事件
+        dark_action.triggered.connect(lambda: self.set_theme("dark"))
+        light_action.triggered.connect(lambda: self.set_theme("light"))
+
+        view_menu.addAction(dark_action)
+        view_menu.addAction(light_action)
+
+        # === Layout / 版面配置 ===
+        layout = QVBoxLayout(self)
+        layout.setMenuBar(self.menubar)  # 把選單列放在上方
+        layout.addWidget(self.viewer)  # 把差異檢視器放在主要區域
+
+    def open_repo(self):
+        """
+        Open a Git repository and display its diff.
+        開啟一個 Git 專案並顯示差異。
+        """
+        path = QFileDialog.getExistingDirectory(self, "Select Git Repository")
+        if not path:
+            return
+        try:
+            repo = Repo(path)  # 嘗試載入 Git 專案
+            diff_text = repo.git.diff()  # 取得差異文字
+            if not diff_text.strip():
+                # 如果沒有差異，顯示提示訊息
+                QMessageBox.information(self, "Info", "No changes in repo.")
+            else:
+                # 如果有差異，顯示在 viewer 中
+                self.viewer.set_diff_text(diff_text)
+        except Exception as e:
+            # 如果開啟失敗，顯示錯誤訊息
+            QMessageBox.critical(self, "Error", f"Failed to open repo:\n{e}")
+
+    def set_theme(self, mode: str):
+        """
+        Switch between dark and light themes.
+        切換深色與淺色主題。
+        """
+        if mode == "dark":
+            self.viewer.set_dark_theme()
+        else:
+            self.viewer.set_light_theme()

je_editor/pyside_ui/git_ui/code_diff_compare/line_number_code_viewer.py

@@ -0,0 +1,141 @@
+from PySide6.QtCore import QRect, QSize, Qt
+from PySide6.QtGui import QPainter, QColor
+from PySide6.QtWidgets import QPlainTextEdit, QWidget, QTextEdit
+
+
+class LineNumberArea(QWidget):
+    """
+    Side widget for displaying line numbers.
+    用來顯示行號的側邊元件。
+    """
+
+    def __init__(self, editor):
+        super().__init__(editor)
+        self.code_editor = editor  # 綁定主要的編輯器 / Bind to main editor
+
+    def sizeHint(self):
+        """
+        Suggest width for line number area.
+        建議行號區域的寬度。
+        """
+        return QSize(self.code_editor.line_number_area_width(), 0)
+
+    def paintEvent(self, event):
+        """
+        Delegate paint event to the main editor.
+        將繪製事件交給主要編輯器處理。
+        """
+        self.code_editor.line_number_area_paint_event(event)
+
+
+class LineNumberedCodeViewer(QPlainTextEdit):
+    """
+    QPlainTextEdit with line numbers.
+    帶有行號顯示的文字編輯器。
+    """
+
+    def __init__(self, parent=None):
+        super().__init__(parent)
+        self.lineNumberArea = LineNumberArea(self)
+
+        # === 信號連接 / Signal connections ===
+        self.blockCountChanged.connect(self.update_line_number_area_width)  # 當行數改變時更新行號區寬度
+        self.updateRequest.connect(self.update_line_number_area)  # 當需要重繪時更新行號區
+        self.cursorPositionChanged.connect(self.highlight_current_line)  # 當游標移動時高亮當前行
+
+        # 初始化行號區寬度與高亮
+        self.update_line_number_area_width(0)
+        self.highlight_current_line()
+
+    def line_number_area_width(self):
+        """
+        Calculate width of line number area based on digit count.
+        根據行數位數計算行號區寬度。
+        """
+        digits = len(str(max(1, self.blockCount())))
+        space = 3 + self.fontMetrics().horizontalAdvance('9') * digits
+        return space
+
+    def update_line_number_area_width(self, _):
+        """
+        Adjust viewport margins to fit line number area.
+        調整視口邊界以容納行號區。
+        """
+        self.setViewportMargins(self.line_number_area_width(), 0, 0, 0)
+
+    def update_line_number_area(self, rect, dy):
+        """
+        Update/redraw line number area when scrolling or editing.
+        當滾動或編輯時更新行號區。
+        """
+        if dy:
+            self.lineNumberArea.scroll(0, dy)
+        else:
+            self.lineNumberArea.update(0, rect.y(), self.lineNumberArea.width(), rect.height())
+        if rect.contains(self.viewport().rect()):
+            self.update_line_number_area_width(0)
+
+    def resizeEvent(self, event):
+        """
+        Resize line number area when editor resizes.
+        編輯器大小改變時調整行號區。
+        """
+        super().resizeEvent(event)
+        cr = self.contentsRect()
+        self.lineNumberArea.setGeometry(QRect(cr.left(), cr.top(), self.line_number_area_width(), cr.height()))
+
+    def line_number_area_paint_event(self, event):
+        """
+        Paint line numbers.
+        繪製行號。
+        """
+        painter = QPainter(self.lineNumberArea)
+        # 背景顏色依主題切換 / Background color depends on theme
+        painter.fillRect(event.rect(), QColor(40, 40, 40) if getattr(self, "is_dark", False) else QColor(230, 230, 230))
+
+        block = self.firstVisibleBlock()
+        blockNumber = block.blockNumber()
+        top = int(self.blockBoundingGeometry(block).translated(self.contentOffset()).top())
+        bottom = top + int(self.blockBoundingRect(block).height())
+
+        while block.isValid() and top <= event.rect().bottom():
+            if block.isVisible() and bottom >= event.rect().top():
+                number = str(blockNumber + 1)
+                # 行號顏色依主題切換 / Line number color depends on theme
+                painter.setPen(QColor("#d4d4d4") if getattr(self, "is_dark", False) else Qt.GlobalColor.black)
+                painter.drawText(
+                    0, top, self.lineNumberArea.width() - 2, self.fontMetrics().height(),
+                    Qt.AlignmentFlag.AlignRight, number
+                )
+            block = block.next()
+            top = bottom
+            bottom = top + int(self.blockBoundingRect(block).height())
+            blockNumber += 1
+
+    def highlight_current_line(self):
+        """
+        Highlight the current line where the cursor is.
+        高亮顯示游標所在的行。
+        """
+        selection = QTextEdit.ExtraSelection()
+        lineColor = QColor(50, 50, 50) if getattr(self, "is_dark", False) else QColor(232, 232, 255)
+        selection.format.setBackground(lineColor)
+        selection.cursor = self.textCursor()
+        selection.cursor.clearSelection()
+
+        # Keep current-line extras for merging
+        self._current_line_extras = [selection]
+
+        # Merge with diff extras if present
+        if hasattr(self, "_diff_extras"):
+            merged = self._diff_extras + self._current_line_extras
+        else:
+            merged = self._current_line_extras
+
+        self.setExtraSelections(merged)
+
+    def apply_theme_to_editor(self, dark: bool):
+        self.setStyleSheet("QPlainTextEdit { background-color: #1e1e1e; color: #d4d4d4; }" if dark
+                           else "QPlainTextEdit { background-color: white; color: black; }")
+        # Re-trigger current line highlight with the new color
+        self.highlight_current_line()

je_editor/pyside_ui/git_ui/code_diff_compare/multi_file_diff_viewer.py

@@ -0,0 +1,88 @@
+from PySide6.QtWidgets import QTabWidget, QVBoxLayout, QWidget
+
+from je_editor.pyside_ui.git_ui.code_diff_compare.side_by_side_diff_widget import SideBySideDiffWidget
+
+
+class MultiFileDiffViewer(QWidget):
+    """
+    Multi-file diff viewer using tabs to display each file.
+    多檔案差異檢視器，使用分頁 (tab) 來顯示每個檔案的差異。
+    """
+
+    def __init__(self, parent=None):
+        """
+        Initialize the multi-file diff viewer.
+        初始化多檔案差異檢視器。
+        """
+        super().__init__(parent)
+        # Tab widget to hold each file's diff
+        # 用來存放每個檔案差異的分頁元件
+        self.tabs = QTabWidget()
+
+        # Layout: vertical box with only the tab widget
+        # 版面配置：垂直佈局，僅包含分頁元件
+        layout = QVBoxLayout(self)
+        layout.addWidget(self.tabs)
+
+    def set_diff_text(self, diff_text: str):
+        """
+        Set the diff text and split it into per-file tabs.
+        設定差異文字，並依檔案拆分成多個分頁。
+        """
+        self.tabs.clear()
+        file_diffs = self._split_by_file(diff_text)
+        for file_name, ftext in file_diffs:
+            viewer = SideBySideDiffWidget()   # 每個檔案使用 side-by-side viewer
+            viewer.set_diff_text(ftext)
+            self.tabs.addTab(viewer, file_name)  # 新增分頁，標題為檔名
+
+    def _split_by_file(self, diff_text: str):
+        """
+        Split a unified diff text into chunks per file.
+        將 unified diff 文字依檔案切分。
+        """
+        chunks = []
+        current = []
+        file_name = None
+
+        for line in diff_text.splitlines():
+            if line.startswith("diff --git"):
+                # 如果遇到新的檔案 diff，先把前一個檔案的內容存起來
+                if current and file_name:
+                    chunks.append((file_name, "\n".join(current)))
+                    current = []
+                # 解析檔名，格式通常為 "diff --git a/file b/file"
+                parts = line.split()
+                if len(parts) >= 4:
+                    file_name = parts[2][2:]  # 去掉 "a/"
+                else:
+                    file_name = "unknown"
+                current.append(line)
+            else:
+                current.append(line)
+
+        # 最後一個檔案也要加入結果
+        if current and file_name:
+            chunks.append((file_name, "\n".join(current)))
+
+        return chunks
+
+    def set_dark_theme(self):
+        """
+        Apply dark theme to all tabs.
+        對所有分頁套用深色主題。
+        """
+        for i in range(self.tabs.count()):
+            w = self.tabs.widget(i)
+            if isinstance(w, SideBySideDiffWidget):
+                w.set_dark_theme()
+
+    def set_light_theme(self):
+        """
+        Apply light theme to all tabs.
+        對所有分頁套用淺色主題。
+        """
+        for i in range(self.tabs.count()):
+            w = self.tabs.widget(i)
+            if isinstance(w, SideBySideDiffWidget):
+                w.set_light_theme()