test-suite

使用ReFrame的软件安装便携式测试套件。

文档

有关安装、配置和使用EESSI测试套件的文档，请参阅https://eessi.io/docs/test-suite/。

开发

如果您想从分支安装EESSI测试套件，您可以使用pip安装功能分支，或者克隆GitHub仓库并检出功能分支。

使用pip从分支安装

要从主仓库的分支安装，使用以下命令

pip install git+https://github.com/EESSI/test-suite.git@branchname

通常，您会从分叉的仓库中执行此操作，在那里有人正在开发一个功能。例如。

pip install git+https://github.com/<someuser>/test-suite.git@branchname

从分叉检出功能分支

假设您已经有一个本地克隆的官方test-suite仓库，称为'origin'。在这种情况下，执行git remote -v，您应该看到

$ git remote -v
origin  git@github.com:EESSI/test-suite.git (fetch)
origin  git@github.com:EESSI/test-suite.git (push)

选项1：直接从PR创建分支

git fetch origin pull/ID/head:BRANCH_NAME

其中ID是拉取请求的编号，BRANCH_NAME是本地分支的名称（您可以自己选择）。

选项2：创建跟踪功能分支的分支

您可以通过添加新远程来将分叉添加到本地克隆。选择一个易于识别的远程名称。例如，要将https://github.com/casparvl/test-suite添加为分叉并给它（本地）名称casparvl，请运行

git remote add casparvl git@github.com:casparvl/test-suite.git

使用git remote -v，现在您应该看到新的远程

$ git remote -v
origin    git@github.com:EESSI/test-suite.git (fetch)
origin    git@github.com:EESSI/test-suite.git (push)
casparvl  git@github.com:casparvl/test-suite.git (fetch)
casparvl  git@github.com:casparvl/test-suite.git (push)

接下来，我们将获取casparvl在其分叉中拥有的分支

$ git fetch casparvl

我们可以使用以下命令检查远程分支：

$ git branch --list --remotes
  casparvl/example_branch
  casparvl/main
  origin/HEAD -> origin/main
  origin/main

（如果新分支没有使用此命令显示，请记住重新运行git fetch <remote>）。

最后，我们可以创建一个新的本地分支（-c）并检出其中一个功能分支（例如，远程casparvl中的example_branch）。在这里，我们选择了my_own_example_branch作为本地分支名称

$ git switch -c my_own_example_branch casparvl/example_branch

虽然初始设置稍微复杂一些，但这种方法的优势在于使用git pull轻松地从功能分支拉取更新。

您也可以直接将更改推送到功能分支，但请注意，您正在将更改推送到其他GitHub用户的GitHub分叉，所以在这样做之前请确保他们同意这样做！

发布管理

当EESSI测试套件的版本发布时，以下事项必须注意：

• 版本升级：在pyproject.toml和setup.cfg中；
• 在CI/run_reframe.sh中升级默认的EESSI_TESTSUITE_BRANCH；
• 发布说明：在RELEASE_NOTES + 在GitHub发布（参考https://github.com/EESSI/test-suite/releases/tag/v0.2.0）；
• 在GitHub上标记发布并发布发布（包括发布说明）；
• 发布到PyPI；

  # example for version 0.2.0
  python setup.py sdist
  twine upload dist/eessi_testsuite-0.2.0.tar.gz