chatup 0.2.2__tar.gz → 0.2.3__tar.gz

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

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

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

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

{chatup-0.2.2 → chatup-0.2.3}/pyproject.toml

@@ -11,7 +11,7 @@ requires-python = ">=3.10"
 license = "MIT"
 dependencies = [
     "click>=8.0",
-    "chatstyle>=0.1.0,<0.2.0",
+    "chatstyle>=0.1.1,<0.2.0",
     "chatenv>=0.2.0,<0.3.0",
     "colorama",
 ]

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

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

chatup-0.2.3/src/chatup/chrome_for_testing.py

@@ -0,0 +1,126 @@
+"""Public API for ChatArch-managed Google Chrome for Testing."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from chatup.runtime.chrome_for_testing import (
+    DEFAULT_CHROME_FOR_TESTING_HOME,
+    SUPPORTED_CFT_PLATFORMS,
+    ChromeForTestingError,
+    ChromeForTestingInstallation,
+    doctor_chrome_for_testing,
+    ensure_chrome_for_testing,
+    garbage_collect_chrome_for_testing,
+    install_chrome_for_testing,
+    list_chrome_for_testing,
+    remove_chrome_for_testing,
+    resolve_chrome_for_testing,
+)
+
+DEFAULT_HOME = DEFAULT_CHROME_FOR_TESTING_HOME
+SUPPORTED_PLATFORMS = SUPPORTED_CFT_PLATFORMS
+
+
+def install(
+    version: str = "stable",
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+    expected_sha256: str | None = None,
+    force: bool = False,
+) -> ChromeForTestingInstallation:
+    return install_chrome_for_testing(
+        version,
+        home=home,
+        cft_platform=platform,
+        expected_sha256=expected_sha256,
+        force=force,
+    )
+
+
+def ensure(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+    expected_sha256: str | None = None,
+) -> ChromeForTestingInstallation:
+    return ensure_chrome_for_testing(
+        version,
+        home=home,
+        cft_platform=platform,
+        expected_sha256=expected_sha256,
+    )
+
+
+def resolve(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+) -> ChromeForTestingInstallation:
+    return resolve_chrome_for_testing(
+        version,
+        home=home,
+        cft_platform=platform,
+    )
+
+
+def list_installations(
+    *,
+    home: Path | str | None = None,
+) -> list[ChromeForTestingInstallation]:
+    return list_chrome_for_testing(home=home)
+
+
+def doctor(
+    installation: ChromeForTestingInstallation,
+    *,
+    execute: bool = True,
+) -> dict[str, Any]:
+    return doctor_chrome_for_testing(installation, execute=execute)
+
+
+def remove(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+) -> ChromeForTestingInstallation:
+    return remove_chrome_for_testing(
+        version,
+        home=home,
+        cft_platform=platform,
+    )
+
+
+def gc(
+    *,
+    home: Path | str | None = None,
+    dry_run: bool = True,
+    yes: bool = False,
+    minimum_age_seconds: int = 24 * 60 * 60,
+) -> dict[str, Any]:
+    return garbage_collect_chrome_for_testing(
+        home=home,
+        dry_run=dry_run,
+        yes=yes,
+        minimum_age_seconds=minimum_age_seconds,
+    )
+
+
+__all__ = [
+    "DEFAULT_HOME",
+    "SUPPORTED_PLATFORMS",
+    "ChromeForTestingError",
+    "ChromeForTestingInstallation",
+    "doctor",
+    "ensure",
+    "gc",
+    "install",
+    "list_installations",
+    "remove",
+    "resolve",
+]

chatup-0.2.3/src/chatup/chromedriver.py

@@ -0,0 +1,147 @@
+"""Public API for ChatArch-managed ChromeDriver installations."""
+
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Any
+
+from chatup.runtime.chromedriver import (
+    DEFAULT_CHROMEDRIVER_HOME,
+    SUPPORTED_CHROMEDRIVER_PLATFORMS,
+    ChromeDriverError,
+    ChromeDriverInstallation,
+    doctor_chromedriver,
+    ensure_chromedriver,
+    garbage_collect_chromedriver,
+    install_chromedriver,
+    list_chromedrivers,
+    read_browser_version,
+    remove_chromedriver,
+    resolve_chromedriver,
+    resolve_chromedriver_for_browser_version,
+)
+
+DEFAULT_HOME = DEFAULT_CHROMEDRIVER_HOME
+SUPPORTED_PLATFORMS = SUPPORTED_CHROMEDRIVER_PLATFORMS
+
+
+def install(
+    version: str | None = None,
+    *,
+    match_browser: Path | str | None = None,
+    match_cft_version: str | None = None,
+    home: Path | str | None = None,
+    platform: str | None = None,
+    expected_sha256: str | None = None,
+    force: bool = False,
+) -> ChromeDriverInstallation:
+    return install_chromedriver(
+        version,
+        match_browser=match_browser,
+        match_cft_version=match_cft_version,
+        home=home,
+        driver_platform=platform,
+        expected_sha256=expected_sha256,
+        force=force,
+    )
+
+
+def ensure(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+    expected_sha256: str | None = None,
+) -> ChromeDriverInstallation:
+    return ensure_chromedriver(
+        version,
+        home=home,
+        driver_platform=platform,
+        expected_sha256=expected_sha256,
+    )
+
+
+def resolve(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+) -> ChromeDriverInstallation:
+    return resolve_chromedriver(
+        version,
+        home=home,
+        driver_platform=platform,
+    )
+
+
+def resolve_for_browser_version(
+    browser_version: str,
+    *,
+    platform: str | None = None,
+) -> tuple[str, str, str]:
+    """Resolve the official compatible ChromeDriver artifact for a browser."""
+
+    return resolve_chromedriver_for_browser_version(
+        browser_version,
+        driver_platform=platform,
+    )
+
+
+def list_installations(
+    *,
+    home: Path | str | None = None,
+) -> list[ChromeDriverInstallation]:
+    return list_chromedrivers(home=home)
+
+
+def doctor(
+    installation: ChromeDriverInstallation,
+    *,
+    execute: bool = True,
+) -> dict[str, Any]:
+    return doctor_chromedriver(installation, execute=execute)
+
+
+def remove(
+    version: str,
+    *,
+    home: Path | str | None = None,
+    platform: str | None = None,
+) -> ChromeDriverInstallation:
+    return remove_chromedriver(
+        version,
+        home=home,
+        driver_platform=platform,
+    )
+
+
+def gc(
+    *,
+    home: Path | str | None = None,
+    dry_run: bool = True,
+    yes: bool = False,
+    minimum_age_seconds: int = 24 * 60 * 60,
+) -> dict[str, Any]:
+    return garbage_collect_chromedriver(
+        home=home,
+        dry_run=dry_run,
+        yes=yes,
+        minimum_age_seconds=minimum_age_seconds,
+    )
+
+
+__all__ = [
+    "DEFAULT_HOME",
+    "SUPPORTED_PLATFORMS",
+    "ChromeDriverError",
+    "ChromeDriverInstallation",
+    "doctor",
+    "ensure",
+    "gc",
+    "install",
+    "list_installations",
+    "read_browser_version",
+    "remove",
+    "resolve",
+    "resolve_for_browser_version",
+]

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

@@ -3,6 +3,8 @@ from __future__ import annotations
 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.setup.cli import register_setup_commands
 
 
@@ -19,6 +21,8 @@ def doctor() -> None:
 
 
 register_setup_commands(main)
+main.add_command(chrome_for_testing_cli)
+main.add_command(chromedriver_cli)
 
 
 if __name__ == "__main__":

chatup-0.2.3/src/chatup/commands/__init__.py

@@ -0,0 +1 @@
+"""Click command groups for ChatUp backends."""