Files
voculinux/tests/test_autostart_manager.py
T
Jatin K MalikandGitHub 3deb523efd feat(flatpak): add Flatpak packaging for universal distribution (#484)
* feat(flatpak): add Flatpak packaging for universal distribution

Adds a Flathub-ready Flatpak for the whisper.cpp engine, plus the minimal
runtime adaptations Flatpak actually needs — deliberately scoped down from the
earlier attempts (#416, #428), which bundled unrelated whisper.cpp GPU, audio,
and clipboard changes.

Packaging (packaging/flatpak/):
- app manifest, AppStream metainfo, and desktop entry (com.vocalinux.Vocalinux)
- generated offline Python dependency modules (flatpak-pip-generator)
- bundled shared modules: PortAudio, libayatana-appindicator, xdotool, xsel

Runtime changes (Flatpak-only, behaviour unchanged outside a sandbox):
- utils/paths.py: honour XDG_CONFIG_HOME/XDG_DATA_HOME so config, models and
  runtime data live under ~/.var/app/<app-id> in the sandbox
- autostart uses `flatpak run <app-id>` (the host launcher is always on PATH)
- text injection and keyboard backend detect a Wayland host reached via XWayland
  (no Wayland socket granted) and route through xdotool / pynput-on-X11
- tray indicator references the exported `<app-id>-*` host icon theme names

Also: a CI workflow building x86_64 + aarch64 bundles, and README / packaging
README / distro-compatibility doc updates.

Verified with a full flatpak-builder build + bundle install on aarch64:
pywhispercpp loads its native libraries without LD_LIBRARY_PATH, XDG paths
redirect correctly, bundled tools are present, and the entrypoint runs.
Manifest and builddir lint are clean and AppStream metadata validates.

Closes #167

* chore(flatpak): sync metainfo version to 0.14.0-beta

Also ignore flatpak-build-dir/ so local builder output stays untracked.

* refactor(flatpak): trim docs and comments after ponytail review

Drop redundant packaging README command blocks, shrink path/tray/autostart
comments, and stop ignoring a non-canonical build-dir name.

* fix(flatpak): close readiness gaps for v0.14.0-beta

Route log files through XDG data dirs so Flatpak keeps them under
~/.var/app, refresh AppStream screenshots to vocalinux.com, and use
the SPDX GPL-3.0-only license id.

* fix(flatpak): enable global hotkeys via evdev and --device=input

pynput over XWayland only receives keys for the focused X client. Prefer
evdev inside Flatpak and grant /dev/input so shortcuts work app-wide.

* fix(flatpak): inject text with ydotool/uinput on Wayland

xdotool only reaches XWayland clients, so typing appeared to succeed but
never hit native apps. Ship ydotool, grant --device=all for uinput, start
ydotoold on demand, and type via uinput inside the Flatpak.

* fix(flatpak): paste via wl-copy + Ctrl+V instead of typing

ydotool type injects character-by-character. Ship wl-clipboard, grant
--socket=wayland, and prefer clipboard paste for instant insertion.

* test(text-injection): expect ydotool default key-delay of 2

Matches the shipped VOCALINUX_YDOTOOL_KEY_DELAY default used when
clipboard paste falls back to character typing.
2026-07-16 00:03:30 -07:00

71 lines
3.3 KiB
Python

import tempfile
import unittest
from pathlib import Path
from unittest.mock import patch
from vocalinux.ui import autostart_manager
class TestAutostartManager(unittest.TestCase):
def test_get_autostart_dir_uses_xdg_config_home(self):
with patch.dict("os.environ", {"XDG_CONFIG_HOME": "/tmp/vlx-config"}, clear=False):
autostart_dir = autostart_manager.get_autostart_dir()
self.assertEqual(autostart_dir, Path("/tmp/vlx-config") / "autostart")
def test_get_exec_command_prefers_installed_command(self):
with patch(
"vocalinux.ui.autostart_manager.shutil.which",
return_value="/usr/bin/vocalinux",
):
command = autostart_manager.get_exec_command()
self.assertEqual(command, "/usr/bin/vocalinux --start-minimized")
def test_get_exec_command_falls_back_to_python_module(self):
with (
patch("vocalinux.ui.autostart_manager.shutil.which", return_value=None),
patch("vocalinux.ui.autostart_manager.sys.executable", "/usr/bin/python3"),
patch("vocalinux.ui.autostart_manager.sys.frozen", new=False, create=True),
):
command = autostart_manager.get_exec_command()
self.assertEqual(command, "/usr/bin/python3 -m vocalinux.main --start-minimized")
def test_get_exec_command_flatpak_uses_flatpak_run(self):
# Inside a Flatpak the host session manager must use the flatpak launcher,
# which is always on PATH, rather than /app/bin/vocalinux.
with patch.dict("os.environ", {"FLATPAK_ID": "com.vocalinux.Vocalinux"}, clear=False):
command = autostart_manager.get_exec_command()
self.assertEqual(command, "flatpak run com.vocalinux.Vocalinux --start-minimized")
def test_enable_autostart_flatpak_writes_flatpak_run_exec(self):
with tempfile.TemporaryDirectory() as tmp_dir:
with patch.dict(
"os.environ",
{"XDG_CONFIG_HOME": tmp_dir, "FLATPAK_ID": "com.vocalinux.Vocalinux"},
clear=False,
):
self.assertTrue(autostart_manager.enable_autostart())
desktop_file = Path(tmp_dir) / "autostart" / "vocalinux.desktop"
content = desktop_file.read_text(encoding="utf-8")
self.assertIn("Exec=flatpak run com.vocalinux.Vocalinux --start-minimized", content)
def test_enable_disable_autostart_creates_and_removes_entry(self):
with tempfile.TemporaryDirectory() as tmp_dir:
with (
patch.dict("os.environ", {"XDG_CONFIG_HOME": tmp_dir}, clear=False),
patch(
"vocalinux.ui.autostart_manager.shutil.which",
return_value="/usr/bin/vocalinux",
),
):
enabled = autostart_manager.enable_autostart()
self.assertTrue(enabled)
desktop_file = Path(tmp_dir) / "autostart" / "vocalinux.desktop"
self.assertTrue(desktop_file.exists())
content = desktop_file.read_text(encoding="utf-8")
self.assertIn("Exec=/usr/bin/vocalinux --start-minimized", content)
disabled = autostart_manager.disable_autostart()
self.assertTrue(disabled)
self.assertFalse(desktop_file.exists())