Add pytest-qt and centralize QApplication setup for tests

Added pytest-qt to test dependencies and requirements for better PyQt6 test support. Centralized QApplication initialization in conftest.py to ensure headless and CI compatibility, removing redundant QApplication setup from individual test files.

Author: VoxDroid

pyproject.toml

@@ -37,6 +37,7 @@ requires = [
 test_requires = [
     "pytest",
     "types-requests",
+    "pytest-qt",
 ]
 
 [tool.mypy]

requirements.txt

@@ -13,4 +13,5 @@ PySocks
 pre-commit
 mypy 
 pyright
-pytest
+pytest
+pytest-qt

tests/conftest.py

@@ -1,6 +1,25 @@
 import sys
 from pathlib import Path
+import os
 
 # Add the src directory to the python path
 src_path = Path(__file__).parent.parent / "src"
 sys.path.append(str(src_path))
+
+# Use offscreen Qt platform for headless testing in CI
+os.environ.setdefault("QT_QPA_PLATFORM", "offscreen")
+
+
+def pytest_configure(config):
+    """Create a QApplication early so modules that import Qt at import-time can succeed.
+
+    This runs before collection, preventing ImportError during test collection on headless CI.
+    """
+    try:
+        from PyQt6.QtWidgets import QApplication
+
+        if QApplication.instance() is None:
+            QApplication([])
+    except Exception:
+        # If PyQt is not available, allow tests to fail later rather than crash here.
+        pass

tests/test_creator_downloader.py

@@ -8,12 +8,6 @@
 import os
 import sys
 
-from PyQt6.QtWidgets import QApplication
-
-# Ensure QApplication exists for PyQt6 components
-app = QApplication.instance()
-if app is None:
-    app = QApplication([])
 
 try:
     from kemonodownloader.creator_downloader import (

tests/test_post_downloader.py

@@ -7,12 +7,6 @@
 import sys
 from urllib.parse import urljoin
 
-from PyQt6.QtWidgets import QApplication
-
-# Ensure QApplication exists for PyQt6 components
-app = QApplication.instance()
-if app is None:
-    app = QApplication([])
 
 try:
     from kemonodownloader.post_downloader import (

tests/test_settings.py

@@ -8,12 +8,6 @@
 import tempfile
 
 from PyQt6.QtCore import QSettings
-from PyQt6.QtWidgets import QApplication
-
-# Ensure QApplication exists for PyQt6 components
-app = QApplication.instance()
-if app is None:
-    app = QApplication([])
 
 
 class TestDefaultSettings: