chatup 0.2.1__tar.gz → 0.2.3__tar.gz

chatup-0.2.3/PKG-INFO

@@ -0,0 +1,90 @@
+Metadata-Version: 2.4
+Name: chatup
+Version: 0.2.3
+Summary: ChatArch setup CLI extracted from ChatTool
+Author-email: rexwzh <1073853456@qq.com>
+License-Expression: MIT
+Project-URL: Documentation, https://arch.gh.wzhecnu.cn/ChatUp/
+Project-URL: Source, https://github.com/ChatArch/ChatUp
+Project-URL: Issues, https://github.com/ChatArch/ChatUp/issues
+Keywords: chatup,chatarch,setup,cli
+Classifier: Programming Language :: Python :: 3
+Classifier: Operating System :: OS Independent
+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.1
+Requires-Dist: chatenv<0.3.0,>=0.2.0
+Requires-Dist: colorama
+Provides-Extra: docs
+Requires-Dist: mkdocs<2.0,>=1.6; extra == "docs"
+Requires-Dist: mkdocs-material<10.0,>=9.5; extra == "docs"
+Requires-Dist: mkdocs-static-i18n<2.0,>=1.3; extra == "docs"
+Requires-Dist: mike<3.0,>=2.1; extra == "docs"
+Dynamic: license-file
+
+# ChatUp
+
+ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chattool setup` 的职责，把常用开发环境、Agent CLI、工作区脚手架和本地服务安装整理成一级命令，例如 `chattool setup workspace` 对应 `chatup workspace`。
+
+- 文档站：<https://arch.gh.wzhecnu.cn/ChatUp/>
+- English README: [README.en.md](README.en.md)
+- Source: <https://github.com/ChatArch/ChatUp>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
+| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
+| 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
+| 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
+| 安装 ChatTea-compatible Gitea、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
+
+## 快速开始
+
+```bash
+chatup --help
+chatup doctor
+chatup uv
+chatup chrome-for-testing install --channel stable -I
+chatup workspace default ~/Playground
+```
+
+常见安装命令：
+
+```bash
+chatup gitea --force
+chatup mysql
+chatup nginx
+chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example.invalid --set PROXY_PASS=http://127.0.0.1:3000
+chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
+```
+
+## 当前能力
+
+| 能力组 | 命令 |
+| --- | --- |
+| 基础运行环境 | `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-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+
+## 开发
+
+```bash
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+mkdocs build --strict
+```
+
+更多使用说明见文档站的 [快速开始](https://arch.gh.wzhecnu.cn/ChatUp/quickstart/)、[命令参考](https://arch.gh.wzhecnu.cn/ChatUp/commands/) 和 [CLI 能力地图](https://arch.gh.wzhecnu.cn/ChatUp/capability-map/)。
+
+## 发布
+
+发布由 tag 驱动。`vX.Y.Z` tag 必须与 `src/chatup/__init__.py::__version__` 一致；发布 workflow 会通过 PyPI Trusted Publishing/OIDC 构建并发布到 PyPI。

chatup-0.2.3/README.md

@@ -0,0 +1,64 @@
+# ChatUp
+
+ChatUp 是 ChatArch 的独立环境与工具安装 CLI。它承接原来 `chattool setup` 的职责，把常用开发环境、Agent CLI、工作区脚手架和本地服务安装整理成一级命令，例如 `chattool setup workspace` 对应 `chatup workspace`。
+
+- 文档站：<https://arch.gh.wzhecnu.cn/ChatUp/>
+- English README: [README.en.md](README.en.md)
+- Source: <https://github.com/ChatArch/ChatUp>
+
+按场景选择文档：
+
+| 场景 | 文档 |
+| --- | --- |
+| 从空机器验证 ChatUp、Python runtime 和 workspace | `docs/quickstart.md` |
+| 查看完整一级 CLI 树与 CFT/ChromeDriver 独立 contract | `docs/cli-tree.md` |
+| 查看命令分组、参数边界和服务默认路径 | `docs/commands.md` |
+| 校对哪些 ChatArch setup 流程已经有一等命令 | `docs/capability-map.md` |
+| 理解 `chatup workspace` 创建的目录和项目记录约定 | `docs/workspace.md` |
+| 安装 ChatTea-compatible Gitea、ChatData-compatible MySQL、user-level NGINX 和 CRS | `docs/commands.md` |
+
+## 快速开始
+
+```bash
+chatup --help
+chatup doctor
+chatup uv
+chatup chrome-for-testing install --channel stable -I
+chatup workspace default ~/Playground
+```
+
+常见安装命令：
+
+```bash
+chatup gitea --force
+chatup mysql
+chatup nginx
+chatup nginx proxy-pass ./gitea-local.conf --set SERVER_NAME=gitea.local.example.invalid --set PROXY_PASS=http://127.0.0.1:3000
+chatup crs --install-dir ~/.chatarch/crs/local --port 12392 --redis-port 6379
+```
+
+## 当前能力
+
+| 能力组 | 命令 |
+| --- | --- |
+| 基础运行环境 | `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-for-testing`、`~/.chatarch/chromedriver`、`~/.chatarch/chattea`、`~/.chatarch/chatdata`、`~/.chatarch/nginx` 和 `~/.chatarch/crs/local`。更完整的能力边界见 `docs/capability-map.md`。
+
+## 开发
+
+```bash
+python -m pytest -q
+python -m build
+python -m twine check dist/*
+mkdocs build --strict
+```
+
+更多使用说明见文档站的 [快速开始](https://arch.gh.wzhecnu.cn/ChatUp/quickstart/)、[命令参考](https://arch.gh.wzhecnu.cn/ChatUp/commands/) 和 [CLI 能力地图](https://arch.gh.wzhecnu.cn/ChatUp/capability-map/)。
+
+## 发布
+
+发布由 tag 驱动。`vX.Y.Z` tag 必须与 `src/chatup/__init__.py::__version__` 一致；发布 workflow 会通过 PyPI Trusted Publishing/OIDC 构建并发布到 PyPI。

{chatup-0.2.1 → 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",
 ]
@@ -22,6 +22,19 @@ classifiers = [
     "Operating System :: OS Independent",
 ]
 
+[project.urls]
+Documentation = "https://arch.gh.wzhecnu.cn/ChatUp/"
+Source = "https://github.com/ChatArch/ChatUp"
+Issues = "https://github.com/ChatArch/ChatUp/issues"
+
+[project.optional-dependencies]
+docs = [
+    "mkdocs>=1.6,<2.0",
+    "mkdocs-material>=9.5,<10.0",
+    "mkdocs-static-i18n>=1.3,<2.0",
+    "mike>=2.1,<3.0",
+]
+
 [project.scripts]
 chatup = "chatup.cli:main"
 
@@ -40,6 +53,8 @@ include-package-data = true
     "assets/hermes/*.sh",
     "workspace/templates/default/zh/*.md",
     "workspace/templates/default/zh/projects/*.md",
+    "workspace/templates/default/zh/discussion/*.md",
     "workspace/templates/default/en/*.md",
     "workspace/templates/default/en/projects/*.md",
+    "workspace/templates/default/en/discussion/*.md",
 ]

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

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "0.2.1"
+__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.1 → 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."""