This documentation was rebuilt on and is intended for version .
If you are working off the latest release please see https://buildtest.readthedocs.io/en/latest/ for documentation. If you are working off the devel branch then please refer to https://buildtest.readthedocs.io/en/devel/ for documentation.
buildtest is a testing framework to help HPC sites write test for their system as part of their routine acceptance and regression testing. Buildtest provides a YAML interface to write tests which buildtest can validate and then use to generate shell scripts that run on your HPC system. The test template (YAML) is called a buildspec which can define one or more test instances and is validated by a json schema. Buildtest supports the following batch schedulers: IBM Spectrum LSF, Slurm, PBS and Cobalt.
To learn more about buildtest, see the What is buildtest?
A spin-off project called lmodule is a Python API for Lmod. The buildtest module features were deprecated and moved to lmodule with the main objective is to automate module load testing. For more details on lmodule see https://github.com/buildtesters/lmodule.
If you are interested in trying out buildtest, first install buildtest <installing_buildtest> and check out the quick start guide <quick_start>. Next, go through the Getting Started Guide <getting_started> which will walk you through the basic features of buildtest. Once you are ready to write tests, check out the writing buildspecs guide <writing_buildspecs> which will discuss how to write buildspecs.
If you are first time user of buildtest, we recommend you to go through the command line tutorial <command_line_tutorial> and buildspec tutorial <buildspec_tutorial>.
- Source Code: https://github.com/buildtesters/buildtest
- Documentation: http://buildtest.rtfd.io/
- Buildtest Home Page: https://buildtesters.github.io/buildtest.io/
- ReadTheDocs: https://readthedocs.org/projects/buildtest/
- CodeCov: https://codecov.io/gh/buildtesters/buildtest
- Slack Channel: http://hpcbuildtest.slack.com
- Slack Invite: https://communityinviter.com/apps/hpcbuildtest/buildtest-slack-invitation
- CodeFactor: https://www.codefactor.io/repository/github/buildtesters/buildtest
- Snyk: https://app.snyk.io/org/buildtesters/
- NERSC Test Repository: https://github.com/buildtesters/buildtest-nersc
what_is_buildtest
installing_buildtest quick_start
command_line_tutorial buildspec_tutorial buildtest_perlmutter
configuring_buildtest batch_support troubleshooting
builder buildtest_site
getting_started writing_buildspecs features schema_examples facility_examples api command conferences
contributing
Buildtest Github repo <https://github.com/buildtesters/buildtest> Buildtest Slack <https://hpcbuildtest.slack.com> buildtest at NERSC <https://github.com/buildtesters/buildtest-nersc>
buildtest is released under the MIT license
genindexmodindexsearch