This documentation was last rebuild on Dec 15, 2020 and is intended for version 0.9.0.

Please refer to for documentation on latest release. If you are working off devel branch then please to devel docs at


license Documentation Status codecov coveralls slack CodeFactor jsonschema2md checkurls blackformat clichecks regressiontest buildtest_scripts core_infrastructure black

Source Code


buildtest is a HPC testing framework to help sites perform acceptance & regression testing of an HPC system. buildtest utilizes json schema to define structure of test written in YAML called a Buildspec File. The schema docs is a resource that hosts buildtest schemas and documents all field attributes for each schema, this will be useful when you are writting buildspecs.

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

To get started with buildtest, please review the Terminology and proceed to Installing buildtest followed by Getting Started.

For additional reference, you can read Summary of buildtest and Conference and Publications.


buildtest is released under the MIT license

Indices and tables