Add test_espeak_voices

pyttsx3/drivers/espeak.py

@@ -85,7 +85,7 @@ def getProperty(name: str):
             return voices
         elif name == "voice":
             voice = _espeak.GetCurrentVoice()
-            return voice.contents.name.decode("utf-8")
+            return voice.contents.name.decode("utf-8") if voice.contents.name else None
         elif name == "rate":
             return _espeak.GetParameter(_espeak.RATE)
         elif name == "volume":

tests/test_engines.py

@@ -30,3 +30,93 @@ def test_speaking_text(driver_name):
     engine.runAndWait()
     print(list(pyttsx3._activeEngines.values()), flush=True)
     engine.stop()
+
+
+@pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
+def test_espeak_voices(driver_name):
+    if driver_name != "espeak":
+        pytest.skip(f"Skipping eSpeak-specific test for {driver_name}.")
+
+    engine = pyttsx3.init(driver_name)
+    print(list(pyttsx3._activeEngines))
+    print(engine)
+    assert str(engine) == "espeak", "Expected engine name to be espeak"
+    voice = engine.getProperty("voice")
+    if voice:  # eSpeak-NG Windows v1.52-dev returns None
+        assert (
+            voice == "English (Great Britain)"
+        ), f"Expected {engine} default voice to be 'English (Great Britain)'"
+    voices = engine.getProperty("voices")
+    print(f"{engine} has {len(voices) = } voices.")
+    # Linux eSpeak-NG v1.50 has 109 voices,
+    # macOS eSpeak-NG v1.51 has 131 voices,
+    # Windows eSpeak-NG v1.52-dev has 221 voices.
+    assert len(voices) in {109, 131, 221}, f"Expected 109, 131, 221 voices in {engine}"
+    # print("\n".join(voice.id for voice in voices))
+    english_voices = [voice for voice in voices if voice.id.startswith("English")]
+    # Linux eSpeak-NG (v1.50) has 7 English voices, macOS eSpeak-NG (v1.51) has 8.
+    assert len(english_voices) in {7, 8}, "Expected 7 or 8 English voices in {engine}"
+    names = []
+    for _voice in english_voices:
+        engine.setProperty("voice", _voice.id)
+        # English (America, New York City) --> America, New York City
+        name = _voice.id[9:-1]
+        names.append(name)
+        engine.say(f"{name} says hello")
+        engine.runAndWait()  # TODO: Remove this line when multiple utterances work!
+    name_str = "|".join(names)
+    expected = (
+        "Caribbean|Great Britain|Scotland|Lancaster|West Midlands"
+        "|Received Pronunciation|America|America, New York City"
+    )
+    no_nyc = expected.rpartition("|")[0]
+    assert name_str in {expected, no_nyc}, f"Expected '{expected}' or '{no_nyc}'."
+    print(f"({name_str.replace('|', ' ; ')})", end=" ", flush=True)
+    engine.runAndWait()
+    engine.setProperty("voice", voice)  # Reset voice to original value
+    engine.stop()
+
+
+@pytest.mark.parametrize("driver_name", pyttsx3.engine.engines_by_sys_platform())
+def test_apple_nsss_voices(driver_name):
+    if driver_name != "nsss":
+        pytest.skip(f"Skipping nsss-specific test for {driver_name}.")
+
+    import platform
+
+    engine = pyttsx3.init(driver_name)
+    macos_version, _, macos_hardware = platform.mac_ver()
+    print(f"{sys.platform = }, {macos_version = } on {macos_hardware = }")
+    print(list(pyttsx3._activeEngines))
+    print(engine)
+    assert str(engine) == "nsss", "Expected engine name to be nsss on macOS and iOS"
+    voice = engine.getProperty("voice")
+    # On macOS v14.x, the default nsss voice is com.apple.voice.compact.en-US.Samantha.
+    # ON macOS v15.x, the default nsss voice is ""
+    assert (
+        voice in {"", "com.apple.voice.compact.en-US.Samantha"}
+    ), "Expected default voice to be com.apple.voice.compact.en-US.Samantha on macOS and iOS"
+    voices = engine.getProperty("voices")
+    # On macOS v14.x, nsss has 143 voices.
+    # On macOS v15.x, nsss has 176 voices
+    print(f"On macOS v{macos_version}, {engine} has {len(voices) = } voices.")
+    assert len(voices) in {176, 143}, "Expected 176 or 143 voices on macOS and iOS"
+    # print("\n".join(voice.id for voice in voices))
+    en_us_voices = [
+        voice for voice in voices if voice.id.startswith("com.apple.eloquence.en-US.")
+    ]
+    assert (
+        len(en_us_voices) == 8
+    ), "Expected 8 com.apple.eloquence.en-US voices on macOS and iOS"
+    names = []
+    for _voice in en_us_voices:
+        engine.setProperty("voice", _voice.id)
+        name = _voice.id.split(".")[-1]
+        names.append(name)
+        engine.say(f"{name} says hello")
+    name_str = ", ".join(names)
+    assert name_str == "Eddy, Flo, Grandma, Grandpa, Reed, Rocko, Sandy, Shelley"
+    print(f"({name_str})", end=" ", flush=True)
+    engine.runAndWait()
+    engine.setProperty("voice", voice)  # Reset voice to original value
+    engine.stop()

tests/test_pyttsx3.py

@@ -36,48 +36,6 @@ def test_speaking_text(engine):
     engine.runAndWait()
 
 
-@pytest.mark.skipif(
-    sys.platform not in ("darwin", "ios"), reason="Testing only on macOS and iOS"
-)
-def test_apple_nsss_voices(engine):
-    import platform
-
-    macos_version, _, macos_hardware = platform.mac_ver()
-    print(f"{sys.platform = }, {macos_version = } on {macos_hardware = }")
-    print(list(pyttsx3._activeEngines))
-    print(engine)
-    assert str(engine) == "nsss", "Expected engine name to be nsss on macOS and iOS"
-    voice = engine.getProperty("voice")
-    # On macOS v14.x, the default nsss voice is com.apple.voice.compact.en-US.Samantha.
-    # ON macOS v15.x, the default nsss voice is ""
-    assert (
-        voice in ("", "com.apple.voice.compact.en-US.Samantha")
-    ), "Expected default voice to be com.apple.voice.compact.en-US.Samantha on macOS and iOS"
-    voices = engine.getProperty("voices")
-    # On macOS v14.x, nsss has 143 voices.
-    # On macOS v15.x, nsss has 176 voices
-    print(f"On macOS v{macos_version}, {engine} has {len(voices) = } voices.")
-    assert len(voices) in (176, 143), "Expected 176 or 143 voices on macOS and iOS"
-    # print("\n".join(voice.id for voice in voices))
-    en_us_voices = [
-        voice for voice in voices if voice.id.startswith("com.apple.eloquence.en-US.")
-    ]
-    assert (
-        len(en_us_voices) == 8
-    ), "Expected 8 com.apple.eloquence.en-US voices on macOS and iOS"
-    names = []
-    for _voice in en_us_voices:
-        engine.setProperty("voice", _voice.id)
-        name = _voice.id.split(".")[-1]
-        names.append(name)
-        engine.say(f"{name} says hello")
-    name_str = ", ".join(names)
-    assert name_str == "Eddy, Flo, Grandma, Grandpa, Reed, Rocko, Sandy, Shelley"
-    print(f"({name_str})", end=" ", flush=True)
-    engine.runAndWait()
-    engine.setProperty("voice", voice)  # Reset voice to original value
-
-
 @pytest.mark.xfail(
     sys.platform == "darwin", reason="TODO: Fix this test to pass on macOS"
 )