Metadata-Version: 2.4
Name: testtools-cli
Version: 0.2.19
Summary: TestSolar TestTool CLI
Project-URL: repository, https://github.com/OpenTestSolar/testtools-cli
Author-email: asiazhang <asiazhang2002@gmail.com>
License: Apache License 2.0
License-File: LICENSE
Keywords: cli,testsolar
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.9
Requires-Dist: pydantic-settings>=2.6.1
Requires-Dist: rich>=13.7.1
Requires-Dist: solar-registry>=0.3.27
Requires-Dist: typer>=0.12.3
Requires-Dist: urllib3==1.26.6
Description-Content-Type: text/markdown

# testtools-cli
testtools命令行工具，主要提供脚手架辅助功能

## 安装

```shell
pip install testtools-cli
```

## 如何使用

### 💾testtools-cli install

安装工具开发依赖的相关组件，目前包括:

- solarctl

### ✨testtools-cli init

在指定目录(默认当前目录)创建测试工具脚手架内容,当前支持语言：

- python
- golang

使用例子：

```shell
testtools-cli init
```

```shell
testtools-cli init --workdir /tmp/jagma
```

> 测试工具建议使用小写英文名称。

### 🪄testtools-cli check

检查指定目录(默认当前目录)的脚手架内容还有哪些要修改的。

- \_\_TODO\_\_: 必须实现的部分

> 必须实现的部分主要包括用例的**加载**、**执行**以及**结果的上报**

- \_\_RECOMMANDTODO\_\_: 建议实现的部分

> 建议实现的部分主要为工具的元数据信息，包括homePage（工具主页）、repository（工具源码地址）、gitPkgUrl以及httpPkgUrl（工具压缩包地址）等

### 🐞testtools-cli debug

执行`加载用例`及`执行用例`并输出工具日志，命令支持参数如下所示:

- `--case-root`指定用例库根目录，若不传入则默认为当前目录

- `--target`指定加载/执行的用例范围，支持传入多个执行目标，若不传入则默认执行用例库下所有用例。

- `--tool`指定开发的工具所在目录，若不传入则默认为当前目录

- `--commands`指定构建 TestContainer 时执行的自定义命令，适用于用例执行过程中需要安装额外依赖的场景，支持传入多个命令

## 开发说明

脚手架内容按照语言统一放到 [脚手架目录](./src/testtools_cli/generator/scaffold) 下面。模板语言使用Jinja2，只有2条简单规则：

- 文件内容中的`{{name}}`会被替换为输入的工具名称
- 路径中的`{{name}}`会被替换为输入的工具名称