stackops 26.7__tar.gz → 26.7.1__tar.gz

{stackops-26.7/src/stackops.egg-info → stackops-26.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 26.7
+Version: 26.7.1
 Summary: Developer Stack Manager
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{stackops-26.7 → stackops-26.7.1}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "26.7"
+version = "26.7.1"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -77,6 +77,7 @@ dev = [
     "ipdb>=0.13.13",
     "ipykernel>=7.3.0",
     "ipython>=9.15.0",
+    "jsonschema>=4.26.0",
     "kaleido>=1.3.0",
     "marimo>=0.23.11",
     "matplotlib>=3.11.0",

stackops-26.7.1/src/stackops/jobs/installer/linux_scripts/__init__.py

@@ -0,0 +1,4 @@
+NETWORK_PATH_REFERENCE = "network.sh"
+NGROK_PATH_REFERENCE = "ngrok.sh"
+Q_PATH_REFERENCE = "q.sh"
+SYSABC_MACOS_PATH_REFERENCE = "sysabc_macos.sh"

{stackops-26.7 → stackops-26.7.1}/src/stackops/jobs/installer/linux_scripts/ngrok.sh

@@ -2,5 +2,5 @@ curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc \
   | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null \
   && echo "deb https://ngrok-agent.s3.amazonaws.com bookworm main" \
   | sudo tee /etc/apt/sources.list.d/ngrok.list \
-  && sudo apt update \
-  && sudo apt install ngrok
+  && sudo apt-get update \
+  && sudo apt-get install -y ngrok

stackops-26.7.1/src/stackops/jobs/installer/python_scripts/brave.py

@@ -0,0 +1,117 @@
+"""brave installer"""
+
+import platform
+from typing import TYPE_CHECKING
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+from stackops.utils.code import run_shell_script
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.meta import print_code
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match (distribution.distribution_id, distribution.package_manager):
+        case ("alpine", "apk"):
+            raise NotImplementedError("Brave Browser does not publish an Alpine Linux APK package.")
+        case (unsupported_distribution_id, "apk"):
+            raise ValueError(f"Invalid package-manager metadata for Linux distribution '{unsupported_distribution_id}': manager=apk")
+        case (_, "apt"):
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y curl
+
+echo "🔐 Adding Brave's official signing key and repository..."
+sudo curl -fsSLo /usr/share/keyrings/brave-browser-archive-keyring.gpg https://brave-browser-apt-release.s3.brave.com/brave-browser-archive-keyring.gpg
+sudo curl -fsSLo /etc/apt/sources.list.d/brave-browser-release.sources https://brave-browser-apt-release.s3.brave.com/brave-browser.sources
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y brave-browser"
+        case ("fedora", "dnf"):
+            repository_setup = """
+echo "📥 Installing DNF repository prerequisites..."
+sudo dnf install -y dnf-plugins-core
+
+echo "📝 Adding Brave's official Fedora repository..."
+sudo dnf config-manager addrepo --from-repofile=https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
+"""
+            install_command = "sudo dnf install -y brave-browser"
+        case ("rhel" | "rocky" | "centos", "dnf"):
+            repository_setup = """
+echo "📥 Installing DNF repository prerequisites..."
+sudo dnf install -y dnf-plugins-core
+
+echo "📝 Adding Brave's official RPM repository..."
+sudo dnf config-manager --add-repo https://brave-browser-rpm-release.s3.brave.com/brave-browser.repo
+"""
+            install_command = "sudo dnf install -y brave-browser"
+        case (unsupported_distribution_id, "dnf"):
+            raise NotImplementedError(
+                "Brave's official RPM instructions do not support Linux distribution "
+                f"'{unsupported_distribution_id}'. Supported RPM distributions: fedora, rhel, rocky, centos."
+            )
+        case ("arch", "pacman"):
+            raise NotImplementedError("Brave Browser is only available through the AUR on Arch Linux; pacman cannot install it.")
+        case (unsupported_distribution_id, "pacman"):
+            raise ValueError(f"Invalid package-manager metadata for Linux distribution '{unsupported_distribution_id}': manager=pacman")
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "🦁 Installing Brave on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Brave Browser..."
+{install_command}
+
+echo "✅ Brave Browser installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    console = Console()
+    _ = installer_data, update
+    system = platform.system()
+    console.print(
+        Panel.fit(
+            "\n".join([f"💻 Platform: {system}", f"🔄 Version: {'latest' if version is None else version}"]),
+            title="🦁 Brave Browser Installer",
+            border_style="orange1",
+            box=box.ROUNDED,
+        )
+    )
+
+    match system:
+        case "Windows":
+            console.print("🪟 Installing Brave Browser on Windows using winget...", style="bold")
+            program = """
+winget install --no-upgrade --name "Brave" --Id "Brave.Brave" --source winget --scope user --accept-package-agreements --accept-source-agreements
+"""
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            console.print(f"🐧 Installing Brave Browser on {distribution.distribution_id} with its official repository...", style="bold")
+            program = _build_linux_install_script(distribution)
+        case "Darwin":
+            console.print("🍎 Installing Brave Browser on macOS...", style="bold")
+            program = "brew install --cask brave-browser"
+        case _:
+            error_msg = f"Unsupported platform: {system}"
+            console.print(Panel.fit(error_msg, title="❌ Error", subtitle="⚠️ Unsupported platform", border_style="red", box=box.ROUNDED))
+            raise NotImplementedError(error_msg)
+
+    print_code(code=program, lexer="shell", desc="Installation Script Preview")
+    result = run_shell_script(program, display_script=True, clean_env=False)
+    if result.returncode != 0:
+        raise RuntimeError(f"Brave Browser installation failed with exit code {result.returncode}")
+    console.print("✅ Installation completed successfully!", style="bold green")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main
+    pass

stackops-26.7.1/src/stackops/jobs/installer/python_scripts/cloudflare_warp_cli.py

@@ -0,0 +1,84 @@
+import platform
+import subprocess
+from typing import TYPE_CHECKING
+
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match (distribution.distribution_id, distribution.package_manager):
+        case ("alpine", "apk"):
+            raise NotImplementedError("Cloudflare WARP does not publish an Alpine Linux APK repository or package.")
+        case ("ubuntu" | "debian", "apt"):
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y curl gpg lsb-release
+
+echo "🔐 Adding Cloudflare's current signing key..."
+curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | sudo gpg --yes --dearmor --output /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg
+
+echo "📝 Adding Cloudflare's APT repository..."
+echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/cloudflare-client.list > /dev/null
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y cloudflare-warp"
+        case ("fedora", "dnf"):
+            repository_setup = """
+echo "📥 Installing RPM repository prerequisites..."
+sudo dnf install -y curl
+
+echo "🔐 Importing Cloudflare's current signing key..."
+sudo rpm --import https://pkg.cloudflareclient.com/pubkey.gpg
+
+echo "📝 Adding Cloudflare's RPM repository..."
+sudo curl -fsSLo /etc/yum.repos.d/cloudflare-warp.repo https://pkg.cloudflareclient.com/cloudflare-warp-ascii.repo
+sudo dnf makecache --refresh
+"""
+            install_command = "sudo dnf install -y cloudflare-warp"
+        case ("rhel" | "centos", "dnf"):
+            raise NotImplementedError("Cloudflare WARP on RHEL and CentOS requires an explicit, version-specific EPEL setup.")
+        case (unsupported_distribution_id, _):
+            raise NotImplementedError(
+                "Cloudflare's package repository does not support Linux distribution "
+                f"'{unsupported_distribution_id}'. Supported without extra repositories: ubuntu, debian, fedora."
+            )
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "🔒 Installing Cloudflare WARP on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Cloudflare WARP..."
+{install_command}
+
+echo "📡 Registering the WARP client..."
+warp-cli registration new
+
+echo "✅ Cloudflare WARP installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> str:
+    _ = installer_data, version, update
+    system = platform.system()
+    match system:
+        case "Windows":
+            raise NotImplementedError("Installer is not yet implemented for Windows.")
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            program = _build_linux_install_script(distribution)
+        case "Darwin":
+            program = "brew install --cask cloudflare-warp"
+        case _:
+            raise NotImplementedError(f"Unsupported platform: {system}")
+    subprocess.run(["bash", "-c", program], text=True, check=True)
+    return f"Cloudflare WARP CLI installed successfully on {system}."
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main

stackops-26.7.1/src/stackops/jobs/installer/python_scripts/code.py

@@ -0,0 +1,117 @@
+"""vs code installer as per https://code.visualstudio.com/docs/setup/linux"""
+
+import platform
+from typing import TYPE_CHECKING, assert_never
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+from stackops.utils.code import run_shell_script
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _build_linux_install_script(distribution: LinuxDistribution) -> str:
+    match distribution.package_manager:
+        case "apk":
+            raise NotImplementedError("Microsoft Visual Studio Code does not publish an Alpine Linux APK repository or package.")
+        case "apt":
+            repository_setup = """
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y wget gpg
+
+echo "🔐 Adding Microsoft's signing key..."
+wget -qO- https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --yes --dearmor -o /usr/share/keyrings/microsoft.gpg
+
+echo "📝 Adding Microsoft's VS Code repository..."
+sudo tee /etc/apt/sources.list.d/vscode.sources > /dev/null <<'EOF'
+Types: deb
+URIs: https://packages.microsoft.com/repos/code
+Suites: stable
+Components: main
+Architectures: amd64,arm64,armhf
+Signed-By: /usr/share/keyrings/microsoft.gpg
+EOF
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y code"
+        case "dnf":
+            repository_setup = """
+echo "🔐 Importing Microsoft's signing key..."
+sudo rpm --import https://packages.microsoft.com/keys/microsoft.asc
+
+echo "📝 Adding Microsoft's VS Code repository..."
+sudo tee /etc/yum.repos.d/vscode.repo > /dev/null <<'EOF'
+[code]
+name=Visual Studio Code
+baseurl=https://packages.microsoft.com/yumrepos/vscode
+enabled=1
+autorefresh=1
+type=rpm-md
+gpgcheck=1
+gpgkey=https://packages.microsoft.com/keys/microsoft.asc
+EOF
+sudo dnf makecache --refresh
+"""
+            install_command = "sudo dnf install -y code"
+        case "pacman":
+            raise NotImplementedError("Microsoft Visual Studio Code is only available through the AUR on Arch Linux; pacman cannot install it.")
+        case _:
+            assert_never(distribution.package_manager)
+
+    return f"""#!/usr/bin/env bash
+set -euo pipefail
+
+echo "💻 Installing VS Code on {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 Installing Visual Studio Code..."
+{install_command}
+
+echo "✅ Visual Studio Code installation completed"
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    console = Console()
+    _ = installer_data, update
+    system = platform.system()
+    console.print(
+        Panel.fit(
+            "\n".join([f"🖥️  Platform: {system}", f"🔄 Version: {'latest' if version is None else version}"]),
+            title="💻 VS Code Installer",
+            border_style="blue",
+            box=box.ROUNDED,
+        )
+    )
+
+    match system:
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            console.print(f"🐧 Installing VS Code on {distribution.distribution_id} with Microsoft's official repository...", style="bold")
+            install_script = _build_linux_install_script(distribution)
+        case "Darwin":
+            console.print("🍎 Installing VS Code on macOS using Homebrew...", style="bold")
+            install_script = "brew install --cask visual-studio-code"
+        case "Windows":
+            console.print("🪟 Installing VS Code on Windows using winget...", style="bold")
+            install_script = """
+winget install --no-upgrade --name "Microsoft Visual Studio Code" --Id "Microsoft.VisualStudioCode" --source winget --scope user --accept-package-agreements --accept-source-agreements
+"""
+        case _:
+            error_msg = f"Unsupported platform: {system}"
+            console.print(Panel.fit(error_msg, title="❌ Error", subtitle="⚠️ Unsupported platform", border_style="red", box=box.ROUNDED))
+            raise NotImplementedError(error_msg)
+
+    result = run_shell_script(install_script, display_script=True, clean_env=False)
+    if result.returncode != 0:
+        raise RuntimeError(f"VS Code installation failed with exit code {result.returncode}")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main
+    pass

stackops-26.7.1/src/stackops/jobs/installer/python_scripts/docker.py

@@ -0,0 +1,192 @@
+import platform
+from typing import TYPE_CHECKING
+
+from rich import box
+from rich.console import Console
+from rich.panel import Panel
+
+from stackops.utils.code import run_shell_script
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
+from stackops.utils.installer_utils.linux_package_manager import LinuxDistribution, detect_current_linux_distribution
+from stackops.utils.meta import print_code
+from stackops.utils.schemas.installer.installer_types import InstallerData
+
+
+def _get_linux_install_script(distribution: LinuxDistribution) -> str:
+    match (distribution.distribution_id, distribution.package_manager):
+        case ("alpine", "apk"):
+            repository_setup = """
+echo "📦 Using Alpine Linux's official repositories..."
+""".strip()
+            install_command = "sudo apk add --no-cache"
+            package_names = "docker docker-cli-compose"
+        case (("ubuntu" | "debian") as distribution_id, "apt"):
+            match distribution_id:
+                case "ubuntu":
+                    suite_expression = "${UBUNTU_CODENAME:-$VERSION_CODENAME}"
+                case "debian":
+                    suite_expression = "$VERSION_CODENAME"
+            repository_url = f"https://download.docker.com/linux/{distribution_id}"
+            repository_setup = f"""
+echo "📥 Installing APT repository prerequisites..."
+sudo apt-get update
+sudo apt-get install -y ca-certificates curl
+
+echo "🔐 Adding Docker's official signing key..."
+sudo install -m 0755 -d /etc/apt/keyrings
+sudo curl -fsSL "{repository_url}/gpg" -o /etc/apt/keyrings/docker.asc
+sudo chmod a+r /etc/apt/keyrings/docker.asc
+
+echo "📝 Adding Docker's official {distribution_id} repository..."
+sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
+Types: deb
+URIs: {repository_url}
+Suites: $(. /etc/os-release && echo "{suite_expression}")
+Components: stable
+Architectures: $(dpkg --print-architecture)
+Signed-By: /etc/apt/keyrings/docker.asc
+EOF
+sudo apt-get update
+"""
+            install_command = "sudo apt-get install -y"
+            package_names = "docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin"
+        case (("rhel" | "centos" | "ol") as distribution_id, "dnf"):
+            repository_distribution_id = "rhel" if distribution_id == "ol" else distribution_id
+            repository_url = f"https://download.docker.com/linux/{repository_distribution_id}/docker-ce.repo"
+            repository_setup = f"""
+echo "📥 Installing DNF repository prerequisites..."
+sudo dnf -y install dnf-plugins-core
+
+echo "📝 Adding Docker's official {repository_distribution_id} repository for {distribution_id}..."
+sudo dnf config-manager --add-repo "{repository_url}"
+"""
+            install_command = "sudo dnf install -y"
+            package_names = "docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin"
+        case ("fedora", "dnf"):
+            repository_setup = """
+echo "📝 Adding Docker's official fedora repository..."
+sudo dnf config-manager addrepo --from-repofile "https://download.docker.com/linux/fedora/docker-ce.repo"
+"""
+            install_command = "sudo dnf install -y"
+            package_names = "docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin"
+        case ("arch", "pacman"):
+            repository_setup = """
+echo "📦 Using Arch Linux's official repositories..."
+""".strip()
+            install_command = "sudo pacman -S --needed --noconfirm"
+            package_names = "docker docker-buildx docker-compose"
+        case ("alpine" | "arch" | "ubuntu" | "debian" | "rhel" | "fedora" | "centos" | "ol", _):
+            raise ValueError(
+                f"Invalid package-manager metadata for Linux distribution '{distribution.distribution_id}': manager={distribution.package_manager}"
+            )
+        case (unsupported_distribution_id, _):
+            raise NotImplementedError(
+                "Docker Engine's official repositories do not support Linux distribution "
+                f"'{unsupported_distribution_id}'. Supported distributions: alpine, arch, ubuntu, debian, rhel, fedora, centos, ol."
+            )
+
+    match distribution.package_manager:
+        case "apk":
+            service_setup = """sudo rc-update add docker default
+sudo rc-service docker start"""
+            add_user_to_group = 'sudo addgroup "$(id -un)" docker'
+        case "apt" | "dnf" | "pacman":
+            service_setup = "sudo systemctl enable --now docker"
+            add_user_to_group = 'sudo usermod -aG docker "$(id -un)"'
+
+    return f"""
+set -euo pipefail
+
+echo "🐧 Installing Docker Engine for {distribution.distribution_id} with {distribution.package_manager}"
+{repository_setup}
+
+echo "📦 INSTALLATION | Installing Docker packages"
+{install_command} {package_names}
+
+echo "⚙️ Enabling and starting Docker system service..."
+{service_setup}
+
+echo "👥 Adding current user to docker group..."
+{add_user_to_group}
+
+echo "🧪 Testing Docker installation with hello-world..."
+sudo docker run hello-world
+
+echo "✅ Docker installation completed"
+echo "ℹ️ Log out and back in, or run 'newgrp docker', before using Docker without sudo."
+"""
+
+
+def _get_darwin_install_script() -> str:
+    return """
+set -euo pipefail
+
+echo "🍎 DETECTING SYSTEM | Preparing macOS Docker installation"
+
+if ! command -v brew >/dev/null 2>&1; then
+    echo "❌ Homebrew is required to install Docker on macOS."
+    exit 1
+fi
+
+echo "🔄 Updating Homebrew..."
+brew update
+
+echo "📥 Installing Docker CLI packages..."
+brew install docker docker-buildx docker-compose
+brew install colima
+# colima start
+
+echo "✅ Docker installation completed"
+echo "ℹ️ This installs the Docker CLI only. You still need a reachable Docker daemon, such as a remote host or a separate local runtime."
+"""
+
+
+def main(installer_data: InstallerData, version: str | None, update: bool) -> None:
+    console = Console()
+    _ = installer_data, update
+    console.print(
+        Panel.fit(
+            "\n".join([f"💻 Platform: {platform.system()}", f"🔄 Version: {'latest' if version is None else version}"]),
+            title="🐳 Docker Installer",
+            border_style="blue",
+            box=box.ROUNDED,
+        )
+    )
+
+    match platform.system():
+        case "Linux":
+            distribution = detect_current_linux_distribution()
+            console.print(f"🐧 Installing Docker on {distribution.distribution_id} with Docker's official repository...", style="bold")
+            program = _get_linux_install_script(distribution=distribution)
+        case "Darwin":
+            console.print("🍎 Installing Docker CLI on macOS with Homebrew...", style="bold")
+            program = _get_darwin_install_script()
+        case "Windows":
+            error_msg = "Docker installation is not supported on Windows through this installer"
+            console.print(
+                Panel.fit(
+                    "\n".join([error_msg, "💡 Use Docker Desktop directly or install through a Windows-specific installer entry."]),
+                    title="❌ Error",
+                    subtitle="⚠️ Unsupported platform",
+                    border_style="red",
+                    box=box.ROUNDED,
+                )
+            )
+            raise NotImplementedError(error_msg)
+        case _:
+            error_msg = f"Unsupported platform: {platform.system()}"
+            console.print(Panel.fit(error_msg, title="❌ Error", subtitle="⚠️ Unsupported platform", border_style="red", box=box.ROUNDED))
+            raise NotImplementedError(error_msg)
+
+    print_code(code=program, lexer="shell", desc="Installation Script Preview")
+    result = run_shell_script(program, display_script=True, clean_env=False)
+    if result.returncode != 0:
+        console.print(f"❌ Docker installation failed with exit code {result.returncode}", style="bold red")
+        raise RuntimeError(f"Docker installation failed with exit code {result.returncode}")
+    console.print("✅ Docker installation completed successfully", style="bold green")
+
+
+if __name__ == "__main__":
+    if TYPE_CHECKING:
+        _main_protocol_check: InstallerPythonScriptMain = main
+    pass

{stackops-26.7 → stackops-26.7.1}/src/stackops/jobs/installer/python_scripts/espanso.py

@@ -11,12 +11,11 @@ from rich import box
 from rich.console import Console
 from rich.panel import Panel
 
-from stackops.utils.installer_utils.installer_main_protocol import (
-    InstallerPythonScriptMain,
-)
+from stackops.utils.installer_utils.installer_main_protocol import InstallerPythonScriptMain
 from stackops.utils.installer_utils.installer_class import Installer
 from stackops.utils.schemas.installer.installer_types import (
     CPU_ARCHITECTURES,
+    InstallerFileNamePatterns,
     OPERATING_SYSTEMS,
     InstallerData,
     get_normalized_arch,
@@ -29,19 +28,8 @@ ESPANSO_WINDOWS_PORTABLE_ASSET = "Espanso-Win-Portable-x86_64.zip"
 ESPANSO_MACOS_UNIVERSAL_ASSET = "Espanso-Mac-Universal.zip"
 
 
-def _empty_file_name_pattern() -> dict[CPU_ARCHITECTURES, dict[OPERATING_SYSTEMS, str | None]]:
-    return {
-        "amd64": {
-            "linux": None,
-            "windows": None,
-            "darwin": None,
-        },
-        "arm64": {
-            "linux": None,
-            "windows": None,
-            "darwin": None,
-        },
-    }
+def _empty_file_name_pattern() -> InstallerFileNamePatterns:
+    return {"amd64": {"linux": None, "windows": None, "darwin": None}, "arm64": {"linux": None, "windows": None, "darwin": None}}
 
 
 def _resolve_linux_asset_name(current_arch: CPU_ARCHITECTURES, xdg_session_type: str) -> str:
@@ -53,10 +41,7 @@ def _resolve_linux_asset_name(current_arch: CPU_ARCHITECTURES, xdg_session_type:
 
 
 def _build_espanso_installer_data(
-    base_installer_data: InstallerData,
-    os_name: OPERATING_SYSTEMS,
-    arch: CPU_ARCHITECTURES,
-    xdg_session_type: str | None,
+    base_installer_data: InstallerData, os_name: OPERATING_SYSTEMS, arch: CPU_ARCHITECTURES, xdg_session_type: str | None
 ) -> InstallerData:
     file_name_pattern = _empty_file_name_pattern()
     match os_name:
@@ -67,10 +52,12 @@ def _build_espanso_installer_data(
         case "linux":
             if xdg_session_type is None:
                 raise RuntimeError("XDG_SESSION_TYPE must be set for Linux Espanso installations.")
-            file_name_pattern[arch]["linux"] = _resolve_linux_asset_name(
-                current_arch=arch,
-                xdg_session_type=xdg_session_type,
-            )
+            file_name_pattern[arch]["linux"] = {
+                "apk": None,
+                "apt": _resolve_linux_asset_name(current_arch=arch, xdg_session_type=xdg_session_type),
+                "dnf": None,
+                "pacman": None,
+            }
         case "darwin":
             file_name_pattern["amd64"]["darwin"] = ESPANSO_MACOS_UNIVERSAL_ASSET
             file_name_pattern["arm64"]["darwin"] = ESPANSO_MACOS_UNIVERSAL_ASSET
@@ -91,19 +78,11 @@ def main(installer_data: InstallerData, version: str | None, update: bool) -> No
     arch = get_normalized_arch()
     xdg_session_type = os.environ["XDG_SESSION_TYPE"] if os_name == "linux" else None
     resolved_installer_data = _build_espanso_installer_data(
-        base_installer_data=installer_data,
-        os_name=os_name,
-        arch=arch,
-        xdg_session_type=xdg_session_type,
+        base_installer_data=installer_data, os_name=os_name, arch=arch, xdg_session_type=xdg_session_type
     )
     console.print(
         Panel.fit(
-            "\n".join(
-                [
-                    f"🔄 Version: {'latest' if version is None else version}",
-                    f"🔗 Source: {ESPANSO_REPO_URL}",
-                ]
-            ),
+            "\n".join([f"🔄 Version: {'latest' if version is None else version}", f"🔗 Source: {ESPANSO_REPO_URL}"]),
             title="⚡ Espanso Installer",
             border_style="yellow",
             box=box.ROUNDED,
@@ -125,10 +104,7 @@ def main(installer_data: InstallerData, version: str | None, update: bool) -> No
         else:
             console.print(
                 Panel.fit(
-                    "\n".join(["X11 detected", "📦 Using X11-specific package"]),
-                    title="🖥️  Display Server",
-                    border_style="cyan",
-                    box=box.ROUNDED,
+                    "\n".join(["X11 detected", "📦 Using X11-specific package"]), title="🖥️  Display Server", border_style="cyan", box=box.ROUNDED
                 )
             )
     else:
@@ -147,12 +123,7 @@ espanso install actually-all-emojis
     console.print(
         Panel.fit(
             "\n".join(
-                [
-                    "📋 Post-installation steps:",
-                    "1️⃣  Register Espanso as a service",
-                    "2️⃣  Start the Espanso service",
-                    "3️⃣  Install the emoji package",
-                ]
+                ["📋 Post-installation steps:", "1️⃣  Register Espanso as a service", "2️⃣  Start the Espanso service", "3️⃣  Install the emoji package"]
             ),
             title="✅ Espanso Installation Completed",
             border_style="green",