chatup 0.2.3__tar.gz → 0.2.4__tar.gz

{chatup-0.2.3/src/chatup.egg-info → chatup-0.2.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: chatup
-Version: 0.2.3
+Version: 0.2.4
 Summary: ChatArch setup CLI extracted from ChatTool
 Author-email: rexwzh <1073853456@qq.com>
 License-Expression: MIT
@@ -37,7 +37,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 场景 | 文档 |
 | --- | --- |
 | 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
-| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
@@ -50,6 +50,7 @@ chatup --help
 chatup doctor
 chatup uv
 chatup chrome-for-testing install --channel stable -I
+chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
@@ -67,12 +68,12 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 
 | 能力组 | 命令 |
 | --- | --- |
-| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`frp` |
+| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.3 → chatup-0.2.4}/README.md

@@ -11,7 +11,7 @@ ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chatto
 | 场景 | 文档 |
 | --- | --- |
 | 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
-| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 阅读完整顶层 CLI 树和独立 CFT/ChromeDriver/Playwright contract | `docs/cli-tree.md` |
 | 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
 | 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
 | 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
@@ -24,6 +24,7 @@ chatup --help
 chatup doctor
 chatup uv
 chatup chrome-for-testing install --channel stable -I
+chatup playwright install 1.61.1 -I
 chatup workspace default ~/Playground
 ```
 
@@ -41,12 +42,12 @@ chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
 
 | 能力组 | 命令 |
 | --- | --- |
-| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`frp` |
+| 基础运行环境 | `doctor`、`uv`、`nodejs`、`docker`、`zsh`、`chrome-for-testing`、`chromedriver`、`playwright`、`frp` |
 | 工作区脚手架 | `workspace` |
 | 本地服务安装 | `gitea`、`mysql`、`nginx`、`crs` |
 | Agent 工具链 | `cc-connect`、`claude`、`codex`、`opencode`、`hermes`、`lark-cli` |
 
-所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+所有新增安装项默认目录都收敛到 `~/.chatarch/...`，例如 `~/.chatarch/chrome-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/playwright`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
 
 ## 开发
 

{chatup-0.2.3 → chatup-0.2.4}/src/chatup/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.3"
+__version__ = "0.2.4"

{chatup-0.2.3 → chatup-0.2.4}/src/chatup/cli.py

@@ -5,6 +5,7 @@ import click
 from chatup import __version__
 from chatup.commands.chrome_for_testing import cli as chrome_for_testing_cli
 from chatup.commands.chromedriver import cli as chromedriver_cli
+from chatup.commands.playwright import cli as playwright_cli
 from chatup.setup.cli import register_setup_commands
 
 
@@ -23,6 +24,7 @@ def doctor() -> None:
 register_setup_commands(main)
 main.add_command(chrome_for_testing_cli)
 main.add_command(chromedriver_cli)
+main.add_command(playwright_cli)
 
 
 if __name__ == "__main__":

chatup-0.2.4/src/chatup/commands/playwright.py

@@ -0,0 +1,213 @@
+from __future__ import annotations
+
+import json
+import re
+from pathlib import Path
+from typing import Any
+
+import click
+from chatstyle import (
+    CommandField,
+    CommandSchema,
+    add_interactive_option,
+    resolve_command_inputs,
+)
+
+import chatup.playwright as backend
+
+OUTPUT_TYPES = ("text", "json")
+
+
+def _validate_version(value: Any, _values: dict[str, Any]) -> str | None:
+    if re.fullmatch(r"\d+\.\d+\.\d+", str(value).strip()):
+        return None
+    return "Playwright version must contain three numeric components"
+
+
+VERSION_SCHEMA = CommandSchema(
+    name="playwright version",
+    fields=(
+        CommandField(
+            "version",
+            prompt="Exact Playwright version",
+            required=True,
+            normalizer=lambda value: str(value).strip(),
+            validator=_validate_version,
+        ),
+    ),
+)
+
+
+def _resolve_version(version: str | None, interactive: bool | None, action: str) -> str:
+    values = resolve_command_inputs(
+        schema=VERSION_SCHEMA,
+        provided={"version": version},
+        interactive=interactive,
+        usage=f"Usage: chatup playwright {action} [VERSION] [-i|-I]",
+    )
+    return str(values["version"])
+
+
+def _call(operation):
+    try:
+        return operation()
+    except backend.PlaywrightError as exc:
+        raise click.ClickException(str(exc)) from exc
+
+
+def _emit(payload: dict[str, Any], output: str) -> None:
+    if output.lower() == "json":
+        click.echo(json.dumps(payload, indent=2, sort_keys=True))
+        return
+    for key, value in payload.items():
+        if value is not None:
+            click.echo(f"{key}: {value}")
+
+
+@click.group(name="playwright")
+def cli() -> None:
+    """Manage user-level Playwright browser installations."""
+
+
+@cli.command(name="install")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option("--force", is_flag=True, help="Atomically replace an existing installation.")
+@click.option(
+    "--doctor/--no-doctor",
+    default=True,
+    show_default=True,
+    help="Probe the installed browser version.",
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def install_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    force: bool,
+    doctor: bool,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Install one exact Playwright package and browser."""
+
+    exact = _resolve_version(version, interactive, "install")
+    installation = _call(
+        lambda: backend.install(
+            exact,
+            browser=browser,
+            home=home,
+            force=force,
+        )
+    )
+    health = _call(lambda: backend.doctor(installation, execute=doctor))
+    _emit(health, output)
+    if health["status"] != "ready":
+        raise click.ClickException(
+            "Playwright installation is unhealthy: " + ", ".join(health["errors"])
+        )
+
+
+@cli.command(name="path")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def path_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Print the browser executable path for an installed Playwright version."""
+
+    exact = _resolve_version(version, interactive, "path")
+    installation = _call(
+        lambda: backend.resolve(exact, browser=browser, home=home)
+    )
+    if output.lower() == "json":
+        _emit(installation.to_dict(), output)
+    else:
+        click.echo(installation.binary_path)
+
+
+@cli.command(name="doctor")
+@click.argument("version", required=False)
+@click.option(
+    "--browser",
+    type=click.Choice(backend.SUPPORTED_BROWSERS, case_sensitive=False),
+    default="chromium",
+    show_default=True,
+)
+@click.option(
+    "--home",
+    type=click.Path(path_type=Path, file_okay=False),
+    default=backend.DEFAULT_HOME,
+    show_default=True,
+)
+@click.option(
+    "--execute/--no-execute",
+    default=True,
+    show_default=True,
+)
+@click.option(
+    "--output",
+    type=click.Choice(OUTPUT_TYPES, case_sensitive=False),
+    default="text",
+    show_default=True,
+)
+@add_interactive_option
+def doctor_command(
+    version: str | None,
+    browser: str,
+    home: Path,
+    execute: bool,
+    output: str,
+    interactive: bool | None,
+) -> None:
+    """Validate one installed Playwright browser."""
+
+    exact = _resolve_version(version, interactive, "doctor")
+    installation = _call(
+        lambda: backend.resolve(exact, browser=browser, home=home)
+    )
+    health = _call(lambda: backend.doctor(installation, execute=execute))
+    _emit(health, output)
+    if health["status"] != "ready":
+        raise click.ClickException(
+            "Playwright installation is unhealthy: " + ", ".join(health["errors"])
+        )

chatup-0.2.4/src/chatup/playwright.py

@@ -0,0 +1,62 @@
+"""Public API for ChatArch-managed Playwright browsers."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from chatup.runtime.playwright import (
+    DEFAULT_PLAYWRIGHT_HOME,
+    SUPPORTED_PLAYWRIGHT_BROWSERS,
+    PlaywrightBrowserInstallation,
+    PlaywrightError,
+    doctor_playwright_browser,
+    install_playwright_browser,
+    resolve_playwright_browser,
+)
+
+DEFAULT_HOME = DEFAULT_PLAYWRIGHT_HOME
+SUPPORTED_BROWSERS = SUPPORTED_PLAYWRIGHT_BROWSERS
+
+
+def install(
+    version: str,
+    *,
+    browser: str = "chromium",
+    home: Path | str | None = None,
+    force: bool = False,
+) -> PlaywrightBrowserInstallation:
+    return install_playwright_browser(
+        version,
+        browser=browser,
+        home=home,
+        force=force,
+    )
+
+
+def resolve(
+    version: str,
+    *,
+    browser: str = "chromium",
+    home: Path | str | None = None,
+) -> PlaywrightBrowserInstallation:
+    return resolve_playwright_browser(version, browser=browser, home=home)
+
+
+def doctor(
+    installation: PlaywrightBrowserInstallation,
+    *,
+    execute: bool = True,
+) -> dict[str, Any]:
+    return doctor_playwright_browser(installation, execute=execute)
+
+
+__all__ = [
+    "DEFAULT_HOME",
+    "SUPPORTED_BROWSERS",
+    "PlaywrightBrowserInstallation",
+    "PlaywrightError",
+    "doctor",
+    "install",
+    "resolve",
+]

chatup-0.2.4/src/chatup/runtime/__init__.py

@@ -0,0 +1,6 @@
+"""Internal implementations for backend-specific ChatUp artifacts.
+
+Public consumers should import :mod:`chatup.chrome_for_testing`,
+:mod:`chatup.chromedriver`, or :mod:`chatup.playwright` instead of this
+internal package.
+"""