python-voiceio 1.10.0__tar.gz → 1.12.0__tar.gz

{python_voiceio-1.10.0/python_voiceio.egg-info → python_voiceio-1.12.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.10.0
+Version: 1.12.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -65,7 +65,7 @@ Dynamic: license-file
 **[Try it in your browser at voiceio.dev](https://voiceio.dev)**: no install, the model runs in the tab.
 
 - **Types anywhere.** Press your hotkey, speak, and the words stream into the focused app with a live underlined preview (IBus), on Wayland and X11: GNOME, KDE, Hyprland, sway, i3.
-- **Runs on your machine.** Whisper decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
+- **Runs on your machine.** Whisper, or NVIDIA's Parakeet (about 2x faster, with every name you use as a hotword), decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
 - **Learns your words.** Keep your recordings (opt-in, on your disk) and voiceio fine-tunes its model on them while the machine is idle. It switches only when the new model wins on clips it never trained on. On the author's voice: 12.1% → 4.9% word errors after one night on a laptop CPU.
 
 ## Install
@@ -87,7 +87,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -118,10 +127,10 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 
 ## Roadmap
 
-- **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
+- **Parakeet by default for everyone**: it needs our sherpa-onnx fix ([#4084](https://github.com/k2-fsa/sherpa-onnx/pull/4084)) in an upstream release; until then `voiceio models sherpa && voiceio models use parakeet-tdt-0.6b-v2` installs a patched build ([why](CONTRIBUTING.md#model-choice-parakeet-where-it-can-be-biased-whisper-otherwise)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing
@@ -130,7 +139,7 @@ Open an issue before a large PR. [CONTRIBUTING.md](CONTRIBUTING.md) covers the a
 
 ## Credits
 
-- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models; [sherpa-onnx](https://github.com/k2-fsa/sherpa-onnx) with NVIDIA's [Parakeet-TDT](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v2). The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
 - Ideas borrowed with thanks: modifier release, paste keys and media pausing from [Voxtype](https://github.com/peteonrails/voxtype); the landing page's look from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
 
 ## License

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/README.md

@@ -12,7 +12,7 @@
 **[Try it in your browser at voiceio.dev](https://voiceio.dev)**: no install, the model runs in the tab.
 
 - **Types anywhere.** Press your hotkey, speak, and the words stream into the focused app with a live underlined preview (IBus), on Wayland and X11: GNOME, KDE, Hyprland, sway, i3.
-- **Runs on your machine.** Whisper decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
+- **Runs on your machine.** Whisper, or NVIDIA's Parakeet (about 2x faster, with every name you use as a hotword), decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
 - **Learns your words.** Keep your recordings (opt-in, on your disk) and voiceio fine-tunes its model on them while the machine is idle. It switches only when the new model wins on clips it never trained on. On the author's voice: 12.1% → 4.9% word errors after one night on a laptop CPU.
 
 ## Install
@@ -34,7 +34,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -65,10 +74,10 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 
 ## Roadmap
 
-- **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
+- **Parakeet by default for everyone**: it needs our sherpa-onnx fix ([#4084](https://github.com/k2-fsa/sherpa-onnx/pull/4084)) in an upstream release; until then `voiceio models sherpa && voiceio models use parakeet-tdt-0.6b-v2` installs a patched build ([why](CONTRIBUTING.md#model-choice-parakeet-where-it-can-be-biased-whisper-otherwise)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing
@@ -77,7 +86,7 @@ Open an issue before a large PR. [CONTRIBUTING.md](CONTRIBUTING.md) covers the a
 
 ## Credits
 
-- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models; [sherpa-onnx](https://github.com/k2-fsa/sherpa-onnx) with NVIDIA's [Parakeet-TDT](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v2). The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
 - Ideas borrowed with thanks: modifier release, paste keys and media pausing from [Voxtype](https://github.com/peteonrails/voxtype); the landing page's look from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
 
 ## License

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-voiceio"
-version = "1.10.0"
+version = "1.12.0"
 description = "Voice dictation for Linux. Speak → text, locally, instantly."
 readme = "README.md"
 license = "MIT"

{python_voiceio-1.10.0 → python_voiceio-1.12.0/python_voiceio.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-voiceio
-Version: 1.10.0
+Version: 1.12.0
 Summary: Voice dictation for Linux. Speak → text, locally, instantly.
 Author: Hugo Montenegro
 License-Expression: MIT
@@ -65,7 +65,7 @@ Dynamic: license-file
 **[Try it in your browser at voiceio.dev](https://voiceio.dev)**: no install, the model runs in the tab.
 
 - **Types anywhere.** Press your hotkey, speak, and the words stream into the focused app with a live underlined preview (IBus), on Wayland and X11: GNOME, KDE, Hyprland, sway, i3.
-- **Runs on your machine.** Whisper decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
+- **Runs on your machine.** Whisper, or NVIDIA's Parakeet (about 2x faster, with every name you use as a hotword), decodes your speech locally. No account, no server, no telemetry; logs never contain your words.
 - **Learns your words.** Keep your recordings (opt-in, on your disk) and voiceio fine-tunes its model on them while the machine is idle. It switches only when the new model wins on clips it never trained on. On the author's voice: 12.1% → 4.9% word errors after one night on a laptop CPU.
 
 ## Install
@@ -87,7 +87,16 @@ pipx install 'python-voiceio[desktop]'
 voiceio setup        # model, hotkey, autostart
 ```
 
-Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works and `voiceio doctor --fix` repairs what it can. NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
+**Or as a Debian/Ubuntu package** (new; bundles everything, nothing to compile):
+
+```bash
+# Debian / Ubuntu: download voiceio_*.deb from the latest release, then
+sudo apt install ./voiceio_*.deb
+
+voiceio setup
+```
+
+Then press your hotkey, speak, and press it again (or hold it while you speak). `voiceio doctor` shows what works, `voiceio doctor --fix` repairs what it can, and `voiceio doctor --report` shares an anonymous install report on the [feedback board](https://voiceio.dev/#feedback) (it shows you the text and asks first). NixOS, other extras and installing from source: [docs/linux.md](docs/linux.md). Agent runbook: [INSTALL.md](INSTALL.md).
 
 ## Make it yours
 
@@ -118,10 +127,10 @@ Everything lives in `~/.config/voiceio/config.toml`; [config.example.toml](confi
 
 ## Roadmap
 
-- **Unbounded vocabulary**: a decoder whose biasing has no token cap (see [model choice](CONTRIBUTING.md#model-choice-why-whisper-and-what-would-change-it)).
+- **Parakeet by default for everyone**: it needs our sherpa-onnx fix ([#4084](https://github.com/k2-fsa/sherpa-onnx/pull/4084)) in an upstream release; until then `voiceio models sherpa && voiceio models use parakeet-tdt-0.6b-v2` installs a patched build ([why](CONTRIBUTING.md#model-choice-parakeet-where-it-can-be-biased-whisper-otherwise)).
 - **GPU on AMD and Intel**: let setup run a Vulkan whisper.cpp server for you.
 - **Typing without IBus on GNOME and KDE**: a libei backend.
-- **Distro packages**: AUR, .deb and .rpm.
+- **Distro packages**: AUR (packaged, not yet published) and .rpm.
 - **One model everywhere**: sync your fine-tune across your machines.
 
 ## Contributing
@@ -130,7 +139,7 @@ Open an issue before a large PR. [CONTRIBUTING.md](CONTRIBUTING.md) covers the a
 
 ## Credits
 
-- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models. The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
+- Speech recognition: [faster-whisper](https://github.com/SYSTRAN/faster-whisper) and [CTranslate2](https://github.com/OpenNMT/CTranslate2), with OpenAI's [Whisper](https://github.com/openai/whisper) models; [sherpa-onnx](https://github.com/k2-fsa/sherpa-onnx) with NVIDIA's [Parakeet-TDT](https://huggingface.co/nvidia/parakeet-tdt-0.6b-v2). The in-browser demo runs [Moonshine](https://github.com/usefulsensors/moonshine) through [transformers.js](https://github.com/huggingface/transformers.js).
 - Ideas borrowed with thanks: modifier release, paste keys and media pausing from [Voxtype](https://github.com/peteonrails/voxtype); the landing page's look from Romario Kavin's [KOLlateral](https://github.com/RomarioKavin1/kollateral).
 
 ## License

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/python_voiceio.egg-info/SOURCES.txt

@@ -65,12 +65,14 @@ tests/test_presence.py
 tests/test_prompt.py
 tests/test_quiet_audio.py
 tests/test_recorder_integration.py
+tests/test_report.py
 tests/test_retention.py
 tests/test_robustness.py
 tests/test_security_hardening.py
 tests/test_server.py
 tests/test_service.py
 tests/test_setup.py
+tests/test_sherpa.py
 tests/test_streaming.py
 tests/test_suggest.py
 tests/test_tokens.py
@@ -114,6 +116,7 @@ voiceio/privacy.py
 voiceio/prompt.py
 voiceio/quiet_audio.py
 voiceio/recorder.py
+voiceio/report.py
 voiceio/retention.py
 voiceio/service.py
 voiceio/streaming.py
@@ -142,6 +145,7 @@ voiceio/core/pipeline.py
 voiceio/core/decoders/__init__.py
 voiceio/core/decoders/base.py
 voiceio/core/decoders/catalog.py
+voiceio/core/decoders/fetch.py
 voiceio/core/decoders/lanes.py
 voiceio/core/decoders/sherpa.py
 voiceio/core/decoders/whispercpp.py

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/tests/test_config.py

@@ -98,7 +98,7 @@ def test_example_config_matches_defaults():
     import dataclasses
     from pathlib import Path
 
-    from voiceio.config import Config
+    from voiceio.config import Config, ModelConfig
     example = tomllib.loads(
         (Path(__file__).parent.parent / "config.example.toml").read_text())
     cfg = Config()
@@ -107,6 +107,11 @@ def test_example_config_matches_defaults():
         assert sec.name in example, f"[{sec.name}] missing from example"
         for f in dataclasses.fields(defaults):
             assert f.name in example[sec.name], f"{sec.name}.{f.name} missing"
+            if (sec.name, f.name) == ("model", "name"):
+                # "auto" resolves to the default decoder on construction
+                assert example["model"]["name"] == "auto"
+                assert ModelConfig(name="auto").name == defaults.name
+                continue
             assert example[sec.name][f.name] == getattr(defaults, f.name), \
                 f"{sec.name}.{f.name}: example differs from default"
     for name, section in example.items():

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/tests/test_decoders.py

@@ -3,7 +3,6 @@ from __future__ import annotations
 
 import io
 import json
-import sys
 import types
 
 import numpy as np
@@ -54,61 +53,6 @@ def test_whispercpp_errors_are_decode_errors(monkeypatch):
         dec.decode(np.zeros(1600, dtype=np.float32))
 
 
-def _fake_sherpa(monkeypatch, created):
-    class Stream:
-        def accept_waveform(self, sr, a):
-            self.n = len(a)
-
-        @property
-        def result(self):
-            return types.SimpleNamespace(text=" hello world ")
-
-    class Rec:
-        def create_stream(self):
-            return Stream()
-
-        def decode_stream(self, s):
-            pass
-
-    class OfflineRecognizer:
-        @staticmethod
-        def from_transducer(**kw):
-            created.append(kw)
-            return Rec()
-
-    monkeypatch.setitem(sys.modules, "sherpa_onnx",
-                        types.SimpleNamespace(OfflineRecognizer=OfflineRecognizer))
-
-
-def _model_dir(tmp_path):
-    for f in ("encoder.int8.onnx", "decoder.int8.onnx", "joiner.int8.onnx", "tokens.txt"):
-        (tmp_path / f).write_text("x")
-    return tmp_path
-
-
-def test_sherpa_greedy_declares_no_bias(monkeypatch, tmp_path):
-    created = []
-    _fake_sherpa(monkeypatch, created)
-    dec = build_decoder(ModelConfig(name=f"sherpa:{_model_dir(tmp_path)}"))
-    assert dec.capabilities.bias == BiasMode.NONE
-    assert dec.decode(np.zeros(16000, dtype=np.float32),
-                      bias=Bias(hotwords="Kalshi")).text == "hello world"
-    assert "hotwords_file" not in created[-1]
-
-
-def test_sherpa_mbs_passes_unbounded_hotwords(monkeypatch, tmp_path):
-    created = []
-    _fake_sherpa(monkeypatch, created)
-    dec = build_decoder(ModelConfig(name=f"sherpa:{_model_dir(tmp_path)}",
-                                    decoding="modified_beam_search"))
-    assert dec.capabilities.bias == BiasMode.UNBOUNDED
-    dec.decode(np.zeros(16000, dtype=np.float32), bias=Bias(hotwords="Kalshi, HyperNEAT"))
-    kw = created[-1]
-    assert kw["decoding_method"] == "modified_beam_search"
-    with open(kw["hotwords_file"]) as f:
-        assert f.read().split() == ["Kalshi", "HyperNEAT"]
-
-
 def test_lanes_share_the_thread_budget(monkeypatch):
     import voiceio.core.decoders.faster_whisper as tr
     from voiceio.core.decoders.faster_whisper.worker import auto_cpu_threads

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/tests/test_postprocess.py

@@ -70,6 +70,19 @@ class TestStripDisfluencies:
             "First para.\n\nSecond para."
         assert "\n\n" in strip_disfluencies("First para.\n\num\n\nSecond para.")
 
+    def test_filler_sentence_goes_with_its_full_stop(self):
+        # Parakeet writes a filler as a sentence of its own.
+        assert strip_disfluencies("escape them. Um. So on") == "escape them. So on"
+        assert strip_disfluencies("the scope of this? Um. I want") == "the scope of this? I want"
+        assert strip_disfluencies("Um. I want it") == "I want it"
+
+    def test_word_after_a_sentence_opening_filler_is_capitalized(self):
+        # Else "those. so I" reads as a false stop and cleanup makes it a comma.
+        assert strip_disfluencies("most of those. Um so I") == "most of those. So I"
+        assert strip_disfluencies("might be. Um uh yeah, and") == "might be. Yeah, and"
+        assert cleanup(strip_disfluencies("most of those. Um so I")) == "Most of those. So I"
+        assert strip_disfluencies("it was um uh good") == "it was good"
+
     def test_uh_huh_removed_whole(self):
         # Regression: ordering bug once stranded "-huh".
         assert strip_disfluencies("uh-huh right") == "right"

python_voiceio-1.12.0/tests/test_report.py

@@ -0,0 +1,314 @@
+"""`voiceio doctor --report` and the post-setup feedback line: what goes public."""
+from __future__ import annotations
+
+import io
+import json
+import sys
+
+import pytest
+
+from voiceio import report
+from voiceio.config import Config
+from voiceio.health import BackendStatus, HealthReport
+from voiceio.platform import Platform
+
+FAKE_HOME = "/home/zelda-tester"
+FAKE_USER = "zelda-tester"
+FAKE_HOST = "zeldas-thinkpad"
+
+
+@pytest.fixture
+def identity(monkeypatch):
+    """A fake user, home and hostname that must never reach a report."""
+    monkeypatch.setenv("HOME", FAKE_HOME)
+    monkeypatch.setenv("USER", FAKE_USER)
+    monkeypatch.setattr(report.getpass, "getuser", lambda: FAKE_USER)
+    monkeypatch.setattr(report.socket, "gethostname", lambda: FAKE_HOST)
+    monkeypatch.setattr(report._py_platform, "node", lambda: FAKE_HOST)
+    monkeypatch.setattr(report, "_homes", lambda: [FAKE_HOME])
+
+
+def _health(**kw) -> HealthReport:
+    defaults = dict(
+        platform=Platform(os="linux", display_server="wayland", desktop="gnome"),
+        hotkey_backends=[BackendStatus("evdev", True)],
+        typer_backends=[BackendStatus("ibus", True), BackendStatus("ydotool", False, "not installed")],
+        audio_ok=True, cli_in_path=True, tray_ok=True,
+    )
+    defaults.update(kw)
+    return HealthReport(**defaults)
+
+
+def _assert_private(text: str) -> None:
+    for secret in (FAKE_HOME, FAKE_USER, FAKE_HOST, "zelda"):
+        assert secret not in text.lower(), (secret, text)
+
+
+# ── scrubbing ──
+
+def test_scrub_removes_home_user_host_and_addresses(identity):
+    raw = (f"cannot open {FAKE_HOME}/.config/voiceio/x.toml as {FAKE_USER}@{FAKE_HOST}; "
+           "also /home/someoneelse/.cache, 192.168.1.40, fe80:0:0:0:1:2:3:4, "
+           "aa:bb:cc:dd:ee:ff, /dev/input/by-id/usb-Logitech_K120_SN12345-event-kbd, "
+           "ZELDA-TESTER shouted")
+    out = report.scrub(raw)
+    _assert_private(out)
+    for leaked in ("someoneelse", "192.168", "fe80", "aa:bb", "SN12345", "Logitech"):
+        assert leaked not in out
+    assert "~/.config/voiceio/x.toml" in out
+
+
+def test_scrub_keeps_versions_and_backend_names(identity):
+    out = report.scrub("voiceio 1.10.0.2 · ibus · python 3.12.3")
+    assert out == "voiceio 1.10.0.2 · ibus · python 3.12.3"
+
+
+def test_report_scrubs_check_messages_and_comment(identity):
+    health = _health(
+        hotkey_backends=[BackendStatus("evdev", False, f"{FAKE_HOME}/dev denied for {FAKE_USER}")],
+        audio_ok=False, audio_reason=f"device on {FAKE_HOST} busy",
+        warnings=[f"see {FAKE_HOME}/.local/state/voiceio/voiceio.log"],
+    )
+    text = report.build_report(health, comment=f"broke in {FAKE_HOME}/src, I'm {FAKE_USER}",
+                               cfg=Config())
+    _assert_private(text)
+    assert "failed: hotkey evdev: ~/dev denied" in text
+    assert "audio: device on <host> busy" in text
+    assert "comment: broke in ~/src" in text
+
+
+def test_report_contains_only_backend_and_model_names(identity):
+    cfg = Config()
+    cfg.model.name = f"{FAKE_HOME}/models/my-tune"
+    cfg.model.vocabulary_file = f"{FAKE_HOME}/vocab.txt"
+    cfg.cloud.api_key = "sk-secret"
+    cfg.hotkey.key = "ctrl+alt+zelda"
+    text = report.build_report(_health(), cfg=cfg)
+    _assert_private(text)
+    assert "sk-secret" not in text and "vocab" not in text and "ctrl+alt" not in text
+    assert "model: custom (local path)" in text
+    assert "hotkey evdev" in text and "typer ibus" in text
+    assert "fallbacks unavailable: ydotool" in text
+    assert "failed: none" in text
+    assert text.splitlines()[0].startswith("voiceio ")
+
+
+def test_report_lists_failures_and_warnings():
+    health = _health(typer_backends=[BackendStatus("ibus", False, "daemon down")],
+                     cli_in_path=False, tray_ok=False, tray_reason="no AppIndicator")
+    text = report.build_report(health, missing_deps=["portaudio"], perm_issues=2, cfg=Config())
+    assert "typer none" in text
+    assert "typer ibus: daemon down" in text
+    assert "missing system deps" in text
+    assert "cli not in PATH" in text and "tray: no AppIndicator" in text
+    assert "insecure permissions on 2 file(s)" in text
+
+
+def test_comment_is_one_bounded_line():
+    text = report.build_report(_health(), comment="a\nb\tc " + "x" * 1000, cfg=Config())
+    line = next(ln for ln in text.splitlines() if ln.startswith("comment:"))
+    assert line.startswith("comment: a b c x")
+    assert len(line) <= len("comment: ") + report.MAX_COMMENT
+
+
+# ── posting ──
+
+class _Resp(io.BytesIO):
+    def __enter__(self):
+        return self
+
+    def __exit__(self, *a):
+        return False
+
+
+def test_post_success_reads_receipt(monkeypatch):
+    seen = []
+
+    def fake(url, timeout):
+        seen.append((url, timeout))
+        return _Resp(json.dumps({"ok": True, "receipt": {"id": "r123"}}).encode())
+
+    monkeypatch.setattr(report, "_urlopen", fake)
+    assert report.post("hello world") == (True, "r123")
+    url, timeout = seen[0]
+    assert url.startswith(report.POST_URL + "?")
+    assert "text=hello+world" in url and "format=json" in url and "request_id=voiceio-" in url
+    assert timeout <= 10
+
+
+@pytest.mark.parametrize("body", [b'{"ok": false, "error": "rate limited"}', b"[]", b"not json",
+                                  b'{"ok": true}'])
+def test_post_bad_response_is_failure(monkeypatch, body):
+    monkeypatch.setattr(report, "_urlopen", lambda url, timeout: _Resp(body))
+    ok, why = report.post("x")
+    assert not ok and why
+
+
+def test_post_network_error_never_raises():
+    # conftest refuses every connection: this is the offline path.
+    ok, why = report.post("x")
+    assert not ok and "ConnectionRefused" in why
+
+
+# ── confirm / --yes / no TTY ──
+
+@pytest.fixture
+def posted(monkeypatch):
+    calls: list[str] = []
+    monkeypatch.setattr(report, "post", lambda text: (calls.append(text), (True, "r1"))[1])
+    return calls
+
+
+def _tty(monkeypatch, tty: bool):
+    monkeypatch.setattr(report, "_interactive", lambda: tty)
+
+
+def test_share_asks_and_posts_on_yes(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda prompt: "y")
+    assert report.share("the report") is True
+    out = capsys.readouterr().out
+    assert "PUBLICLY" in out and "the report" in out and report.BOARD_URL in out
+    assert posted == ["the report"]
+
+
+@pytest.mark.parametrize("answer", ["", "n", "no", "whatever"])
+def test_share_defaults_to_no(monkeypatch, capsys, posted, answer):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda prompt: answer)
+    assert report.share("r") is False
+    assert posted == []
+
+
+def test_share_eof_is_no(monkeypatch, posted):
+    _tty(monkeypatch, True)
+
+    def eof(prompt):
+        raise EOFError
+
+    monkeypatch.setattr("builtins.input", eof)
+    assert report.share("r") is False and posted == []
+
+
+def test_share_without_tty_prints_but_never_posts(monkeypatch, capsys, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    assert report.share("the report") is False
+    out = capsys.readouterr().out
+    assert "the report" in out and "--yes" in out
+    assert posted == []
+
+
+def test_share_yes_skips_prompt(monkeypatch, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    assert report.share("r", yes=True) is True and posted == ["r"]
+
+
+def test_share_failure_is_reported_not_raised(monkeypatch, capsys):
+    assert report.share("r", yes=True) is False
+    assert "Could not confirm the post" in capsys.readouterr().out
+
+
+# ── CLI wiring ──
+
+@pytest.fixture
+def doctor_env(monkeypatch, identity):
+    from voiceio import config, health
+    from voiceio import platform as plat
+    monkeypatch.setattr(health, "check_health", lambda: _health(
+        warnings=[f"something at {FAKE_HOME}/.config"]))
+    monkeypatch.setattr(health, "format_report", lambda r: "DOCTOR OUTPUT")
+    monkeypatch.setattr(health, "usage_findings", lambda: [])
+    monkeypatch.setattr(plat, "check_system_deps", lambda: [])
+    monkeypatch.setattr(config, "check_permissions", lambda: [])
+    monkeypatch.setattr("voiceio.hints.hint", lambda *a, **k: None)
+
+
+def _doctor(monkeypatch, capsys, *argv):
+    from voiceio.cli import main
+    monkeypatch.setattr(sys, "argv", ["voiceio", "doctor", *argv])
+    with pytest.raises(SystemExit):
+        main()
+    return capsys.readouterr().out
+
+
+def test_doctor_report_yes_posts_scrubbed_comment(monkeypatch, capsys, doctor_env, posted):
+    out = _doctor(monkeypatch, capsys, "--report", "--yes",
+                  "--comment", f"worked, {FAKE_USER} here")
+    assert len(posted) == 1
+    _assert_private(posted[0])
+    _assert_private(out)
+    assert "comment: worked, <user> here" in posted[0]
+    assert report.BOARD_URL in out
+
+
+def test_doctor_report_without_tty_or_yes_does_not_post(monkeypatch, capsys, doctor_env, posted):
+    _tty(monkeypatch, False)
+    out = _doctor(monkeypatch, capsys, "--report")
+    assert posted == []
+    assert "voiceio " in out and "Not posted" in out
+
+
+def test_doctor_without_report_never_posts(monkeypatch, capsys, doctor_env, posted):
+    out = _doctor(monkeypatch, capsys)
+    assert posted == [] and "PUBLICLY" not in out
+
+
+# ── after setup ──
+
+def test_after_setup_enter_skips_silently(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda p: "")
+    monkeypatch.setattr(report, "gather", lambda c: pytest.fail("no checks on skip"))
+    report.offer_after_setup()
+    assert posted == [] and "PUBLICLY" not in capsys.readouterr().out
+
+
+def test_after_setup_comment_is_shown_confirmed_and_posted(monkeypatch, capsys, posted):
+    _tty(monkeypatch, True)
+    answers = iter(["went fine", "y"])
+    monkeypatch.setattr("builtins.input", lambda p: next(answers))
+    monkeypatch.setattr(report, "gather", lambda c: (None, f"voiceio x report\ncomment: {c}"))
+    report.offer_after_setup()
+    assert posted == ["voiceio x report\ncomment: went fine"]
+
+
+def test_after_setup_never_raises(monkeypatch, capsys):
+    _tty(monkeypatch, True)
+    monkeypatch.setattr("builtins.input", lambda p: "it broke")
+
+    def boom(c):
+        raise RuntimeError("probe exploded")
+
+    monkeypatch.setattr(report, "gather", boom)
+    report.offer_after_setup()  # must not raise
+    assert "Skipped" in capsys.readouterr().out
+
+
+def test_after_setup_needs_a_terminal(monkeypatch, posted):
+    _tty(monkeypatch, False)
+    monkeypatch.setattr("builtins.input", lambda p: pytest.fail("must not prompt"))
+    report.offer_after_setup()
+    assert posted == []
+
+
+def test_setup_wizard_offers_the_report(monkeypatch):
+    from voiceio.cli import main
+    calls = []
+    monkeypatch.setattr("voiceio.setup.run_wizard", lambda: calls.append("wizard"))
+    monkeypatch.setattr(report, "offer_after_setup", lambda: calls.append("offer"))
+    monkeypatch.setattr("voiceio.hints.hint", lambda *a, **k: None)
+    monkeypatch.setattr(sys, "argv", ["voiceio", "setup"])
+    main()
+    assert calls == ["wizard", "offer"]
+
+
+def test_network_guard_blocks_real_hosts():
+    import socket
+    s = socket.socket()
+    try:
+        with pytest.raises(ConnectionRefusedError):
+            s.connect(("93.184.216.34", 443))
+    finally:
+        s.close()

{python_voiceio-1.10.0 → python_voiceio-1.12.0}/tests/test_service.py

@@ -25,6 +25,28 @@ def test_install_symlinks_relinks_and_drops_legacy(monkeypatch, tmp_path):
     assert not (local_bin / "voiceio-doctor").is_symlink()
 
 
+def test_packaged_install_links_nothing_and_serves_its_own_bin(monkeypatch, tmp_path):
+    prefix = tmp_path / "usr-lib-voiceio"
+    (prefix / "bin").mkdir(parents=True)
+    (prefix / "bin" / "voiceio").write_text("#!/bin/sh\n")
+    (prefix / service.PACKAGED_MARKER).write_text("deb\n")
+    local_bin = tmp_path / "local-bin"
+    monkeypatch.setattr(service, "LOCAL_BIN", local_bin)
+    monkeypatch.setattr(sys, "prefix", str(prefix))
+
+    assert service.packaged_by() == "deb"
+    assert service.package_remove_cmd() == "sudo apt remove voiceio"
+    service.install_symlinks()
+    assert not local_bin.exists()
+    # The unit's ExecStart is the package's own path, stable across upgrades.
+    assert service._find_voiceio_bin() == str((prefix / "bin" / "voiceio").resolve())
+
+
+def test_unpackaged_install_has_no_package(monkeypatch, tmp_path):
+    monkeypatch.setattr(sys, "prefix", str(tmp_path))
+    assert service.packaged_by() is None and service.package_remove_cmd() is None
+
+
 def test_learn_timer_runs_maintain_at_idle_priority(monkeypatch, tmp_path):
     calls = []
     monkeypatch.setattr(service, "has_systemd", lambda: True)