cct-cli 0.7.9.0__py3-none-any.whl

calc_terminal/browser_gui/launcher.py

@@ -0,0 +1,173 @@
+"""
+DEPRECATED — Legacy separate-window browser launcher. NOT the normal Browser Mode.
+
+Normal Browser Mode uses calc_terminal.host.desktop.EmbeddedBrowserPane
+(QWebEngineView = real Chromium) instead, which is owned by CAT and runs
+in the same process.
+
+This module is kept for backward compatibility only. Do NOT use it as
+the primary browser entry point.
+"""
+
+from __future__ import annotations
+
+import os
+import sys
+import subprocess
+import pathlib
+
+def _has_module(name: str) -> bool:
+    try:
+        __import__(name)
+        return True
+    except ImportError:
+        return False
+
+def _launch_with_pyside(start_url: str) -> int:
+    try:
+        from .qt_browser import launch_qt_browser
+        return launch_qt_browser(start_url)
+    except Exception as e:
+        print(f"[CAT Browser] PySide6 launch failed: {e}", file=sys.stderr)
+        return 1
+
+def _launch_with_pyqt(start_url: str) -> int:
+    try:
+        # Qt browser is written for PySide6, but PyQt6 API is almost identical
+        # We try to reuse same file with an alias
+        import importlib
+        # Force import as PySide6 name if only PyQt6 installed — our qt_browser
+        # already handles both via try/except inside
+        from .qt_browser import launch_qt_browser
+        return launch_qt_browser(start_url)
+    except Exception as e:
+        print(f"[CAT Browser] PyQt launch failed: {e}", file=sys.stderr)
+        return 1
+
+def _launch_with_webview(start_url: str) -> int:
+    try:
+        from .webview_browser import launch_webview_browser
+        return launch_webview_browser(start_url)
+    except Exception as e:
+        print(f"[CAT Browser] pywebview launch failed: {e}", file=sys.stderr)
+        return 1
+
+def _launch_with_playwright(start_url: str) -> int:
+    try:
+        from .playwright_browser import launch_playwright_browser
+        return launch_playwright_browser(start_url)
+    except Exception as e:
+        print(f"[CAT Browser] Playwright launch failed: {e}", file=sys.stderr)
+        return 1
+
+def launch_browser_gui(start_url: str = "about:home", block: bool = True) -> int:
+    """
+    LEGACY separate-window launcher — DEPRECATED for normal Browser Mode.
+
+    Per the architecture fix, normal Browser Mode must NOT open a separate OS
+    window (webbrowser.open / Chrome / Edge / this launcher's old path).
+    It must create/show CAT's EMBEDDED browser view (QWebEngineView child of
+    CAT Host, inside the same CAT window that holds the terminal).
+
+    This function now ONLY delegates to the Host embedded path. If no
+    embedded engine is available, it ERRORS with install instructions
+    instead of launching a separate Chrome/Edge window (which would violate
+    the single-process requirement).
+
+    Normal code must call:  from calc_terminal.host.launcher import launch_cat_host
+    """
+    # Prefer Host embedded (correct architecture) when available
+    try:
+        from ..host.launcher import can_launch_host, launch_cat_host, get_host_status  # type: ignore
+        if can_launch_host():
+            # Delegate to Host — Browser INSIDE CAT (embedded QWebEngineView)
+            return launch_cat_host(start_browser_url=start_url, start_mode="browser", block=block)
+        else:
+            st = get_host_status()
+            print(f"[CAT Browser] ERROR: No EMBEDDED engine — cannot show Browser INSIDE CAT.", file=sys.stderr)
+            print(f"[CAT Browser] {st['reason']}", file=sys.stderr)
+            print("[CAT Browser] Install: pip install PySide6  (QWebEngineView child inside CAT Host)", file=sys.stderr)
+            print("[CAT Browser] Not launching separate Chrome/Edge (violates architecture).", file=sys.stderr)
+            print(f"[CAT Browser] URL that would have rendered inside CAT: {start_url}", file=sys.stderr)
+            return 2
+    except SystemExit:
+        raise
+    except Exception as e:
+        print(f"[CAT Browser] Host delegate failed ({e}) — not launching external.", file=sys.stderr)
+        return 1
+    # Legacy separate-window fallback REMOVED — Browser Mode must be embedded.
+    # The old _launch_with_* paths are kept below only for diagnostics but are
+    # NOT used for normal Browser Mode. Do not re-enable them without fixing
+    # the architecture violation.
+    # Check for a custom browser backend override
+    backend = os.environ.get("CAT_BROWSER_BACKEND", "").lower().strip()
+
+    # If block=False, spawn a new process so CAT terminal stays usable
+    if not block:
+        # Spawn detached process: python -m calc_terminal.browser_gui --url <url>
+        try:
+            cmd = [sys.executable, "-m", "calc_terminal.browser_gui", "--url", start_url]
+            kwargs = {}
+            if os.name == "nt":
+                # DETACHED_PROCESS
+                import subprocess as sp
+                kwargs["creationflags"] = sp.DETACHED_PROCESS | sp.CREATE_NEW_PROCESS_GROUP  # type: ignore
+            else:
+                kwargs["start_new_session"] = True
+            subprocess.Popen(cmd, **kwargs, cwd=os.getcwd())
+            return 0
+        except Exception as e:
+            print(f"[CAT Browser] Failed to spawn browser process: {e}", file=sys.stderr)
+            return 1
+
+    # Block path — try backends in order (or forced)
+    if backend in ("pyside", "pyside6"):
+        return _launch_with_pyside(start_url)
+    if backend in ("pyqt", "pyqt6"):
+        return _launch_with_pyqt(start_url)
+    if backend in ("playwright", "pw"):
+        return _launch_with_playwright(start_url)
+    if backend in ("webview", "pywebview"):
+        return _launch_with_webview(start_url)
+
+    # Auto-detect — Playwright is already required for CAT Preview, so it will be available
+    # and gives a real Chromium window without extra Qt install
+    if _has_module("PySide6"):
+        rc = _launch_with_pyside(start_url)
+        if rc == 0:
+            return rc
+    if _has_module("PyQt6"):
+        rc = _launch_with_pyqt(start_url)
+        if rc == 0:
+            return rc
+    # Playwright visible window is always available if CAT Preview works — use it as primary fallback
+    # (real HTML/CSS/JS, no text extraction)
+    if _has_module("playwright"):
+        rc = _launch_with_playwright(start_url)
+        if rc == 0:
+            return rc
+    if _has_module("webview"):
+        rc = _launch_with_webview(start_url)
+        if rc == 0:
+            return rc
+
+    # No GUI backend installed
+    print("\n[CAT Browser] No graphical browser backend found.", file=sys.stderr)
+    print("Install one of (Playwright already covers Preview, but for standalone window):", file=sys.stderr)
+    print("  pip install playwright && playwright install chromium  # already for CAT Preview", file=sys.stderr)
+    print("  pip install PySide6   # full browser with tabs/toolbar", file=sys.stderr)
+    print("  pip install pywebview # lightweight WebView2", file=sys.stderr)
+    print("\nAfter installing, run again:", file=sys.stderr)
+    print(f"  cat browse {start_url}" if start_url != "about:home" else "  cat browse", file=sys.stderr)
+    return 2
+
+def main():
+    import argparse
+    p = argparse.ArgumentParser(description="CAT Browser — graphical WebView2/Chromium window")
+    p.add_argument("--url", default="about:home", help="URL to open")
+    p.add_argument("--no-block", action="store_true", help="Don't block, spawn detached")
+    args = p.parse_args()
+    sys.exit(launch_browser_gui(args.url, block=not args.no_block))
+
+if __name__ == "__main__":
+    main()

calc_terminal/browser_gui/playwright_browser.py

@@ -0,0 +1,117 @@
+"""
+Playwright visible browser — fallback when Qt not available.
+Launches a real Chromium window (headless=False) with the URL.
+This is a real browser rendering (HTML/CSS/JS), not text.
+Used for CAT Browser when PySide6/PyQt not installed but Playwright is.
+"""
+
+from __future__ import annotations
+
+import time
+import sys
+
+def launch_playwright_browser(start_url: str = "about:home") -> int:
+    try:
+        from playwright.sync_api import sync_playwright
+    except ImportError:
+        print("[CAT Browser] Playwright not installed. Run: pip install playwright && playwright install chromium", file=sys.stderr)
+        return 2
+
+    if start_url in ("about:home", "about:blank", "", None):
+        # For new-tab, show a simple CAT page via data URL with real HTML
+        html = f"""<!doctype html>
+<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
+<title>CAT — New Tab</title>
+<style>
+  body{{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Helvetica,Arial,sans-serif;background:#1a1b26;color:#e8ebfa;display:flex;align-items:center;justify-content:center;min-height:100vh;margin:0;padding:40px}}
+  .wrap{{width:640px;max-width:100%;text-align:center}}
+  .logo{{font-size:42px;font-weight:800;letter-spacing:0.08em;margin-bottom:28px}}
+  .logo span{{color:#82aaff}}
+  .search{{display:flex;align-items:center;background:#1e2030;border:1px solid #737aa2;border-radius:999px;padding:14px 18px}}
+  .search input{{flex:1;background:transparent;border:none;outline:none;color:#e8ebfa;font-size:16px}}
+  .grid{{display:grid;grid-template-columns:repeat(4,1fr);gap:14px;margin-top:28px}}
+  .card{{background:#1e2030;border:1px solid #737aa2;border-radius:16px;padding:18px;text-decoration:none;color:#e8ebfa;display:flex;flex-direction:column;align-items:center;gap:10px}}
+  .card:hover{{border-color:#82aaff}}
+</style>
+<div class="wrap">
+  <div class="logo">C<span>A</span>T</div>
+  <div class="search"><span>🔍</span><input id="q" placeholder="Search or enter a URL" style="flex:1;background:transparent;border:none;outline:none;color:#e8ebfa;font-size:16px;margin-left:10px"></div>
+  <div class="grid">
+    <a class="card" href="https://youtube.com">▶<br>YouTube</a>
+    <a class="card" href="https://github.com">⬢<br>GitHub</a>
+    <a class="card" href="https://mail.google.com">✉<br>Gmail</a>
+    <a class="card" href="http://localhost:3000/connector.html">🔗<br>Fomoji</a>
+  </div>
+  <div style="margin-top:22px;color:#878caf;font-size:12px">CAT Browser · Fomoji-protected · Chromium</div>
+</div>
+<script>
+  const inp = document.getElementById('q');
+  inp.addEventListener('keydown', e=>{{
+    if(e.key==='Enter'){{
+      const v=inp.value.trim();
+      if(!v) return;
+      const hasScheme=/^[a-zA-Z][a-zA-Z0-9+.-]*:/.test(v);
+      const isLocal=v.includes('localhost');
+      if(hasScheme||isLocal||(v.includes('.')&&!v.includes(' '))){{
+        location.href = hasScheme?v:'https://'+v;
+      }} else {{
+        location.href='https://www.google.com/search?q='+encodeURIComponent(v)+'&hl=en';
+      }}
+    }}
+  }});
+</script>
+"""
+        import urllib.parse
+        start_url = "data:text/html;charset=utf-8," + urllib.parse.quote(html)
+
+    # Normalize localhost without scheme
+    if start_url.startswith("localhost:"):
+        start_url = "http://" + start_url
+
+    print(f"[CAT Browser] Opening graphical browser (Playwright Chromium) → {start_url}")
+    print("[CAT Browser] Close the browser window to return to CAT.")
+    try:
+        from pathlib import Path
+        user_data_dir = str(Path.home() / ".cat_browser_playwright_data")
+        with sync_playwright() as p:
+            # headless=False gives a real OS window with full rendering
+            # Use persistent context so Fomoji cookies persist between sessions
+            context = p.chromium.launch_persistent_context(
+                user_data_dir,
+                headless=False,
+                args=["--disable-blink-features=AutomationControlled"],
+                viewport={"width": 1280, "height": 800},
+            )
+            # For Fomoji, we need to handle new tabs (target=_blank) — open as new page
+            def handle_new_page(new_page):
+                new_page.wait_for_load_state()
+            context.on("page", handle_new_page)
+            if context.pages:
+                page = context.pages[0]
+            else:
+                page = context.new_page()
+            page.goto(start_url, wait_until="domcontentloaded", timeout=15000)
+            # Keep browser open until user closes window
+            try:
+                while True:
+                    time.sleep(0.5)
+                    if len(context.pages) == 0:
+                        break
+                    try:
+                        _ = context.browser
+                    except Exception:
+                        break
+            except KeyboardInterrupt:
+                pass
+            finally:
+                try:
+                    context.close()
+                except Exception:
+                    pass
+        return 0
+    except Exception as e:
+        print(f"[CAT Browser] Playwright launch failed: {e}", file=sys.stderr)
+        # If chromium not downloaded, try to suggest install
+        if "Executable doesn't exist" in str(e) or "chromium" in str(e).lower():
+            print("Run: playwright install chromium", file=sys.stderr)
+        return 1