Tackle-Test CLIJava 应用程序自动化测试生成器

这个仓库包含一个基于 Python 的命令行接口（CLI）—— tkltest，用于 Tackle-Test 工具。tlktest 为 Java 单元测试提供了这种能力，单元测试用例可以在给定的应用程序版本（基础版本）上自动生成，并针对修改后的版本执行以检测差异。

安装和运行 CLI

CLI 命令可以安装在本地运行，也可以在 Docker 容器中运行，在这种情况下，各种依赖（Java、Ant 和 Maven）不需要在本地安装。

先决条件

要以任何一种方式运行 CLI，都需要从托管在 GitHub 上的 Maven 存储库下载一些 jar 文件，这需要身份验证。要启用身份验证，请创建一个具有权限的GitHub 个人访问令牌read:packages。

通过 Docker 或 Docker Compose 运行 CLI

要使用docker-compose运行 CLI，请在 CLI 目录中运行以下命令，该命令为 CLI 构建 docker 映像（称为tkltest-cli），然后运行 ​​CLI 命令；docker 容器在 CLI 命令完成后被删除。

docker-compose run --rm tkltest-cli --help

或者，要使用docker而不是 docker-compose构建和运行 CLI，请在 CLI 目录中运行命令：

docker build --build-arg GITHUB_TOKEN=$GITHUB_TOKEN --build-arg GITHUB_USERNAME=$GITHUB_USERNAME --tag tkltest-cli .
docker run --rm -it -v /path-to-the-cli-directory:/app/tackle-test-cli tkltest-cli --help

请注意，在这两种情况下，CLI 目录都挂载到容器上，以便在容器中生成或执行测试的结果在主机上的 CLI 目录中可用。

为了方便通过docker-compose或 docker运行 CLI，用户可以创建一个别名，例如：

alias tkltest='docker-compose run --rm tkltest-cli'
alias tkltest='docker run --rm -it -v /path-to-the-cli-directory:/app/tackle-test-cli tkltest-cli'

从本地安装运行 CLI

要从本地安装运行 CLI，需要安装 JDK、Ant 和 Maven。此外，需要下载 Java 库依赖项。

1. 安装 Python 3.8

2. 安装 JDK 8

3. 安装 Ant，Ant 可执行文件必须在路径中

4. 安装 Maven，Maven 可执行文件必须在路径中。

5. 使用脚本 lib/download_lib_jars.sh 下载 Java 库

6. 最后，要tkltest在虚拟环境中安装 CLI 命令，请执行以下步骤：

   python3 -m venv venv
   source venv/bin/activate
   pip install .

   Windows 用户应该运行：

   python3 -m venv venv
   venv\Scripts\activate.bat
   pip install --editable .

要安装用于开发的 CLI，请设置可编辑模式：pip install --editable。