Metadata-Version: 2.4
Name: openbench-cli
Version: 0.0.2
Summary: openbench dataset external client CLI
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: MacOS
Classifier: Operating System :: POSIX :: Linux
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: packaging>=23

# openbench-cli

`openbench-cli` 是 openbench 数据集平台的 Python 命令行客户端，安装后的命令是 **`ob`**。

它负责在本地创建一个数据集工作目录，把数据集标注、样本、原始文件与附加文件先写入本地暂存区（`.ds_cache`），再通过 HTTP/WebSocket 推送到远端数据集服务。整个流程更接近一个 Git 风格的数据集 CLI：

```text
准备数据集目录 -> ob upload 校验并转换（落云端 TEMP_VERSION，不自动发布）
              -> ob release 申请发布版本
              -> ob download 还原用户视图目录
```

## 安装

```bash
python -m pip install openbench-cli
```

安装后直接使用 `ob` 命令：

```bash
ob -h
ob upload <dataset-dir>
ob release -n <dataset> -v v1.0.0 -m "发布说明"
ob download -n <dataset>
```

## 说明

- 命令行统一为 `ob`（历史上是 `ds` / `ds-cli`，旧命令已不再提供）。
- 本地暂存区结构：`.ds_cache/changes/<version>/`，`add/update/rm` 只写入暂存区，需 `ob push` 才会同步云端。
- 数据集级标签由数据库驱动的 `custom_config` 规范校验，不在 CLI 内硬编码。
- 依赖 Python 3.9+。
