Release v0.3.0

Author: chrisdpurcell

.github/workflows/ci.yml

@@ -9,23 +9,33 @@ on:
 jobs:
   test:
     runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ["3.12", "3.13", "3.14"]
 
     steps:
     - uses: actions/checkout@v4
 
-    - name: Set up Python 3.14
+    - name: Set up Python ${{ matrix.python-version }}
       uses: actions/setup-python@v5
       with:
-        python-version: '3.14'
+        python-version: ${{ matrix.python-version }}
 
     - name: Install uv
       run: pip install uv
 
     - name: Install dependencies
       run: uv pip install --system -r requirements.txt
 
+    - name: Install Qt runtime dependencies
+      run: |
+        sudo apt-get update -q
+        sudo apt-get install -y libgl1 libegl1 libxkbcommon-x11-0
+
     - name: Run tests
-      run: pytest tests/ -v --cov=src --cov-report=xml
+      env:
+        QT_QPA_PLATFORM: offscreen
+      run: pytest tests/ -v --cov=src --cov-report=xml --cov-fail-under=80
 
     - name: Upload coverage to Codecov
       uses: codecov/codecov-action@v4

README.md

@@ -2,7 +2,7 @@
 
 A PySide6 desktop application for text processing on Linux. Provides encoding conversion (to UTF-8), text formatting/cleaning, find/replace, and file management through a split-panel interface.
 
-**Status**: v0.2.0 — core features implemented and tested. Encoding conversion is stubbed; find/replace, text cleaning, and file I/O are fully functional. See `DESIGN.md` for the full specification.
+**Status**: v0.3.0 — core features implemented and tested. Encoding conversion, find/replace, text cleaning, and file I/O are fully functional. See `DESIGN.md` for the full specification.
 
 ## Stack
 

src/utils/constants.py

@@ -9,8 +9,26 @@
 # File extensions shown in the QFileSystemModel tree.
 # Covers common text, config, markup, and script formats.
 TEXT_FILE_EXTENSIONS = [
-    "*.txt", "*.md", "*.rst", "*.csv", "*.log",
-    "*.json", "*.yaml", "*.yml", "*.toml", "*.xml", "*.html", "*.htm",
-    "*.css", "*.js", "*.ts", "*.py", "*.sh", "*.bash",
-    "*.conf", "*.cfg", "*.ini", "*.env",
+    "*.txt",
+    "*.md",
+    "*.rst",
+    "*.csv",
+    "*.log",
+    "*.json",
+    "*.yaml",
+    "*.yml",
+    "*.toml",
+    "*.xml",
+    "*.html",
+    "*.htm",
+    "*.css",
+    "*.js",
+    "*.ts",
+    "*.py",
+    "*.sh",
+    "*.bash",
+    "*.conf",
+    "*.cfg",
+    "*.ini",
+    "*.env",
 ]

src/views/main_window.py

@@ -235,7 +235,9 @@ def _setup_file_tree(self) -> None:
         self._fs_model = QFileSystemModel(self.ui)
         self._fs_model.setRootPath(QDir.homePath())
         self._fs_model.setNameFilters(TEXT_FILE_EXTENSIONS)
-        self._fs_model.setNameFilterDisables(False)  # hide non-matches (not just grey them)
+        self._fs_model.setNameFilterDisables(
+            False
+        )  # hide non-matches (not just grey them)
         self._file_tree_view.setModel(self._fs_model)
         self._file_tree_view.setRootIndex(self._fs_model.index(QDir.homePath()))
         # Hide size/type/date columns — name column only
@@ -324,7 +326,9 @@ def _connect_signals(self) -> None:
         self._plain_text_edit.cursorPositionChanged.connect(self._update_cursor_label)
         # contentsChanged fires on Delete/Backspace where cursor position does not
         # change — without this the char count goes stale after in-place deletions.
-        self._plain_text_edit.document().contentsChanged.connect(self._update_cursor_label)
+        self._plain_text_edit.document().contentsChanged.connect(
+            self._update_cursor_label
+        )
 
         # Keyboard shortcuts not present in the .ui file.
         # (Ctrl+S/O/Q/Shift+S are already wired via QAction shortcuts in main_window.ui.)
@@ -592,7 +596,7 @@ def _apply_preferences(self) -> None:
 
         # Font
         family = str(settings.value(KEY_FONT_FAMILY, DEFAULTS[KEY_FONT_FAMILY]))
-        size = int(settings.value(KEY_FONT_SIZE, DEFAULTS[KEY_FONT_SIZE]))
+        size = int(str(settings.value(KEY_FONT_SIZE, DEFAULTS[KEY_FONT_SIZE])))
         self._plain_text_edit.setFont(QFont(family, size))
 
         # Word wrap
@@ -605,7 +609,7 @@ def _apply_preferences(self) -> None:
 
         # Theme — Fusion style with a dark palette; restore system default for light.
         theme = str(settings.value(KEY_THEME, DEFAULTS[KEY_THEME]))
-        app = QApplication.instance()
+        app = cast(QApplication, QApplication.instance())
         if app is not None:
             if theme == "dark":
                 app.setStyle("Fusion")

src/views/preferences_dialog.py

@@ -8,6 +8,7 @@
 """
 
 import os
+from typing import TypeVar
 
 from PySide6.QtCore import QDir, QFile, QObject, QSettings, Signal
 from PySide6.QtUiTools import QUiLoader
@@ -23,14 +24,14 @@
     QWidget,
 )
 
-from typing import TypeVar
-
 _W = TypeVar("_W")
 
 
 def _require(widget: "_W | None", name: str) -> "_W":
     if widget is None:
-        raise RuntimeError(f"Required widget '{name}' not found in preferences_dialog.ui")
+        raise RuntimeError(
+            f"Required widget '{name}' not found in preferences_dialog.ui"
+        )
     return widget
 
 
@@ -98,7 +99,8 @@ def _load_ui(self, parent: QWidget | None) -> None:
             self.dialog.findChild(QCheckBox, "wordWrapCheckBox"), "wordWrapCheckBox"
         )
         self._line_numbers_cb = _require(
-            self.dialog.findChild(QCheckBox, "lineNumbersCheckBox"), "lineNumbersCheckBox"
+            self.dialog.findChild(QCheckBox, "lineNumbersCheckBox"),
+            "lineNumbersCheckBox",
         )
         self._theme_light_radio = _require(
             self.dialog.findChild(QRadioButton, "themeLightRadio"), "themeLightRadio"
@@ -139,13 +141,15 @@ def _load_from_settings(self) -> None:
             str(settings.value(KEY_FONT_FAMILY, DEFAULTS[KEY_FONT_FAMILY]))
         )
         self._font_size_spin.setValue(
-            int(settings.value(KEY_FONT_SIZE, DEFAULTS[KEY_FONT_SIZE]))
+            int(str(settings.value(KEY_FONT_SIZE, DEFAULTS[KEY_FONT_SIZE])))
         )
         self._word_wrap_cb.setChecked(
-            settings.value(KEY_WORD_WRAP, DEFAULTS[KEY_WORD_WRAP], type=bool)
+            bool(settings.value(KEY_WORD_WRAP, DEFAULTS[KEY_WORD_WRAP], type=bool))
         )
         self._line_numbers_cb.setChecked(
-            settings.value(KEY_LINE_NUMBERS, DEFAULTS[KEY_LINE_NUMBERS], type=bool)
+            bool(
+                settings.value(KEY_LINE_NUMBERS, DEFAULTS[KEY_LINE_NUMBERS], type=bool)
+            )
         )
         theme = settings.value(KEY_THEME, DEFAULTS[KEY_THEME])
         self._theme_dark_radio.setChecked(theme == "dark")
@@ -161,7 +165,9 @@ def _write_to_settings(self) -> None:
         settings.setValue(KEY_FONT_SIZE, self._font_size_spin.value())
         settings.setValue(KEY_WORD_WRAP, self._word_wrap_cb.isChecked())
         settings.setValue(KEY_LINE_NUMBERS, self._line_numbers_cb.isChecked())
-        settings.setValue(KEY_THEME, "dark" if self._theme_dark_radio.isChecked() else "light")
+        settings.setValue(
+            KEY_THEME, "dark" if self._theme_dark_radio.isChecked() else "light"
+        )
         settings.setValue(KEY_DEFAULT_DIR, self._default_dir_edit.text())
 
     def _on_apply_clicked(self) -> None:

tests/integration/test_live_scenarios.py

@@ -87,9 +87,7 @@ def test_title_loses_star_after_save(self, app, tmp_path, qtbot):
 
 
 class TestCleaningWithRealService:
-    def test_trim_removes_trailing_spaces_and_blank_lines(
-        self, app, tmp_path, qtbot
-    ):
+    def test_trim_removes_trailing_spaces_and_blank_lines(self, app, tmp_path, qtbot):
         # trim_whitespace strips trailing spaces per line and removes trailing
         # blank lines, but does NOT strip leading spaces.
         f = tmp_path / "trim.txt"
@@ -148,9 +146,7 @@ def test_find_wraps_from_end_of_document(self, app, tmp_path, qtbot):
         app._on_find_clicked()  # wraps to start, then finds
         assert app._plain_text_edit.textCursor().selectedText() == "quick"
 
-    def test_replace_all_updates_editor_and_emits_signal(
-        self, app, tmp_path, qtbot
-    ):
+    def test_replace_all_updates_editor_and_emits_signal(self, app, tmp_path, qtbot):
         f = tmp_path / "rep.txt"
         f.write_text("cat cat cat", encoding="utf-8")
         app._file_name_edit.setText(str(f))