webtap-tool 0.1.4__py3-none-any.whl → 0.2.0__py3-none-any.whl

webtap/services/setup/desktop.py

@@ -0,0 +1,228 @@
+"""Desktop/Application launcher setup (cross-platform)."""
+
+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>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
+        launcher_path = macos_dir / "Chrome Debug"
+        launcher_content = f"""#!/bin/bash
+# Chrome Debug app launcher
+# Uses absolute path to wrapper
+exec "{self.wrapper_path.expanduser()}" "$@"
+"""
+        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,101 @@
+"""Chrome extension setup service (cross-platform)."""
+
+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", "popup.html", "popup.js"]
+
+
+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()
+
+        # Create extension directory
+        self.extension_dir.mkdir(parents=True, exist_ok=True)
+
+        # Download each file
+        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)
+
+        # 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",
+            }
+
+        if failed:
+            # Partial success - some files downloaded
+            return {
+                "success": True,  # Partial is still success
+                "message": f"Downloaded {len(downloaded)}/{len(EXTENSION_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)}",
+        }

webtap/services/setup/filters.py

@@ -0,0 +1,89 @@
+"""Filter setup service (cross-platform)."""
+
+import json
+import logging
+from pathlib import Path
+from typing import Dict, Any
+
+import requests
+
+from .platform import get_platform_info
+
+logger = logging.getLogger(__name__)
+
+# GitHub URL for filters
+FILTERS_URL = "https://raw.githubusercontent.com/angelsen/tap-tools/main/packages/webtap/data/filters.json"
+
+
+class FilterSetupService:
+    """Filter configuration installation service."""
+
+    def __init__(self):
+        self.info = get_platform_info()
+        self.paths = self.info["paths"]
+
+        # Filters go in the current working directory's .webtap folder
+        # (project-specific, not global)
+        self.filters_path = Path.cwd() / ".webtap" / "filters.json"
+
+    def install_filters(self, force: bool = False) -> Dict[str, Any]:
+        """Install filters to .webtap/filters.json in current directory.
+
+        Args:
+            force: Overwrite existing file
+
+        Returns:
+            Installation result
+        """
+        # Check if exists
+        if self.filters_path.exists() and not force:
+            return {
+                "success": False,
+                "message": f"Filters already exist at {self.filters_path}",
+                "path": str(self.filters_path),
+                "details": "Use --force to overwrite",
+            }
+
+        # Download from GitHub
+        try:
+            logger.info(f"Downloading filters from {FILTERS_URL}")
+            response = requests.get(FILTERS_URL, timeout=10)
+            response.raise_for_status()
+
+            # Validate it's proper JSON
+            filters_data = json.loads(response.text)
+
+            # Quick validation - should have dict structure
+            if not isinstance(filters_data, dict):
+                return {
+                    "success": False,
+                    "message": "Invalid filter format - expected JSON object",
+                    "path": None,
+                    "details": None,
+                }
+
+            # Count categories for user feedback
+            category_count = len(filters_data)
+
+            # Create directory and save
+            self.filters_path.parent.mkdir(parents=True, exist_ok=True)
+            self.filters_path.write_text(response.text)
+
+            logger.info(f"Saved {category_count} filter categories to {self.filters_path}")
+
+            return {
+                "success": True,
+                "message": f"Downloaded {category_count} filter categories",
+                "path": str(self.filters_path),
+                "details": f"Categories: {', '.join(filters_data.keys())}",
+            }
+
+        except requests.RequestException as e:
+            logger.error(f"Network error downloading filters: {e}")
+            return {"success": False, "message": f"Network error: {e}", "path": None, "details": None}
+        except json.JSONDecodeError as e:
+            logger.error(f"Invalid JSON in filters: {e}")
+            return {"success": False, "message": f"Invalid JSON format: {e}", "path": None, "details": None}
+        except Exception as e:
+            logger.error(f"Unexpected error: {e}")
+            return {"success": False, "message": f"Failed to download filters: {e}", "path": None, "details": None}

webtap/services/setup/platform.py

@@ -0,0 +1,126 @@
+"""Platform detection and path management using platformdirs."""
+
+import platform
+import shutil
+from pathlib import Path
+from typing import Optional
+
+import platformdirs
+
+
+def get_platform_paths() -> dict[str, Path]:
+    """Get platform-appropriate paths using platformdirs.
+
+    Returns:
+        Dictionary of paths for config, data, cache, runtime, and state directories.
+    """
+    app_name = "webtap"
+    app_author = "webtap"
+
+    dirs = platformdirs.PlatformDirs(app_name, app_author)
+
+    paths = {
+        "config_dir": Path(dirs.user_config_dir),  # ~/.config/webtap or ~/Library/Application Support/webtap
+        "data_dir": Path(dirs.user_data_dir),  # ~/.local/share/webtap or ~/Library/Application Support/webtap
+        "cache_dir": Path(dirs.user_cache_dir),  # ~/.cache/webtap or ~/Library/Caches/webtap
+        "state_dir": Path(dirs.user_state_dir),  # ~/.local/state/webtap or ~/Library/Application Support/webtap
+    }
+
+    # Runtime dir (not available on all platforms)
+    try:
+        paths["runtime_dir"] = Path(dirs.user_runtime_dir)
+    except AttributeError:
+        # Fallback for platforms without runtime dir
+        paths["runtime_dir"] = Path("/tmp") / app_name
+
+    return paths
+
+
+def get_chrome_path() -> Optional[Path]:
+    """Find Chrome executable path for current platform.
+
+    Returns:
+        Path to Chrome executable or None if not found.
+    """
+    system = platform.system()
+
+    if system == "Darwin":
+        # macOS standard locations
+        candidates = [
+            Path("/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"),
+            Path.home() / "Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
+        ]
+    elif system == "Linux":
+        # Linux standard locations
+        candidates = [
+            Path("/usr/bin/google-chrome"),
+            Path("/usr/bin/google-chrome-stable"),
+            Path("/usr/bin/chromium"),
+            Path("/usr/bin/chromium-browser"),
+            Path("/snap/bin/chromium"),
+        ]
+    else:
+        return None
+
+    for path in candidates:
+        if path.exists():
+            return path
+
+    # Try to find in PATH
+    for name in ["google-chrome", "google-chrome-stable", "chromium", "chromium-browser"]:
+        if found := shutil.which(name):
+            return Path(found)
+
+    return None
+
+
+def get_platform_info() -> dict:
+    """Get comprehensive platform information.
+
+    Returns:
+        Dictionary with system info, paths, and capabilities.
+    """
+    system = platform.system()
+    paths = get_platform_paths()
+
+    # Unified paths for both platforms
+    paths["bin_dir"] = Path.home() / ".local/bin"  # User space, no sudo needed
+    wrapper_name = "chrome-debug"  # Same name on both platforms
+
+    # Platform-specific launcher locations
+    if system == "Darwin":
+        paths["applications_dir"] = Path.home() / "Applications"
+    else:  # Linux
+        paths["applications_dir"] = Path.home() / ".local/share/applications"
+
+    chrome_path = get_chrome_path()
+
+    return {
+        "system": system.lower(),
+        "is_macos": system == "Darwin",
+        "is_linux": system == "Linux",
+        "paths": paths,
+        "chrome": {
+            "path": chrome_path,
+            "found": chrome_path is not None,
+            "wrapper_name": wrapper_name,
+        },
+        "capabilities": {
+            "desktop_files": system == "Linux",
+            "app_bundles": system == "Darwin",
+            "bindfs": system == "Linux" and shutil.which("bindfs") is not None,
+        },
+    }
+
+
+def ensure_directories() -> None:
+    """Ensure all required directories exist with proper permissions."""
+    paths = get_platform_paths()
+
+    for name, path in paths.items():
+        if name != "runtime_dir":  # Runtime dir is often system-managed
+            path.mkdir(parents=True, exist_ok=True, mode=0o755)
+
+    # Ensure bin directory exists
+    info = get_platform_info()
+    info["paths"]["bin_dir"].mkdir(parents=True, exist_ok=True, mode=0o755)

{webtap_tool-0.1.4.dist-info → webtap_tool-0.2.0.dist-info}/METADATA

@@ -1,9 +1,11 @@
 Metadata-Version: 2.4
 Name: webtap-tool
-Version: 0.1.4
+Version: 0.2.0
 Summary: Terminal-based web page inspector for AI debugging sessions
 Author-email: Fredrik Angelsen <fredrikangelsen@gmail.com>
 Classifier: Development Status :: 3 - Alpha
+Classifier: Operating System :: MacOS :: MacOS X
+Classifier: Operating System :: POSIX :: Linux
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Internet :: WWW/HTTP :: Browsers
 Classifier: Topic :: Software Development :: Debuggers
@@ -15,6 +17,7 @@ Requires-Dist: fastapi>=0.116.1
 Requires-Dist: httpx>=0.28.1
 Requires-Dist: lxml>=6.0.1
 Requires-Dist: msgpack-python>=0.5.6
+Requires-Dist: platformdirs>=4.4.0
 Requires-Dist: protobuf>=6.32.0
 Requires-Dist: pyjwt>=2.10.1
 Requires-Dist: pyyaml>=6.0.2

{webtap_tool-0.1.4.dist-info → webtap_tool-0.2.0.dist-info}/RECORD

@@ -28,7 +28,7 @@ webtap/commands/javascript.py,sha256=QpQdqqoQwwTyz1lpibZ92XKOL89scu_ndgSjkhaYuDk
 webtap/commands/launch.py,sha256=iZDLundKlxKRLKf3Vz5at42-tp2f-Uj5wZf7fbhBfA0,2202
 webtap/commands/navigation.py,sha256=Mapawp2AZTJQaws2uwlTgMUhqz7HlVTLxiZ06n_MQc0,6071
 webtap/commands/network.py,sha256=hwZshGGdVsJ_9MFjOKJXT07I990JjZInw2LLnKXLQ5Y,2910
-webtap/commands/setup.py,sha256=ewoOTvgCAzMPcFm6cbk-93nY_BI2IXqPZGGGpc1rJiw,4459
+webtap/commands/setup.py,sha256=B60hajR8tKWLJcjlhEL4zYClB5DWd57AqnwJry_cHrs,10098
 webtap/services/README.md,sha256=rala_jtnNgSiQ1lFLM7x_UQ4SJZDceAm7dpkQMRTYaI,2346
 webtap/services/__init__.py,sha256=IjFqu0Ak6D-r18aokcQMtenDV3fbelvfjTCejGv6CZ0,570
 webtap/services/body.py,sha256=XQPa19y5eUc3XJ2TuwVK6kffO1VQoKqNs33MBBz7hzU,3913
@@ -36,8 +36,13 @@ webtap/services/console.py,sha256=XVfSKTvEHyyOdujsg85S3wtj1CdZhzKtWwlx25MvSv8,37
 webtap/services/fetch.py,sha256=nl6bpU2Vnf40kau4-mqAnIkhC-7Lx2vbTJKUglz9KnE,13602
 webtap/services/main.py,sha256=HcXdPuI7hzsxsNvfN0npGhj_M7HObc83Lr3fuy7BMeE,5673
 webtap/services/network.py,sha256=0o_--F6YvmXqqFqrcjL1gc6Vr9V1Ytb_U7r_DSUWupA,3444
-webtap/services/setup.py,sha256=dXzqlXR37-chZO2qCsuiVq9N7fELXtND5jH_9QQwsws,7932
-webtap_tool-0.1.4.dist-info/METADATA,sha256=xX7oPMbWWVeiFFRYbCB7V87iEMDoqh9JXfog5AY0gXM,17457
-webtap_tool-0.1.4.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-webtap_tool-0.1.4.dist-info/entry_points.txt,sha256=iFe575I0CIb1MbfPt0oX2VYyY5gSU_dA551PKVR83TU,39
-webtap_tool-0.1.4.dist-info/RECORD,,
+webtap/services/setup/__init__.py,sha256=rCi6HjyWQmtoBu6NwB1Aw3bEklxsC-bt1jPJ8rGeNgA,6635
+webtap/services/setup/chrome.py,sha256=nNeb7j_yCSx5-Urw4RqbOE6x46gY_vR-s2-TCRMrc8U,7119
+webtap/services/setup/desktop.py,sha256=pMH5gk14iGEZ7SyaBNb4pYt7C1xJSx47oFzQCBIB_E4,7317
+webtap/services/setup/extension.py,sha256=OvTLuSi5u-kBAkqWAzfYt5lTNZrduXoCMZhFCuMisew,3318
+webtap/services/setup/filters.py,sha256=lAPSLMH_KZQO-7bRkmURwzforx7C3SDrKEw2ZogN-Lo,3220
+webtap/services/setup/platform.py,sha256=RQrhvp8mLg5Bssy5Slfl5SPVGo3BlUIn3lxVm-ZmkAM,3987
+webtap_tool-0.2.0.dist-info/METADATA,sha256=e3ux3On__FO9C8B1LVQ12t30A-YtDhw-vHkbevZ7SlQ,17588
+webtap_tool-0.2.0.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+webtap_tool-0.2.0.dist-info/entry_points.txt,sha256=iFe575I0CIb1MbfPt0oX2VYyY5gSU_dA551PKVR83TU,39
+webtap_tool-0.2.0.dist-info/RECORD,,