feat: Add visual breakpoint gutter (F9), recent files menu, and bump version 0.3.2

Author: lukisch

CHANGELOG.md

@@ -10,6 +10,27 @@
 
 Alle wesentlichen Änderungen an CodeBox werden hier dokumentiert.
 
+## [0.3.2] - 2026-09-14
+
+### Visuelle Breakpoints im Zeilennummern-Gutter & Zuletzt geöffnete Dateien (Recent Files)
+
+- `core/editor.py`:
+  - Visueller Breakpoint-Indikator im Zeilennummern-Gutter (`LineNumberArea`): Antialiased roter Kreis (`#e51400`) mit dynamischer Skalierung und zentrierter Ausrichtung.
+  - Breakpoint-Management auf `CodeEditor`: `toggle_breakpoint(line)`, `has_breakpoint(line)`, `get_breakpoints()`, `set_breakpoints(lines)`, `clear_breakpoints()`.
+  - Signal `breakpointsChanged` informiert externe Listener über modifizierte Breakpoint-Mengen.
+  - Interaktives Umschalten von Breakpoints per Mausklick in die Gutter-Fläche links neben den Zeilennummern mit Zeiger-Cursor (`PointingHandCursor`).
+- `ui/main_window.py`:
+  - Menüpunkt *Ausführen -> Breakpoint umschalten* (`F9`) und *Ausführen -> Alle Breakpoints löschen* (`Ctrl+Shift+F9`) mit Statusleistenmeldungen und Tastenkürzeln.
+  - Submenü *Datei -> Zuletzt geöffnete Dateien* mit persistenter Nachverfolgung (`recent_files` in Config-Settings), automatischer Bereinigung nicht mehr existierender Pfade, De-Duplizierung und Aktion "Verlauf leeren".
+  - Automatisches Erfassen geöffneter und gespeicherter Dateien in `open_path` und `save_file`.
+  - Robuste C++-Objekt-Lebenszyklus-Absicherung (`isValid`-Check & MainWindow-Parenting) gegen Shiboken-Wrapper-Invalidierung bei Menübaum-Traversierung.
+- `ui/shortcuts_dialog.py`:
+  - Registrierung von `F9` (Breakpoint umschalten) und `Ctrl+Shift+F9` (Alle Breakpoints löschen) in der Tastenkürzel-Übersicht unter *Ausführen*.
+- `ui/command_palette.py`:
+  - Schnellauswahl-Aktionen für Breakpoint-Umschaltung und -Bereinigung in den Quick Actions der Befehlspalette.
+- `tests/test_breakpoints_and_recent_files.py`:
+  - 5 neue automatisierte Tests zur Überprüfung von Editor-Breakpoint-Logik, Gutter-Breiten, MainWindow-Menüaktionen und persistenter Recent-Files-Verwaltung.
+
 ## [0.3.1] - 2026-09-13
 
 ### Integrierte Aufgaben- und TODO-Seitenleiste (TodoPanel & TodoScanner Engine)

README.md

@@ -6,13 +6,13 @@
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![Platform: Windows | Linux | macOS](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
 [![CI](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml/badge.svg)](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-273%20passed%20%7C%20100%25-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-285%20passed%20%7C%20100%25-brightgreen.svg)]()
 [![Privacy: Zero-Egress](https://img.shields.io/badge/privacy-100%25%20local--first%20%7C%20zero--egress-success.svg)](SECURITY.md)
 [![Security Policy](https://img.shields.io/badge/security-bilingual%20policy-blue.svg)](SECURITY.md)
 [![Ecosystem: dev-bricks](https://img.shields.io/badge/ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
 [![Part of: open-bricks](https://img.shields.io/badge/part%20of-open--bricks-blue.svg)](https://github.com/open-bricks)
 [![LSP Ready](https://img.shields.io/badge/LSP-ready-purple.svg)]()
-[![Version: 0.3.0](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
+[![Version: 0.3.2](https://img.shields.io/badge/version-0.3.2-green.svg)](CHANGELOG.md)
 [![llms.txt](https://img.shields.io/badge/llms.txt-available-green.svg)](llms.txt)
 
 [Deutsch](README_de.md) | English

README_de.md

@@ -6,13 +6,13 @@
 [![Python 3.10+](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue.svg)](https://www.python.org/)
 [![Plattform: Windows | Linux | macOS](https://img.shields.io/badge/platform-Windows%20%7C%20Linux%20%7C%20macOS-lightgrey.svg)]()
 [![CI](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml/badge.svg)](https://github.com/dev-bricks/CodeBox/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-273%20passed%20%7C%20100%25-brightgreen.svg)]()
+[![Tests](https://img.shields.io/badge/tests-285%20passed%20%7C%20100%25-brightgreen.svg)]()
 [![Datenschutz: Zero-Egress](https://img.shields.io/badge/datenschutz-100%25%20local--first%20%7C%20zero--egress-success.svg)](SECURITY.md)
 [![Sicherheitsrichtlinie](https://img.shields.io/badge/sicherheit-zweisprachige%20policy-blue.svg)](SECURITY.md)
 [![Ökosystem: dev-bricks](https://img.shields.io/badge/ecosystem-dev--bricks-blue.svg)](https://github.com/dev-bricks)
 [![Dachverband: open-bricks](https://img.shields.io/badge/part%20of-open--bricks-blue.svg)](https://github.com/open-bricks)
 [![LSP Ready](https://img.shields.io/badge/LSP-ready-purple.svg)]()
-[![Version: 0.3.0](https://img.shields.io/badge/version-0.3.0-green.svg)](CHANGELOG.md)
+[![Version: 0.3.2](https://img.shields.io/badge/version-0.3.2-green.svg)](CHANGELOG.md)
 [![llms.txt](https://img.shields.io/badge/llms.txt-verf%C3%BCgbar-green.svg)](llms.txt)
 
 [English](README.md) | Deutsch

core/editor.py

@@ -18,7 +18,7 @@
 
 
 class LineNumberArea(QWidget):
-    """Zeichnet Zeilennummern und Faltungs-Indikatoren für den CodeEditor"""
+    """Zeichnet Zeilennummern, Breakpoints und Faltungs-Indikatoren für den CodeEditor"""
     def __init__(self, editor):
         super().__init__(editor)
         self.codeEditor = editor
@@ -35,16 +35,21 @@ def mousePressEvent(self, event):
             block = self.codeEditor.firstVisibleBlock()
             top = int(self.codeEditor.blockBoundingGeometry(block).translated(self.codeEditor.contentOffset()).top())
             y = event.position().y()
+            x = event.position().x()
+            fold_x = self.width() - getattr(self.codeEditor, 'FOLD_AREA_WIDTH', 14)
             while block.isValid():
                 if block.isVisible():
                     h = int(self.codeEditor.blockBoundingRect(block).height())
                     if top <= y < top + h:
                         block_num = block.blockNumber()
-                        if self.codeEditor.is_line_foldable(block_num):
+                        if x >= fold_x - 4 and self.codeEditor.is_line_foldable(block_num):
                             self.codeEditor.toggle_fold(block_num)
                             event.accept()
                             return
-                        break
+                        # Klick im Zeilennummer- oder Breakpoint-Bereich schaltet Breakpoint um
+                        self.codeEditor.toggle_breakpoint(block_num + 1)
+                        event.accept()
+                        return
                     top += h
                 block = block.next()
         super().mousePressEvent(event)
@@ -55,18 +60,19 @@ def mouseMoveEvent(self, event):
         y = event.position().y()
         x = event.position().x()
         fold_x = self.width() - getattr(self.codeEditor, 'FOLD_AREA_WIDTH', 14)
-        is_hovering_fold = False
+        bp_w = getattr(self.codeEditor, 'BREAKPOINT_AREA_WIDTH', 14)
+        is_hovering_interactive = False
         while block.isValid():
             if block.isVisible():
                 h = int(self.codeEditor.blockBoundingRect(block).height())
                 if top <= y < top + h:
                     block_num = block.blockNumber()
-                    if self.codeEditor.is_line_foldable(block_num) and x >= fold_x - 4:
-                        is_hovering_fold = True
+                    if (self.codeEditor.is_line_foldable(block_num) and x >= fold_x - 4) or (x <= bp_w + 4):
+                        is_hovering_interactive = True
                     break
                 top += h
             block = block.next()
-        if is_hovering_fold:
+        if is_hovering_interactive:
             self.setCursor(Qt.CursorShape.PointingHandCursor)
         else:
             self.setCursor(Qt.CursorShape.ArrowCursor)
@@ -235,6 +241,7 @@ class CodeEditor(QPlainTextEdit):
     completionRequested = Signal(int, int, str)  # LSP: Zeile, Spalte, Prefix (0-basiert)
     definitionRequested = Signal(int, int, str)  # LSP/Fallback: Zeile, Spalte, Symbol (0-basiert)
     referencesRequested = Signal(int, int, str)  # LSP/Fallback: Zeile, Spalte, Symbol (0-basiert)
+    breakpointsChanged = Signal(object)  # List[int] mit 1-basierten Zeilennummern
     modificationChanged = Signal(bool)
     focusReceived = Signal()
 
@@ -253,6 +260,9 @@ def __init__(self, parent=None):
         self.bracket_matching_enabled = True
         self.linter_errors: List[Dict] = []
 
+        self.BREAKPOINT_AREA_WIDTH = 14
+        self._breakpoints: set[int] = set()
+
         self.lineNumberArea = LineNumberArea(self)
         self.minimap = Minimap(self)
         self._minimap_visible = True
@@ -894,7 +904,8 @@ def lineNumberAreaWidth(self):
         fm = self.fontMetrics()
         char_width = fm.horizontalAdvance('9') if hasattr(fm, 'horizontalAdvance') else fm.width('9')
         fold_w = getattr(self, 'FOLD_AREA_WIDTH', 14)
-        return 16 + char_width * digits + fold_w
+        bp_w = getattr(self, 'BREAKPOINT_AREA_WIDTH', 14)
+        return bp_w + char_width * digits + fold_w + 14
 
     def updateLineNumberAreaWidth(self, _):
         right_margin = self.minimap.width() if self._minimap_visible else 0
@@ -934,12 +945,25 @@ def lineNumberAreaPaintEvent(self, event):
         top = int(self.blockBoundingGeometry(block).translated(self.contentOffset()).top())
         bottom = top + int(self.blockBoundingRect(block).height())
         fold_width = getattr(self, 'FOLD_AREA_WIDTH', 14)
+        bp_width = getattr(self, 'BREAKPOINT_AREA_WIDTH', 14)
         area_width = self.lineNumberArea.width()
         font_h = self.fontMetrics().height()
 
         while block.isValid() and top <= event.rect().bottom():
             if block.isVisible() and bottom >= event.rect().top():
                 line_num = blockNumber + 1
+
+                # Breakpoint-Indikator zeichnen (roter Kreis im Gutter)
+                if hasattr(self, '_breakpoints') and line_num in self._breakpoints:
+                    painter.save()
+                    painter.setRenderHint(QPainter.RenderHint.Antialiasing)
+                    painter.setPen(Qt.PenStyle.NoPen)
+                    painter.setBrush(QColor(229, 20, 0))
+                    bp_cx = (bp_width // 2) + 1
+                    bp_cy = top + (font_h // 2)
+                    painter.drawEllipse(QPointF(bp_cx, bp_cy), 4.5, 4.5)
+                    painter.restore()
+
                 has_error = any(e['line'] == line_num and e.get('severity') == 'error'
                                 for e in self.linter_errors)
                 has_warning = any(e['line'] == line_num and e.get('severity') == 'warning'
@@ -951,8 +975,9 @@ def lineNumberAreaPaintEvent(self, event):
                 else:
                     painter.setPen(QColor(100, 100, 100))
 
-                num_rect_w = max(0, area_width - fold_width - 4)
-                painter.drawText(0, top, num_rect_w,
+                num_x = bp_width + 4
+                num_rect_w = max(0, area_width - fold_width - bp_width - 8)
+                painter.drawText(num_x, top, num_rect_w,
                                  font_h, Qt.AlignmentFlag.AlignRight, str(line_num))
 
                 if hasattr(self, 'folding_manager') and self.folding_manager.is_line_foldable(blockNumber):
@@ -988,6 +1013,50 @@ def lineNumberAreaPaintEvent(self, event):
             bottom = top + int(self.blockBoundingRect(block).height())
             blockNumber += 1
 
+    # ---- Breakpoint Management ----
+
+    def toggle_breakpoint(self, line: Optional[int] = None) -> bool:
+        """Schaltet einen Breakpoint auf der angegebenen Zeile (1-basiert) oder der Cursorzeile um."""
+        if line is None:
+            line = self.textCursor().blockNumber() + 1
+        line = int(line)
+        if line < 1:
+            return False
+
+        if line in self._breakpoints:
+            self._breakpoints.remove(line)
+            active = False
+        else:
+            self._breakpoints.add(line)
+            active = True
+
+        if hasattr(self, 'lineNumberArea'):
+            self.lineNumberArea.update()
+        self.breakpointsChanged.emit(self.get_breakpoints())
+        return active
+
+    def has_breakpoint(self, line: int) -> bool:
+        """Prüft, ob auf der Zeile (1-basiert) ein Breakpoint gesetzt ist."""
+        return int(line) in self._breakpoints
+
+    def get_breakpoints(self) -> List[int]:
+        """Gibt eine sortierte Liste aller gesetzten Breakpoints (1-basiert) zurück."""
+        return sorted(self._breakpoints)
+
+    def set_breakpoints(self, lines: List[int]):
+        """Setzt die Liste aller Breakpoints (1-basiert)."""
+        self._breakpoints = {int(line_num) for line_num in lines if int(line_num) >= 1}
+        if hasattr(self, 'lineNumberArea'):
+            self.lineNumberArea.update()
+        self.breakpointsChanged.emit(self.get_breakpoints())
+
+    def clear_breakpoints(self):
+        """Entfernt alle gesetzten Breakpoints in diesem Editor."""
+        self._breakpoints.clear()
+        if hasattr(self, 'lineNumberArea'):
+            self.lineNumberArea.update()
+        self.breakpointsChanged.emit([])
+
     # ---- Code Folding ----
 
     def _schedule_fold_update(self):

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "CodeBox"
-version = "0.3.1"
+version = "0.3.2"
 description = "Lightweight local PySide6 desktop code editor with LSP diagnostics, tabs, project tree, and integrated terminal"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -71,7 +71,7 @@ Security = "https://github.com/dev-bricks/CodeBox/blob/main/SECURITY.md"
 minversion = "7.0"
 testpaths = ["tests"]
 pythonpath = ["."]
-addopts = "-ra"
+addopts = "-ra -p no:flask"
 
 [tool.ruff]
 line-length = 100