scitex 2.0.0__py2.py3-none-any.whl → 2.1.0__py2.py3-none-any.whl

scitex/browser/debugging/_highlight_element.py

@@ -0,0 +1,143 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-10-08 03:52:34 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/browser/debugging/highlight_element.py
+# ----------------------------------------
+from __future__ import annotations
+import os
+__FILE__ = (
+    "./src/scitex/browser/debugging/highlight_element.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+__FILE__ = __file__
+
+"""
+Functionalities:
+  - Highlights a Playwright element with red overlay for visual debugging
+  - Scrolls element into view and displays a temporary visual indicator
+  - Demonstrates element highlighting when run standalone
+
+Dependencies:
+  - packages:
+    - playwright
+
+IO:
+  - input-files:
+    - None
+  - output-files:
+    - None
+"""
+
+"""Imports"""
+import argparse
+
+from playwright.async_api import Locator
+
+import scitex as stx
+from scitex import logging
+
+logger = logging.getLogger(__name__)
+
+"""Functions & Classes"""
+async def highlight_element_async(element: Locator, duration_ms: int = 1_000, func_name: str = "highlight_element_async"):
+    """Highlight element with red overlay rectangle.
+
+    Args:
+        element: Locator to highlight
+        duration_ms: Duration to display highlight in milliseconds
+        func_name: Name of calling function for logging context
+    """
+    await element.evaluate(
+        """(element, duration) => {
+            // Scroll element into view FIRST
+            element.scrollIntoView({behavior: 'smooth', block: 'center'});
+
+            // Wait for scroll to complete, then create overlay
+            setTimeout(() => {
+                // Get element position AFTER scroll
+                const rect = element.getBoundingClientRect();
+
+                // Create overlay div
+                const overlay = document.createElement('div');
+                overlay.id = 'highlight-overlay-' + Date.now();
+                overlay.style.cssText = `
+                    position: fixed;
+                    top: ${rect.top}px;
+                    left: ${rect.left}px;
+                    width: ${rect.width}px;
+                    height: ${rect.height}px;
+                    border: 5px solid red;
+                    background-color: rgba(255, 0, 0, 0.2);
+                    pointer-events: none;
+                    z-index: 999999;
+                    box-shadow: 0 0 20px red;
+                `;
+
+                document.body.appendChild(overlay);
+
+                // Remove overlay after duration
+                setTimeout(() => {
+                    if (overlay && overlay.parentNode) {
+                        overlay.parentNode.removeChild(overlay);
+                    }
+                }, duration);
+            }, 500);  // Wait 500ms for smooth scroll to complete
+        }""",
+        duration_ms,
+    )
+    await element.page.wait_for_timeout(duration_ms)
+
+
+def main(args):
+    logger.debug("Element highlighting utility - use highlight_element_async() in your code")
+    return 0
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command line arguments."""
+    import scitex as stx
+
+    parser = argparse.ArgumentParser(description="Element highlighting utility for debugging")
+    args = parser.parse_args()
+    return args
+
+
+def run_main() -> None:
+    """Initialize scitex framework, run main function, and cleanup."""
+    global CONFIG, CC, sys, plt, rng
+
+    import sys
+
+    import matplotlib.pyplot as plt
+
+    import scitex as stx
+
+    args = parse_args()
+
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
+        sys,
+        plt,
+        args=args,
+        file=__FILE__,
+        sdir_suffix=None,
+        verbose=False,
+        agg=True,
+    )
+
+    exit_status = main(args)
+
+    stx.session.close(
+        CONFIG,
+        verbose=False,
+        notify=False,
+        message="",
+        exit_status=exit_status,
+    )
+
+
+if __name__ == "__main__":
+    run_main()
+
+# EOF

scitex/browser/debugging/_show_grid.py

@@ -0,0 +1,154 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-10-10 00:27:58 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/browser/debugging/_show_grid.py
+# ----------------------------------------
+from __future__ import annotations
+import os
+__FILE__ = (
+    "./src/scitex/browser/debugging/_show_grid.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+__FILE__ = __file__
+
+"""
+Functionalities:
+  - Displays a coordinate grid overlay on a webpage for debugging layout
+  - Shows major grid lines every 100px and minor lines every 20px
+  - Demonstrates grid overlay when run standalone
+
+Dependencies:
+  - packages:
+    - playwright
+
+IO:
+  - input-files:
+    - None
+  - output-files:
+    - None
+"""
+
+"""Imports"""
+import argparse
+
+import scitex as stx
+from scitex import logging
+
+logger = logging.getLogger(__name__)
+
+"""Functions & Classes"""
+async def show_grid_async(page, func_name: str = "show_grid_async"):
+    from ._browser_logger import browser_logger
+
+    await browser_logger.debug(page, f"{func_name}: Showing Grid...")
+    await page.evaluate(
+        """() => {
+        // Remove existing grid if present
+        const existingGrid = document.getElementById('scitex-debug-grid');
+        if (existingGrid) {
+            existingGrid.remove();
+        }
+
+        const canvas = document.createElement('canvas');
+        canvas.id = 'scitex-debug-grid';
+        canvas.style.position = 'fixed';
+        canvas.style.top = '0';
+        canvas.style.left = '0';
+        canvas.style.width = '100%';
+        canvas.style.height = '100%';
+        canvas.style.pointerEvents = 'none';
+        canvas.style.zIndex = '9998';  // Below popups (9999) but above content
+        canvas.width = window.innerWidth;
+        canvas.height = window.innerHeight;
+
+        const ctx = canvas.getContext('2d');
+        ctx.font = '12px Arial';
+
+        // Vertical lines
+        for (let xx = 0; xx < canvas.width; xx += 20) {
+            ctx.strokeStyle = xx % 100 === 0 ? 'rgba(255, 0, 0, 0.8)' : 'rgba(255, 0, 0, 0.2)';
+            ctx.lineWidth = xx % 100 === 0 ? 2 : 1;
+            ctx.beginPath();
+            ctx.moveTo(xx, 0);
+            ctx.lineTo(xx, canvas.height);
+            ctx.stroke();
+            if (xx % 100 === 0) {
+                ctx.fillStyle = 'rgba(255, 0, 0, 0.9)';
+                ctx.fillText(xx, xx + 5, 15);
+            }
+        }
+
+        // Horizontal lines
+        for (let yy = 0; yy < canvas.height; yy += 20) {
+            ctx.strokeStyle = yy % 100 === 0 ? 'rgba(255, 0, 0, 0.8)' : 'rgba(255, 0, 0, 0.2)';
+            ctx.lineWidth = yy % 100 === 0 ? 2 : 1;
+            ctx.beginPath();
+            ctx.moveTo(0, yy);
+            ctx.lineTo(canvas.width, yy);
+            ctx.stroke();
+            if (yy % 100 === 0) {
+                ctx.fillStyle = 'rgba(255, 0, 0, 0.9)';
+                ctx.fillText(yy, 5, yy + 15);
+            }
+        }
+
+        document.body.appendChild(canvas);
+    }"""
+    )
+
+
+def main(args):
+    logger.debug("Grid overlay utility - use show_grid_async() in your code")
+    return 0
+
+
+def parse_args() -> argparse.Namespace:
+    """Parse command line arguments."""
+    import scitex as stx
+
+    parser = argparse.ArgumentParser(
+        description="Grid overlay utility for debugging"
+    )
+    args = parser.parse_args()
+    return args
+
+
+def run_main() -> None:
+    """Initialize scitex framework, run main function, and cleanup."""
+    global CONFIG, CC, sys, plt, rng
+
+    import sys
+
+    import matplotlib.pyplot as plt
+
+    import scitex as stx
+
+    args = parse_args()
+
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
+        sys,
+        plt,
+        args=args,
+        file=__FILE__,
+        sdir_suffix=None,
+        verbose=False,
+        agg=True,
+    )
+
+    exit_status = main(args)
+
+    stx.session.close(
+        CONFIG,
+        verbose=False,
+        notify=False,
+        message="",
+        exit_status=exit_status,
+    )
+
+
+if __name__ == "__main__":
+    run_main()
+
+# EOF

scitex/browser/interaction/__init__.py

@@ -0,0 +1,24 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# SciTeX Browser Interaction Utilities
+# ----------------------------------------
+
+from .click_center import click_center_async
+from .click_with_fallbacks import click_with_fallbacks_async
+from .fill_with_fallbacks import fill_with_fallbacks_async
+from .close_popups import (
+    PopupHandler,
+    close_popups_async,
+    ensure_no_popups_async,
+)
+
+__all__ = [
+    "click_center_async",
+    "click_with_fallbacks_async",
+    "fill_with_fallbacks_async",
+    "PopupHandler",
+    "close_popups_async",
+    "ensure_no_popups_async",
+]
+
+# EOF

scitex/browser/interaction/click_center.py

@@ -0,0 +1,149 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-10-10 03:24:17 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/browser/interaction/click_center.py
+# ----------------------------------------
+from __future__ import annotations
+import os
+__FILE__ = (
+    "./src/scitex/browser/interaction/click_center.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+__FILE__ = __file__
+
+"""
+Click center of viewport utility for browser automation.
+
+Functionalities:
+  - Clicks the center point of the browser viewport
+  - Provides visual feedback during operation
+  - Simple utility for centering interactions
+
+Dependencies:
+  - packages:
+    - playwright
+
+IO:
+  - input-files: None
+  - output-files: None
+"""
+
+"""Imports"""
+from scitex import logging
+
+logger = logging.getLogger(__name__)
+
+"""Functions & Classes"""
+async def click_center_async(
+    page, verbose: bool = False, func_name="click_center_async"
+):
+    """Click the center of the viewport.
+
+    Args:
+        page: Playwright page object
+        verbose: Enable visual feedback (default False)
+
+    Returns:
+        Click result
+    """
+    from ..debugging import browser_logger
+
+    if verbose:
+        await browser_logger.debug(
+            page,
+            f"{func_name}: Clicking the center of the page...",
+            verbose=verbose,
+        )
+
+    viewport_size = page.viewport_size
+    center_x = viewport_size["width"] // 2
+    center_y = viewport_size["height"] // 2
+    clicked = await page.mouse.click(center_x, center_y)
+    await page.wait_for_timeout(1_000)
+
+    logger.debug(f"{func_name}: Clicked center at ({center_x}, {center_y})")
+    return clicked
+
+
+def main(args):
+    """Demonstrate click_center functionality."""
+    import asyncio
+
+    from playwright.async_api import async_playwright
+
+    from ..debugging import browser_logger
+
+    async def demo():
+        async with async_playwright() as p:
+            browser = await p.chromium.launch(headless=False)
+            page = await browser.new_page()
+
+            await browser_logger.debug(
+                page, "Click Center: Starting demo", verbose=True
+            )
+
+            await page.goto("https://example.com", timeout=30000)
+
+            # Demonstrate clicking center
+            await click_center_async(page, verbose=True)
+
+            logger.success("Click center demonstration complete")
+
+            await browser_logger.debug(page, "✓ Demo complete", verbose=True)
+
+            await asyncio.sleep(2)
+            await browser.close()
+
+    asyncio.run(demo())
+    return 0
+
+
+def parse_args():
+    """Parse command line arguments."""
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Click center demo")
+    return parser.parse_args()
+
+
+def run_main() -> None:
+    """Initialize scitex framework, run main function, and cleanup."""
+    global CONFIG, CC, sys, plt, rng
+
+    import sys
+
+    import matplotlib.pyplot as plt
+
+    import scitex as stx
+
+    args = parse_args()
+
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
+        sys,
+        plt,
+        args=args,
+        file=__FILE__,
+        sdir_suffix=None,
+        verbose=False,
+        agg=True,
+    )
+
+    exit_status = main(args)
+
+    stx.session.close(
+        CONFIG,
+        verbose=False,
+        notify=False,
+        message="",
+        exit_status=exit_status,
+    )
+
+
+if __name__ == "__main__":
+    run_main()
+
+# python -m scitex.browser.interaction.click_center
+
+# EOF

scitex/browser/interaction/click_with_fallbacks.py

@@ -0,0 +1,206 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+# Timestamp: "2025-10-10 03:24:15 (ywatanabe)"
+# File: /home/ywatanabe/proj/scitex_repo/src/scitex/browser/interaction/click_with_fallbacks.py
+# ----------------------------------------
+from __future__ import annotations
+import os
+__FILE__ = (
+    "./src/scitex/browser/interaction/click_with_fallbacks.py"
+)
+__DIR__ = os.path.dirname(__FILE__)
+# ----------------------------------------
+
+from playwright.async_api import Page
+
+from scitex import logging
+
+logger = logging.getLogger(__name__)
+
+
+# 1. Main entry point
+# ---------------------------------------
+async def click_with_fallbacks_async(
+    page: Page, selector: str, method: str = "auto", verbose: bool = False
+) -> bool:
+    """Click element using multiple fallback methods.
+
+    Args:
+        page: Playwright page object
+        selector: CSS selector for the element
+        method: Click method ("auto", "playwright", "force", "js")
+        verbose: Enable visual feedback via popup system (default False)
+
+    Returns:
+        bool: True if click successful, False otherwise
+    """
+    from ..debugging import browser_logger
+
+    if method == "auto":
+        methods_order = ["playwright", "force", "js"]
+    else:
+        methods_order = [method]
+
+    methods = {
+        "playwright": _click_with_playwright,
+        "force": _click_with_force,
+        "js": _click_with_js,
+    }
+
+    if verbose:
+        await browser_logger.debug(
+            page, f"Attempting click: {selector}", verbose=verbose
+        )
+
+    for method_name in methods_order:
+        if method_name in methods:
+            success = await methods[method_name](page, selector)
+            if success:
+                logger.debug(
+                    f"Click successful with {method_name}: {selector}"
+                )
+                if verbose:
+                    await browser_logger.debug(
+                        page,
+                        f"✓ Click successful ({method_name}): {selector}",
+                        verbose=verbose,
+                    )
+                return True
+
+    logger.error(f"All click methods failed for {selector}")
+    if verbose:
+        await browser_logger.debug(
+            page, f"✗ All click methods failed: {selector}", verbose=verbose
+        )
+    return False
+
+
+# 2. Helper functions
+# ---------------------------------------
+async def _click_with_playwright(page: Page, selector: str) -> bool:
+    try:
+        await page.click(selector, timeout=5000)
+        return True
+    except Exception:
+        return False
+
+
+async def _click_with_force(page: Page, selector: str) -> bool:
+    try:
+        await page.click(selector, force=True, timeout=5000)
+        return True
+    except Exception:
+        return False
+
+
+async def _click_with_js(page: Page, selector: str) -> bool:
+    try:
+        result = await page.evaluate(
+            """(selector) => {
+                const element = document.querySelector(selector);
+                if (element) {
+                    element.click();
+                    return 'success';
+                }
+                return 'element not found';
+            }""",
+            selector,
+        )
+        return result == "success"
+    except Exception:
+        return False
+
+
+def main(args):
+    """Demonstrate click_with_fallbacks functionality."""
+    import asyncio
+
+    from playwright.async_api import async_playwright
+
+    from ..debugging import browser_logger
+
+    async def demo():
+        async with async_playwright() as p:
+            browser = await p.chromium.launch(headless=False)
+            page = await browser.new_page()
+
+            await browser_logger.debug(
+                page, "Click with Fallbacks: Starting demo", verbose=True
+            )
+
+            # Navigate to a test page
+            await page.goto("https://example.com", timeout=30000)
+
+            # Demonstrate clicking with verbose feedback
+            await browser_logger.debug(
+                page, "Testing click with fallbacks...", verbose=True
+            )
+
+            # Try to click a common element
+            success = await click_with_fallbacks_async(
+                page, "a", verbose=True  # Click first link
+            )
+
+            if success:
+                logger.success("Click demonstration completed successfully")
+            else:
+                logger.warning(
+                    "Click demonstration: no clickable element found"
+                )
+
+            await browser_logger.debug(page, "✓ Demo complete", verbose=True)
+
+            await asyncio.sleep(2)
+            await browser.close()
+
+    asyncio.run(demo())
+    return 0
+
+
+def parse_args():
+    """Parse command line arguments."""
+    import argparse
+
+    parser = argparse.ArgumentParser(description="Click with fallbacks demo")
+    return parser.parse_args()
+
+
+def run_main() -> None:
+    """Initialize scitex framework, run main function, and cleanup."""
+    global CONFIG, CC, sys, plt, rng
+
+    import sys
+
+    import matplotlib.pyplot as plt
+
+    import scitex as stx
+
+    args = parse_args()
+
+    CONFIG, sys.stdout, sys.stderr, plt, CC, rng = stx.session.start(
+        sys,
+        plt,
+        args=args,
+        file=__FILE__,
+        sdir_suffix=None,
+        verbose=False,
+        agg=True,
+    )
+
+    exit_status = main(args)
+
+    stx.session.close(
+        CONFIG,
+        verbose=False,
+        notify=False,
+        message="",
+        exit_status=exit_status,
+    )
+
+
+if __name__ == "__main__":
+    run_main()
+
+# python -m scitex.browser.interaction.click_with_fallbacks
+
+# EOF