Test free threading with pytest-run-parallel (#435)

* Test free threading with pytest-run-parallel

https://py-free-threading.github.io/testing --> https://github.com/Quansight-Labs/pytest-run-parallel

* @pytest.mark.iterations(1)

* @pytest.mark.test_threads(1)

Author: cclauss

.github/workflows/python_publish.yml

@@ -36,6 +36,7 @@ jobs:
         include:
           - os: macos-26
             python-version: '3.x'
+
     runs-on: ${{ matrix.os }}
     steps:
       - if: runner.os == 'Linux'
@@ -63,11 +64,22 @@ jobs:
       - name: Install dependencies
         run: |
           pip install --upgrade pip
-          pip install pytest
+          pip install pytest pytest-run-parallel
           pip install --editable .
 
       - timeout-minutes: 15  # Save resources while our pytests are hanging
         run: pytest --full-trace -s -vvv --strict
+      - if: runner.os == 'Linux'
+        timeout-minutes: 15  # Save resources while our pytests are hanging
+        run: pytest --full-trace --iterations=8 -s --strict
+      #- timeout-minutes: 15  # Save resources while our pytests are hanging
+      #  env:
+      #    PYTEST_RUN_PARALLEL_VERBOSE: 1
+      #  run: pytest --full-trace --parallel-threads=auto --strict tests/test_engines.py || true
+      #- timeout-minutes: 15  # Save resources while our pytests are hanging
+      #  env:
+      #    PYTEST_RUN_PARALLEL_VERBOSE: 1
+      #  run: pytest --full-trace --parallel-threads=auto --strict tests/test_pyttsx3.py || true
 
   build:
     runs-on: ubuntu-latest

tests/test_engines.py

@@ -10,6 +10,7 @@
 
 
 @pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
+@pytest.mark.parallel_threads(1)
 def test_engine_name(driver_name) -> None:
     engine = pyttsx3.init(driver_name)
     assert engine.driver_name == driver_name
@@ -21,6 +22,7 @@ def test_engine_name(driver_name) -> None:
 @pytest.mark.skipif(
     sys.platform == "win32", reason="TODO: Make this test pass on eSpeak-NG on Windows"
 )
+@pytest.mark.parallel_threads(1)
 @pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
 def test_speaking_text(driver_name) -> None:
     engine = pyttsx3.init(driver_name)
@@ -32,6 +34,7 @@ def test_speaking_text(driver_name) -> None:
     engine.stop()
 
 
+@pytest.mark.parallel_threads(1)
 @pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
 def test_espeak_voices(driver_name) -> None:
     if driver_name != "espeak":
@@ -93,6 +96,7 @@ def test_espeak_voices(driver_name) -> None:
         engine.runAndWait()
 
 
+@pytest.mark.parallel_threads(1)
 @pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
 def test_apple_nsss_voices(driver_name) -> None:
     if driver_name != "nsss":

tests/test_pyttsx3.py

@@ -23,6 +23,7 @@ def engine(driver_name: str | None = None) -> pyttsx3.engine.Engine:
     engine.stop()  # Ensure the engine stops after tests
 
 
+@pytest.mark.parallel_threads(1)
 def test_engine_name(engine) -> None:
     expected = pyttsx3.engine.default_engine_by_sys_platform()
     assert engine.driver_name == expected
@@ -31,6 +32,7 @@ def test_engine_name(engine) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+# @pytest.mark.parallel_threads(1)
 def test_speaking_text(engine) -> None:
     engine.say("Sally sells seashells by the seashore.")
     engine.say(quick_brown_fox)
@@ -39,6 +41,7 @@ def test_speaking_text(engine) -> None:
 
 
 @pytest.mark.skipif(sys.platform not in ("darwin", "ios"), reason="Testing only on macOS and iOS")
+@pytest.mark.parallel_threads(1)
 def test_apple_avspeech_voices(engine):
     import platform  # noqa: PLC0415  # Only needed on macOS and iOS
 
@@ -80,6 +83,7 @@ def test_apple_avspeech_voices(engine):
 
 
 @pytest.mark.skipif(sys.platform not in ("darwin", "ios"), reason="Testing only on macOS and iOS")
+@pytest.mark.parallel_threads(1)
 def test_apple_nsss_voices(engine):
     import platform  # noqa: PLC0415  # Only needed on macOS and iOS
 
@@ -117,6 +121,7 @@ def test_apple_nsss_voices(engine):
     engine.setProperty("voice", voice)  # Reset voice to original value
 
 
+@pytest.mark.parallel_threads(1)
 def test_saving_to_file(engine, tmp_path: Path) -> None:
     """
     Apple writes .aiff, not .wav.  https://github.com/nateshmbhat/pyttsx3/issues/361
@@ -144,6 +149,7 @@ def test_saving_to_file(engine, tmp_path: Path) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+@pytest.mark.parallel_threads(1)
 def test_listening_for_events(engine) -> None:
     onStart = mock.Mock()
     onWord = mock.Mock()
@@ -166,6 +172,7 @@ def test_listening_for_events(engine) -> None:
     sys.platform in ("linux", "win32"),
     reason="TODO: Fix this test to pass on Linux and Windows",
 )
+@pytest.mark.parallel_threads(1)
 def test_interrupting_utterance(engine) -> None:
     def onWord(name, location, length) -> None:
         if location > 10:
@@ -181,6 +188,7 @@ def onWord(name, location, length) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+@pytest.mark.parallel_threads(1)
 def test_changing_speech_rate(engine) -> None:
     rate = engine.getProperty("rate")
     rate_plus_fifty = rate + 50
@@ -191,6 +199,7 @@ def test_changing_speech_rate(engine) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+@pytest.mark.parallel_threads(1)
 def test_changing_volume(engine) -> None:
     volume = engine.getProperty("volume")
     volume_minus_a_quarter = volume - 0.25
@@ -201,6 +210,7 @@ def test_changing_volume(engine) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+@pytest.mark.parallel_threads(1)
 def test_changing_voices(engine) -> None:
     voices = engine.getProperty("voices")
     for voice in voices:  # TODO: This could be lots of voices! (e.g. 177 on macOS v15.x)
@@ -210,6 +220,8 @@ def test_changing_voices(engine) -> None:
 
 
 @pytest.mark.skipif(sys.platform == "win32", reason="TODO: Fix this test to pass on Windows")
+@pytest.mark.iterations(1)
+@pytest.mark.parallel_threads(1)
 def test_running_driver_event_loop(engine) -> None:
     def onStart(name) -> None:
         print("starting", name)
@@ -234,6 +246,7 @@ def onEnd(name, completed) -> None:
     sys.platform in ("linux", "win32"),
     reason="TODO: Fix this test to pass on Linux and Windows",
 )
+@pytest.mark.parallel_threads(1)
 def test_external_event_loop(engine) -> None:
     def externalLoop() -> None:
         for _ in range(5):