python-voiceio 0.4.0__tar.gz → 0.5.0__tar.gz

{python_voiceio-0.4.0/python_voiceio.egg-info → python_voiceio-0.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.4.0
+Version: 0.5.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -40,6 +40,10 @@ Requires-Dist: edge-tts>=6.1.0; extra == "tts-cloud"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
+Provides-Extra: linux
+Requires-Dist: pystray>=0.19; extra == "linux"
+Requires-Dist: Pillow>=10.0; extra == "linux"
+Requires-Dist: piper-tts>=1.2.0; extra == "linux"
 Dynamic: license-file
 
 # voiceio
@@ -74,8 +78,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -86,11 +91,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -100,8 +108,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/README.md

@@ -30,8 +30,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -42,11 +43,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -56,8 +60,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "0.4.0"
+version = "0.5.0"
 description = "Voice dictation for Linux. Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"
@@ -37,6 +37,10 @@ tray = ["pystray>=0.19", "Pillow>=10.0"]
 tts = ["piper-tts>=1.2.0"]
 tts-cloud = ["edge-tts>=6.1.0"]
 dev = ["pytest>=7.0", "pytest-mock"]
+# Convenience bundle for a full Linux install (tray icon + local TTS). The core
+# Linux deps (evdev, sounddevice) are already unconditional; system packages
+# (IBus, PortAudio, a C toolchain) are installed separately — see README.
+linux = ["pystray>=0.19", "Pillow>=10.0", "piper-tts>=1.2.0"]
 
 [project.urls]
 Homepage = "https://github.com/Hugo0/voiceio"

{python_voiceio-0.4.0 → python_voiceio-0.5.0/python_voiceio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 0.4.0
+Version: 0.5.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -40,6 +40,10 @@ Requires-Dist: edge-tts>=6.1.0; extra == "tts-cloud"
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
+Provides-Extra: linux
+Requires-Dist: pystray>=0.19; extra == "linux"
+Requires-Dist: Pillow>=10.0; extra == "linux"
+Requires-Dist: piper-tts>=1.2.0; extra == "linux"
 Dynamic: license-file
 
 # voiceio
@@ -74,8 +78,9 @@ Open-source, sovereign voice input/output. Your speech is transcribed on your ow
 ## Quick start
 
 ```bash
-# 1. Install system dependencies (Ubuntu/Debian)
-sudo apt install pipx ibus gir1.2-ibus-1.0 python3-gi python3-dev portaudio19-dev
+# 1. Install system dependencies (Ubuntu/Debian). build-essential + python3-dev
+#    are needed to compile evdev (no prebuilt wheel); portaudio for the mic.
+sudo apt install pipx build-essential python3-dev portaudio19-dev ibus gir1.2-ibus-1.0 python3-gi
 
 # 2. Install voiceio
 pipx install python-voiceio
@@ -86,11 +91,14 @@ voiceio setup
 
 That's it. Press **Ctrl+Alt+V** (or your chosen hotkey) to start dictating.
 
+**Installing with an AI agent?** Point it at [INSTALL.md](INSTALL.md) — a terse,
+copy-pasteable runbook (`voiceio setup --defaults` / `--answers '{json}'`, no TTY needed).
+
 <details>
 <summary><strong>Fedora</strong></summary>
 
 ```bash
-sudo dnf install pipx ibus python3-gobject python3-devel portaudio-devel
+sudo dnf install pipx gcc gcc-c++ make python3-devel portaudio-devel ibus ibus-libs python3-gobject
 pipx install python-voiceio
 voiceio setup
 ```
@@ -100,8 +108,8 @@ voiceio setup
 <summary><strong>Arch Linux</strong></summary>
 
 ```bash
-sudo pacman -S python-pipx ibus python-gobject portaudio
-# Note: Arch includes Python headers by default with the python package
+sudo pacman -S python-pipx base-devel portaudio ibus python-gobject
+# base-devel provides gcc/make; the python package ships headers.
 pipx install python-voiceio
 voiceio setup
 ```

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/python_voiceio.egg-info/SOURCES.txt

@@ -17,6 +17,7 @@ tests/test_backend_probes.py
 tests/test_cli.py
 tests/test_clipboard_read.py
 tests/test_commands.py
+tests/test_concurrency_lockdown.py
 tests/test_config.py
 tests/test_correct_batch.py
 tests/test_corrections.py
@@ -24,6 +25,7 @@ tests/test_fallback.py
 tests/test_health.py
 tests/test_hints.py
 tests/test_history.py
+tests/test_ibus_pending.py
 tests/test_ibus_typer.py
 tests/test_llm.py
 tests/test_llm_api.py
@@ -36,12 +38,14 @@ tests/test_prompt.py
 tests/test_recorder_integration.py
 tests/test_retention.py
 tests/test_robustness.py
+tests/test_security_hardening.py
 tests/test_snapshots.py
 tests/test_streaming.py
 tests/test_transcriber.py
 tests/test_tts.py
 tests/test_vad.py
 tests/test_vocabulary.py
+tests/test_wizard.py
 tests/test_wordfreq.py
 voiceio/__init__.py
 voiceio/__main__.py
@@ -54,6 +58,7 @@ voiceio/cli.py
 voiceio/clipboard_read.py
 voiceio/commands.py
 voiceio/config.py
+voiceio/consent.py
 voiceio/corrections.py
 voiceio/demo.py
 voiceio/feedback.py
@@ -87,6 +92,7 @@ voiceio/hotkeys/pynput_backend.py
 voiceio/hotkeys/socket_backend.py
 voiceio/ibus/__init__.py
 voiceio/ibus/engine.py
+voiceio/ibus/pending.py
 voiceio/models/__init__.py
 voiceio/models/silero_vad.onnx
 voiceio/sounds/__init__.py

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/python_voiceio.egg-info/requires.txt

@@ -16,6 +16,11 @@ win11toast>=0.36
 pytest>=7.0
 pytest-mock
 
+[linux]
+pystray>=0.19
+Pillow>=10.0
+piper-tts>=1.2.0
+
 [tray]
 pystray>=0.19
 Pillow>=10.0

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/tests/test_app_wiring.py

@@ -27,7 +27,10 @@ def _make_vio(mock_transcriber=None):
         mock_detect.return_value = MagicMock(display_server="wayland", desktop="gnome")
 
         from voiceio.app import VoiceIO
-        vio = VoiceIO(Config())
+        cfg = Config()
+        # Tests must never touch the real system clipboard
+        cfg.output.copy_to_clipboard = "off"
+        vio = VoiceIO(cfg)
         mock_stream = MagicMock()
         mock_stream.active = True
         mock_stream.closed = False
@@ -209,3 +212,51 @@ class TestStateMachine:
         vio._request_stop()
         assert vio._state == _State.IDLE
         assert not vio.recorder.is_recording
+
+
+class TestClipboardMirror:
+    """copy_to_clipboard: interim/final text mirrored to the clipboard."""
+
+    def test_interim_copy_skipped_for_clipboard_typer(self):
+        vio, mock_typer, _ = _make_vio()
+        mock_typer.name = "clipboard"
+        vio.cfg.output.copy_to_clipboard = "live"
+        with patch("voiceio.clipboard_read.copy_text") as mock_copy:
+            vio._on_interim_text("hello")
+            mock_copy.assert_not_called()
+
+    def test_interim_copy_fires_for_other_typers(self):
+        vio, mock_typer, _ = _make_vio()
+        mock_typer.name = "ibus"
+        vio.cfg.output.copy_to_clipboard = "live"
+        with patch("voiceio.clipboard_read.copy_text") as mock_copy:
+            vio._on_interim_text("hello")
+            mock_copy.assert_called_once_with("hello")
+
+    def test_interim_copy_off_unless_live(self):
+        vio, mock_typer, _ = _make_vio()
+        mock_typer.name = "ibus"
+        vio.cfg.output.copy_to_clipboard = "final"
+        with patch("voiceio.clipboard_read.copy_text") as mock_copy:
+            vio._on_interim_text("hello")
+            mock_copy.assert_not_called()
+
+    def test_final_copy_respects_off(self):
+        vio, mock_typer, _ = _make_vio()
+        mock_typer.name = "ibus"
+        vio.cfg.output.copy_to_clipboard = "off"
+        with patch("voiceio.clipboard_read.copy_text") as mock_copy:
+            vio._copy_result_async("hello")
+            time.sleep(0.1)
+            mock_copy.assert_not_called()
+
+    def test_final_copy_runs_async(self):
+        vio, mock_typer, _ = _make_vio()
+        mock_typer.name = "ibus"
+        vio.cfg.output.copy_to_clipboard = "final"
+        done = threading.Event()
+        with patch("voiceio.clipboard_read.copy_text",
+                   side_effect=lambda t: done.set()) as mock_copy:
+            vio._copy_result_async("hello world")
+            assert done.wait(timeout=2)
+            mock_copy.assert_called_once_with("hello world")

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/tests/test_clipboard_read.py

@@ -89,3 +89,57 @@ def test_read_text_no_tools():
         from voiceio.clipboard_read import read_text
         result = read_text()
         assert result is None
+
+
+# --- copy_text ---
+
+def test_copy_text_wayland():
+    """Wayland copies via wl-copy with text on stdin."""
+    with patch("voiceio.clipboard_read.detect", return_value=_mock_platform(display_server="wayland")), \
+         patch("shutil.which", return_value="/usr/bin/wl-copy"), \
+         patch("subprocess.run") as mock_run:
+        mock_run.return_value = MagicMock(returncode=0)
+        from voiceio.clipboard_read import copy_text
+        assert copy_text("hello") is True
+        args = mock_run.call_args[0][0]
+        assert "wl-copy" in args
+        assert mock_run.call_args.kwargs["input"] == b"hello"
+
+
+def test_copy_text_x11_xclip():
+    """X11 copies to the CLIPBOARD selection via xclip."""
+    with patch("voiceio.clipboard_read.detect", return_value=_mock_platform(display_server="x11")), \
+         patch("shutil.which", lambda t: "/usr/bin/xclip" if t == "xclip" else None), \
+         patch("subprocess.run") as mock_run:
+        mock_run.return_value = MagicMock(returncode=0)
+        from voiceio.clipboard_read import copy_text
+        assert copy_text("hello") is True
+        args = mock_run.call_args[0][0]
+        assert args[:1] == ["xclip"]
+        assert "clipboard" in args
+
+
+def test_copy_text_no_tools():
+    """Returns False (no raise) when no clipboard tools available."""
+    with patch("voiceio.clipboard_read.detect", return_value=_mock_platform(display_server="x11")), \
+         patch("shutil.which", return_value=None):
+        from voiceio.clipboard_read import copy_text
+        assert copy_text("hello") is False
+
+
+def test_copy_text_empty():
+    """Empty text is never copied."""
+    with patch("subprocess.run") as mock_run:
+        from voiceio.clipboard_read import copy_text
+        assert copy_text("") is False
+        mock_run.assert_not_called()
+
+
+def test_copy_text_command_failure():
+    """Nonzero exit from the copy tool reports False."""
+    with patch("voiceio.clipboard_read.detect", return_value=_mock_platform(display_server="wayland")), \
+         patch("shutil.which", return_value="/usr/bin/wl-copy"), \
+         patch("subprocess.run") as mock_run:
+        mock_run.return_value = MagicMock(returncode=1)
+        from voiceio.clipboard_read import copy_text
+        assert copy_text("hello") is False

python_voiceio-0.5.0/tests/test_concurrency_lockdown.py

@@ -0,0 +1,254 @@
+"""Regression tests for the concurrency lockdown + IBus good-citizenship work.
+
+Covers:
+  #1 IBus input-source is never re-forced while IDLE; mid-record switch-away
+     falls back to clipboard instead of fighting the user.
+  #2 IBus deactivation is generation-checked and restores the user's source.
+  #3 Watchdog typer/platform mutation goes through lock-guarded, IDLE-gated
+     swap helpers.
+  #8 SIGTERM runs the same shutdown path as Ctrl-C.
+"""
+from __future__ import annotations
+
+import time
+from unittest.mock import MagicMock, patch
+
+from voiceio.config import Config
+from voiceio.typers.base import TyperBackend
+
+
+def _make_app(typer_name="clipboard"):
+    """VoiceIO with mocked backends; typer.name configurable."""
+    mock_hotkey = MagicMock()
+    mock_hotkey.name = "socket"
+    mock_typer = MagicMock(spec=TyperBackend)
+    mock_typer.name = typer_name
+
+    with patch("voiceio.app.hotkey_chain.select", return_value=mock_hotkey), \
+         patch("voiceio.app.typer_chain.select", return_value=mock_typer), \
+         patch("voiceio.app.Transcriber", return_value=MagicMock()), \
+         patch("voiceio.app.plat.detect") as mock_detect:
+        mock_detect.return_value = MagicMock(
+            display_server="wayland", desktop="gnome", is_gnome=True,
+        )
+        from voiceio.app import VoiceIO
+        vio = VoiceIO(Config())
+    mock_stream = MagicMock()
+    mock_stream.active = True
+    mock_stream.closed = False
+    mock_stream.stopped = False
+    vio.recorder._stream = mock_stream
+    vio.recorder._last_callback_time = time.monotonic()
+    return vio
+
+
+# ── Fix #3: lock-guarded, IDLE-gated swaps ──────────────────────────────
+
+class TestGuardedSwaps:
+    def test_swap_typer_only_when_idle(self):
+        from voiceio.app import _State
+        vio = _make_app()
+        new = MagicMock(spec=TyperBackend)
+        new.name = "ydotool"
+
+        vio._state = _State.RECORDING
+        assert vio._swap_typer(new, "test") is False
+        assert vio._typer is not new  # not swapped mid-recording
+
+        vio._state = _State.IDLE
+        assert vio._swap_typer(new, "test") is True
+        assert vio._typer is new
+
+    def test_swap_platform_only_when_idle(self):
+        from voiceio.app import _State
+        vio = _make_app()
+        original = vio.platform
+        new_platform = MagicMock(desktop="kde")
+
+        vio._state = _State.FINALIZING
+        assert vio._swap_platform(new_platform) is False
+        assert vio.platform is original
+
+        vio._state = _State.IDLE
+        assert vio._swap_platform(new_platform) is True
+        assert vio.platform is new_platform
+
+    def test_health_upkeep_skipped_when_not_idle(self):
+        """_check_health must not run typer upkeep during a live recording."""
+        from voiceio.app import _State
+        vio = _make_app()
+        vio._state = _State.RECORDING
+        vio.transcriber.is_worker_alive.return_value = True
+        vio.recorder.stream_health = MagicMock(return_value=(True, ""))
+        vio.cfg.tray.enabled = False
+        vio._health_typer_upkeep = MagicMock()
+        vio._check_health()
+        vio._health_typer_upkeep.assert_not_called()
+
+
+# ── Fix #2: generation-checked deactivation + source restore ─────────────
+
+class TestIBusDeactivation:
+    def test_deactivate_skipped_when_superseded(self):
+        vio = _make_app(typer_name="ibus")
+        vio._generation = 6
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=5)  # a newer recording already started
+            MockThread.assert_not_called()
+
+    def test_deactivate_runs_when_current(self):
+        vio = _make_app(typer_name="ibus")
+        vio._generation = 6
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=6)
+            MockThread.assert_called_once()
+
+    def test_deactivate_noop_for_non_ibus(self):
+        vio = _make_app(typer_name="clipboard")
+        with patch("voiceio.app.threading.Thread") as MockThread:
+            vio._deactivate_ibus(gen=1)
+            MockThread.assert_not_called()
+
+    def test_restore_uses_recorded_prev_index(self):
+        vio = _make_app(typer_name="ibus")
+        vio._prev_input_source_index = 2
+        vio._voiceio_source_index = 4
+        calls = []
+        vio._set_gnome_input_source_index = lambda i: calls.append(i)
+        vio._restore_input_source()
+        assert calls == [2]  # restores the user's source, not hardcoded 0
+        assert vio._prev_input_source_index is None
+        assert vio._voiceio_source_index is None
+
+    def test_restore_defaults_to_zero_when_unknown(self):
+        vio = _make_app(typer_name="ibus")
+        vio._prev_input_source_index = None
+        calls = []
+        vio._set_gnome_input_source_index = lambda i: calls.append(i)
+        vio._restore_input_source()
+        assert calls == [0]
+
+    def test_do_stop_does_not_deactivate_synchronously(self):
+        """Fix #2: deactivation is deferred to after the final commit, not run
+        inside _do_stop (which would race the finalizer's commit)."""
+        from voiceio.app import _State
+        vio = _make_app(typer_name="ibus")
+        vio._deactivate_ibus = MagicMock()
+        vio._state = _State.RECORDING
+        vio._record_start = time.monotonic() - 2
+        # Give the recorder something to return so a finalizer is spawned.
+        vio.recorder.stop = MagicMock(return_value=None)
+        vio._session = MagicMock()
+        with patch("voiceio.app.threading.Thread"):
+            vio._do_stop()
+        # For the streaming path the finalizer owns deactivation, so _do_stop
+        # itself must not have called it.
+        vio._deactivate_ibus.assert_not_called()
+
+
+# ── Fix #1: no re-force while IDLE; mid-record fallback ──────────────────
+
+class TestIBusGoodCitizen:
+    def _idle_healthy_ibus(self):
+        from voiceio.app import _State
+        vio = _make_app(typer_name="ibus")
+        vio._state = _State.IDLE
+        vio.transcriber.is_worker_alive.return_value = True
+        vio.recorder.stream_health = MagicMock(return_value=(True, ""))
+        vio.cfg.tray.enabled = False
+        vio._health_typer_upkeep = MagicMock()
+        vio._engine_proc = MagicMock()
+        vio._engine_proc.poll.return_value = None  # alive
+        vio._ping_ibus_engine = MagicMock(return_value=True)  # responsive
+        return vio
+
+    def test_idle_never_touches_input_source(self):
+        vio = self._idle_healthy_ibus()
+        vio._set_gnome_input_source_index = MagicMock()
+        vio._switch_gnome_input_source = MagicMock()
+        vio._detect_input_source_hijack = MagicMock()
+        vio._check_health()
+        # A responsive engine while IDLE => no source re-forcing at all.
+        vio._set_gnome_input_source_index.assert_not_called()
+        vio._switch_gnome_input_source.assert_not_called()
+        vio._detect_input_source_hijack.assert_not_called()
+
+    def test_recording_watches_for_hijack(self):
+        from voiceio.app import _State
+        vio = self._idle_healthy_ibus()
+        vio._state = _State.RECORDING
+        vio._detect_input_source_hijack = MagicMock()
+        vio._check_health()
+        vio._detect_input_source_hijack.assert_called_once()
+
+    def test_hijack_falls_back_to_clipboard(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 0  # user switched away
+        session = MagicMock()
+        vio._session = session
+        with patch("voiceio.typers.clipboard.ClipboardTyper", return_value=MagicMock()):
+            vio._detect_input_source_hijack()
+        assert vio._ibus_session_fallback is True
+        session.set_typer.assert_called_once()
+
+    def test_hijack_is_idempotent(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 0
+        session = MagicMock()
+        vio._session = session
+        with patch("voiceio.typers.clipboard.ClipboardTyper", return_value=MagicMock()):
+            vio._detect_input_source_hijack()
+            session.set_typer.reset_mock()
+            vio._detect_input_source_hijack()  # already fell back
+        session.set_typer.assert_not_called()
+
+    def test_no_hijack_when_still_on_voiceio(self):
+        vio = _make_app(typer_name="ibus")
+        vio._voiceio_source_index = 3
+        vio._get_current_input_source_index = lambda: 3  # still on voiceio
+        session = MagicMock()
+        vio._session = session
+        vio._detect_input_source_hijack()
+        assert vio._ibus_session_fallback is False
+        session.set_typer.assert_not_called()
+
+
+# ── Fix #8: SIGTERM shutdown wiring ─────────────────────────────────────
+
+class TestSigterm:
+    def test_run_registers_sigterm(self, monkeypatch, tmp_path):
+        import signal as _signal
+        vio = _make_app(typer_name="clipboard")
+
+        import voiceio.config as vcfg
+        monkeypatch.setattr(vcfg, "PID_PATH", tmp_path / "pid")
+        monkeypatch.setattr(vcfg, "LOG_DIR", tmp_path / "logs")
+        monkeypatch.setattr("voiceio.pidlock.lock_pid_file", lambda fd: None)
+        # Neutralize anything that could touch the real session/system.
+        monkeypatch.setattr("voiceio.app._import_graphical_env", lambda: None)
+        monkeypatch.setattr("voiceio.app._redetect_platform", lambda: vio.platform)
+        vio._stop_ibus_engine = MagicMock()
+        vio._set_gnome_input_source_index = MagicMock()
+        vio._try_upgrade_typer = MagicMock()
+        vio.cfg.tray.enabled = False
+        vio.cfg.feedback.sound_enabled = False
+        vio._hotkey = MagicMock()
+        vio._socket = None
+        vio._tts_hotkey = None
+
+        handlers = {}
+        monkeypatch.setattr(
+            "voiceio.app.signal.signal",
+            lambda sig, handler: handlers.__setitem__(sig, handler),
+        )
+
+        vio._shutdown.set()  # make run()'s wait return immediately
+        vio.run()
+
+        assert _signal.SIGTERM in handlers
+        # Invoking the handler must trigger the shared shutdown path.
+        vio._shutdown.clear()
+        handlers[_signal.SIGTERM]()
+        assert vio._shutdown.is_set()

{python_voiceio-0.4.0 → python_voiceio-0.5.0}/tests/test_config.py

@@ -61,3 +61,16 @@ def test_migrate_x11_to_pynput():
     raw = {"hotkey": {"backend": "x11"}}
     result = _migrate_v1(raw)
     assert result["hotkey"]["backend"] == "pynput"
+
+
+def test_copy_to_clipboard_default_and_override(tmp_path):
+    cfg = load(path=tmp_path / "nonexistent.toml")
+    assert cfg.output.copy_to_clipboard == "final"
+
+    config_file = tmp_path / "config.toml"
+    config_file.write_text(textwrap.dedent("""\
+        [output]
+        copy_to_clipboard = "live"
+    """))
+    cfg = load(path=config_file)
+    assert cfg.output.copy_to_clipboard == "live"

python_voiceio-0.5.0/tests/test_ibus_pending.py

@@ -0,0 +1,38 @@
+"""Tests for the IBus engine's pre-ready command buffer (fix #7).
+
+The buffer must never replay commands that went stale before the engine
+instance existed, and must be cleared outright when a fresh engine is created.
+"""
+from __future__ import annotations
+
+from voiceio.ibus.pending import PendingBuffer
+
+
+def test_fresh_commands_are_replayed_in_order():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("preedit:a", now=100.0)
+    buf.add("commit:b", now=100.5)
+    assert buf.drain_fresh(now=101.0) == ["preedit:a", "commit:b"]
+    assert len(buf) == 0  # draining empties the buffer
+
+
+def test_stale_commands_are_dropped():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("commit:old", now=100.0)   # 5s before drain -> stale
+    buf.add("commit:new", now=104.0)   # 1s before drain -> fresh
+    assert buf.drain_fresh(now=105.0) == ["commit:new"]
+
+
+def test_all_stale_yields_nothing():
+    buf = PendingBuffer(max_age=3.0)
+    buf.add("commit:x", now=0.0)
+    assert buf.drain_fresh(now=100.0) == []
+
+
+def test_clear_empties_buffer():
+    buf = PendingBuffer()
+    buf.add("preedit:z")
+    assert len(buf) == 1
+    buf.clear()
+    assert len(buf) == 0
+    assert buf.drain_fresh() == []