stackops 26.6.7__tar.gz → 26.7.1__tar.gz

stackops-26.7.1/PKG-INFO

@@ -0,0 +1,144 @@
+Metadata-Version: 2.4
+Name: stackops
+Version: 26.7.1
+Summary: Developer Stack Manager
+Author-email: Alex Al-Saffar <programmer@usa.com>
+License: Apache 2.0
+Project-URL: Homepage, https://github.com/thisismygitrepo/stackops
+Project-URL: Bug Tracker, https://github.com/thisismygitrepo/stackops/issues
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.13
+Description-Content-Type: text/markdown
+Requires-Dist: fire>=0.7.1
+Requires-Dist: gitpython>=3.1.46
+Requires-Dist: psutil>=7.2.2
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: questionary>=2.1.1
+Requires-Dist: randomname>=0.2.1
+Requires-Dist: requests>=2.32.5
+Requires-Dist: rich>=14.3.3
+Requires-Dist: tenacity>=9.1.4
+Requires-Dist: typer>=0.24.1
+Provides-Extra: windows
+Provides-Extra: plot
+
+<div align="center">
+
+<h1>🗜 StackOps</h1>
+
+<strong>Digital Life Manager.</strong>
+
+<p>
+  <a href="https://thisismygitrepo.github.io/stackops/"><img alt="Docs" src="https://img.shields.io/badge/docs-online-2f6f6f"></a>
+  <a href="https://pypi.org/project/stackops/"><img alt="PyPI package" src="https://img.shields.io/pypi/v/stackops?color=2f6f6f"></a>
+  <img alt="Python 3.13+" src="https://img.shields.io/badge/python-3.13%2B-3776AB">
+  <img alt="Installed with uv" src="https://img.shields.io/badge/install-uv-f05d23">
+</p>
+
+</div>
+
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+
+
+| Before | After |
+| --- | --- |
+| ![Fresh minimal machine state](docs/assets/before.png) | ![Developer-ready machine state](docs/assets/after.png) |
+
+
+See the [online docs](https://thisismygitrepo.github.io/stackops/) for full usage and reference material.
+
+## Install
+
+Choose your platform and expand only the commands you need.
+
+<details>
+<summary><strong>Linux</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>macOS</strong></summary>
+
+```bash
+curl -LsSf https://astral.sh/uv/install.sh | sh
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: . < (curl -L https://bit.ly/sopsu)
+```
+
+</details>
+
+<details>
+<summary><strong>Windows PowerShell</strong></summary>
+
+```powershell
+powershell -ExecutionPolicy Bypass -c "irm https://astral.sh/uv/install.ps1 | iex"
+uv tool install --upgrade --python 3.14 stackops
+stackops --help
+# OR: irm bit.ly/sopsw | iex
+```
+
+</details>
+
+
+## Codex Skill
+
+Install the StackOps skill for Codex with:
+
+```bash
+bunx skills add thisismygitrepo/stackops --skill stackops --global --agent codex --yes
+```
+
+
+## Quick Init
+
+Run these once StackOps is installed.
+
+```bash
+devops install --group sysabc
+devops config copy-assets all
+devops config sync down \
+  --sensitivity public \
+  --method copy \
+  --on-conflict throw-error \
+  --which all
+devops config terminal config-shell --which default
+devops install --group termabc
+```
+
+
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
+## Author
+
+Alex Al-Saffar. [email](mailto:programmer@usa.com)
+
+## Contributor
+
+Ruby Chan. [email](mailto:ruby.chan@sa.gov.au)

stackops-26.7.1/pyproject.toml

@@ -0,0 +1,166 @@
+[build-system]
+requires = ["setuptools>=80", "wheel"]
+build-backend = "setuptools.build_meta"
+# requires = ["hatchling"]
+# build-backend = "hatchling.build"
+
+[project]
+name = "stackops"
+version = "26.7.1"
+description = "Developer Stack Manager"
+readme = "README.md"
+license = {text = "Apache 2.0"}
+authors = [
+    {name = "Alex Al-Saffar", email = "programmer@usa.com"},
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: Apache Software License",
+    "Operating System :: OS Independent",
+]
+requires-python = ">=3.13"
+dependencies = [
+    "fire>=0.7.1",
+    "gitpython>=3.1.46",
+    "psutil>=7.2.2",
+    "pyyaml>=6.0.3",
+    "questionary>=2.1.1",
+    "randomname>=0.2.1",
+    "requests>=2.32.5",
+    "rich>=14.3.3",
+    "tenacity>=9.1.4",
+    "typer>=0.24.1",
+]
+
+[project.optional-dependencies]
+windows = []
+plot = [
+
+]
+
+
+[project.urls]
+"Homepage" = "https://github.com/thisismygitrepo/stackops"
+"Bug Tracker" = "https://github.com/thisismygitrepo/stackops/issues"
+
+[project.scripts]
+devops = "stackops.scripts.python.devops:main"
+cloud = "stackops.scripts.python.cloud:main"
+fire = "stackops.scripts.python.fire_jobs:main"
+agents = "stackops.scripts.python.agents:main"
+terminal = "stackops.scripts.python.terminal:main"
+preview = "stackops.scripts.python.preview:main"
+utils = "stackops.scripts.python.utils:main"
+stackops = "stackops.scripts.python.stackops_entry:main"
+seek = "stackops.scripts.python.seek:main"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+include-package-data = true
+license-files = []
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+stackops = ["**/*.toml", "**/*.md", "**/*.sh", "**/*.ps1", "**/*.txt", "utils/schemas/**/*.json", "utils/schemas/**/*.yaml"]
+
+[dependency-groups]
+dev = [
+    "aider>=0.2.6",
+    "build>=1.5.0",
+    "cleanpy>=0.5.1",
+    "cowsay>=6.1",
+    "duckdb>=1.5.4",
+    "gdown>=6.1.0",
+    "griffe>=2.1.0",
+    "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",
+    "mkdocstrings>=1.0.4",
+    "mkdocstrings-python>=2.0.5",
+    "mypy>=2.1.0",
+    "numpy>=2.5.0",
+    "pandas>=3.0.3",
+    "paramiko>=5.0.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "pre-commit>=4.6.0",
+    "pudb>=2025.1.5",
+    "py7zr>=1.1.3",
+    "pydantic>=2.13.4",
+    "pydeps>=3.0.6",
+    "pyinstaller>=6.21.0",
+    "pylint>=4.0.6",
+    "pylsp-mypy>=0.7.3",
+    "pymupdf>=1.27.2.3",
+    "pypdf>=6.14.2",
+    "pyrefly>=1.1.1",
+    "pyright>=1.1.411",
+    "pytest>=9.1.1",
+    "python-lsp-server[mypy]>=1.14.0",
+    "qrcode>=8.2",
+    "ruff>=0.15.20",
+    "ruff-lsp>=0.0.62",
+    "sqlalchemy>=2.0.51",
+    "textual>=8.2.7",
+    "trogon>=0.6.0",
+    "ty>=0.0.55",
+    "types-mysqlclient>=2.2.0.20260508",
+    "types-paramiko>=5.0.0.20260617",
+    "types-pytz>=2026.2.0.20260518",
+    "types-pyyaml>=6.0.12.20260518",
+    "types-requests>=2.33.0.20260518",
+    "types-sqlalchemy>=1.4.53.38",
+    "types-toml>=0.10.8.20260518",
+    "types-urllib3>=1.26.25.14",
+    "vt-py>=0.22.0",
+    "yapf>=0.43.0",
+    "zensical>=0.0.46",
+]
+other = [
+    "duckdb-engine>=0.17.0",
+    "pycrucible>=0.4.6",
+    "vt-py>=0.22.0",
+]
+plot = [
+    "duckdb>=1.5.4",
+    "ipykernel>=7.3.0",
+    "ipython>=9.15.0",
+    "jupyterlab>=4.6.0",
+    "kaleido>=1.3.0",
+    "matplotlib>=3.11.0",
+    "nbformat>=5.10.4",
+    "numpy>=2.5.0",
+    "plotly>=6.8.0",
+    "polars>=1.42.0",
+    "python-magic>=0.4.27",
+    "sqlalchemy>=2.0.51",
+]
+
+
+# [tool.uv]
+# default-groups = []
+
+[tool.pycrucible]
+entry = "src/stackops/scripts/python/devops.py"
+[tool.pycrucible.options]
+debug = false
+extract_to_temp = false
+delete_after_run = false
+offline_mode = false
+
+[tool.pycrucible.patterns]
+include = [
+    "**/*.py",
+    "**/*.ps1",
+    "**/*.sh",
+    "**/*.md",
+]
+exclude = [
+    "**/__pycache__/**",
+]

stackops-26.7.1/src/stackops/jobs/installer/checks/install_utils.py

@@ -0,0 +1,160 @@
+"""
+Installation Utilities
+======================
+
+This module provides functionality to download and install pre-checked applications.
+"""
+
+import csv
+from io import StringIO
+import platform
+from concurrent.futures import ThreadPoolExecutor
+from pathlib import Path
+from typing import cast
+
+import stackops.utils.path_core as path_core
+from rich.console import Console
+
+from stackops.utils.cloud.rclone_wrapper import get_remote_path, to_cloud
+from stackops.utils.source_of_truth import CONFIG_ROOT, LINUX_INSTALL_PATH, WINDOWS_INSTALL_PATH
+
+# Constants
+APP_METADATA_PATH = CONFIG_ROOT.joinpath(f"profile/records/{platform.system().lower()}/apps_metadata_report.csv")
+ENGINE_RESULTS_PATH = CONFIG_ROOT.joinpath(f"profile/records/{platform.system().lower()}/apps_engine_results_report.csv")
+CLOUD_STORAGE_NAME = "gdp"  # Default cloud storage name for rclone
+
+console = Console()
+
+
+def _load_csv_report(path: Path) -> list[dict[str, str]]:
+    csv_text = path.read_text(encoding="utf-8")
+    return list(csv.DictReader(StringIO(csv_text)))
+
+def upload_app(path: Path) -> str | None:
+    """Uploads the app to cloud storage and returns the shareable link."""
+    try:
+        local_path = path.expanduser().absolute()
+        remote_path = get_remote_path(
+            local_path=local_path,
+            root="myhome",
+            os_specific=True,
+            rel2home=True,
+            strict=True,
+        )
+        return to_cloud(
+            local_path=local_path,
+            cloud=CLOUD_STORAGE_NAME,
+            remote_path=remote_path,
+            share=True,
+            share_options=None,
+            verbose=False,
+            transfers=10,
+        )
+    except Exception as e:
+        console.print(f"[red]Failed to upload {path}: {e}[/red]")
+        return None
+
+def download_google_drive_file(url: str) -> Path:
+    """Downloads a file from Google Drive using gdown."""
+    try:
+        # Extract ID from URL
+        # Assuming URL format like https://drive.google.com/file/d/FILE_ID/view or similar
+        # or https://drive.google.com/uc?id=FILE_ID
+        if "id=" in url:
+            file_id = url.split("id=")[1].split("&")[0]
+        elif "/d/" in url:
+            file_id = url.split("/d/")[1].split("/")[0]
+        else:
+            # Fallback to gdown's auto detection or just pass URL
+            file_id = url
+
+        # Create a temporary directory for download
+        output_dir = path_core.tmpdir(prefix="gdown_")
+        # gdown.download returns the output filename when output is a directory path
+        from gdown.download import download
+        output_file = download(id=file_id, output=str(output_dir) + "/", quiet=False)
+
+        if not output_file:
+            raise ValueError(f"Download failed for {url}")
+
+        return Path(cast(str, output_file))
+    except Exception as e:
+        raise RuntimeError(f"Failed to download from Google Drive: {e}") from e
+
+def install_cli_app(app_url: str) -> bool:
+    """Downloads and installs a CLI app."""
+    try:
+        if not app_url:
+            return False
+            
+        exe_path = download_google_drive_file(app_url)
+        console.print(f"[green]Downloaded {exe_path.name}[/green]")
+        
+        system = platform.system().lower()
+        if system in ["linux", "darwin"]:
+            exe_path.chmod(0o755) # Make executable
+            # Move to local bin (requires user to have write access or sudo, which we can't easily do here without interaction)
+            # Using LINUX_INSTALL_PATH is safer
+            install_path = Path(LINUX_INSTALL_PATH)
+            install_path.mkdir(parents=True, exist_ok=True)
+            target = install_path / exe_path.name
+            exe_path.rename(target)
+            console.print(f"[green]Installed to {target}[/green]")
+        elif system == "windows":
+            install_path = Path(WINDOWS_INSTALL_PATH)
+            install_path.mkdir(parents=True, exist_ok=True)
+            target = install_path / exe_path.name
+            # Use shutil.move or path_core.move
+            path_core.move(exe_path, path=target, overwrite=True)
+            console.print(f"[green]Installed to {target}[/green]")
+        
+        return True
+    except Exception as e:
+        console.print(f"[red]Failed to install app from {app_url}: {e}[/red]")
+        return False
+
+def load_app_metadata_report() -> list[dict[str, str]]:
+    """Loads the app metadata report from CSV."""
+    if APP_METADATA_PATH.exists():
+        return _load_csv_report(APP_METADATA_PATH)
+    console.print(f"[yellow]Warning: App metadata report not found at {APP_METADATA_PATH}[/yellow]")
+    return []
+
+
+def load_engine_results_report() -> list[dict[str, str]]:
+    """Loads the engine results report from CSV."""
+    if ENGINE_RESULTS_PATH.exists():
+        return _load_csv_report(ENGINE_RESULTS_PATH)
+    console.print(f"[yellow]Warning: Engine results report not found at {ENGINE_RESULTS_PATH}[/yellow]")
+    return []
+
+def download_safe_apps(name: str = "essentials") -> bool:
+    """Downloads and installs safe apps."""
+    data = load_app_metadata_report()
+    if not data:
+        console.print("[red]No app data available to install.[/red]")
+        return False
+
+    apps_to_install = []
+    if name == "essentials":
+        # Install all available apps in the report? Or filter?
+        # Original code installed all if name="essentials" (implied by logic)
+        apps_to_install = [item['app_url'] for item in data if item.get('app_url')]
+    else:
+        apps_to_install = [item['app_url'] for item in data if item.get('app_name') == name and item.get('app_url')]
+
+    if not apps_to_install:
+        console.print(f"[yellow]No apps found to install for '{name}'.[/yellow]")
+        return False
+
+    console.print(f"[bold]Installing {len(apps_to_install)} apps...[/bold]")
+    
+    with ThreadPoolExecutor(max_workers=5) as executor:
+        results = list(executor.map(install_cli_app, apps_to_install))
+    
+    success_count = sum(results)
+    if success_count != len(apps_to_install):
+        console.print(f"[bold yellow]Installed {success_count}/{len(apps_to_install)} apps.[/bold yellow]")
+        return False
+    console.print(f"[bold green]Successfully installed {success_count}/{len(apps_to_install)} apps.[/bold green]")
+    return True

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.1/src/stackops/jobs/installer/linux_scripts/ngrok.sh

@@ -0,0 +1,6 @@
+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-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