compshare-cli 0.3.4__tar.gz → 0.3.5__tar.gz

compshare_cli-0.3.5/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: compshare-cli
+Version: 0.3.5
+Summary: Command-line client for CompShare GPU compute
+Author: CompShare
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/BennielAllan/compshare-cli
+Project-URL: Repository, https://github.com/BennielAllan/compshare-cli
+Project-URL: Changelog, https://github.com/BennielAllan/compshare-cli/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/BennielAllan/compshare-cli/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9,>=8.1
+Requires-Dist: pexpect<5,>=4.9; platform_system != "Windows"
+Requires-Dist: rich<15,>=13
+Requires-Dist: typer<1,>=0.12
+Requires-Dist: ucloud-sdk-python3<0.12,>=0.11.103
+Requires-Dist: urllib3<2,>=1.26.18; python_version < "3.10" and platform_system == "Darwin"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-cov<8,>=5; extra == "dev"
+Requires-Dist: ruff<1,>=0.6; extra == "dev"
+Dynamic: license-file
+
+# CompShare CLI
+
+在终端管理优云智算 GPU 实例、镜像、云盘、US3 挂载和团队资源。
+
+- 交互式创建实例，实时查询规格、库存和价格
+- 支持批量生命周期操作、等待状态和跨地域查询
+- 支持可断线恢复的远程任务、状态查询和增量日志读取
+- 支持社区/自定义镜像、云盘、团队额度与账单
+- 默认中文帮助，可切换英文；所有命令支持 JSON 输出
+- 可通过 `compshare ask` 查询产品使用和计费知识
+- 可通过 `compshare feedback` 反馈 CLI 问题和建议
+
+## 安装
+
+```bash
+pip install compshare-cli
+pip install --upgrade compshare-cli
+```
+
+## 配置
+
+```bash
+compshare config --name default
+```
+
+凭证保存在 `~/.config/compshare/config.json`，支持多个配置：
+
+```bash
+compshare config list
+compshare config use production
+compshare --profile production instance list
+```
+
+也可以使用环境变量：
+
+```bash
+export COMPSHARE_PUBLIC_KEY='...'
+export COMPSHARE_PRIVATE_KEY='...'
+```
+
+## 快速开始
+
+```bash
+# 查询、创建和查看实例
+compshare instance search --region cn-sh2 --zone cn-sh2-02
+compshare instance create
+compshare instance list --all
+
+# 连接实例
+compshare instance ssh INSTANCE_ID
+
+# 查看帮助
+compshare -h
+compshare instance -h
+```
+
+## 命令概览
+
+```text
+compshare config     API 凭证配置
+compshare feedback   反馈 CLI 问题或建议
+compshare doctor     配置、鉴权、网络与 SSH 环境诊断
+compshare ask        产品使用和计费问答
+compshare instance   GPU 实例、规格、库存、价格和生命周期
+compshare image      平台、自定义、社区及共享镜像
+compshare storage    云盘和 US3 挂载
+compshare team       团队、邀请、成员额度、账单和审计
+```
+
+## Skill
+
+为 Codex、Claude Code、Cursor 等 AI Agent 安装 CompShare CLI Skill：
+
+```bash
+npx skills add compshare-cn/compshare-cli --skill compshare-cli
+```
+
+完整说明见 [CompShare CLI Skill](skills/compshare-cli/SKILL.md)。
+
+## SDK
+
+如需通过 SDK 集成 CompShare API，可参考独立的
+[CompShare Developer Examples](https://github.com/ucloud/compshare-developer-examples) 仓库。
+其中包含 Python、Go、Java、JavaScript 和 PHP 示例，覆盖 API 鉴权、GPU 实例创建、规格配置和状态查询。

compshare_cli-0.3.5/README.md

@@ -0,0 +1,84 @@
+# CompShare CLI
+
+在终端管理优云智算 GPU 实例、镜像、云盘、US3 挂载和团队资源。
+
+- 交互式创建实例，实时查询规格、库存和价格
+- 支持批量生命周期操作、等待状态和跨地域查询
+- 支持可断线恢复的远程任务、状态查询和增量日志读取
+- 支持社区/自定义镜像、云盘、团队额度与账单
+- 默认中文帮助，可切换英文；所有命令支持 JSON 输出
+- 可通过 `compshare ask` 查询产品使用和计费知识
+- 可通过 `compshare feedback` 反馈 CLI 问题和建议
+
+## 安装
+
+```bash
+pip install compshare-cli
+pip install --upgrade compshare-cli
+```
+
+## 配置
+
+```bash
+compshare config --name default
+```
+
+凭证保存在 `~/.config/compshare/config.json`，支持多个配置：
+
+```bash
+compshare config list
+compshare config use production
+compshare --profile production instance list
+```
+
+也可以使用环境变量：
+
+```bash
+export COMPSHARE_PUBLIC_KEY='...'
+export COMPSHARE_PRIVATE_KEY='...'
+```
+
+## 快速开始
+
+```bash
+# 查询、创建和查看实例
+compshare instance search --region cn-sh2 --zone cn-sh2-02
+compshare instance create
+compshare instance list --all
+
+# 连接实例
+compshare instance ssh INSTANCE_ID
+
+# 查看帮助
+compshare -h
+compshare instance -h
+```
+
+## 命令概览
+
+```text
+compshare config     API 凭证配置
+compshare feedback   反馈 CLI 问题或建议
+compshare doctor     配置、鉴权、网络与 SSH 环境诊断
+compshare ask        产品使用和计费问答
+compshare instance   GPU 实例、规格、库存、价格和生命周期
+compshare image      平台、自定义、社区及共享镜像
+compshare storage    云盘和 US3 挂载
+compshare team       团队、邀请、成员额度、账单和审计
+```
+
+## Skill
+
+为 Codex、Claude Code、Cursor 等 AI Agent 安装 CompShare CLI Skill：
+
+```bash
+npx skills add compshare-cn/compshare-cli --skill compshare-cli
+```
+
+完整说明见 [CompShare CLI Skill](skills/compshare-cli/SKILL.md)。
+
+## SDK
+
+如需通过 SDK 集成 CompShare API，可参考独立的
+[CompShare Developer Examples](https://github.com/ucloud/compshare-developer-examples) 仓库。
+其中包含 Python、Go、Java、JavaScript 和 PHP 示例，覆盖 API 鉴权、GPU 实例创建、规格配置和状态查询。

{compshare_cli-0.3.4 → compshare_cli-0.3.5}/src/compshare_cli/__init__.py

@@ -1,3 +1,3 @@
 """CompShare command-line client."""
 
-__version__ = "0.3.4"
+__version__ = "0.3.5"

{compshare_cli-0.3.4 → compshare_cli-0.3.5}/src/compshare_cli/location.py

@@ -77,11 +77,7 @@ def locate_disk(
     zone = str(disk.get("Zone") or "")
     locations = supported_locations(state, request_region=request_region)
     location = next(
-        (
-            item
-            for item in locations
-            if str(item.get("Zone") or "") == zone and item.get("Region")
-        ),
+        (item for item in locations if str(item.get("Zone") or "") == zone and item.get("Region")),
         None,
     )
     if location is None:
@@ -95,8 +91,6 @@ def locate_disk(
     region = str(location["Region"])
     mount_instance = disk.get("MountInstance")
     host = (
-        {"UHostId": str(mount_instance), "Region": region, "Zone": zone}
-        if mount_instance
-        else None
+        {"UHostId": str(mount_instance), "Region": region, "Zone": zone} if mount_instance else None
     )
     return region, zone, host, disk

compshare_cli-0.3.5/src/compshare_cli.egg-info/PKG-INFO

@@ -0,0 +1,109 @@
+Metadata-Version: 2.4
+Name: compshare-cli
+Version: 0.3.5
+Summary: Command-line client for CompShare GPU compute
+Author: CompShare
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/BennielAllan/compshare-cli
+Project-URL: Repository, https://github.com/BennielAllan/compshare-cli
+Project-URL: Changelog, https://github.com/BennielAllan/compshare-cli/blob/master/CHANGELOG.md
+Project-URL: Issues, https://github.com/BennielAllan/compshare-cli/issues
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click<9,>=8.1
+Requires-Dist: pexpect<5,>=4.9; platform_system != "Windows"
+Requires-Dist: rich<15,>=13
+Requires-Dist: typer<1,>=0.12
+Requires-Dist: ucloud-sdk-python3<0.12,>=0.11.103
+Requires-Dist: urllib3<2,>=1.26.18; python_version < "3.10" and platform_system == "Darwin"
+Provides-Extra: dev
+Requires-Dist: pytest<10,>=8; extra == "dev"
+Requires-Dist: pytest-cov<8,>=5; extra == "dev"
+Requires-Dist: ruff<1,>=0.6; extra == "dev"
+Dynamic: license-file
+
+# CompShare CLI
+
+在终端管理优云智算 GPU 实例、镜像、云盘、US3 挂载和团队资源。
+
+- 交互式创建实例，实时查询规格、库存和价格
+- 支持批量生命周期操作、等待状态和跨地域查询
+- 支持可断线恢复的远程任务、状态查询和增量日志读取
+- 支持社区/自定义镜像、云盘、团队额度与账单
+- 默认中文帮助，可切换英文；所有命令支持 JSON 输出
+- 可通过 `compshare ask` 查询产品使用和计费知识
+- 可通过 `compshare feedback` 反馈 CLI 问题和建议
+
+## 安装
+
+```bash
+pip install compshare-cli
+pip install --upgrade compshare-cli
+```
+
+## 配置
+
+```bash
+compshare config --name default
+```
+
+凭证保存在 `~/.config/compshare/config.json`，支持多个配置：
+
+```bash
+compshare config list
+compshare config use production
+compshare --profile production instance list
+```
+
+也可以使用环境变量：
+
+```bash
+export COMPSHARE_PUBLIC_KEY='...'
+export COMPSHARE_PRIVATE_KEY='...'
+```
+
+## 快速开始
+
+```bash
+# 查询、创建和查看实例
+compshare instance search --region cn-sh2 --zone cn-sh2-02
+compshare instance create
+compshare instance list --all
+
+# 连接实例
+compshare instance ssh INSTANCE_ID
+
+# 查看帮助
+compshare -h
+compshare instance -h
+```
+
+## 命令概览
+
+```text
+compshare config     API 凭证配置
+compshare feedback   反馈 CLI 问题或建议
+compshare doctor     配置、鉴权、网络与 SSH 环境诊断
+compshare ask        产品使用和计费问答
+compshare instance   GPU 实例、规格、库存、价格和生命周期
+compshare image      平台、自定义、社区及共享镜像
+compshare storage    云盘和 US3 挂载
+compshare team       团队、邀请、成员额度、账单和审计
+```
+
+## Skill
+
+为 Codex、Claude Code、Cursor 等 AI Agent 安装 CompShare CLI Skill：
+
+```bash
+npx skills add compshare-cn/compshare-cli --skill compshare-cli
+```
+
+完整说明见 [CompShare CLI Skill](skills/compshare-cli/SKILL.md)。
+
+## SDK
+
+如需通过 SDK 集成 CompShare API，可参考独立的
+[CompShare Developer Examples](https://github.com/ucloud/compshare-developer-examples) 仓库。
+其中包含 Python、Go、Java、JavaScript 和 PHP 示例，覆盖 API 鉴权、GPU 实例创建、规格配置和状态查询。

{compshare_cli-0.3.4 → compshare_cli-0.3.5}/tests/test_location.py

@@ -137,9 +137,7 @@ def test_locate_disk_supports_detached_disk(monkeypatch) -> None:
     def fake_call(state, action, params):
         if action == "DescribeCompshareDisk":
             return {
-                "DiskSet": [
-                    {"ResourceId": "udisk-1", "Zone": "cn-sh2-02", "MountInstance": ""}
-                ]
+                "DiskSet": [{"ResourceId": "udisk-1", "Zone": "cn-sh2-02", "MountInstance": ""}]
             }
         return {"ZoneInfo": [{"Region": "cn-sh2", "Zone": "cn-sh2-02"}]}