webtap-tool 0.11.0__py3-none-any.whl

webtap/services/setup/chrome.py

@@ -0,0 +1,233 @@
+"""Chrome setup service for installing wrapper scripts (cross-platform).
+
+PUBLIC API:
+  - ChromeSetupService: Chrome wrapper script installation
+"""
+
+import os
+import logging
+from typing import Dict, Any
+
+from .platform import get_platform_info, ensure_directories
+
+logger = logging.getLogger(__name__)
+
+# Wrapper script templates
+LINUX_BINDFS_WRAPPER = """#!/bin/bash
+# Chrome Debug Launcher for Linux (bindfs mode)
+# Generated by webtap setup-chrome --bindfs
+# Mounts your real Chrome profile via bindfs for debugging with full session state
+
+DEBUG_DIR="$HOME/.config/google-chrome-debug"
+REAL_DIR="$HOME/.config/google-chrome"
+PORT=${{WEBTAP_PORT:-9222}}
+CHROME_BIN="{chrome_path}"
+
+# Check if bindfs is installed
+if ! command -v bindfs &>/dev/null; then
+    echo "Error: bindfs not installed. Install with:" >&2
+    echo "  Ubuntu/Debian: sudo apt install bindfs" >&2
+    echo "  Arch: yay -S bindfs" >&2
+    echo "  Fedora: sudo dnf install bindfs" >&2
+    exit 1
+fi
+
+# Check if real Chrome profile exists
+if [ ! -d "$REAL_DIR" ]; then
+    echo "Error: Chrome profile not found at $REAL_DIR" >&2
+    echo "Please run Chrome normally first to create a profile" >&2
+    exit 1
+fi
+
+# Mount real profile via bindfs if not already mounted
+if ! mountpoint -q "$DEBUG_DIR" 2>/dev/null; then
+    mkdir -p "$DEBUG_DIR"
+    if ! bindfs --no-allow-other "$REAL_DIR" "$DEBUG_DIR"; then
+        echo "Error: Failed to mount Chrome profile via bindfs" >&2
+        exit 1
+    fi
+    echo "Chrome debug profile mounted. To unmount: fusermount -u $DEBUG_DIR" >&2
+fi
+
+# Launch Chrome with debugging on bindfs mount
+exec "$CHROME_BIN" \\
+    --remote-debugging-port="$PORT" \\
+    --remote-allow-origins='*' \\
+    --user-data-dir="$DEBUG_DIR" \\
+    "$@"
+"""
+
+LINUX_STANDARD_WRAPPER = """#!/bin/bash
+# Chrome Debug Launcher for Linux
+# Generated by webtap setup-chrome
+
+# Configuration
+PORT=${{WEBTAP_PORT:-9222}}
+PROFILE_BASE="{profile_dir}"
+CHROME_BIN="{chrome_path}"
+
+# Profile handling
+if [ "$1" = "--temp" ]; then
+    PROFILE_DIR="$(mktemp -d /tmp/webtap-chrome-XXXXXX)"
+    shift
+    echo "Using temporary profile: $PROFILE_DIR" >&2
+else
+    PROFILE_DIR="$PROFILE_BASE/default"
+    mkdir -p "$PROFILE_DIR"
+fi
+
+# Launch Chrome with debugging
+exec "$CHROME_BIN" \\
+    --remote-debugging-port="$PORT" \\
+    --remote-allow-origins='*' \\
+    --user-data-dir="$PROFILE_DIR" \\
+    --no-first-run \\
+    --no-default-browser-check \\
+    "$@"
+"""
+
+MACOS_WRAPPER = """#!/bin/bash
+# Chrome Debug Launcher for macOS
+# Generated by webtap setup-chrome
+
+# Configuration
+PORT=${{WEBTAP_PORT:-9222}}
+PROFILE_BASE="{profile_dir}"
+CHROME_APP="{chrome_path}"
+
+# Profile handling
+if [ "$1" = "--temp" ]; then
+    PROFILE_DIR="$(mktemp -d /tmp/webtap-chrome-XXXXXX)"
+    shift
+    echo "Using temporary profile: $PROFILE_DIR" >&2
+else
+    PROFILE_DIR="$PROFILE_BASE/default"
+    mkdir -p "$PROFILE_DIR"
+fi
+
+# Launch Chrome with debugging
+exec "$CHROME_APP" \\
+    --remote-debugging-port="$PORT" \\
+    --remote-allow-origins='*' \\
+    --user-data-dir="$PROFILE_DIR" \\
+    --no-first-run \\
+    --no-default-browser-check \\
+    "$@"
+"""
+
+
+class ChromeSetupService:
+    """Chrome wrapper installation service (cross-platform)."""
+
+    def __init__(self):
+        self.info = get_platform_info()
+        self.paths = self.info["paths"]
+        self.chrome = self.info["chrome"]
+
+        # Unified wrapper location for both platforms
+        self.wrapper_dir = self.paths["bin_dir"]  # ~/.local/bin
+        self.wrapper_name = self.chrome["wrapper_name"]  # chrome-debug
+        self.wrapper_path = self.wrapper_dir / self.wrapper_name
+
+        # Profile locations
+        self.profile_dir = self.paths["data_dir"] / "profiles"
+        self.temp_profile_dir = self.paths["runtime_dir"] / "profiles"
+
+    def install_wrapper(self, force: bool = False, bindfs: bool = False) -> Dict[str, Any]:
+        """Install Chrome wrapper script appropriate for platform.
+
+        Args:
+            force: Overwrite existing wrapper
+            bindfs: Use bindfs to mount real Chrome profile (Linux only)
+
+        Returns:
+            Installation result
+        """
+        if not self.chrome["found"]:
+            return {
+                "success": False,
+                "message": "Chrome not found on system",
+                "details": "Please install Google Chrome first",
+            }
+
+        if self.wrapper_path.exists() and not force:
+            return {
+                "success": False,
+                "message": f"Wrapper already exists at {self.wrapper_path}",
+                "details": "Use --force to overwrite",
+                "path": str(self.wrapper_path),
+            }
+
+        # Ensure directories exist
+        ensure_directories()
+        self.wrapper_dir.mkdir(parents=True, exist_ok=True)
+
+        # Generate platform-specific wrapper
+        if self.info["is_macos"]:
+            wrapper_content = self._generate_macos_wrapper()
+        else:
+            wrapper_content = self._generate_linux_wrapper(bindfs=bindfs)
+
+        self.wrapper_path.write_text(wrapper_content)
+        self.wrapper_path.chmod(0o755)
+
+        # Check if wrapper dir is in PATH
+        path_dirs = os.environ.get("PATH", "").split(os.pathsep)
+        in_path = str(self.wrapper_dir) in path_dirs
+
+        logger.info(f"Installed Chrome wrapper to {self.wrapper_path}")
+
+        # Build detailed message with PATH setup instructions
+        if in_path:
+            details = "✅ Run 'chrome-debug' to launch Chrome with debugging"
+        else:
+            shell = os.environ.get("SHELL", "/bin/bash")
+            if "zsh" in shell:
+                rc_file = "~/.zshrc"
+            elif "fish" in shell:
+                rc_file = "~/.config/fish/config.fish"
+            else:
+                rc_file = "~/.bashrc"
+
+            details = (
+                f"⚠️  Add to PATH to use from terminal:\n"
+                f"echo 'export PATH=\"$HOME/.local/bin:$PATH\"' >> {rc_file}\n"
+                f"source {rc_file}\n\n"
+                f"Or run directly: ~/.local/bin/chrome-debug\n"
+                f"✅ GUI launcher will work regardless (uses full path)"
+            )
+
+        return {
+            "success": True,
+            "message": "Chrome wrapper 'chrome-debug' installed successfully",
+            "path": str(self.wrapper_path),
+            "details": details,
+        }
+
+    def _generate_linux_wrapper(self, bindfs: bool = False) -> str:
+        """Generate Linux wrapper script with optional bindfs support.
+
+        Args:
+            bindfs: If True, use bindfs to mount real Chrome profile
+
+        Returns:
+            Wrapper script content
+        """
+        chrome_path = self.chrome["path"]
+        profile_dir = self.profile_dir
+
+        if bindfs:
+            return LINUX_BINDFS_WRAPPER.format(chrome_path=chrome_path)
+        else:
+            return LINUX_STANDARD_WRAPPER.format(chrome_path=chrome_path, profile_dir=profile_dir)
+
+    def _generate_macos_wrapper(self) -> str:
+        """Generate macOS wrapper script.
+
+        Returns:
+            Wrapper script content
+        """
+        chrome_path = self.chrome["path"]
+        profile_dir = self.profile_dir
+
+        return MACOS_WRAPPER.format(chrome_path=chrome_path, profile_dir=profile_dir)

webtap/services/setup/desktop.py

@@ -0,0 +1,255 @@
+"""Desktop/Application launcher setup (cross-platform).
+
+PUBLIC API:
+  - DesktopSetupService: Desktop entry/app bundle installation
+"""
+
+import logging
+from typing import Dict, Any
+
+from .platform import get_platform_info
+
+logger = logging.getLogger(__name__)
+
+# Desktop entry template for Linux
+LINUX_DESKTOP_ENTRY = """[Desktop Entry]
+Version=1.0
+Type=Application
+Name=Chrome Debug
+GenericName=Web Browser (Debug Mode)
+Comment=Chrome with remote debugging enabled
+Icon=google-chrome
+Categories=Development;WebBrowser;
+MimeType=application/pdf;application/rdf+xml;application/rss+xml;application/xhtml+xml;application/xhtml_xml;application/xml;image/gif;image/jpeg;image/png;image/webp;text/html;text/xml;x-scheme-handler/ftp;x-scheme-handler/http;x-scheme-handler/https;
+StartupWMClass=Google-chrome
+StartupNotify=true
+Terminal=false
+Exec={wrapper_path} %U
+Actions=new-window;new-private-window;temp-profile;
+
+[Desktop Action new-window]
+Name=New Window
+StartupWMClass=Google-chrome
+Exec={wrapper_path}
+
+[Desktop Action new-private-window]
+Name=New Incognito Window
+StartupWMClass=Google-chrome
+Exec={wrapper_path} --incognito
+
+[Desktop Action temp-profile]
+Name=New Window (Temp Profile)
+StartupWMClass=Google-chrome
+Exec={wrapper_path} --temp
+"""
+
+# Info.plist template for macOS app bundle
+MACOS_INFO_PLIST = """<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+    <key>CFBundleExecutable</key>
+    <string>Chrome Debug</string>
+    <key>CFBundleIdentifier</key>
+    <string>com.webtap.chrome-debug</string>
+    <key>CFBundleName</key>
+    <string>Chrome Debug</string>
+    <key>CFBundleDisplayName</key>
+    <string>Chrome Debug</string>
+    <key>CFBundleVersion</key>
+    <string>1.0</string>
+    <key>CFBundleShortVersionString</key>
+    <string>1.0</string>
+    <key>CFBundlePackageType</key>
+    <string>APPL</string>
+    <key>CFBundleSignature</key>
+    <string>????</string>
+    <key>LSMinimumSystemVersion</key>
+    <string>10.12</string>
+    <key>LSArchitecturePriority</key>
+    <array>
+        <string>arm64</string>
+        <string>x86_64</string>
+    </array>
+    <key>CFBundleDocumentTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>HTML Document</string>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+            <key>LSItemContentTypes</key>
+            <array>
+                <string>public.html</string>
+            </array>
+        </dict>
+        <dict>
+            <key>CFBundleTypeName</key>
+            <string>Web Location</string>
+            <key>CFBundleTypeRole</key>
+            <string>Viewer</string>
+            <key>LSItemContentTypes</key>
+            <array>
+                <string>public.url</string>
+            </array>
+        </dict>
+    </array>
+    <key>CFBundleURLTypes</key>
+    <array>
+        <dict>
+            <key>CFBundleURLName</key>
+            <string>Web site URL</string>
+            <key>CFBundleURLSchemes</key>
+            <array>
+                <string>http</string>
+                <string>https</string>
+            </array>
+        </dict>
+    </array>
+</dict>
+</plist>"""
+
+
+class DesktopSetupService:
+    """Platform-appropriate GUI launcher setup."""
+
+    def __init__(self):
+        self.info = get_platform_info()
+        self.paths = self.info["paths"]
+        self.chrome = self.info["chrome"]
+
+        # Unified wrapper path: ~/.local/bin/chrome-debug
+        self.wrapper_name = self.chrome["wrapper_name"]  # chrome-debug
+        self.wrapper_path = self.paths["bin_dir"] / self.wrapper_name
+
+    def install_launcher(self, force: bool = False) -> Dict[str, Any]:
+        """Install platform-appropriate launcher.
+
+        Args:
+            force: Overwrite existing launcher
+
+        Returns:
+            Installation result
+        """
+        # Check if wrapper exists first
+        if not self.wrapper_path.exists():
+            return {
+                "success": False,
+                "message": "Chrome wrapper 'chrome-debug' not found. Run 'setup-chrome' first",
+                "path": None,
+                "details": f"Expected wrapper at {self.wrapper_path}",
+            }
+
+        if self.info["is_macos"]:
+            return self._install_macos_app(force)
+        else:
+            return self._install_linux_desktop(force)
+
+    def _install_macos_app(self, force: bool) -> Dict[str, Any]:
+        """Create .app bundle for macOS.
+
+        Args:
+            force: Overwrite existing app
+
+        Returns:
+            Installation result
+        """
+        app_path = self.paths["applications_dir"] / "Chrome Debug.app"
+
+        if app_path.exists() and not force:
+            return {
+                "success": False,
+                "message": "Chrome Debug app already exists",
+                "path": str(app_path),
+                "details": "Use --force to overwrite",
+            }
+
+        # Create app structure
+        contents_dir = app_path / "Contents"
+        macos_dir = contents_dir / "MacOS"
+        macos_dir.mkdir(parents=True, exist_ok=True)
+
+        # Create launcher script that directly launches Chrome
+        # This avoids Rosetta warnings from nested bash scripts
+        launcher_path = macos_dir / "Chrome Debug"
+
+        # Get Chrome path from platform info
+        chrome_path = self.chrome["path"]
+        profile_dir = self.paths["data_dir"] / "profiles" / "default"
+
+        launcher_content = f"""#!/bin/bash
+# Chrome Debug app launcher - direct Chrome execution
+# Avoids Rosetta warnings by directly launching Chrome
+
+PORT=${{WEBTAP_PORT:-9222}}
+PROFILE_DIR="{profile_dir}"
+mkdir -p "$PROFILE_DIR"
+
+# Launch Chrome directly with debugging
+exec "{chrome_path}" \\
+    --remote-debugging-port="$PORT" \\
+    --remote-allow-origins='*' \\
+    --user-data-dir="$PROFILE_DIR" \\
+    --no-first-run \\
+    --no-default-browser-check \\
+    "$@"
+"""
+        launcher_path.write_text(launcher_content)
+        launcher_path.chmod(0o755)
+
+        # Create Info.plist
+        plist_path = contents_dir / "Info.plist"
+        plist_path.write_text(MACOS_INFO_PLIST)
+
+        logger.info(f"Created Chrome Debug app at {app_path}")
+
+        return {
+            "success": True,
+            "message": "Chrome Debug app created successfully",
+            "path": str(app_path),
+            "details": "Available in Launchpad and Spotlight search",
+        }
+
+    def _install_linux_desktop(self, force: bool) -> Dict[str, Any]:
+        """Install .desktop file for Linux.
+
+        Args:
+            force: Overwrite existing desktop entry
+
+        Returns:
+            Installation result
+        """
+        # Create separate Chrome Debug desktop entry (doesn't override system Chrome)
+        desktop_path = self.paths["applications_dir"] / "chrome-debug.desktop"
+
+        if desktop_path.exists() and not force:
+            return {
+                "success": False,
+                "message": "Desktop entry already exists",
+                "path": str(desktop_path),
+                "details": "Use --force to overwrite",
+            }
+
+        # Create Chrome Debug desktop entry
+        desktop_content = self._create_chrome_debug_desktop()
+
+        # Create directory and save
+        desktop_path.parent.mkdir(parents=True, exist_ok=True)
+        desktop_path.write_text(desktop_content)
+        desktop_path.chmod(0o644)  # Standard permissions for desktop files
+
+        logger.info(f"Installed desktop entry to {desktop_path}")
+
+        return {
+            "success": True,
+            "message": "Installed Chrome Debug desktop entry",
+            "path": str(desktop_path),
+            "details": "Available in application menu as 'Chrome Debug'",
+        }
+
+    def _create_chrome_debug_desktop(self) -> str:
+        """Create Chrome Debug desktop entry with absolute paths."""
+        # Use absolute expanded path for Exec lines
+        wrapper_abs_path = self.wrapper_path.expanduser()
+
+        return LINUX_DESKTOP_ENTRY.format(wrapper_path=wrapper_abs_path)

webtap/services/setup/extension.py

@@ -0,0 +1,147 @@
+"""Chrome extension setup service (cross-platform).
+
+PUBLIC API:
+  - ExtensionSetupService: Chrome extension file installation
+"""
+
+import json
+import logging
+from typing import Dict, Any
+
+import requests
+
+from .platform import get_platform_info, ensure_directories
+
+logger = logging.getLogger(__name__)
+
+# GitHub URLs for extension files
+EXTENSION_BASE_URL = "https://raw.githubusercontent.com/angelsen/tap-tools/main/packages/webtap/extension"
+EXTENSION_FILES = [
+    "manifest.json",
+    "background.js",
+    "sidepanel.html",
+    "sidepanel.js",
+    "sidepanel.css",
+    "bind.js",
+    "client.js",
+]
+EXTENSION_ASSETS = [
+    "assets/icon-16.png",
+    "assets/icon-32.png",
+    "assets/icon-48.png",
+    "assets/icon-128.png",
+]
+
+
+class ExtensionSetupService:
+    """Chrome extension installation service."""
+
+    def __init__(self):
+        self.info = get_platform_info()
+        self.paths = self.info["paths"]
+
+        # Extension goes in data directory (persistent app data)
+        self.extension_dir = self.paths["data_dir"] / "extension"
+
+    def install_extension(self, force: bool = False) -> Dict[str, Any]:
+        """Install Chrome extension to platform-appropriate location.
+
+        Args:
+            force: Overwrite existing files
+
+        Returns:
+            Installation result
+        """
+        # Check if exists (manifest.json is required file)
+        if (self.extension_dir / "manifest.json").exists() and not force:
+            return {
+                "success": False,
+                "message": f"Extension already exists at {self.extension_dir}",
+                "path": str(self.extension_dir),
+                "details": "Use --force to overwrite",
+            }
+
+        # Ensure base directories exist
+        ensure_directories()
+
+        # If force, clean out old extension files first
+        if force and self.extension_dir.exists():
+            import shutil
+
+            shutil.rmtree(self.extension_dir)
+            logger.info(f"Cleaned old extension directory: {self.extension_dir}")
+
+        # Create extension directory
+        self.extension_dir.mkdir(parents=True, exist_ok=True)
+
+        # Download text files
+        downloaded = []
+        failed = []
+
+        for filename in EXTENSION_FILES:
+            url = f"{EXTENSION_BASE_URL}/{filename}"
+            target_file = self.extension_dir / filename
+
+            try:
+                logger.info(f"Downloading {filename}")
+                response = requests.get(url, timeout=10)
+                response.raise_for_status()
+
+                # For manifest.json, validate it's proper JSON
+                if filename == "manifest.json":
+                    json.loads(response.text)
+
+                target_file.write_text(response.text)
+                downloaded.append(filename)
+
+            except Exception as e:
+                logger.error(f"Failed to download {filename}: {e}")
+                failed.append(filename)
+
+        # Download binary assets (icons)
+        assets_dir = self.extension_dir / "assets"
+        assets_dir.mkdir(exist_ok=True)
+
+        for asset_path in EXTENSION_ASSETS:
+            url = f"{EXTENSION_BASE_URL}/{asset_path}"
+            target_file = self.extension_dir / asset_path
+
+            try:
+                logger.info(f"Downloading {asset_path}")
+                response = requests.get(url, timeout=10)
+                response.raise_for_status()
+
+                target_file.write_bytes(response.content)
+                downloaded.append(asset_path)
+
+            except Exception as e:
+                logger.error(f"Failed to download {asset_path}: {e}")
+                failed.append(asset_path)
+
+        # Determine success level
+        if not downloaded:
+            return {
+                "success": False,
+                "message": "Failed to download any extension files",
+                "path": None,
+                "details": "Check network connection and try again",
+            }
+
+        total_files = len(EXTENSION_FILES) + len(EXTENSION_ASSETS)
+        if failed:
+            # Partial success - some files downloaded
+            return {
+                "success": True,  # Partial is still success
+                "message": f"Downloaded {len(downloaded)}/{total_files} files",
+                "path": str(self.extension_dir),
+                "details": f"Failed: {', '.join(failed)}",
+            }
+
+        logger.info(f"Extension installed to {self.extension_dir}")
+
+        return {
+            "success": True,
+            "message": "Downloaded Chrome extension",
+            "path": str(self.extension_dir),
+            "details": f"Files: {', '.join(downloaded)}",
+        }