Installing buildtest

Requirements

You need the following packages to get started.

  • git

  • Python >= 3.6

  • pip

Cloning buildtest

To get started, clone the buildtest repository in your local machine as follows:

$ git clone https://github.com/buildtesters/buildtest.git

If you prefer the SSH method, make sure your GitHub account is configured properly, for more details see Connecting to GitHub with SSH

Once your account is configured you can clone the repository as follows:

$ git clone git@github.com:buildtesters/buildtest.git

If you prefer the latest release use the master branch:

$ git clone -b master git@github.com:buildtesters/buildtest.git

Installing buildtest

To install buildtest run the following depending on your shell:

# BASH users
$ source setup.sh

# CSH users
$ source setup.csh

You may want to create an isolated python environment of choice depending on your preference you can use any of the following

Development Dependencies (Optional)

If you plan to contribute back to buildtest, you will need to install additional dependencies found in the requirements file in docs/requirements.txt as follows:

$ pip install -r docs/requirements.txt

Usage (buildtest --help)

Once you are setup, you can run buildtest --help for more details on how to use buildtest. Shown below is the output

$ buildtest --help
usage: buildtest [options] [COMMANDS]

buildtest is a HPC testing framework for building and executingtests. Buildtest comes with a set of json-schemas used to write test configuration (Buildspecs) in YAML to generate test scripts.

optional arguments:
  -h, --help            show this help message and exit
  -V, --version         show program's version number and exit
  -d {DEBUG,INFO,WARNING,ERROR,CRITICAL}, --debug {DEBUG,INFO,WARNING,ERROR,CRITICAL}
                        Enable debugging messages.

COMMANDS:
  
   build                          Options for building test scripts
   buildspec                      Command options for buildspecs
   report                         Show report for test results  
   schema                         Commands for viewing buildtest schemas
   config                         Buildtest Configuration Menu  
   inspect                        Inspect details for test from test report
   docs                           Open buildtest docs in browser
   schemadocs                     Open buildtest schema docs in browser

  {docs,schemadocs,build,buildspec,report,inspect,schema,config}

Documentation: https://buildtest.readthedocs.io/en/latest/index.html

buildtest commands make use of sub-commands (i.e buildtest <subcommand>). For more details on any subcommand run:

$ buildtest <subcommand> --help

If you have got this far, please go to the next section on Getting Started with buildtest