test: add PythonBox regression CI

Author: Lukas Geiger

.github/workflows/tests.yml

@@ -0,0 +1,46 @@
+name: PythonBox tests
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+    branches: [master]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  regression-tests:
+    runs-on: windows-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: ['3.10', '3.11', '3.12']
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: |
+          python -m pip install --upgrade pip
+          python -m pip install -r requirements.txt
+
+      - name: Compile sources
+        env:
+          PYTHONIOENCODING: utf-8
+        run: |
+          python -m py_compile PythonBox_v8.py manage_translations.py translator.py
+
+      - name: Run regression tests
+        env:
+          PYTHONIOENCODING: utf-8
+          QT_QPA_PLATFORM: offscreen
+        run: |
+          python -m unittest discover -s tests -v

CHANGELOG.md

@@ -8,14 +8,20 @@ Format basiert auf [Keep a Changelog](https://keepachangelog.com/de/1.1.0/).
 ### Hinzugefügt / Added
 - App- und Fenstericon über `PythonBox.ico`.
 - `build_exe.bat` für lokale PyInstaller-Builds.
+- Regressionstests für Qt6-Editor-APIs, F5-Ausführung, externe Python-Kommandos und Offscreen-Fensteraufbau.
+- GitHub Actions Workflow für Windows-Regressionstests auf Python 3.10 bis 3.12.
 
 ### Geändert / Changed
 - README, Security Policy, Contributing Guide und Code of Conduct auf das aktuelle Repository `dev-bricks/pythonbox` und die MIT-Lizenz ausgerichtet.
 - `.gitignore` um interne Steuerungsdateien, Secrets, Datenbanken, Logs, Test-Locks und Windows-/Build-Artefakte erweitert.
+- Dokumentierte Mindestversion auf Python 3.10+ vereinheitlicht, passend zur Startdatei und Testmatrix.
 
 ### Behoben / Fixed
 - Veraltete Clone-Pfade und `main.py`-Startbefehle in der Repository-Dokumentation entfernt.
 - Öffentliche E-Mail-Adresse aus dem Code of Conduct entfernt.
+- Doppelte `run_script`-Definition in `PythonArchitect` beseitigt, damit F5 wieder konsistent über das Debug-Output-Panel läuft.
+- Entfernte Qt6-APIs `fontMetrics().width()` und `setTabStopWidth()` durch aktuelle Alternativen ersetzt.
+- Externe Python-Skripte starten jetzt mit `sys.executable` statt einem hardcodierten `python`/`python3`.
 
 ## [1.0.0] - YYYY-MM-DD
 

PythonBox_v8.py

@@ -50,23 +50,38 @@
     QApplication, QMainWindow, QWidget, QVBoxLayout, QHBoxLayout,
     QPushButton, QLabel, QSplitter, QTreeWidget, QTreeWidgetItem,
     QMessageBox, QInputDialog, QPlainTextEdit, QFrame, QComboBox,
-    QDialog, QFormLayout, QDialogButtonBox, QTextEdit, QMenu, QAction,
+    QDialog, QFormLayout, QDialogButtonBox, QTextEdit, QMenu,
     QFileDialog, QProgressBar, QCheckBox, QStyle, QSystemTrayIcon,
-    QTabWidget, QTabBar, QLineEdit, QShortcut, QToolBar, QStatusBar,
+    QTabWidget, QTabBar, QLineEdit, QToolBar, QStatusBar,
     QDockWidget, QGroupBox, QRadioButton, QCompleter, QSpinBox,
     QScrollBar, QSlider, QSizePolicy, QListWidget, QListWidgetItem,
     QToolTip
 )
 from PySide6.QtCore import (
     Qt, QSize, QRect, QRegularExpression, QUrl, QMimeData, QProcess,
-    QTimer, Signal, QSettings, QStringListModel, QPoint
+    QTimer, Signal, QSettings, QStringListModel, QPoint, QEvent
 )
 from PySide6.QtGui import (
     QFont, QColor, QPainter, QTextFormat, QSyntaxHighlighter, 
     QTextCharFormat, QPalette, QIcon, QKeySequence, QTextCursor,
-    QTextDocument, QFontMetrics, QPen, QBrush
+    QTextDocument, QFontMetrics, QPen, QBrush, QAction, QShortcut
 )
 
+
+def build_external_python_command(script_path: Path) -> List[str]:
+    """Build a command that runs a script with the current Python interpreter."""
+    interpreter = sys.executable or ("python.exe" if sys.platform == "win32" else "python3")
+    script = str(script_path)
+
+    if sys.platform == "win32":
+        return ['cmd', '/c', 'start', '', 'cmd', '/k', interpreter, script]
+
+    terminal = shutil.which("x-terminal-emulator")
+    if terminal:
+        return [terminal, '-e', interpreter, script]
+
+    return [interpreter, script]
+
 # ============================================================================
 # MODERN UI THEME
 # ============================================================================
@@ -219,7 +234,7 @@ def __init__(self, parent=None):
         font.setStyleHint(QFont.Monospace)
         self.setFont(font)
         self.setLineWrapMode(QPlainTextEdit.NoWrap)
-        self.setTabStopWidth(self.fontMetrics().width(' ') * 4)
+        self.setTabStopDistance(self.fontMetrics().horizontalAdvance(' ') * 4)
 
         # Auto-Completion Setup
         self.completer = None
@@ -481,7 +496,7 @@ def lineNumberAreaWidth(self):
         while max_val >= 10:
             max_val //= 10
             digits += 1
-        width = 20 + self.fontMetrics().width('9') * digits
+        width = 20 + self.fontMetrics().horizontalAdvance('9') * digits
         # Platz für Git-Markierung
         width += 4
         return width
@@ -1528,7 +1543,7 @@ def setup_ui(self):
 
     def eventFilter(self, obj, event):
         """Behandelt Pfeiltasten für Command-History"""
-        if obj == self.input_line and event.type() == event.KeyPress:
+        if obj == self.input_line and event.type() == QEvent.Type.KeyPress:
             if event.key() == Qt.Key_Up:
                 self.navigate_history(-1)
                 return True
@@ -2944,7 +2959,7 @@ def _apply_settings_to_editors(self):
             editor.setFont(font)
 
             # Tab-Größe
-            editor.setTabStopWidth(editor.fontMetrics().width(' ') * tab_size)
+            editor.setTabStopDistance(editor.fontMetrics().horizontalAdvance(' ') * tab_size)
 
             # Zeilenumbruch
             if word_wrap:
@@ -3477,18 +3492,22 @@ def fix_encoding(self):
 
     # --- BUILD & RUN ---
 
-    def run_script(self):
-        """Führt das aktuelle Skript im integrierten Output-Panel aus"""
+    def run_current_code(self):
+        """Führt den aktuellen Editor-Inhalt über eine temporäre Datei aus."""
         editor = self.tab_editor.current_editor()
         if not editor:
             return
 
         code = editor.toPlainText()
         if not code.strip():
             return
-        
+
+        tmp_path = Path.home() / ".python_baukasten" / "temp_run.py"
+        tmp_path.parent.mkdir(parents=True, exist_ok=True)
+        tmp_path.write_text(code, encoding='utf-8')
+
         self.output_dock.show()
-        self.output_panel.run_code(code)
+        self.debug_output.run_normal(str(tmp_path))
 
     def run_script_external(self):
         """Führt das aktuelle Skript in externem Terminal aus"""
@@ -3503,11 +3522,8 @@ def run_script_external(self):
         tmp_path = Path.home() / ".python_baukasten" / "temp_run.py"
         tmp_path.parent.mkdir(parents=True, exist_ok=True)
         tmp_path.write_text(code, encoding='utf-8')
-        
-        if sys.platform == "win32":
-            subprocess.Popen(['cmd', '/c', 'start', '', 'cmd', '/k', 'python', str(tmp_path)])
-        else:
-            subprocess.Popen(['x-terminal-emulator', '-e', 'python3', str(tmp_path)])
+
+        subprocess.Popen(build_external_python_command(tmp_path))
 
     def build_exe(self):
         if not shutil.which("pyinstaller"):
@@ -3561,10 +3577,7 @@ def scan_external_tools(self):
             self.ext_tools_menu.addAction(f"🛠️ {name}", lambda t=tool: self.run_external_tool(t))
 
     def run_external_tool(self, path):
-        if sys.platform == "win32":
-            subprocess.Popen(['cmd', '/c', 'start', '', 'cmd', '/k', 'python', str(path)])
-        else:
-            subprocess.Popen(['python3', str(path)])
+        subprocess.Popen(build_external_python_command(Path(path)))
 
 
 # ============================================================================

README.md

@@ -4,7 +4,7 @@ PythonBox ist eine leichtgewichtige Python-IDE mit Dark Theme, integriertem Debu
 
 PythonBox is a lightweight Python IDE with a dark theme, integrated debugging, code folding, and optional VS Code/PyCharm integration.
 
-![Python](https://img.shields.io/badge/Python-3.8+-blue.svg)
+![Python](https://img.shields.io/badge/Python-3.10+-blue.svg)
 ![PySide6](https://img.shields.io/badge/PySide6-6.5+-green.svg)
 ![License](https://img.shields.io/badge/License-MIT-yellow.svg)
 
@@ -24,6 +24,7 @@ PythonBox is a lightweight Python IDE with a dark theme, integrated debugging, c
 - Debug-Toolbar mit Step In, Step Over und Step Out
 - Linter-Integration für Pylint und Flake8
 - Git-Status, Diff und Modified-Markierung
+- Qt6-kompatible Editor-Metriken und F5-Ausführung über das Debug-Output-Panel
 
 ### Windows-Paketierung
 - `PythonBox.ico` wird als App- und Fenstericon verwendet, wenn die Datei vorhanden ist.
@@ -37,7 +38,7 @@ PythonBox is a lightweight Python IDE with a dark theme, integrated debugging, c
 ## Installation
 
 ### Voraussetzungen / Requirements
-- Python 3.8+
+- Python 3.10+
 - PySide6 6.5+
 - Optional: Git, Pylint, Flake8, VS Code, PyCharm
 
@@ -61,6 +62,16 @@ build_exe.bat
 
 Das Build-Ergebnis liegt anschließend in `dist/`. Build-Artefakte und lokale Releases sind bewusst nicht Teil des Git-Repositories.
 
+## Tests
+
+Die Regressionstests prüfen die Qt6-API-Kompatibilität, die F5-Ausführung über `debug_output.run_normal`, die externe Terminal-Ausführung mit dem aktuellen Python-Interpreter und einen Offscreen-Smoke-Test für das Hauptfenster.
+
+```bash
+python -m unittest discover -s tests -v
+```
+
+GitHub Actions führt diese Prüfungen unter Windows für Python 3.10 bis 3.12 aus.
+
 ## Tastenkürzel / Keyboard Shortcuts
 
 | Shortcut | Funktion / Action |

tests/test_pythonbox_regressions.py

@@ -0,0 +1,108 @@
+import ast
+import importlib.util
+import os
+import unittest
+from pathlib import Path
+from unittest import mock
+
+
+ROOT = Path(__file__).resolve().parents[1]
+SOURCE = ROOT / "PythonBox_v8.py"
+
+
+def load_pythonbox_module():
+    spec = importlib.util.spec_from_file_location("pythonbox_v8", SOURCE)
+    module = importlib.util.module_from_spec(spec)
+    spec.loader.exec_module(module)
+    return module
+
+
+class PythonArchitectRegressionTests(unittest.TestCase):
+    def _pythonarchitect_class(self):
+        tree = ast.parse(SOURCE.read_text(encoding="utf-8"))
+        for node in tree.body:
+            if isinstance(node, ast.ClassDef) and node.name == "PythonArchitect":
+                return node
+        self.fail("PythonArchitect class not found")
+
+    def test_pythonarchitect_has_no_shadowed_methods(self):
+        methods = [
+            node.name
+            for node in self._pythonarchitect_class().body
+            if isinstance(node, ast.FunctionDef)
+        ]
+        duplicates = sorted({name for name in methods if methods.count(name) > 1})
+
+        self.assertEqual([], duplicates)
+
+    def test_f5_run_script_uses_debug_output_panel(self):
+        run_script = None
+        for node in self._pythonarchitect_class().body:
+            if isinstance(node, ast.FunctionDef) and node.name == "run_script":
+                run_script = node
+                break
+        self.assertIsNotNone(run_script)
+
+        call_targets = []
+        for node in ast.walk(run_script):
+            if (
+                isinstance(node, ast.Call)
+                and isinstance(node.func, ast.Attribute)
+                and isinstance(node.func.value, ast.Attribute)
+                and isinstance(node.func.value.value, ast.Name)
+                and node.func.value.value.id == "self"
+            ):
+                call_targets.append((node.func.value.attr, node.func.attr))
+
+        self.assertIn(("debug_output", "run_normal"), call_targets)
+        self.assertNotIn(("output_panel", "run_code"), call_targets)
+
+    def test_qt6_removed_editor_apis_are_not_used(self):
+        source = SOURCE.read_text(encoding="utf-8")
+
+        self.assertNotIn(".fontMetrics().width(", source)
+        self.assertNotIn(".setTabStopWidth(", source)
+
+    def test_main_window_can_be_constructed_offscreen(self):
+        os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+        module = load_pythonbox_module()
+        app = module.QApplication.instance() or module.QApplication([])
+        window = module.PythonArchitect()
+
+        try:
+            self.assertIsNotNone(window.tab_editor.current_editor())
+        finally:
+            window.close()
+            window.deleteLater()
+            app.processEvents()
+
+
+class ExternalPythonCommandTests(unittest.TestCase):
+    def test_windows_external_commands_use_current_interpreter(self):
+        module = load_pythonbox_module()
+
+        with (
+            mock.patch.object(module.sys, "platform", "win32"),
+            mock.patch.object(module.sys, "executable", r"C:\Current Python\python.exe"),
+        ):
+            cmd = module.build_external_python_command(Path("tool.py"))
+
+        self.assertEqual(['cmd', '/c', 'start', '', 'cmd', '/k'], cmd[:6])
+        self.assertEqual(r"C:\Current Python\python.exe", cmd[6])
+        self.assertEqual("tool.py", cmd[7])
+
+    def test_non_windows_external_commands_use_current_interpreter(self):
+        module = load_pythonbox_module()
+
+        with (
+            mock.patch.object(module.sys, "platform", "linux"),
+            mock.patch.object(module.sys, "executable", "/opt/current-python/bin/python"),
+            mock.patch.object(module.shutil, "which", return_value=None),
+        ):
+            cmd = module.build_external_python_command(Path("tool.py"))
+
+        self.assertEqual(["/opt/current-python/bin/python", "tool.py"], cmd)
+
+
+if __name__ == "__main__":
+    unittest.main()