CI: rewrite test harness to unittest per AGENTS.md

The previous harness used pytest for fixtures, markers, and discovery.
AGENTS.md mandates the stdlib unittest framework, so this replaces the
pytest scaffolding with equivalent unittest constructs.

- Remove pytest.ini and the root conftest.py (pytest-specific).
- Replace tests/conftest.py with tests/gramps_test_env.py, a regular
  helper module that bootstraps sys.path / GRAMPS_RESOURCES at import
  and exposes two base classes: GrampsTestCase (session-cached plugin
  manager + registry via setUpClass) and GrampsDbTestCase (same plus a
  fresh in-memory SQLite DB per test).
- Rewrite tests/test_plugin_registration.py as four unittest.TestCase
  subclasses (TestPluginRegistration, TestPluginLoading,
  TestImportPluginSmoke, TestExportPluginSmoke). pytest.fail(...) calls
  become self.fail(...); fixture injection becomes self.plugin_registry
  populated in setUpClass.
- Add GPL header to tests/__init__.py (was empty).
- Annotate all helpers and test methods with Python 3.10+ type hints;
  add Sphinx :param:/:returns: markers; add #---- class-header
  dividers.
- .github/workflows/ci.yml: replace `python3 -m pytest` invocations
  with `python3 -m unittest` using explicit module lists. Unit-test
  jobs build the module list via a shell loop that skips
  test_integration*.py and Sqlite/tests/test_sqlite.py; integration
  job uses `unittest discover` on tests/ plus an explicit list of
  per-addon integration modules.
- Drop the pytest `gui` marker mechanism — tests that require GTK
  now self-skip at import time via unittest.SkipTest (see the
  per-addon test files).
- Remove pytest from the CI Dockerfile and from .github/environment.yml;
  unittest is stdlib so no install is needed.

All touched files are Black-formatted.

Issue #9393.

Author: eduralph

.github/docker/gramps-ci/Dockerfile

@@ -5,7 +5,7 @@
 #   - GTK typelibs (so addon modules that `from gi.repository import Gtk`
 #     at module load time are importable — widgets still need xvfb to render)
 #   - intltool/gettext/git for make.py builds
-#   - ruff, pytest, dbf for lint/test tooling
+#   - ruff, dbf for lint/test tooling (tests use stdlib unittest per AGENTS.md)
 #   - xvfb + xauth for tests that actually render (wrap with `xvfb-run`)
 #
 # No display server runs by default — the image is headless unless a command
@@ -42,7 +42,6 @@ RUN pip install --no-cache-dir \
         pycairo \
         "gramps>=6.0,<6.1" \
         orjson \
-        pytest \
         ruff \
         dbf
 

.github/environment.yml

@@ -9,5 +9,4 @@ dependencies:
   - pip:
       - "gramps>=6.0,<6.1"
       - orjson
-      - pytest
       - dbf

.github/workflows/ci.yml

@@ -95,20 +95,24 @@ jobs:
         env:
           PYTHONPATH: .
         run: |
-          test_dirs=""
-          for d in */tests/; do
-            if ls "$d"/test_*.py 1>/dev/null 2>&1; then
-              test_dirs="$test_dirs $d"
-            fi
+          modules=""
+          for f in */tests/test_*.py; do
+            [ -f "$f" ] || continue
+            case "$(basename "$f")" in
+              test_integration*) continue ;;
+            esac
+            case "$f" in
+              Sqlite/tests/test_sqlite.py) continue ;;
+            esac
+            mod="${f%.py}"
+            mod="${mod//\//.}"
+            modules="$modules $mod"
           done
-          if [ -n "$test_dirs" ]; then
-            echo "Running unit tests in: $test_dirs"
-            python3 -m pytest $test_dirs -v --tb=short \
-              --ignore-glob='**/test_integration*.py' \
-              --ignore=Sqlite/tests/test_sqlite.py \
-              -m 'not gui'
+          if [ -n "$modules" ]; then
+            echo "Running unit tests:$modules"
+            python3 -m unittest -v $modules
           else
-            echo "No per-addon unit test files found"
+            echo "No per-addon unit test modules found"
           fi
 
   # -----------------------------------------------------------------
@@ -135,26 +139,30 @@ jobs:
         run: |
           mamba info
           mamba list | head -30
-          python -c "import pytest, gramps, gi; print('deps OK')"
+          python -c "import gramps, gi; print('deps OK')"
 
       - name: Run per-addon unit tests
         env:
           PYTHONPATH: .
         run: |
-          test_dirs=""
-          for d in */tests/; do
-            if ls "$d"/test_*.py 1>/dev/null 2>&1; then
-              test_dirs="$test_dirs $d"
-            fi
+          modules=""
+          for f in */tests/test_*.py; do
+            [ -f "$f" ] || continue
+            case "$(basename "$f")" in
+              test_integration*) continue ;;
+            esac
+            case "$f" in
+              Sqlite/tests/test_sqlite.py) continue ;;
+            esac
+            mod="${f%.py}"
+            mod="${mod//\//.}"
+            modules="$modules $mod"
           done
-          if [ -n "$test_dirs" ]; then
-            echo "Running unit tests in: $test_dirs"
-            python -m pytest $test_dirs -v --tb=short \
-              --ignore-glob='**/test_integration*.py' \
-              --ignore=Sqlite/tests/test_sqlite.py \
-              -m 'not gui'
+          if [ -n "$modules" ]; then
+            echo "Running unit tests:$modules"
+            python -m unittest -v $modules
           else
-            echo "No per-addon unit test files found"
+            echo "No per-addon unit test modules found"
           fi
 
   # -----------------------------------------------------------------
@@ -173,23 +181,24 @@ jobs:
       - name: Run plugin registration tests
         env:
           PYTHONPATH: .
-        run: python3 -m pytest tests/ -v --tb=short
+        run: python3 -m unittest discover -s tests -p "test_*.py" -t . -v
 
       - name: Run per-addon integration tests
         env:
           PYTHONPATH: .
         run: |
-          integration_tests=""
-          for f in */tests/test_integration*.py */test_integration*.py; do
-            if [ -f "$f" ]; then
-              integration_tests="$integration_tests $f"
-            fi
+          modules=""
+          for f in */tests/test_integration*.py; do
+            [ -f "$f" ] || continue
+            mod="${f%.py}"
+            mod="${mod//\//.}"
+            modules="$modules $mod"
           done
-          if [ -n "$integration_tests" ]; then
-            echo "Running per-addon integration tests: $integration_tests"
-            python3 -m pytest $integration_tests -v --tb=short
+          if [ -n "$modules" ]; then
+            echo "Running per-addon integration tests:$modules"
+            python3 -m unittest -v $modules
           else
-            echo "No per-addon integration test files found"
+            echo "No per-addon integration test modules found"
           fi
 
   # -----------------------------------------------------------------

conftest.py

@@ -0,0 +1,21 @@
+#
+# Gramps - a GTK+/GNOME based genealogy program
+#
+# Copyright (C) 2026  Eduard Ralph
+#
+# This program is free software; you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation; either version 2 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program; if not, write to the Free Software
+# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
+#
+
+"""Package marker for the repo-wide Gramps addon test suite."""