Building Test via buildtest (buildtest build)

This guide will get you familiar with buildtest command line interface. Once you complete this section, you can proceed to writing buildspecs section where we will cover how to write buildspecs.

Once you install buildtest, you should find the buildtest command in your $PATH. You can check the path to buildtest command by running:

$ which buildtest

If you don’t see buildtest go back and install buildtest.

When you clone buildtest, you also get a set of buildspecs that you can run on your system. The buildtest build command is used for building and running tests. Buildtest will read one or more buildspecs file that adheres to one of the buildtest schemas. For a complete list of build options please run buildtest build --help.

Note

buildtest bd is an alias for buildtest build command.

Build Usage

buildtest build --help
$ buildtest build --help
usage: buildtest [options] [COMMANDS] build [-h] [-b BUILDSPEC] [-x EXCLUDE]
                                            [-e EXECUTOR] [-t TAGS] [--rerun]
                                            [-f FILTER] [--helpfilter]
                                            [-et {local,batch}]
                                            [--module-purge] [-m MODULES]
                                            [-u UNLOAD_MODULES]
                                            [--account ACCOUNT]
                                            [--disable-executor-check]
                                            [--remove-stagedir]
                                            [--maxpendtime MAXPENDTIME]
                                            [--pollinterval POLLINTERVAL]
                                            [--procs PROCS [PROCS ...]]
                                            [--nodes NODES [NODES ...]]
                                            [--rebuild REBUILD]
                                            [--retry RETRY] [-s {parse,build}]
                                            [--testdir TESTDIR]
                                            [--timeout TIMEOUT]

optional arguments:
  -h, --help            show this help message and exit

select:
  Select buildspec file to run based on file, tag, executor

  -b BUILDSPEC, --buildspec BUILDSPEC
                        Specify a buildspec (file or directory) to build. A
                        buildspec must end in '.yml' extension.
  -x EXCLUDE, --exclude EXCLUDE
                        Exclude one or more buildspecs (file or directory)
                        from processing. A buildspec must end in '.yml'
                        extension.
  -e EXECUTOR, --executor EXECUTOR
                        Discover buildspecs by executor name found in
                        buildspec cache
  -t TAGS, --tags TAGS  Discover buildspecs by tags found in buildspec cache
  --rerun               Rerun last successful buildtest build command.

filter:
  Filter tests after selection

  -f FILTER, --filter FILTER
                        Filter buildspec based on tags, type, or maintainers.
                        Usage: --filter key1=val1,key2=val2
  --helpfilter          Show available filter fields used with --filter option
  -et {local,batch}, --executor-type {local,batch}
                        Filter tests by executor type (local, batch)

module:
  Module Selection option

  --module-purge        Run 'module purge' before running any test
  -m MODULES, --modules MODULES
                        Specify a list of modules to load during test
                        execution, to specify multiple modules each one must
                        be comma separated for instance if you want to load
                        'gcc' and 'python' module you can do '-m gcc,python'
  -u UNLOAD_MODULES, --unload-modules UNLOAD_MODULES
                        Specify a list of modules to unload during test
                        execution

batch:
  Batch Submission Options

  --account ACCOUNT     Specify project account used to charge batch jobs
                        (applicable for batch jobs only)
  --maxpendtime MAXPENDTIME
                        Specify Maximum Pending Time (sec) for job before
                        cancelling job. This only applies for batch job
                        submission.
  --pollinterval POLLINTERVAL
                        Specify Poll Interval (sec) for polling batch jobs
  --procs PROCS [PROCS ...]
                        Specify number of processes to run tests (only
                        applicable with batch jobs). Multiple values can be
                        specified comma separated.
  --nodes NODES [NODES ...]
                        Specify number of nodes to run tests (only applicable
                        with batch jobs). Multiple values can be specified
                        comma separated.

extra:
  All extra options

  --disable-executor-check
                        Disable executor check during configuration check. By
                        default these checks are enforced for Local, Slurm,
                        PBS, LSF, and Cobalt Executor.
  --remove-stagedir     Remove stage directory after job completion.
  --rebuild REBUILD     Rebuild test X number of times. Must be a positive
                        number between [1-50]
  --retry RETRY         Retry failed jobs
  -s {parse,build}, --stage {parse,build}
                        Control behavior of buildtest build to stop execution
                        after 'parse' or 'build' stage
  --testdir TESTDIR     Specify a custom test directory where to write tests.
                        This overrides configuration file and default
                        location.
  --timeout TIMEOUT     Specify test timeout in number of seconds

Building a Test

To build a test, we use the --buildspec or short option -b to specify the path to buildspec file. Let’s see some examples, first we specify a full path to buildspec file. In this example, buildtest will discover buildspecs followed by parsing the test with appropriate schema and generate a shell script that is run by buildtest. You can learn more about build and test process.

buildtest build -b $BUILDTEST_ROOT/tutorials/vars.yml
$ buildtest build -b $BUILDTEST_ROOT/tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:35:07                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/c70320c7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/c70320c7
variables_bash/c70320c7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/c70320c7/stage
variables_bash/c70320c7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/c70320c7/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/c70320c7 does not have any dependencies adding test to queue
variables_bash/c70320c7: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/c70320c7: Test completed in 0.010626 seconds
variables_bash/c70320c7: Test completed with returncode: 0
variables_bash/c70320c7: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/c70320c7/variables_bash.out
variables_bash/c70320c7: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/c70320c7/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/c70320c7]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.010626 │
│ sh/c70320c7  │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_5tom4dty.log

Note

buildtest will only read buildspecs with .yml extension, if you specify a .yaml it will be ignored by buildtest.

The --buildspec option can be used to specify a file or directory path. If you want to build multiple buildspecs in a directory you can specify the directory path and buildtest will recursively search for all .yml files. In the next example, we build all tests in directory general_tests/configuration.

buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/
$ buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:05                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  4
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  4
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 4 buildspecs
Valid Buildspecs: 4
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/ulimits.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/systemd-default-target.yml: VALID
Total builder objects created: 9
Total compiler builder: 0
Total script builder: 9
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ ulimit_fi… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ file lock  │            │
│            │            │          │       │       │ is set to  │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_cp… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ cputime is │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_st… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ stack size │            │
│            │            │          │       │       │ is set to  │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_vm… │ generic.l… │ None     │ None  │ None  │ Check      │ /home/doc… │
│            │            │          │       │       │ virtual    │            │
│            │            │          │       │       │ memory     │            │
│            │            │          │       │       │ size and   │            │
│            │            │          │       │       │ check if   │            │
│            │            │          │       │       │ its set to │            │
│            │            │          │       │       │ unlimited  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_fi… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ open file  │            │
│            │            │          │       │       │ descripto… │            │
│            │            │          │       │       │ limit is   │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ 4096       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_ma… │ generic.l… │ None     │ None  │ None  │ Check max  │ /home/doc… │
│            │            │          │       │       │ number of  │            │
│            │            │          │       │       │ user       │            │
│            │            │          │       │       │ process    │            │
│            │            │          │       │       │ limit is   │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ 2048       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ kernel_sw… │ generic.l… │ None     │ None  │ None  │ Retrieve   │ /home/doc… │
│            │            │          │       │       │ Kernel     │            │
│            │            │          │       │       │ Swap Usage │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ root_disk… │ generic.l… │ None     │ None  │ None  │ Check root │ /home/doc… │
│            │            │          │       │       │ disk usage │            │
│            │            │          │       │       │ and report │            │
│            │            │          │       │       │ if it      │            │
│            │            │          │       │       │ exceeds    │            │
│            │            │          │       │       │ threshold  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ systemd_d… │ generic.l… │ None     │ None  │ None  │ check if   │ /home/doc… │
│            │            │          │       │       │ default    │            │
│            │            │          │       │       │ target is  │            │
│            │            │          │       │       │ multi-use… │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
ulimit_filelock_unlimited/20ac7f02: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02
ulimit_filelock_unlimited/20ac7f02: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02/stage
ulimit_filelock_unlimited/20ac7f02: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02/ulimit_filelock_unlimited_build.sh
ulimit_cputime_unlimited/b890008c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c
ulimit_cputime_unlimited/b890008c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c/stage
ulimit_cputime_unlimited/b890008c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/430d08f3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3
ulimit_stacksize_unlimited/430d08f3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3/stage
ulimit_stacksize_unlimited/430d08f3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3/ulimit_stacksize_unlimited_build.sh
ulimit_vmsize_unlimited/2948d368: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368
ulimit_vmsize_unlimited/2948d368: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368/stage
ulimit_vmsize_unlimited/2948d368: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/8cd1c835: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835
ulimit_filedescriptor_4096/8cd1c835: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835/stage
ulimit_filedescriptor_4096/8cd1c835: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835/ulimit_filedescriptor_4096_build.sh
ulimit_max_user_process_2048/c0665cfc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc
ulimit_max_user_process_2048/c0665cfc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc/stage
ulimit_max_user_process_2048/c0665cfc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc/ulimit_max_user_process_2048_build.sh
kernel_swapusage/1ffe842d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/1ffe842d
kernel_swapusage/1ffe842d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/1ffe842d/stage
kernel_swapusage/1ffe842d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/1ffe842d/kernel_swapusage_build.sh
root_disk_usage/d8a8aa22: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/d8a8aa22
root_disk_usage/d8a8aa22: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/d8a8aa22/stage
root_disk_usage/d8a8aa22: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/d8a8aa22/root_disk_usage_build.sh
systemd_default_target/a5022534: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/a5022534
systemd_default_target/a5022534: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/a5022534/stage
systemd_default_target/a5022534: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/a5022534/systemd_default_target_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
ulimit_cputime_unlimited/b890008c does not have any dependencies adding test to queue
ulimit_filelock_unlimited/20ac7f02 does not have any dependencies adding test to queue
ulimit_vmsize_unlimited/2948d368 does not have any dependencies adding test to queue
kernel_swapusage/1ffe842d does not have any dependencies adding test to queue
root_disk_usage/d8a8aa22 does not have any dependencies adding test to queue
systemd_default_target/a5022534 does not have any dependencies adding test to queue
ulimit_stacksize_unlimited/430d08f3 does not have any dependencies adding test to queue
ulimit_max_user_process_2048/c0665cfc does not have any dependencies adding test to queue
ulimit_filedescriptor_4096/8cd1c835 does not have any dependencies adding test to queue
ulimit_cputime_unlimited/b890008c: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/b890008c: Test completed in 0.005551 seconds
ulimit_cputime_unlimited/b890008c: Test completed with returncode: 0
ulimit_cputime_unlimited/b890008c: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/b890008c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/b890008c: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/b890008c/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/b890008c: Regular Expression Match - Success!
ulimit_filelock_unlimited/20ac7f02: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/20ac7f02: Test completed in 0.00546 seconds
ulimit_filelock_unlimited/20ac7f02: Test completed with returncode: 0
ulimit_filelock_unlimited/20ac7f02: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/20ac7f02: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/20ac7f02: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/20ac7f02/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/20ac7f02: Regular Expression Match - Success!
kernel_swapusage/1ffe842d: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/1ffe842d: Test completed in 0.138695 seconds
kernel_swapusage/1ffe842d: Test completed with returncode: 255
kernel_swapusage/1ffe842d: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/1ffe842d/kernel_swapusage.out
kernel_swapusage/1ffe842d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/1ffe842d/kernel_swapusage.err
ulimit_vmsize_unlimited/2948d368: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/2948d368: Test completed in 0.005832 seconds
ulimit_vmsize_unlimited/2948d368: Test completed with returncode: 0
ulimit_vmsize_unlimited/2948d368: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/2948d368: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/2948d368: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/2948d368/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/2948d368: Regular Expression Match - Success!
root_disk_usage/d8a8aa22: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/d8a8aa22: Test completed in 0.117554 seconds
root_disk_usage/d8a8aa22: Test completed with returncode: 0
root_disk_usage/d8a8aa22: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/d8a8aa22/root_disk_usage.out
root_disk_usage/d8a8aa22: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/d8a8aa22/root_disk_usage.err
systemd_default_target/a5022534: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/a5022534: Test completed in 0.084561 seconds
systemd_default_target/a5022534: Test completed with returncode: 1
systemd_default_target/a5022534: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/a5022534/systemd_default_target.out
systemd_default_target/a5022534: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/a5022534/systemd_default_target.err
ulimit_stacksize_unlimited/430d08f3: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/430d08f3: Test completed in 0.005774 seconds
ulimit_stacksize_unlimited/430d08f3: Test completed with returncode: 0
ulimit_stacksize_unlimited/430d08f3: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/430d08f3: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/430d08f3: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/430d08f3/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/430d08f3: Regular Expression Match - Failed!
ulimit_max_user_process_2048/c0665cfc: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/c0665cfc: Test completed in 0.005493 seconds
ulimit_max_user_process_2048/c0665cfc: Test completed with returncode: 0
ulimit_max_user_process_2048/c0665cfc: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/c0665cfc: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc/ulimit_max_user_process_2048.err
ulimit_max_user_process_2048/c0665cfc: performing regular expression - '^2048$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/c0665cfc/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/c0665cfc: Regular Expression Match - Failed!
ulimit_filedescriptor_4096/8cd1c835: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/8cd1c835: Test completed in 0.005377 seconds
ulimit_filedescriptor_4096/8cd1c835: Test completed with returncode: 0
ulimit_filedescriptor_4096/8cd1c835: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/8cd1c835: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/8cd1c835: performing regular expression - '^4096$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/8cd1c835/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/8cd1c835: Regular Expression Match - Failed!
In this iteration we are going to run the following tests: [ulimit_cputime_unlimited/b890008c, ulimit_filelock_unlimited/20ac7f02, kernel_swapusage/1ffe842d, ulimit_vmsize_unlimited/2948d368, root_disk_usage/d8a8aa22, systemd_default_target/a5022534, ulimit_stacksize_unlimited/430d08f3, ulimit_max_user_process_2048/c0665cfc, ulimit_filedescriptor_4096/8cd1c835]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ ulimit_cputi │ generic.loc… │ PASS   │ False True    │ 0          │ 0.005551 │
│ me_unlimited │              │        │ False         │            │          │
│ /b890008c    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS   │ False True    │ 0          │ 0.005832 │
│ e_unlimited/ │              │        │ False         │            │          │
│ 2948d368     │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005493 │
│ ser_process_ │              │        │ False         │            │          │
│ 2048/c0665cf │              │        │               │            │          │
│ c            │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 255        │ 0.138695 │
│ sage/1ffe842 │              │        │               │            │          │
│ d            │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.117554 │
│ age/d8a8aa22 │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filel │ generic.loc… │ PASS   │ False True    │ 0          │ 0.00546  │
│ ock_unlimite │              │        │ False         │            │          │
│ d/20ac7f02   │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.084561 │
│ ult_target/a │              │        │               │            │          │
│ 5022534      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_stack │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005774 │
│ size_unlimit │              │        │ False         │            │          │
│ ed/430d08f3  │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005377 │
│ escriptor_40 │              │        │ False         │            │          │
│ 96/8cd1c835  │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 4/9 Percentage: 44.444%
Failed Tests: 5/9 Percentage: 55.556%


Adding 9 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_ob0w_8s6.log

Building Multiple Buildspecs

You can append -b option to build multiple buildspecs in the same command. Buildtest will discover buildspecs for every argument (-b) and accumulate a list of buildspecs to run. In this example, we instruct buildtest to build a buildspec file and all buildspecs in a directory path.

buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/ -b $BUILDTEST_ROOT/tutorials/vars.yml
$ buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/ -b $BUILDTEST_ROOT/tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:06                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  5
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  5
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 5 buildspecs
Valid Buildspecs: 5
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/ulimits.yml: VALID
Total builder objects created: 10
Total compiler builder: 0
Total script builder: 10
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ kernel_sw… │ generic.l… │ None     │ None  │ None  │ Retrieve   │ /home/doc… │
│            │            │          │       │       │ Kernel     │            │
│            │            │          │       │       │ Swap Usage │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ root_disk… │ generic.l… │ None     │ None  │ None  │ Check root │ /home/doc… │
│            │            │          │       │       │ disk usage │            │
│            │            │          │       │       │ and report │            │
│            │            │          │       │       │ if it      │            │
│            │            │          │       │       │ exceeds    │            │
│            │            │          │       │       │ threshold  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ systemd_d… │ generic.l… │ None     │ None  │ None  │ check if   │ /home/doc… │
│            │            │          │       │       │ default    │            │
│            │            │          │       │       │ target is  │            │
│            │            │          │       │       │ multi-use… │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_fi… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ file lock  │            │
│            │            │          │       │       │ is set to  │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_cp… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ cputime is │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_st… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ stack size │            │
│            │            │          │       │       │ is set to  │            │
│            │            │          │       │       │ unlimited  │            │
│            │            │          │       │       │ in ulimits │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_vm… │ generic.l… │ None     │ None  │ None  │ Check      │ /home/doc… │
│            │            │          │       │       │ virtual    │            │
│            │            │          │       │       │ memory     │            │
│            │            │          │       │       │ size and   │            │
│            │            │          │       │       │ check if   │            │
│            │            │          │       │       │ its set to │            │
│            │            │          │       │       │ unlimited  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_fi… │ generic.l… │ None     │ None  │ None  │ Check if   │ /home/doc… │
│            │            │          │       │       │ open file  │            │
│            │            │          │       │       │ descripto… │            │
│            │            │          │       │       │ limit is   │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ 4096       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ ulimit_ma… │ generic.l… │ None     │ None  │ None  │ Check max  │ /home/doc… │
│            │            │          │       │       │ number of  │            │
│            │            │          │       │       │ user       │            │
│            │            │          │       │       │ process    │            │
│            │            │          │       │       │ limit is   │            │
│            │            │          │       │       │ set to     │            │
│            │            │          │       │       │ 2048       │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
kernel_swapusage/ec2da2e5: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/ec2da2e5
kernel_swapusage/ec2da2e5: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/ec2da2e5/stage
kernel_swapusage/ec2da2e5: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/ec2da2e5/kernel_swapusage_build.sh
root_disk_usage/de555e22: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/de555e22
root_disk_usage/de555e22: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/de555e22/stage
root_disk_usage/de555e22: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/de555e22/root_disk_usage_build.sh
variables_bash/532e3e6a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/532e3e6a
variables_bash/532e3e6a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/532e3e6a/stage
variables_bash/532e3e6a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/532e3e6a/variables_bash_build.sh
systemd_default_target/ed72918c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/ed72918c
systemd_default_target/ed72918c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/ed72918c/stage
systemd_default_target/ed72918c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/ed72918c/systemd_default_target_build.sh
ulimit_filelock_unlimited/2447aa35: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35
ulimit_filelock_unlimited/2447aa35: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35/stage
ulimit_filelock_unlimited/2447aa35: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35/ulimit_filelock_unlimited_build.sh
ulimit_cputime_unlimited/2f2ddcfb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb
ulimit_cputime_unlimited/2f2ddcfb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb/stage
ulimit_cputime_unlimited/2f2ddcfb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/3ad463a6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6
ulimit_stacksize_unlimited/3ad463a6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6/stage
ulimit_stacksize_unlimited/3ad463a6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6/ulimit_stacksize_unlimited_build.sh
ulimit_vmsize_unlimited/569236eb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb
ulimit_vmsize_unlimited/569236eb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb/stage
ulimit_vmsize_unlimited/569236eb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/a6843235: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235
ulimit_filedescriptor_4096/a6843235: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235/stage
ulimit_filedescriptor_4096/a6843235: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235/ulimit_filedescriptor_4096_build.sh
ulimit_max_user_process_2048/3d06dabf: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf
ulimit_max_user_process_2048/3d06dabf: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf/stage
ulimit_max_user_process_2048/3d06dabf: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf/ulimit_max_user_process_2048_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
systemd_default_target/ed72918c does not have any dependencies adding test to queue
ulimit_filelock_unlimited/2447aa35 does not have any dependencies adding test to queue
root_disk_usage/de555e22 does not have any dependencies adding test to queue
variables_bash/532e3e6a does not have any dependencies adding test to queue
ulimit_filedescriptor_4096/a6843235 does not have any dependencies adding test to queue
ulimit_max_user_process_2048/3d06dabf does not have any dependencies adding test to queue
ulimit_cputime_unlimited/2f2ddcfb does not have any dependencies adding test to queue
ulimit_stacksize_unlimited/3ad463a6 does not have any dependencies adding test to queue
kernel_swapusage/ec2da2e5 does not have any dependencies adding test to queue
ulimit_vmsize_unlimited/569236eb does not have any dependencies adding test to queue
systemd_default_target/ed72918c: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/ed72918c: Test completed in 0.008166 seconds
systemd_default_target/ed72918c: Test completed with returncode: 1
systemd_default_target/ed72918c: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/ed72918c/systemd_default_target.out
systemd_default_target/ed72918c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/ed72918c/systemd_default_target.err
ulimit_filelock_unlimited/2447aa35: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/2447aa35: Test completed in 0.005451 seconds
ulimit_filelock_unlimited/2447aa35: Test completed with returncode: 0
ulimit_filelock_unlimited/2447aa35: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/2447aa35: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/2447aa35: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/2447aa35/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/2447aa35: Regular Expression Match - Success!
kernel_swapusage/ec2da2e5: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/ec2da2e5: Test completed in 0.006661 seconds
kernel_swapusage/ec2da2e5: Test completed with returncode: 255
kernel_swapusage/ec2da2e5: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/ec2da2e5/kernel_swapusage.out
kernel_swapusage/ec2da2e5: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/ec2da2e5/kernel_swapusage.err
variables_bash/532e3e6a: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/532e3e6a: Test completed in 0.008606 seconds
variables_bash/532e3e6a: Test completed with returncode: 0
variables_bash/532e3e6a: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/532e3e6a/variables_bash.out
variables_bash/532e3e6a: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/532e3e6a/variables_bash.err
ulimit_filedescriptor_4096/a6843235: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/a6843235: Test completed in 0.005172 seconds
ulimit_filedescriptor_4096/a6843235: Test completed with returncode: 0
ulimit_filedescriptor_4096/a6843235: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/a6843235: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/a6843235: performing regular expression - '^4096$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/a6843235/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/a6843235: Regular Expression Match - Failed!
ulimit_max_user_process_2048/3d06dabf: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/3d06dabf: Test completed in 0.005327 seconds
ulimit_max_user_process_2048/3d06dabf: Test completed with returncode: 0
ulimit_max_user_process_2048/3d06dabf: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/3d06dabf: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf/ulimit_max_user_process_2048.err
ulimit_max_user_process_2048/3d06dabf: performing regular expression - '^2048$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/3d06dabf/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/3d06dabf: Regular Expression Match - Failed!
ulimit_cputime_unlimited/2f2ddcfb: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/2f2ddcfb: Test completed in 0.005442 seconds
ulimit_cputime_unlimited/2f2ddcfb: Test completed with returncode: 0
ulimit_cputime_unlimited/2f2ddcfb: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/2f2ddcfb: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/2f2ddcfb: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/2f2ddcfb/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/2f2ddcfb: Regular Expression Match - Success!
ulimit_stacksize_unlimited/3ad463a6: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/3ad463a6: Test completed in 0.005451 seconds
ulimit_stacksize_unlimited/3ad463a6: Test completed with returncode: 0
ulimit_stacksize_unlimited/3ad463a6: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/3ad463a6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/3ad463a6: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/3ad463a6/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/3ad463a6: Regular Expression Match - Failed!
root_disk_usage/de555e22: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/de555e22: Test completed in 0.009156 seconds
root_disk_usage/de555e22: Test completed with returncode: 0
root_disk_usage/de555e22: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/de555e22/root_disk_usage.out
root_disk_usage/de555e22: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/de555e22/root_disk_usage.err
ulimit_vmsize_unlimited/569236eb: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/569236eb: Test completed in 0.00566 seconds
ulimit_vmsize_unlimited/569236eb: Test completed with returncode: 0
ulimit_vmsize_unlimited/569236eb: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/569236eb: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/569236eb: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/569236eb/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/569236eb: Regular Expression Match - Success!
In this iteration we are going to run the following tests: [systemd_default_target/ed72918c, ulimit_filelock_unlimited/2447aa35, kernel_swapusage/ec2da2e5, variables_bash/532e3e6a, ulimit_filedescriptor_4096/a6843235, ulimit_max_user_process_2048/3d06dabf, ulimit_cputime_unlimited/2f2ddcfb, ulimit_stacksize_unlimited/3ad463a6, root_disk_usage/de555e22, ulimit_vmsize_unlimited/569236eb]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ ulimit_cputi │ generic.loc… │ PASS   │ False True    │ 0          │ 0.005442 │
│ me_unlimited │              │        │ False         │            │          │
│ /2f2ddcfb    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.009156 │
│ age/de555e22 │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS   │ False True    │ 0          │ 0.00566  │
│ e_unlimited/ │              │        │ False         │            │          │
│ 569236eb     │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005172 │
│ escriptor_40 │              │        │ False         │            │          │
│ 96/a6843235  │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 255        │ 0.006661 │
│ sage/ec2da2e │              │        │               │            │          │
│ 5            │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filel │ generic.loc… │ PASS   │ False True    │ 0          │ 0.005451 │
│ ock_unlimite │              │        │ False         │            │          │
│ d/2447aa35   │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ variables_ba │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.008606 │
│ sh/532e3e6a  │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005327 │
│ ser_process_ │              │        │ False         │            │          │
│ 2048/3d06dab │              │        │               │            │          │
│ f            │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_stack │ generic.loc… │ FAIL   │ False False   │ 0          │ 0.005451 │
│ size_unlimit │              │        │ False         │            │          │
│ ed/3ad463a6  │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.008166 │
│ ult_target/e │              │        │               │            │          │
│ d72918c      │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 5/10 Percentage: 50.000%
Failed Tests: 5/10 Percentage: 50.000%


Adding 10 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_mxuw3s_v.log

Excluding Buildspecs

So far we learned how to build buildspecs by file and directory path using the -b option. Next, we will discuss how one may exclude buildspecs which behaves similar to -b option. You can exclude buildspecs via --exclude or short option -x which can be useful when you want to exclude certain files or sub directory.

For example we can build all buildspecs in tutorials but exclude file tutorials/vars.yml by running:

$ buildtest build -b tutorials -x tutorials/vars.yml

buildtest will discover all buildspecs and then exclude any buildspecs specified by -x option. You can specify -x multiple times just like -b option.

For example, we can undo discovery by passing same option to -b and -x as follows

buildtest bd -b tutorials/ -x tutorials/
$ buildtest bd -b tutorials/ -x tutorials/
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:07                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
There are no Buildspec files to process.

Buildtest will stop immediately if there are no Buildspecs to process, this is true if you were to specify files instead of directory.

In this example, we build all buildspecs in a directory but exclude a file. Buildtest will report the excluded buildspecs in the output and -x option can be appended multiple times. The -x can be a file or a directory and behaves similar to -b option.

buildtest bd -b general_tests/configuration/ -x general_tests/configuration/ulimits.yml
$ buildtest bd -b general_tests/configuration/ -x general_tests/configuration/ulimits.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:07                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                              Excluded buildspecs                               
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  4
Total Excluded Buildspecs:  1
Detected Buildspecs after exclusion:  3
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 3 buildspecs
Valid Buildspecs: 3
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/general_tests/configuration/systemd-default-target.yml: VALID
Total builder objects created: 3
Total compiler builder: 0
Total script builder: 3
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ kernel_sw… │ generic.l… │ None     │ None  │ None  │ Retrieve   │ /home/doc… │
│            │            │          │       │       │ Kernel     │            │
│            │            │          │       │       │ Swap Usage │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ root_disk… │ generic.l… │ None     │ None  │ None  │ Check root │ /home/doc… │
│            │            │          │       │       │ disk usage │            │
│            │            │          │       │       │ and report │            │
│            │            │          │       │       │ if it      │            │
│            │            │          │       │       │ exceeds    │            │
│            │            │          │       │       │ threshold  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ systemd_d… │ generic.l… │ None     │ None  │ None  │ check if   │ /home/doc… │
│            │            │          │       │       │ default    │            │
│            │            │          │       │       │ target is  │            │
│            │            │          │       │       │ multi-use… │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
kernel_swapusage/318f2a8e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/318f2a8e
kernel_swapusage/318f2a8e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/318f2a8e/stage
kernel_swapusage/318f2a8e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/318f2a8e/kernel_swapusage_build.sh
root_disk_usage/9aca320b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/9aca320b
root_disk_usage/9aca320b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/9aca320b/stage
root_disk_usage/9aca320b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/9aca320b/root_disk_usage_build.sh
systemd_default_target/dbea98d0: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/dbea98d0
systemd_default_target/dbea98d0: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/dbea98d0/stage
systemd_default_target/dbea98d0: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/dbea98d0/systemd_default_target_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
systemd_default_target/dbea98d0 does not have any dependencies adding test to queue
root_disk_usage/9aca320b does not have any dependencies adding test to queue
kernel_swapusage/318f2a8e does not have any dependencies adding test to queue
systemd_default_target/dbea98d0: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/dbea98d0: Test completed in 0.008523 seconds
systemd_default_target/dbea98d0: Test completed with returncode: 1
systemd_default_target/dbea98d0: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/dbea98d0/systemd_default_target.out
systemd_default_target/dbea98d0: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/dbea98d0/systemd_default_target.err
kernel_swapusage/318f2a8e: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/318f2a8e: Test completed in 0.006252 seconds
kernel_swapusage/318f2a8e: Test completed with returncode: 255
kernel_swapusage/318f2a8e: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/318f2a8e/kernel_swapusage.out
kernel_swapusage/318f2a8e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/kernel_state/kernel_swapusage/318f2a8e/kernel_swapusage.err
root_disk_usage/9aca320b: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/9aca320b: Test completed in 0.008687 seconds
root_disk_usage/9aca320b: Test completed with returncode: 0
root_disk_usage/9aca320b: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/9aca320b/root_disk_usage.out
root_disk_usage/9aca320b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/disk_usage/root_disk_usage/9aca320b/root_disk_usage.err
In this iteration we are going to run the following tests: [systemd_default_target/dbea98d0, kernel_swapusage/318f2a8e, root_disk_usage/9aca320b]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ systemd_defa │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.008523 │
│ ult_target/d │              │        │               │            │          │
│ bea98d0      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 255        │ 0.006252 │
│ sage/318f2a8 │              │        │               │            │          │
│ e            │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.008687 │
│ age/9aca320b │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/3 Percentage: 33.333%
Failed Tests: 2/3 Percentage: 66.667%


Adding 3 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_w9mqrhr4.log

Building By Tags

buildtest can perform builds by tags by using --tags or short option (-t). In order to use this feature, buildtest must load buildspecs in cache which can be run via buildtest buildspec find. If you are unsure of the available tags you can run buildtest buildspec find --tags or let buildtest tab-complete the available tags. For more details see Querying buildspec tags.

Let’s assume you want to build by tag name network, buildtest will attempt to find all tests that contain tags: ['network'] in the buildspec which is loaded in the buildcache cache. If a test matches the tag name, the test will be picked up during the discover process.

buildtest build -t network
$ buildtest build -t network
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:08                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                           Buildspecs By Tag=network                            
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/tags_example.yml: VALID
Total builder objects created: 2
Total compiler builder: 0
Total script builder: 2
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ string_ta… │ generic.l… │ None     │ None  │ None  │ tags can   │ /home/doc… │
│            │            │          │       │       │ be a       │            │
│            │            │          │       │       │ string     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ list_of_s… │ generic.l… │ None     │ None  │ None  │ tags can   │ /home/doc… │
│            │            │          │       │       │ be a list  │            │
│            │            │          │       │       │ of strings │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
string_tag/96d3cb9a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/96d3cb9a
string_tag/96d3cb9a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/96d3cb9a/stage
string_tag/96d3cb9a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/96d3cb9a/string_tag_build.sh
list_of_strings_tags/021bf164: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/021bf164
list_of_strings_tags/021bf164: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/021bf164/stage
list_of_strings_tags/021bf164: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/021bf164/list_of_strings_tags_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
list_of_strings_tags/021bf164 does not have any dependencies adding test to queue
string_tag/96d3cb9a does not have any dependencies adding test to queue
list_of_strings_tags/021bf164: Running Test via command: bash --norc --noprofile -eo pipefail list_of_strings_tags_build.sh
list_of_strings_tags/021bf164: Test completed in 3.031318 seconds
list_of_strings_tags/021bf164: Test completed with returncode: 0
list_of_strings_tags/021bf164: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/021bf164/list_of_strings_tags.out
list_of_strings_tags/021bf164: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/021bf164/list_of_strings_tags.err
string_tag/96d3cb9a: Running Test via command: bash --norc --noprofile -eo pipefail string_tag_build.sh
string_tag/96d3cb9a: Test completed in 0.006638 seconds
string_tag/96d3cb9a: Test completed with returncode: 0
string_tag/96d3cb9a: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/96d3cb9a/string_tag.out
string_tag/96d3cb9a: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/96d3cb9a/string_tag.err
In this iteration we are going to run the following tests: [list_of_strings_tags/021bf164, string_tag/96d3cb9a]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ string_tag/9 │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.006638 │
│ 6d3cb9a      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ list_of_stri │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 3.031318 │
│ ngs_tags/021 │              │        │               │            │          │
│ bf164        │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%


Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_nue7yi7y.log

You can build by multiple tags by specifying --tags multiple times. In next example we build all tests with tag name pass and python.

buildtest build -t python -t pass
$ buildtest build -t python -t pass
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:11                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                            Buildspecs By Tag=python                            
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                             Buildspecs By Tag=pass                             
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  3
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  3
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 3 buildspecs
Valid Buildspecs: 3
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 6
Total compiler builder: 0
Total script builder: 6
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ python_he… │ generic.l… │ None     │ None  │ None  │ Hello      │ /home/doc… │
│            │            │          │       │       │ World      │            │
│            │            │          │       │       │ python     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_fai… │ generic.l… │ None     │ None  │ None  │ exit 1 by  │ /home/doc… │
│            │            │          │       │       │ default is │            │
│            │            │          │       │       │ FAIL       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 2     │ /home/doc… │
│            │            │          │       │       │ failed     │            │
│            │            │          │       │       │ since it   │            │
│            │            │          │       │       │ failed to  │            │
│            │            │          │       │       │ match      │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
python_hello/0aa69331: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/0aa69331
python_hello/0aa69331: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/0aa69331/stage
python_hello/0aa69331: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/0aa69331/python_hello_build.sh
circle_area/1f815f1e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/1f815f1e
circle_area/1f815f1e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/1f815f1e/stage
circle_area/1f815f1e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/1f815f1e/circle_area_build.sh
exit1_fail/f92a208f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/f92a208f
exit1_fail/f92a208f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/f92a208f/stage
exit1_fail/f92a208f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/f92a208f/exit1_fail_build.sh
exit1_pass/f24c7458: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/f24c7458
exit1_pass/f24c7458: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/f24c7458/stage
exit1_pass/f24c7458: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/f24c7458/exit1_pass_build.sh
returncode_list_mismatch/54a48aa7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/54a48aa7
returncode_list_mismatch/54a48aa7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/54a48aa7/stage
returncode_list_mismatch/54a48aa7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/54a48aa7/returncode_list_mismatch_build.sh
returncode_int_match/42a739cd: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/42a739cd
returncode_int_match/42a739cd: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/42a739cd/stage
returncode_int_match/42a739cd: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/42a739cd/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
returncode_int_match/42a739cd does not have any dependencies adding test to queue
exit1_fail/f92a208f does not have any dependencies adding test to queue
returncode_list_mismatch/54a48aa7 does not have any dependencies adding test to queue
python_hello/0aa69331 does not have any dependencies adding test to queue
exit1_pass/f24c7458 does not have any dependencies adding test to queue
circle_area/1f815f1e does not have any dependencies adding test to queue
returncode_int_match/42a739cd: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/42a739cd: Test completed in 0.005706 seconds
returncode_int_match/42a739cd: Test completed with returncode: 128
returncode_int_match/42a739cd: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/42a739cd/returncode_int_match.out
returncode_int_match/42a739cd: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/42a739cd/returncode_int_match.err
returncode_int_match/42a739cd: Checking returncode - 128 is matched in list [128]
exit1_fail/f92a208f: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/f92a208f: Test completed in 0.005386 seconds
exit1_fail/f92a208f: Test completed with returncode: 1
exit1_fail/f92a208f: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/f92a208f/exit1_fail.out
exit1_fail/f92a208f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/f92a208f/exit1_fail.err
python_hello/0aa69331: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/0aa69331: Test completed in 0.030863 seconds
python_hello/0aa69331: Test completed with returncode: 0
python_hello/0aa69331: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/0aa69331/python_hello.out
python_hello/0aa69331: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/0aa69331/python_hello.err
returncode_list_mismatch/54a48aa7: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/54a48aa7: Test completed in 0.005748 seconds
returncode_list_mismatch/54a48aa7: Test completed with returncode: 2
returncode_list_mismatch/54a48aa7: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/54a48aa7/returncode_list_mismatch.out
returncode_list_mismatch/54a48aa7: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/54a48aa7/returncode_list_mismatch.err
returncode_list_mismatch/54a48aa7: Checking returncode - 2 is matched in list [1, 3]
exit1_pass/f24c7458: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/f24c7458: Test completed in 0.005601 seconds
exit1_pass/f24c7458: Test completed with returncode: 1
exit1_pass/f24c7458: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/f24c7458/exit1_pass.out
exit1_pass/f24c7458: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/f24c7458/exit1_pass.err
exit1_pass/f24c7458: Checking returncode - 1 is matched in list [1]
circle_area/1f815f1e: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/1f815f1e: Test completed in 0.031002 seconds
circle_area/1f815f1e: Test completed with returncode: 0
circle_area/1f815f1e: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/1f815f1e/circle_area.out
circle_area/1f815f1e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/1f815f1e/circle_area.err
In this iteration we are going to run the following tests: [returncode_int_match/42a739cd, exit1_fail/f92a208f, python_hello/0aa69331, returncode_list_mismatch/54a48aa7, exit1_pass/f24c7458, circle_area/1f815f1e]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS   │ True False    │ 128        │ 0.005706 │
│ nt_match/42a │              │        │ False         │            │          │
│ 739cd        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.030863 │
│ /0aa69331    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/f │ generic.loc… │ PASS   │ True False    │ 1          │ 0.005601 │
│ 24c7458      │              │        │ False         │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/f │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.005386 │
│ 92a208f      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.031002 │
│ 1f815f1e     │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL   │ False False   │ 2          │ 0.005748 │
│ ist_mismatch │              │        │ False         │            │          │
│ /54a48aa7    │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 4/6 Percentage: 66.667%
Failed Tests: 2/6 Percentage: 33.333%


Adding 6 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_defkz8i9.log

When multiple tags are specified, we search each tag independently and if it’s found in the buildspec cache we retrieve the buildspec file and add file to queue. This queue is a list of buildspecs that buildtest will process (i.e parse, build, run). You can query tags from buildspecs cache to see all available tags by running buildtest buildspec find --tags.

Note

The --tags is used for discovering buildspec file and not filtering tests by tag.

You can combine --tags with --buildspec to discover buildspecs in a single command. buildtest will query tags and buildspecs independently and combine all discovered buildspecs together.

buildtest build --tags pass --buildspec tutorials/python-hello.yml
$ buildtest build --tags pass --buildspec tutorials/python-hello.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:12                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                             Buildspecs By Tag=pass                             
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  2
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
Total builder objects created: 5
Total compiler builder: 0
Total script builder: 5
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ exit1_fai… │ generic.l… │ None     │ None  │ None  │ exit 1 by  │ /home/doc… │
│            │            │          │       │       │ default is │            │
│            │            │          │       │       │ FAIL       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 2     │ /home/doc… │
│            │            │          │       │       │ failed     │            │
│            │            │          │       │       │ since it   │            │
│            │            │          │       │       │ failed to  │            │
│            │            │          │       │       │ match      │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ python_he… │ generic.l… │ None     │ None  │ None  │ Hello      │ /home/doc… │
│            │            │          │       │       │ World      │            │
│            │            │          │       │       │ python     │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/c6a25b66: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/c6a25b66
exit1_fail/c6a25b66: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/c6a25b66/stage
exit1_fail/c6a25b66: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/c6a25b66/exit1_fail_build.sh
exit1_pass/36dc3774: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/36dc3774
exit1_pass/36dc3774: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/36dc3774/stage
exit1_pass/36dc3774: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/36dc3774/exit1_pass_build.sh
returncode_list_mismatch/96fc40ae: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/96fc40ae
returncode_list_mismatch/96fc40ae: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/96fc40ae/stage
returncode_list_mismatch/96fc40ae: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/96fc40ae/returncode_list_mismatch_build.sh
returncode_int_match/f9b918bf: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f9b918bf
returncode_int_match/f9b918bf: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f9b918bf/stage
returncode_int_match/f9b918bf: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f9b918bf/returncode_int_match_build.sh
python_hello/03af71fc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/03af71fc
python_hello/03af71fc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/03af71fc/stage
python_hello/03af71fc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/03af71fc/python_hello_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_pass/36dc3774 does not have any dependencies adding test to queue
returncode_list_mismatch/96fc40ae does not have any dependencies adding test to queue
exit1_fail/c6a25b66 does not have any dependencies adding test to queue
returncode_int_match/f9b918bf does not have any dependencies adding test to queue
python_hello/03af71fc does not have any dependencies adding test to queue
exit1_pass/36dc3774: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/36dc3774: Test completed in 0.005511 seconds
exit1_pass/36dc3774: Test completed with returncode: 1
exit1_pass/36dc3774: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/36dc3774/exit1_pass.out
exit1_pass/36dc3774: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/36dc3774/exit1_pass.err
exit1_pass/36dc3774: Checking returncode - 1 is matched in list [1]
returncode_list_mismatch/96fc40ae: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/96fc40ae: Test completed in 0.005471 seconds
returncode_list_mismatch/96fc40ae: Test completed with returncode: 2
returncode_list_mismatch/96fc40ae: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/96fc40ae/returncode_list_mismatch.out
returncode_list_mismatch/96fc40ae: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/96fc40ae/returncode_list_mismatch.err
returncode_list_mismatch/96fc40ae: Checking returncode - 2 is matched in list [1, 3]
returncode_int_match/f9b918bf: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/f9b918bf: Test completed in 0.005587 seconds
returncode_int_match/f9b918bf: Test completed with returncode: 128
returncode_int_match/f9b918bf: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f9b918bf/returncode_int_match.out
returncode_int_match/f9b918bf: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f9b918bf/returncode_int_match.err
returncode_int_match/f9b918bf: Checking returncode - 128 is matched in list [128]
exit1_fail/c6a25b66: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/c6a25b66: Test completed in 0.005395 seconds
exit1_fail/c6a25b66: Test completed with returncode: 1
exit1_fail/c6a25b66: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/c6a25b66/exit1_fail.out
exit1_fail/c6a25b66: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/c6a25b66/exit1_fail.err
python_hello/03af71fc: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/03af71fc: Test completed in 0.030067 seconds
python_hello/03af71fc: Test completed with returncode: 0
python_hello/03af71fc: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/03af71fc/python_hello.out
python_hello/03af71fc: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/03af71fc/python_hello.err
In this iteration we are going to run the following tests: [exit1_pass/36dc3774, returncode_list_mismatch/96fc40ae, returncode_int_match/f9b918bf, exit1_fail/c6a25b66, python_hello/03af71fc]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ python_hello │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.030067 │
│ /03af71fc    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/c │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.005395 │
│ 6a25b66      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/3 │ generic.loc… │ PASS   │ True False    │ 1          │ 0.005511 │
│ 6dc3774      │              │        │ False         │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS   │ True False    │ 128        │ 0.005587 │
│ nt_match/f9b │              │        │ False         │            │          │
│ 918bf        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL   │ False False   │ 2          │ 0.005471 │
│ ist_mismatch │              │        │ False         │            │          │
│ /96fc40ae    │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 3/5 Percentage: 60.000%
Failed Tests: 2/5 Percentage: 40.000%


Adding 5 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_mee9lo8y.log

As you may see, there are several ways to build buildspecs with buildtest. Tags is great way to build a whole collection of tests if you don’t know path to all the files. You can specify multiple tags per buildspecs to classify how test can be run.

Building by Executors

Every buildspec is associated to an executor which is responsible for running the test. You can instruct buildtest to run all tests by given executor via --executor option or short option -e. For instance, if you want to build all test associated to executor generic.local.csh you can run:

$ buildtest build --executor generic.local.csh

buildtest will query buildspec cache for the executor name and retrieve a list of buildspecs with matching executor name. To see a list of available executors in buildspec cache see querying buildspec executor.

Note

By default all tests are run in buildspec file. The buildtest build --executor option discovers buildspecs if one of the test matches the executor name. The --executor option is not filtering tests but only discovering buildspecs.

In this example we run all tests that are associated to generic.local.csh executor.

buildtest build --executor generic.local.csh
$ buildtest build --executor generic.local.csh
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:13                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                    Buildspecs by Executor=generic.local.csh                    
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspecs                                                                   ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  2
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/csh_shell_examples.yml: VALID
Total builder objects created: 4
Total compiler builder: 0
Total script builder: 4
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ bash_env_… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in default │            │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ (bash)     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ csh_env_d… │ generic.l… │ None     │ None  │ None  │ csh shell  │ /home/doc… │
│            │            │          │       │       │ example to │            │
│            │            │          │       │       │ declare    │            │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ tcsh_env_… │ generic.l… │ None     │ None  │ None  │ tcsh shell │ /home/doc… │
│            │            │          │       │       │ example to │            │
│            │            │          │       │       │ declare    │            │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ csh_shell… │ generic.l… │ None     │ None  │ None  │ csh shell  │ /home/doc… │
│            │            │          │       │       │ example    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
bash_env_variables/4612209b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/4612209b
bash_env_variables/4612209b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/4612209b/stage
bash_env_variables/4612209b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/4612209b/bash_env_variables_build.sh
csh_env_declaration/5b87dcea: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/5b87dcea
csh_env_declaration/5b87dcea: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/5b87dcea/stage
csh_env_declaration/5b87dcea: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/5b87dcea/csh_env_declaration_build.sh
tcsh_env_declaration/f298dcea: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/f298dcea
tcsh_env_declaration/f298dcea: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/f298dcea/stage
tcsh_env_declaration/f298dcea: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/f298dcea/tcsh_env_declaration_build.sh
csh_shell/abf7fe2f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/abf7fe2f
csh_shell/abf7fe2f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/abf7fe2f/stage
csh_shell/abf7fe2f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/abf7fe2f/csh_shell_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
bash_env_variables/4612209b does not have any dependencies adding test to queue
csh_env_declaration/5b87dcea does not have any dependencies adding test to queue
csh_shell/abf7fe2f does not have any dependencies adding test to queue
tcsh_env_declaration/f298dcea does not have any dependencies adding test to queue
bash_env_variables/4612209b: Running Test via command: bash --norc --noprofile -eo pipefail bash_env_variables_build.sh
bash_env_variables/4612209b: Test completed in 0.007337 seconds
bash_env_variables/4612209b: Test completed with returncode: 0
bash_env_variables/4612209b: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/4612209b/bash_env_variables.out
bash_env_variables/4612209b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/4612209b/bash_env_variables.err
csh_env_declaration/5b87dcea: Running Test via command: csh -e csh_env_declaration_build.sh
csh_env_declaration/5b87dcea: Test completed in 4.391376 seconds
csh_env_declaration/5b87dcea: Test completed with returncode: 0
csh_env_declaration/5b87dcea: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/5b87dcea/csh_env_declaration.out
csh_env_declaration/5b87dcea: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/5b87dcea/csh_env_declaration.err
csh_shell/abf7fe2f: Running Test via command: csh -e csh_shell_build.sh
csh_shell/abf7fe2f: Test completed in 4.386763 seconds
csh_shell/abf7fe2f: Test completed with returncode: 0
csh_shell/abf7fe2f: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/abf7fe2f/csh_shell.out
csh_shell/abf7fe2f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/abf7fe2f/csh_shell.err
tcsh_env_declaration/f298dcea: Running Test via command: csh -e tcsh_env_declaration_build.sh
tcsh_env_declaration/f298dcea: Test completed in 2.193499 seconds
tcsh_env_declaration/f298dcea: Test completed with returncode: 1
tcsh_env_declaration/f298dcea: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/f298dcea/tcsh_env_declaration.out
tcsh_env_declaration/f298dcea: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/f298dcea/tcsh_env_declaration.err
In this iteration we are going to run the following tests: [bash_env_variables/4612209b, csh_env_declaration/5b87dcea, csh_shell/abf7fe2f, tcsh_env_declaration/f298dcea]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ csh_env_decl │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 4.391376 │
│ aration/5b87 │              │        │               │            │          │
│ dcea         │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ csh_shell/ab │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 4.386763 │
│ f7fe2f       │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ tcsh_env_dec │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 2.193499 │
│ laration/f29 │              │        │               │            │          │
│ 8dcea        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ bash_env_var │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.007337 │
│ iables/46122 │              │        │               │            │          │
│ 09b          │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 3/4 Percentage: 75.000%
Failed Tests: 1/4 Percentage: 25.000%


Adding 4 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_fhgw04k6.log

Note

The --executor option can be appended to discover tests by multiple executors.

Filtering Buildspecs

buildtest has support for filtering buildspecs based on certain attributes defined in buildspec file. Upon Discover Buildspecs, buildtest will filter out tests or entire buildspec files. The buildtest build --filter option can be used to filter buildspecs which expects a single key=value pair. Currently, buildtest can filter tests based on tags, type and maintainers.

To see all available filter fields you can run buildtest build --helpfilter and buildtest will report the fields followed by description.

buildtest build --helpfilter
$ buildtest build --helpfilter
                 Buildtest Filters                  
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Field       ┃ Description                        ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ tags        │ Filter tests by 'tag' field        │
│ type        │ Filter test by 'type' field        │
│ maintainers │ Filter test by 'maintainers' field │
└─────────────┴────────────────────────────────────┘

In this example, we will discover all buildspecs based on tagname pass and then filter each test by tagname pass specified by --filter tags=pass.

buildtest build -t pass --filter tags=pass
$ buildtest build -t pass --filter tags=pass
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:25                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                             Buildspecs By Tag=pass                             
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
[exit1_fail][/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml]: test is skipped because it is not in tag filter list: {'tags': 'pass'}
[returncode_list_mismatch][/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml]: test is skipped because it is not in tag filter list: {'tags': 'pass'}
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 2
Total compiler builder: 0
Total script builder: 2
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_pass/d71a7099: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/d71a7099
exit1_pass/d71a7099: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/d71a7099/stage
exit1_pass/d71a7099: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/d71a7099/exit1_pass_build.sh
returncode_int_match/f41444c8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f41444c8
returncode_int_match/f41444c8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f41444c8/stage
returncode_int_match/f41444c8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f41444c8/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_pass/d71a7099 does not have any dependencies adding test to queue
returncode_int_match/f41444c8 does not have any dependencies adding test to queue
exit1_pass/d71a7099: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/d71a7099: Test completed in 0.005546 seconds
exit1_pass/d71a7099: Test completed with returncode: 1
exit1_pass/d71a7099: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/d71a7099/exit1_pass.out
exit1_pass/d71a7099: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/d71a7099/exit1_pass.err
exit1_pass/d71a7099: Checking returncode - 1 is matched in list [1]
returncode_int_match/f41444c8: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/f41444c8: Test completed in 0.005293 seconds
returncode_int_match/f41444c8: Test completed with returncode: 128
returncode_int_match/f41444c8: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f41444c8/returncode_int_match.out
returncode_int_match/f41444c8: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f41444c8/returncode_int_match.err
returncode_int_match/f41444c8: Checking returncode - 128 is matched in list [128]
In this iteration we are going to run the following tests: [exit1_pass/d71a7099, returncode_int_match/f41444c8]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS   │ True False    │ 128        │ 0.005293 │
│ nt_match/f41 │              │        │ False         │            │          │
│ 444c8        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/d │ generic.loc… │ PASS   │ True False    │ 1          │ 0.005546 │
│ 71a7099      │              │        │ False         │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%


Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_zq9g1z_g.log

buildtest can run filter tests by maintainers, this can be useful if you want to run tests that you are maintainer. The maintainers field is set per buildspec and not each test. You can filter maintiners via --filter maintainers=<MAINTAINER_NAME>. If the maintainers field is not specified the buildspec will be filtered out if --filter maintainers is specified. In this next example, we will build all tests for maintainer @shahzebsiddiqui.

buildtest build -b tutorials --filter maintainers=@shahzebsiddiqui
$ buildtest build -b tutorials --filter maintainers=@shahzebsiddiqui
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:26                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  33
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  33
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 33 buildspecs
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_scheduler.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/explicit_state.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_tests.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/runtime_status_test.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/add_numbers.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_executor.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/burstbuffer_datawarp_executors.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/tags_example.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/gcc_version.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executors_var_env_declaration.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/status_regex.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex3.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/maintainers_example.yml: unable to find maintainer: @shahzebsiddiqui in buildspec which contains the following maintainers: ['@johndoe', '@bobsmith'] therefore we skip this test
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/status_by_executors.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/metrics_regex.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_buildspec.yml: skipping all test since 'skip' is defined
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_regex_script.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/summary_example.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shell_examples.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shebang.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex1.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex2.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/sleep.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex4.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/csh_shell_examples.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/environment.yml: skipping test because 'maintainers' field is not specified in buildspec.
Valid Buildspecs: 31
Invalid Buildspecs: 2
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/burstbuffer_datawarp_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_buildspec.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_buildspec_section.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_tags.yml: INVALID
                            Buildspecs Filtered out                             
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs                                                                   ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ hello_wor… │ generic.l… │ None     │ None  │ None  │ hello      │ /home/doc… │
│            │            │          │       │       │ world      │            │
│            │            │          │       │       │ example    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
hello_world/a2a3b259: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/a2a3b259
hello_world/a2a3b259: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/a2a3b259/stage
hello_world/a2a3b259: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/a2a3b259/hello_world_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
hello_world/a2a3b259 does not have any dependencies adding test to queue
hello_world/a2a3b259: Running Test via command: bash --norc --noprofile -eo pipefail hello_world_build.sh
hello_world/a2a3b259: Test completed in 0.005629 seconds
hello_world/a2a3b259: Test completed with returncode: 0
hello_world/a2a3b259: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/a2a3b259/hello_world.out
hello_world/a2a3b259: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/a2a3b259/hello_world.err
In this iteration we are going to run the following tests: [hello_world/a2a3b259]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ hello_world/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.005629 │
│ a2a3b259     │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_53_vsb5h.log

Please see Query Maintainers (buildtest buildspec maintainers) on list of maintainers and breakdown of buildspecs by maintainers.

We can also filter tests by type field in the buildspec which corresponds to the schema type. In this next example, we filter all tests by script schema type by passing option --filter type=script. We inform buildtest to stop after build stage (--stage=build) for more details see Configure Build Stages.

buildtest build -b tutorials --filter type=script --stage=build
$ buildtest build -b tutorials --filter type=script --stage=build
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:27                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  33
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  33
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 33 buildspecs
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_buildspec.yml: skipping all test since 'skip' is defined
skip: skipping test due to 'skip' property.
Valid Buildspecs: 31
Invalid Buildspecs: 2
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/burstbuffer_datawarp_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_buildspec.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_tags.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_buildspec_section.yml: INVALID
                            Buildspecs Filtered out                             
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs                                                                   ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 62
Total compiler builder: 0
Total script builder: 62
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ create_bu… │ generic.l… │ None     │ None  │ None  │ Create a   │ /home/doc… │
│            │            │          │       │       │ burst      │            │
│            │            │          │       │       │ buffer for │            │
│            │            │          │       │       │ multiple   │            │
│            │            │          │       │       │ executors  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ create_bu… │ generic.l… │ None     │ None  │ None  │ Create a   │ /home/doc… │
│            │            │          │       │       │ burst      │            │
│            │            │          │       │       │ buffer for │            │
│            │            │          │       │       │ multiple   │            │
│            │            │          │       │       │ executors  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ _bin_sh_s… │ generic.l… │ None     │ None  │ None  │ /bin/sh    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ _bin_bash… │ generic.l… │ None     │ None  │ None  │ /bin/bash  │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ bash_shel… │ generic.l… │ None     │ None  │ None  │ bash shell │ /home/doc… │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ sh_shell/… │ generic.l… │ None     │ None  │ None  │ sh shell   │ /home/doc… │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ shell_opt… │ generic.l… │ None     │ None  │ None  │ shell      │ /home/doc… │
│            │            │          │       │       │ options    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ bash_env_… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in default │            │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ (bash)     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ csh_env_d… │ generic.l… │ None     │ None  │ None  │ csh shell  │ /home/doc… │
│            │            │          │       │       │ example to │            │
│            │            │          │       │       │ declare    │            │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ tcsh_env_… │ generic.l… │ None     │ None  │ None  │ tcsh shell │ /home/doc… │
│            │            │          │       │       │ example to │            │
│            │            │          │       │       │ declare    │            │
│            │            │          │       │       │ environme… │            │
│            │            │          │       │       │ variables  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ pass_test… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will       │            │
│            │            │          │       │       │ always     │            │
│            │            │          │       │       │ pass       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ fail_test… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ if test    │            │
│            │            │          │       │       │ 'pass_tes… │            │
│            │            │          │       │       │ is in      │            │
│            │            │          │       │       │ state      │            │
│            │            │          │       │       │ 'PASS'     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ pass_and_… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ if         │            │
│            │            │          │       │       │ pass_test  │            │
│            │            │          │       │       │ is 'PASS'  │            │
│            │            │          │       │       │ and        │            │
│            │            │          │       │       │ fail_test  │            │
│            │            │          │       │       │ is 'FAIL'  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ final_tes… │ generic.l… │ None     │ None  │ None  │ Test will  │ /home/doc… │
│            │            │          │       │       │ run after  │            │
│            │            │          │       │       │ 'pass_tes… │            │
│            │            │          │       │       │ 'fail_tes… │            │
│            │            │          │       │       │ and        │            │
│            │            │          │       │       │ 'pass_and… │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test1/5d1… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will pass  │            │
│            │            │          │       │       │ with exit  │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test2/96f… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ if test1   │            │
│            │            │          │       │       │ has        │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test3/438… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ if test1   │            │
│            │            │          │       │       │ has        │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1 and      │            │
│            │            │          │       │       │ test2 has  │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 2          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ python_he… │ generic.l… │ None     │ None  │ None  │ Hello      │ /home/doc… │
│            │            │          │       │       │ World      │            │
│            │            │          │       │       │ python     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ bash_logi… │ generic.l… │ None     │ None  │ None  │ customize  │ /home/doc… │
│            │            │          │       │       │ shebang    │            │
│            │            │          │       │       │ line with  │            │
│            │            │          │       │       │ bash login │            │
│            │            │          │       │       │ shell      │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ bash_nonl… │ generic.l… │ None     │ None  │ None  │ customize  │ /home/doc… │
│            │            │          │       │       │ shebang    │            │
│            │            │          │       │       │ line with  │            │
│            │            │          │       │       │ default    │            │
│            │            │          │       │       │ bash       │            │
│            │            │          │       │       │ (nonlogin) │            │
│            │            │          │       │       │ shell      │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ foo_bar/b… │ generic.l… │ None     │ None  │ None  │ prints     │ /home/doc… │
│            │            │          │       │       │ variable   │            │
│            │            │          │       │       │ $FOO       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ unskipped… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ is not     │            │
│            │            │          │       │       │ skipped    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ timelimit… │ generic.l… │ None     │ None  │ None  │ Run a      │ /home/doc… │
│            │            │          │       │       │ sleep job  │            │
│            │            │          │       │       │ for 2      │            │
│            │            │          │       │       │ seconds    │            │
│            │            │          │       │       │ and test   │            │
│            │            │          │       │       │ pass if    │            │
│            │            │          │       │       │ its within │            │
│            │            │          │       │       │ 1.0-3.0sec │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ timelimit… │ generic.l… │ None     │ None  │ None  │ Run a      │ /home/doc… │
│            │            │          │       │       │ sleep job  │            │
│            │            │          │       │       │ for 2      │            │
│            │            │          │       │       │ seconds    │            │
│            │            │          │       │       │ and test   │            │
│            │            │          │       │       │ pass if    │            │
│            │            │          │       │       │ its        │            │
│            │            │          │       │       │ exceeds    │            │
│            │            │          │       │       │ min time   │            │
│            │            │          │       │       │ of 1.0 sec │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ timelimit… │ generic.l… │ None     │ None  │ None  │ Run a      │ /home/doc… │
│            │            │          │       │       │ sleep job  │            │
│            │            │          │       │       │ for 2      │            │
│            │            │          │       │       │ seconds    │            │
│            │            │          │       │       │ and test   │            │
│            │            │          │       │       │ pass if    │            │
│            │            │          │       │       │ it's       │            │
│            │            │          │       │       │ within max │            │
│            │            │          │       │       │ time: 5.0  │            │
│            │            │          │       │       │ sec        │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ timelimit… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ fails      │            │
│            │            │          │       │       │ because it │            │
│            │            │          │       │       │ runs less  │            │
│            │            │          │       │       │ than       │            │
│            │            │          │       │       │ mintime of │            │
│            │            │          │       │       │ 10 second  │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ timelimit… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ fails      │            │
│            │            │          │       │       │ because it │            │
│            │            │          │       │       │ exceeds    │            │
│            │            │          │       │       │ maxtime of │            │
│            │            │          │       │       │ 1.0 second │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ csh_shell… │ generic.l… │ None     │ None  │ None  │ csh shell  │ /home/doc… │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ status_re… │ generic.l… │ None     │ None  │ None  │ define     │ /home/doc… │
│            │            │          │       │       │ status per │            │
│            │            │          │       │       │ executor   │            │
│            │            │          │       │       │ type.      │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ status_re… │ generic.l… │ None     │ None  │ None  │ define     │ /home/doc… │
│            │            │          │       │       │ status per │            │
│            │            │          │       │       │ executor   │            │
│            │            │          │       │       │ type.      │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ executors… │ generic.l… │ None     │ None  │ None  │ Declaring  │ /home/doc… │
│            │            │          │       │       │ env and    │            │
│            │            │          │       │       │ vars by    │            │
│            │            │          │       │       │ executors  │            │
│            │            │          │       │       │ section    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ executors… │ generic.l… │ None     │ None  │ None  │ Declaring  │ /home/doc… │
│            │            │          │       │       │ env and    │            │
│            │            │          │       │       │ vars by    │            │
│            │            │          │       │       │ executors  │            │
│            │            │          │       │       │ section    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_fai… │ generic.l… │ None     │ None  │ None  │ exit 1 by  │ /home/doc… │
│            │            │          │       │       │ default is │            │
│            │            │          │       │       │ FAIL       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 2     │ /home/doc… │
│            │            │          │       │       │ failed     │            │
│            │            │          │       │       │ since it   │            │
│            │            │          │       │       │ failed to  │            │
│            │            │          │       │       │ match      │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ multiple_… │ generic.l… │ None     │ None  │ None  │ run test   │ /home/doc… │
│            │            │          │       │       │ with       │            │
│            │            │          │       │       │ executor   │            │
│            │            │          │       │       │ generic.l… │            │
│            │            │          │       │       │ and        │            │
│            │            │          │       │       │ generic.l… │            │
│            │            │          │       │       │ executor   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ multiple_… │ generic.l… │ None     │ None  │ None  │ run test   │ /home/doc… │
│            │            │          │       │       │ with       │            │
│            │            │          │       │       │ executor   │            │
│            │            │          │       │       │ generic.l… │            │
│            │            │          │       │       │ and        │            │
│            │            │          │       │       │ generic.l… │            │
│            │            │          │       │       │ executor   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobA/0912… │ generic.l… │ None     │ None  │ None  │ no job     │ /home/doc… │
│            │            │          │       │       │ dependency │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobB/99fa… │ generic.l… │ None     │ None  │ None  │ job        │ /home/doc… │
│            │            │          │       │       │ dependency │            │
│            │            │          │       │       │ on jobA    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobC/0004… │ generic.l… │ None     │ None  │ None  │ job        │ /home/doc… │
│            │            │          │       │       │ dependency │            │
│            │            │          │       │       │ on jobA    │            │
│            │            │          │       │       │ and jobB   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ hello_wor… │ generic.l… │ None     │ None  │ None  │ hello      │ /home/doc… │
│            │            │          │       │       │ world      │            │
│            │            │          │       │       │ example    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ status_re… │ generic.l… │ None     │ None  │ None  │ Pass test  │ /home/doc… │
│            │            │          │       │       │ based on   │            │
│            │            │          │       │       │ regular    │            │
│            │            │          │       │       │ expression │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ status_re… │ generic.l… │ None     │ None  │ None  │ Pass test  │ /home/doc… │
│            │            │          │       │       │ based on   │            │
│            │            │          │       │       │ regular    │            │
│            │            │          │       │       │ expression │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ string_ta… │ generic.l… │ None     │ None  │ None  │ tags can   │ /home/doc… │
│            │            │          │       │       │ be a       │            │
│            │            │          │       │       │ string     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ list_of_s… │ generic.l… │ None     │ None  │ None  │ tags can   │ /home/doc… │
│            │            │          │       │       │ be a list  │            │
│            │            │          │       │       │ of strings │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ metric_re… │ generic.l… │ None     │ None  │ None  │ capture    │ /home/doc… │
│            │            │          │       │       │ result     │            │
│            │            │          │       │       │ metric     │            │
│            │            │          │       │       │ from       │            │
│            │            │          │       │       │ output     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ runtime_t… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will sleep │            │
│            │            │          │       │       │ 5 second   │            │
│            │            │          │       │       │ but will   │            │
│            │            │          │       │       │ fail due   │            │
│            │            │          │       │       │ to runtime │            │
│            │            │          │       │       │ 2sec       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ runtime_t… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ when       │            │
│            │            │          │       │       │ runtime_t… │            │
│            │            │          │       │       │ is PASS    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ runtime_t… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will run   │            │
│            │            │          │       │       │ when       │            │
│            │            │          │       │       │ runtime_t… │            │
│            │            │          │       │       │ is FAIL    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ executors… │ generic.l… │ None     │ None  │ None  │ Declaring  │ /home/doc… │
│            │            │          │       │       │ env and    │            │
│            │            │          │       │       │ vars by    │            │
│            │            │          │       │       │ executors  │            │
│            │            │          │       │       │ section    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ executors… │ generic.l… │ None     │ None  │ None  │ Declaring  │ /home/doc… │
│            │            │          │       │       │ env and    │            │
│            │            │          │       │       │ vars by    │            │
│            │            │          │       │       │ executors  │            │
│            │            │          │       │       │ section    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ gcc_versi… │ generic.l… │ None     │ None  │ None  │ Print gcc  │ /home/doc… │
│            │            │          │       │       │ version    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ sleep/1bb… │ generic.l… │ None     │ None  │ None  │ sleep 2    │ /home/doc… │
│            │            │          │       │       │ seconds    │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ summary_e… │ generic.l… │ None     │ None  │ None  │ The        │ /home/doc… │
│            │            │          │       │       │ summary    │            │
│            │            │          │       │       │ field can  │            │
│            │            │          │       │       │ be a       │            │
│            │            │          │       │       │ multi-line │            │
│            │            │          │       │       │ string and │            │
│            │            │          │       │       │ exceed 80  │            │
│            │            │          │       │       │ char       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ always_pa… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will       │            │
│            │            │          │       │       │ always     │            │
│            │            │          │       │       │ 'PASS'     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ always_fa… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will       │            │
│            │            │          │       │       │ always     │            │
│            │            │          │       │       │ 'FAIL'     │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test_fail… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will       │            │
│            │            │          │       │       │ 'FAIL'     │            │
│            │            │          │       │       │ even if we │            │
│            │            │          │       │       │ have       │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ match      │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test_pass… │ generic.l… │ None     │ None  │ None  │ This test  │ /home/doc… │
│            │            │          │       │       │ will       │            │
│            │            │          │       │       │ 'PASS'     │            │
│            │            │          │       │       │ even if we │            │
│            │            │          │       │       │ have       │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ mismatch   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ add_numbe… │ generic.l… │ None     │ None  │ None  │ Add X+Y    │ /home/doc… │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
create_burst_buffer_executors/2501fdcb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/2501fdcb
create_burst_buffer_executors/2501fdcb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/2501fdcb/stage
create_burst_buffer_executors/2501fdcb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/2501fdcb/create_burst_buffer_executors_build.sh
create_burst_buffer_executors/08bcadc3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/08bcadc3
create_burst_buffer_executors/08bcadc3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/08bcadc3/stage
create_burst_buffer_executors/08bcadc3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/08bcadc3/create_burst_buffer_executors_build.sh
_bin_sh_shell/20cc8a62: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/20cc8a62
_bin_sh_shell/20cc8a62: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/20cc8a62/stage
_bin_sh_shell/20cc8a62: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/20cc8a62/_bin_sh_shell_build.sh
_bin_bash_shell/920765dc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/920765dc
_bin_bash_shell/920765dc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/920765dc/stage
_bin_bash_shell/920765dc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/920765dc/_bin_bash_shell_build.sh
bash_shell/236f0163: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/bash_shell/236f0163
bash_shell/236f0163: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/bash_shell/236f0163/stage
bash_shell/236f0163: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shell_examples/bash_shell/236f0163/bash_shell_build.sh
sh_shell/9d701f18: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/sh_shell/9d701f18
sh_shell/9d701f18: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/sh_shell/9d701f18/stage
sh_shell/9d701f18: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/sh_shell/9d701f18/sh_shell_build.sh
shell_options/e4f3c052: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/shell_options/e4f3c052
shell_options/e4f3c052: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/shell_options/e4f3c052/stage
shell_options/e4f3c052: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/shell_examples/shell_options/e4f3c052/shell_options_build.sh
bash_env_variables/cddfd531: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/cddfd531
bash_env_variables/cddfd531: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/cddfd531/stage
bash_env_variables/cddfd531: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/environment/bash_env_variables/cddfd531/bash_env_variables_build.sh
csh_env_declaration/2350e726: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/2350e726
csh_env_declaration/2350e726: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/2350e726/stage
csh_env_declaration/2350e726: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/csh_env_declaration/2350e726/csh_env_declaration_build.sh
tcsh_env_declaration/ced981e2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/ced981e2
tcsh_env_declaration/ced981e2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/ced981e2/stage
tcsh_env_declaration/ced981e2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/environment/tcsh_env_declaration/ced981e2/tcsh_env_declaration_build.sh
pass_test/0978d64b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_test/0978d64b
pass_test/0978d64b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_test/0978d64b/stage
pass_test/0978d64b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_test/0978d64b/pass_test_build.sh
fail_test/4af64a0b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/fail_test/4af64a0b
fail_test/4af64a0b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/fail_test/4af64a0b/stage
fail_test/4af64a0b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/fail_test/4af64a0b/fail_test_build.sh
pass_and_fail_test/2ff5b851: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_and_fail_test/2ff5b851
pass_and_fail_test/2ff5b851: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_and_fail_test/2ff5b851/stage
pass_and_fail_test/2ff5b851: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/pass_and_fail_test/2ff5b851/pass_and_fail_test_build.sh
final_test/e89e3ae7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/final_test/e89e3ae7
final_test/e89e3ae7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/final_test/e89e3ae7/stage
final_test/e89e3ae7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex3/final_test/e89e3ae7/final_test_build.sh
test1/5d1ff8ef: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test1/5d1ff8ef
test1/5d1ff8ef: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test1/5d1ff8ef/stage
test1/5d1ff8ef: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test1/5d1ff8ef/test1_build.sh
test2/96fa7e32: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test2/96fa7e32
test2/96fa7e32: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test2/96fa7e32/stage
test2/96fa7e32: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test2/96fa7e32/test2_build.sh
test3/4388656a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test3/4388656a
test3/4388656a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test3/4388656a/stage
test3/4388656a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex2/test3/4388656a/test3_build.sh
python_hello/6888a5b1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/6888a5b1
python_hello/6888a5b1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/6888a5b1/stage
python_hello/6888a5b1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/6888a5b1/python_hello_build.sh
variables_bash/ff795106: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/ff795106
variables_bash/ff795106: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/ff795106/stage
variables_bash/ff795106: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/ff795106/variables_bash_build.sh
bash_login_shebang/d6ccd6bb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_login_shebang/d6ccd6bb
bash_login_shebang/d6ccd6bb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_login_shebang/d6ccd6bb/stage
bash_login_shebang/d6ccd6bb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_login_shebang/d6ccd6bb/bash_login_shebang_build.sh
bash_nonlogin_shebang/6caaca2c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/6caaca2c
bash_nonlogin_shebang/6caaca2c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/6caaca2c/stage
bash_nonlogin_shebang/6caaca2c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/6caaca2c/bash_nonlogin_shebang_build.sh
foo_bar/bad9231c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/maintainers_example/foo_bar/bad9231c
foo_bar/bad9231c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/maintainers_example/foo_bar/bad9231c/stage
foo_bar/bad9231c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/maintainers_example/foo_bar/bad9231c/foo_bar_build.sh
unskipped/be98d23c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/skip_tests/unskipped/be98d23c
unskipped/be98d23c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/skip_tests/unskipped/be98d23c/stage
unskipped/be98d23c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/skip_tests/unskipped/be98d23c/unskipped_build.sh
timelimit_min_max/43918044: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/43918044
timelimit_min_max/43918044: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/43918044/stage
timelimit_min_max/43918044: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/43918044/timelimit_min_max_build.sh
timelimit_min/baf48941: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min/baf48941
timelimit_min/baf48941: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min/baf48941/stage
timelimit_min/baf48941: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min/baf48941/timelimit_min_build.sh
timelimit_max/ed084550: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max/ed084550
timelimit_max/ed084550: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max/ed084550/stage
timelimit_max/ed084550: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max/ed084550/timelimit_max_build.sh
timelimit_min_fail/89f4c4a2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/89f4c4a2
timelimit_min_fail/89f4c4a2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/89f4c4a2/stage
timelimit_min_fail/89f4c4a2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/89f4c4a2/timelimit_min_fail_build.sh
timelimit_max_fail/6d768d92: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/6d768d92
timelimit_max_fail/6d768d92: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/6d768d92/stage
timelimit_max_fail/6d768d92: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/6d768d92/timelimit_max_fail_build.sh
csh_shell/a778b5d8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a778b5d8
csh_shell/a778b5d8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a778b5d8/stage
csh_shell/a778b5d8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a778b5d8/csh_shell_build.sh
status_returncode_by_executors/68ee35a5: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/68ee35a5
status_returncode_by_executors/68ee35a5: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/68ee35a5/stage
status_returncode_by_executors/68ee35a5: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/68ee35a5/status_returncode_by_executors_build.sh
status_returncode_by_executors/7f6c9199: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/7f6c9199
status_returncode_by_executors/7f6c9199: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/7f6c9199/stage
status_returncode_by_executors/7f6c9199: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/7f6c9199/status_returncode_by_executors_build.sh
executors_vars_env_declaration/e10ce418: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e10ce418
executors_vars_env_declaration/e10ce418: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e10ce418/stage
executors_vars_env_declaration/e10ce418: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e10ce418/executors_vars_env_declaration_build.sh
executors_vars_env_declaration/c9824d36: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/c9824d36
executors_vars_env_declaration/c9824d36: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/c9824d36/stage
executors_vars_env_declaration/c9824d36: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/c9824d36/executors_vars_env_declaration_build.sh
exit1_fail/b29e1af3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b29e1af3
exit1_fail/b29e1af3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b29e1af3/stage
exit1_fail/b29e1af3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b29e1af3/exit1_fail_build.sh
exit1_pass/78d27075: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/78d27075
exit1_pass/78d27075: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/78d27075/stage
exit1_pass/78d27075: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/78d27075/exit1_pass_build.sh
returncode_list_mismatch/42235b8e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/42235b8e
returncode_list_mismatch/42235b8e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/42235b8e/stage
returncode_list_mismatch/42235b8e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/42235b8e/returncode_list_mismatch_build.sh
returncode_int_match/49f0ffb9: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/49f0ffb9
returncode_int_match/49f0ffb9: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/49f0ffb9/stage
returncode_int_match/49f0ffb9: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/49f0ffb9/returncode_int_match_build.sh
multiple_executors/c4b7c727: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_regex_script/multiple_executors/c4b7c727
multiple_executors/c4b7c727: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_regex_script/multiple_executors/c4b7c727/stage
multiple_executors/c4b7c727: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_regex_script/multiple_executors/c4b7c727/multiple_executors_build.sh
multiple_executors/cdf8d03e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_regex_script/multiple_executors/cdf8d03e
multiple_executors/cdf8d03e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_regex_script/multiple_executors/cdf8d03e/stage
multiple_executors/cdf8d03e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_regex_script/multiple_executors/cdf8d03e/multiple_executors_build.sh
jobA/0912dfbd: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobA/0912dfbd
jobA/0912dfbd: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobA/0912dfbd/stage
jobA/0912dfbd: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobA/0912dfbd/jobA_build.sh
jobB/99fa801a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobB/99fa801a
jobB/99fa801a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobB/99fa801a/stage
jobB/99fa801a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobB/99fa801a/jobB_build.sh
jobC/00044f2f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobC/00044f2f
jobC/00044f2f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobC/00044f2f/stage
jobC/00044f2f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex1/jobC/00044f2f/jobC_build.sh
hello_world/7f1f23c7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/7f1f23c7
hello_world/7f1f23c7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/7f1f23c7/stage
hello_world/7f1f23c7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/hello_world/hello_world/7f1f23c7/hello_world_build.sh
status_regex_pass/f6cf1c96: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_pass/f6cf1c96
status_regex_pass/f6cf1c96: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_pass/f6cf1c96/stage
status_regex_pass/f6cf1c96: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_pass/f6cf1c96/status_regex_pass_build.sh
status_regex_fail/aba23904: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_fail/aba23904
status_regex_fail/aba23904: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_fail/aba23904/stage
status_regex_fail/aba23904: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/status_regex/status_regex_fail/aba23904/status_regex_fail_build.sh
string_tag/6a2fcdac: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/6a2fcdac
string_tag/6a2fcdac: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/6a2fcdac/stage
string_tag/6a2fcdac: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/string_tag/6a2fcdac/string_tag_build.sh
list_of_strings_tags/91e5c55b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/91e5c55b
list_of_strings_tags/91e5c55b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/91e5c55b/stage
list_of_strings_tags/91e5c55b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/tags_example/list_of_strings_tags/91e5c55b/list_of_strings_tags_build.sh
circle_area/d133a6ee: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/d133a6ee
circle_area/d133a6ee: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/d133a6ee/stage
circle_area/d133a6ee: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/d133a6ee/circle_area_build.sh
metric_regex_example/190c439c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/metrics_regex/metric_regex_example/190c439c
metric_regex_example/190c439c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/metrics_regex/metric_regex_example/190c439c/stage
metric_regex_example/190c439c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/metrics_regex/metric_regex_example/190c439c/metric_regex_example_build.sh
runtime_test/7851f33a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test/7851f33a
runtime_test/7851f33a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test/7851f33a/stage
runtime_test/7851f33a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test/7851f33a/runtime_test_build.sh
runtime_test_pass/898963dc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_pass/898963dc
runtime_test_pass/898963dc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_pass/898963dc/stage
runtime_test_pass/898963dc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_pass/898963dc/runtime_test_pass_build.sh
runtime_test_fail/7e58a51a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_fail/7e58a51a
runtime_test_fail/7e58a51a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_fail/7e58a51a/stage
runtime_test_fail/7e58a51a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/ex4/runtime_test_fail/7e58a51a/runtime_test_fail_build.sh
executors_sbatch_declaration/29616ea3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/29616ea3
executors_sbatch_declaration/29616ea3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/29616ea3/stage
executors_sbatch_declaration/29616ea3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/29616ea3/executors_sbatch_declaration_build.sh
executors_sbatch_declaration/b45f2aad: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/b45f2aad
executors_sbatch_declaration/b45f2aad: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/b45f2aad/stage
executors_sbatch_declaration/b45f2aad: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/b45f2aad/executors_sbatch_declaration_build.sh
gcc_version/fd53a9f9: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/gcc_version/gcc_version/fd53a9f9
gcc_version/fd53a9f9: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/gcc_version/gcc_version/fd53a9f9/stage
gcc_version/fd53a9f9: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/gcc_version/gcc_version/fd53a9f9/gcc_version_build.sh
sleep/1bb5e724: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/1bb5e724
sleep/1bb5e724: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/1bb5e724/stage
sleep/1bb5e724: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/1bb5e724/sleep_build.sh
summary_example/56c1314e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/summary_example/summary_example/56c1314e
summary_example/56c1314e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/summary_example/summary_example/56c1314e/stage
summary_example/56c1314e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/summary_example/summary_example/56c1314e/summary_example_build.sh
always_pass/b90a305a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_pass/b90a305a
always_pass/b90a305a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_pass/b90a305a/stage
always_pass/b90a305a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_pass/b90a305a/always_pass_build.sh
always_fail/cc3e9556: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_fail/cc3e9556
always_fail/cc3e9556: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_fail/cc3e9556/stage
always_fail/cc3e9556: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/always_fail/cc3e9556/always_fail_build.sh
test_fail_returncode_match/59e043b0: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/59e043b0
test_fail_returncode_match/59e043b0: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/59e043b0/stage
test_fail_returncode_match/59e043b0: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/59e043b0/test_fail_returncode_match_build.sh
test_pass_returncode_mismatch/f91145dd: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/f91145dd
test_pass_returncode_mismatch/f91145dd: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/f91145dd/stage
test_pass_returncode_mismatch/f91145dd: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/f91145dd/test_pass_returncode_mismatch_build.sh
add_numbers/969c195f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/add_numbers/add_numbers/969c195f
add_numbers/969c195f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/add_numbers/add_numbers/969c195f/stage
add_numbers/969c195f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/add_numbers/add_numbers/969c195f/add_numbers_build.sh

Filter By Executor Type

In a HPC environment, you may want to run test locally on a login node or perhaps you only want to run batch jobs given a list of buildspecs specified on command line. This can be done in buildtest via option buildtest build –executor-type which takes one of two values local or batch. If you want to filter all tests by local executor you can do buildtest build --executor-type local. buildtest will filter test based on the executor property defined in the buildspec. Let’s assume we want to run all test by python tag on local executor you can do the following:

buildtest build -t python --executor-type local
$ buildtest build -t python --executor-type local
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:28                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                            Buildspecs By Tag=python                            
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  2
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
Total builder objects created: 2
Total compiler builder: 0
Total script builder: 2
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ python_he… │ generic.l… │ None     │ None  │ None  │ Hello      │ /home/doc… │
│            │            │          │       │       │ World      │            │
│            │            │          │       │       │ python     │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
circle_area/6c9572d5: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6c9572d5
circle_area/6c9572d5: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6c9572d5/stage
circle_area/6c9572d5: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6c9572d5/circle_area_build.sh
python_hello/237968f1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/237968f1
python_hello/237968f1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/237968f1/stage
python_hello/237968f1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/237968f1/python_hello_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
circle_area/6c9572d5 does not have any dependencies adding test to queue
python_hello/237968f1 does not have any dependencies adding test to queue
circle_area/6c9572d5: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/6c9572d5: Test completed in 0.03094 seconds
circle_area/6c9572d5: Test completed with returncode: 0
circle_area/6c9572d5: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6c9572d5/circle_area.out
circle_area/6c9572d5: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6c9572d5/circle_area.err
python_hello/237968f1: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/237968f1: Test completed in 0.030242 seconds
python_hello/237968f1: Test completed with returncode: 0
python_hello/237968f1: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/237968f1/python_hello.out
python_hello/237968f1: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-hello/python_hello/237968f1/python_hello.err
In this iteration we are going to run the following tests: [circle_area/6c9572d5, python_hello/237968f1]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ python_hello │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.030242 │
│ /237968f1    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.03094  │
│ 6c9572d5     │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%


Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_i5k9h68i.log

Now let’s say we want to rerun same command but now only run test that are batch, we can specify --executor-type batch and buildtest will filter tests by executor and find all batch executors. In this case we see that all tests were filtered out and we have no test run.

buildtest build -t python --executor-type batch
$ buildtest build -t python --executor-type batch
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:28                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                            Buildspecs By Tag=python                            
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  2
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
circle_area/1e535d4d is excluded since its not using batch executor
python_hello/dfce02b0 is excluded since its not using batch executor
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-hello.yml: VALID
                            Buildspecs Filtered out                             
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs                                                                   ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
└──────────────────────────────────────────────────────────────────────────────┘

buildtest is unable to create any tests because there are no valid buildspecs. 

Please see logfile: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/buildtest.log

This option can be particularly useful if want to run a lot of tests and you are not sure which ones will run locally or batch. Let’s say you have all your buildspecs in a directory name tests and you want to run all test that will use local executor and you don’t want to run the batch jobs then you can do the following:

buildtest build -b tests --executor-type local

Discover Buildspecs

Now, let’s discuss how buildtest discovers buildspecs since there are several ways to build buildspecs.

The buildspec search resolution is described as follows:

  • If file or directory specified by -b option doesn’t exist we exit immediately.

  • If buildspec path is a directory, traverse directory recursively to find all .yml extensions

  • If buildspec path is a file, check if file extension is not .yml, exit immediately

  • If user specifies --tags or --executor we search in buildspec cache to discover buildspecs.

Shown below is a diagram on how buildtest discovers buildspecs. The user can build buildspecs by --buildspec, –tags, or –executor which will discover the buildspecs. You can exclude buildspecs using --exclude option which is processed after discovering buildspecs. The excluded buildspecs are removed from list if found and final list of buildspecs is processed.

../_images/DiscoverBuildspecs.jpg

Configure Build Stages

We can control behavior of buildtest build command to stop at certain phase using --stage option. The –stage option accepts parse or build, which will instruct buildtest to stop at parse or build phase of the pipeline.

Buildtest will validate all the buildspecs in the parse stage, so you can instruct buildtest to stop at parse stage via --stage=parse. This can be useful when debugging buildspecs that are invalid. In this example below, we instruct buildtest to stop after parse stage.

buildtest build -b tutorials/vars.yml --stage=parse
$ buildtest build -b tutorials/vars.yml --stage=parse
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:29                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘

Likewise, if you want to troubleshoot your test script without running them you can use --stage=build which will stop after build phase. This can be used when you are writing buildspec to troubleshoot how test is generated. In this next example, we inform buildtest to stop after build stage.

buildtest build -b tutorials/vars.yml --stage=build
$ buildtest build -b tutorials/vars.yml --stage=build
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:29                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/573fb832: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/573fb832
variables_bash/573fb832: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/573fb832/stage
variables_bash/573fb832: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/573fb832/variables_bash_build.sh

Invalid Buildspecs

buildtest will skip any buildspecs that fail to validate, in that case the test script will not be generated. Here is an example where we have an invalid buildspec.

buildtest build -b tutorials/invalid_buildspec_section.yml
$ buildtest build -b tutorials/invalid_buildspec_section.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:30                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 0
Invalid Buildspecs: 1
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_buildspec_section.yml: INVALID

buildtest is unable to create any tests because there are no valid buildspecs. 

Please see logfile: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/buildtest.log

buildtest may skip tests from running if buildspec specifies an invalid executor name since buildtest needs to know this in order to delegate test to Executor class responsible for running the test. Here is an example where test failed to run since we provided invalid executor.

buildtest build -b tutorials/invalid_executor.yml
$ buildtest build -b tutorials/invalid_executor.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:30                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_executor.yml: VALID
                            Buildspecs Filtered out                             
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs                                                                   ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
└──────────────────────────────────────────────────────────────────────────────┘

buildtest is unable to create any tests because there are no valid buildspecs. 

Please see logfile: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/buildtest.log

Rebuild Tests

buildtest can rebuild tests using the --rebuild option which can be useful if you want to test a particular test multiple times. The rebuild option works across all discovered buildspecs and create a new test instance (unique id) and test directory path. To demonstrate we will build tutorials/python-shell.yml three times using --rebuild=3.

buildtest build -b tutorials/python-shell.yml --rebuild=3
$ buildtest build -b tutorials/python-shell.yml --rebuild=3
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:31                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/python-shell.yml: VALID
Total builder objects created: 3
Total compiler builder: 0
Total script builder: 3
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ circle_ar… │ generic.l… │ None     │ None  │ None  │ Calculate  │ /home/doc… │
│            │            │          │       │       │ circle of  │            │
│            │            │          │       │       │ area given │            │
│            │            │          │       │       │ a radius   │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
circle_area/105b0f6e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/105b0f6e
circle_area/105b0f6e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/105b0f6e/stage
circle_area/105b0f6e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/105b0f6e/circle_area_build.sh
circle_area/6372b390: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6372b390
circle_area/6372b390: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6372b390/stage
circle_area/6372b390: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6372b390/circle_area_build.sh
circle_area/bc92b1d2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/bc92b1d2
circle_area/bc92b1d2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/bc92b1d2/stage
circle_area/bc92b1d2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/bc92b1d2/circle_area_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
circle_area/6372b390 does not have any dependencies adding test to queue
circle_area/bc92b1d2 does not have any dependencies adding test to queue
circle_area/105b0f6e does not have any dependencies adding test to queue
circle_area/6372b390: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/6372b390: Test completed in 0.031279 seconds
circle_area/6372b390: Test completed with returncode: 0
circle_area/6372b390: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6372b390/circle_area.out
circle_area/6372b390: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/6372b390/circle_area.err
circle_area/bc92b1d2: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/bc92b1d2: Test completed in 0.031735 seconds
circle_area/bc92b1d2: Test completed with returncode: 0
circle_area/bc92b1d2: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/bc92b1d2/circle_area.out
circle_area/bc92b1d2: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/bc92b1d2/circle_area.err
circle_area/105b0f6e: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/105b0f6e: Test completed in 0.031864 seconds
circle_area/105b0f6e: Test completed with returncode: 0
circle_area/105b0f6e: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/105b0f6e/circle_area.out
circle_area/105b0f6e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/python-shell/circle_area/105b0f6e/circle_area.err
In this iteration we are going to run the following tests: [circle_area/6372b390, circle_area/bc92b1d2, circle_area/105b0f6e]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.031279 │
│ 6372b390     │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.031864 │
│ 105b0f6e     │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.031735 │
│ bc92b1d2     │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 3/3 Percentage: 100.000%
Failed Tests: 0/3 Percentage: 0.000%


Adding 3 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_29l2f9eg.log

The rebuild works with all options including: --buildspec, --exclude, --tags and --executor. buildtest will perform rebuild for all discovered tests, for instance in this next example we will discover all tests by tag name fail and each test is rebuild twice.

buildtest build -t fail --rebuild 2
$ buildtest build -t fail --rebuild 2
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:31                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝
                             Buildspecs By Tag=fail                             
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  2
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/test_status/pass_returncode.yml: VALID
                            Buildspecs Filtered out                             
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs                                                                   ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 8
Total compiler builder: 0
Total script builder: 8
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ exit1_fai… │ generic.l… │ None     │ None  │ None  │ exit 1 by  │ /home/doc… │
│            │            │          │       │       │ default is │            │
│            │            │          │       │       │ FAIL       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 2     │ /home/doc… │
│            │            │          │       │       │ failed     │            │
│            │            │          │       │       │ since it   │            │
│            │            │          │       │       │ failed to  │            │
│            │            │          │       │       │ match      │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_fai… │ generic.l… │ None     │ None  │ None  │ exit 1 by  │ /home/doc… │
│            │            │          │       │       │ default is │            │
│            │            │          │       │       │ FAIL       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ exit1_pas… │ generic.l… │ None     │ None  │ None  │ report     │ /home/doc… │
│            │            │          │       │       │ exit 1 as  │            │
│            │            │          │       │       │ PASS       │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 2     │ /home/doc… │
│            │            │          │       │       │ failed     │            │
│            │            │          │       │       │ since it   │            │
│            │            │          │       │       │ failed to  │            │
│            │            │          │       │       │ match      │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 1          │            │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ returncod… │ generic.l… │ None     │ None  │ None  │ exit 128   │ /home/doc… │
│            │            │          │       │       │ matches    │            │
│            │            │          │       │       │ returncode │            │
│            │            │          │       │       │ 128        │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/2076aac2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/2076aac2
exit1_fail/2076aac2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/2076aac2/stage
exit1_fail/2076aac2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/2076aac2/exit1_fail_build.sh
exit1_pass/ce86fe2e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce86fe2e
exit1_pass/ce86fe2e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce86fe2e/stage
exit1_pass/ce86fe2e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce86fe2e/exit1_pass_build.sh
returncode_list_mismatch/9c53a81f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/9c53a81f
returncode_list_mismatch/9c53a81f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/9c53a81f/stage
returncode_list_mismatch/9c53a81f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/9c53a81f/returncode_list_mismatch_build.sh
returncode_int_match/7a88518a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/7a88518a
returncode_int_match/7a88518a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/7a88518a/stage
returncode_int_match/7a88518a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/7a88518a/returncode_int_match_build.sh
exit1_fail/b3806d5b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b3806d5b
exit1_fail/b3806d5b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b3806d5b/stage
exit1_fail/b3806d5b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b3806d5b/exit1_fail_build.sh
exit1_pass/7187873d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/7187873d
exit1_pass/7187873d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/7187873d/stage
exit1_pass/7187873d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/7187873d/exit1_pass_build.sh
returncode_list_mismatch/120d7514: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/120d7514
returncode_list_mismatch/120d7514: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/120d7514/stage
returncode_list_mismatch/120d7514: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/120d7514/returncode_list_mismatch_build.sh
returncode_int_match/4a65a42e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/4a65a42e
returncode_int_match/4a65a42e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/4a65a42e/stage
returncode_int_match/4a65a42e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/4a65a42e/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
returncode_int_match/7a88518a does not have any dependencies adding test to queue
returncode_list_mismatch/120d7514 does not have any dependencies adding test to queue
exit1_pass/7187873d does not have any dependencies adding test to queue
exit1_pass/ce86fe2e does not have any dependencies adding test to queue
returncode_list_mismatch/9c53a81f does not have any dependencies adding test to queue
exit1_fail/2076aac2 does not have any dependencies adding test to queue
exit1_fail/b3806d5b does not have any dependencies adding test to queue
returncode_int_match/4a65a42e does not have any dependencies adding test to queue
returncode_list_mismatch/120d7514: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/120d7514: Test completed in 0.005564 seconds
returncode_list_mismatch/120d7514: Test completed with returncode: 2
returncode_list_mismatch/120d7514: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/120d7514/returncode_list_mismatch.out
returncode_list_mismatch/120d7514: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/120d7514/returncode_list_mismatch.err
returncode_list_mismatch/120d7514: Checking returncode - 2 is matched in list [1, 3]
returncode_int_match/7a88518a: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/7a88518a: Test completed in 0.005284 seconds
returncode_int_match/7a88518a: Test completed with returncode: 128
returncode_int_match/7a88518a: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/7a88518a/returncode_int_match.out
returncode_int_match/7a88518a: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/7a88518a/returncode_int_match.err
returncode_int_match/7a88518a: Checking returncode - 128 is matched in list [128]
exit1_pass/7187873d: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/7187873d: Test completed in 0.005345 seconds
exit1_pass/7187873d: Test completed with returncode: 1
exit1_pass/7187873d: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/7187873d/exit1_pass.out
exit1_pass/7187873d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/7187873d/exit1_pass.err
exit1_pass/7187873d: Checking returncode - 1 is matched in list [1]
exit1_pass/ce86fe2e: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/ce86fe2e: Test completed in 0.005386 seconds
exit1_pass/ce86fe2e: Test completed with returncode: 1
exit1_pass/ce86fe2e: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce86fe2e/exit1_pass.out
exit1_pass/ce86fe2e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce86fe2e/exit1_pass.err
exit1_pass/ce86fe2e: Checking returncode - 1 is matched in list [1]
returncode_list_mismatch/9c53a81f: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/9c53a81f: Test completed in 0.005645 seconds
returncode_list_mismatch/9c53a81f: Test completed with returncode: 2
returncode_list_mismatch/9c53a81f: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/9c53a81f/returncode_list_mismatch.out
returncode_list_mismatch/9c53a81f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/9c53a81f/returncode_list_mismatch.err
returncode_list_mismatch/9c53a81f: Checking returncode - 2 is matched in list [1, 3]
exit1_fail/2076aac2: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/2076aac2: Test completed in 0.005634 seconds
exit1_fail/2076aac2: Test completed with returncode: 1
exit1_fail/2076aac2: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/2076aac2/exit1_fail.out
exit1_fail/2076aac2: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/2076aac2/exit1_fail.err
exit1_fail/b3806d5b: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/b3806d5b: Test completed in 0.00548 seconds
exit1_fail/b3806d5b: Test completed with returncode: 1
exit1_fail/b3806d5b: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b3806d5b/exit1_fail.out
exit1_fail/b3806d5b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/exit1_fail/b3806d5b/exit1_fail.err
returncode_int_match/4a65a42e: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/4a65a42e: Test completed in 0.0055 seconds
returncode_int_match/4a65a42e: Test completed with returncode: 128
returncode_int_match/4a65a42e: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/4a65a42e/returncode_int_match.out
returncode_int_match/4a65a42e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/pass_returncode/returncode_int_match/4a65a42e/returncode_int_match.err
returncode_int_match/4a65a42e: Checking returncode - 128 is matched in list [128]
In this iteration we are going to run the following tests: [returncode_list_mismatch/120d7514, returncode_int_match/7a88518a, exit1_pass/7187873d, exit1_pass/ce86fe2e, returncode_list_mismatch/9c53a81f, exit1_fail/2076aac2, exit1_fail/b3806d5b, returncode_int_match/4a65a42e]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS   │ True False    │ 128        │ 0.0055   │
│ nt_match/4a6 │              │        │ False         │            │          │
│ 5a42e        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS   │ True False    │ 128        │ 0.005284 │
│ nt_match/7a8 │              │        │ False         │            │          │
│ 8518a        │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/7 │ generic.loc… │ PASS   │ True False    │ 1          │ 0.005345 │
│ 187873d      │              │        │ False         │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/b │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.00548  │
│ 3806d5b      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL   │ False False   │ 2          │ 0.005564 │
│ ist_mismatch │              │        │ False         │            │          │
│ /120d7514    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL   │ False False   │ 2          │ 0.005645 │
│ ist_mismatch │              │        │ False         │            │          │
│ /9c53a81f    │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/2 │ generic.loc… │ FAIL   │ N/A N/A N/A   │ 1          │ 0.005634 │
│ 076aac2      │              │        │               │            │          │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/c │ generic.loc… │ PASS   │ True False    │ 1          │ 0.005386 │
│ e86fe2e      │              │        │ False         │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 4/8 Percentage: 50.000%
Failed Tests: 4/8 Percentage: 50.000%


Adding 8 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_vvg4p5u6.log

The rebuild option expects a range between 1-50, the --rebuild=1 is equivalent to running without --rebuild option. We set a max limit for rebuild option to avoid system degredation due to high workload.

If you try to exceed this bound you will get an error such as

buildtest build -b tutorials/test_status/pass_returncode.yml --rebuild 51
$ buildtest build -b tutorials/test_status/pass_returncode.yml --rebuild 51
╭───────────────────── Traceback (most recent call last) ──────────────────────╮
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/b │
│ in/buildtest:36 in <module>                                                  │
│                                                                              │
│   33                                                                         │
│   34 import buildtest.main                                                   │
│   35                                                                         │
│ ❱ 36 buildtest.main.main()                                                   │
│   37                                                                         │
│                                                                              │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │ __annotations__ = {}                                                     │ │
│ │    __builtins__ = <module 'builtins' (built-in)>                         │ │
│ │      __cached__ = None                                                   │ │
│ │         __doc__ = ':"\n# preferred pythons for running                   │ │
│ │                   buildtest\nPREFERRED_PYTHONS="python3 python"\n'+365   │ │
│ │        __file__ = '/home/docs/checkouts/readthedocs.org/user_builds/bui… │ │
│ │      __loader__ = <_frozen_importlib_external.SourceFileLoader object at │ │
│ │                   0x7f6c49b36210>                                        │ │
│ │        __name__ = '__main__'                                             │ │
│ │     __package__ = None                                                   │ │
│ │        __spec__ = None                                                   │ │
│ │       buildtest = <module 'buildtest' from                               │ │
│ │                   '/home/docs/checkouts/readthedocs.org/user_builds/bui… │ │
│ │  buildtest_file = '/home/docs/checkouts/readthedocs.org/user_builds/bui… │ │
│ │              os = <module 'os' from                                      │ │
│ │                   '/home/docs/.asdf/installs/python/3.7.13/lib/python3.… │ │
│ │          prefix = '/home/docs/checkouts/readthedocs.org/user_builds/bui… │ │
│ │             sys = <module 'sys' (built-in)>                              │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
│                                                                              │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/b │
│ uildtest/main.py:167 in main                                                 │
│                                                                              │
│   164 │   │   │   │   unload_modules=args.unload_modules,                    │
│   165 │   │   │   │   rerun=args.rerun,                                      │
│   166 │   │   │   │   executor_type=args.executor_type,                      │
│ ❱ 167 │   │   │   │   timeout=args.timeout,                                  │
│   168 │   │   │   )                                                          │
│   169 │   │   │   cmd.build()                                                │
│   170                                                                        │
│                                                                              │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │               args = Namespace(account=None,                             │ │
│ │                      buildspec=['tutorials/test_status/pass_returncode.… │ │
│ │                      configfile=None, debug=False,                       │ │
│ │                      disable_executor_check=True, editor=None,           │ │
│ │                      exclude=None, executor=None, executor_type=None,    │ │
│ │                      filter=None, helpfilter=False, logpath=False,       │ │
│ │                      maxpendtime=None, module_purge=False, modules=None, │ │
│ │                      no_color=False, nodes=None, pollinterval=None,      │ │
│ │                      print_log=False, procs=None, rebuild=51,            │ │
│ │                      remove_stagedir=False, report=None, rerun=False,    │ │
│ │                      retry=1, stage=None, subcommands='build',           │ │
│ │                      tags=None, testdir=None, timeout=None,              │ │
│ │                      unload_modules=None, view_log=False)                │ │
│ │   buildtest_editor = '/usr/bin/vim'                                      │ │
│ │        config_file = None                                                │ │
│ │      configuration = <buildtest.config.SiteConfiguration object at       │ │
│ │                      0x7f6c47eb9850>                                     │ │
│ │              fname = '/home/docs/checkouts/readthedocs.org/user_builds/… │ │
│ │             logger = <Logger buildtest (DEBUG)>                          │ │
│ │           no_color = False                                               │ │
│ │             parser = ArgumentParser(prog='buildtest', usage='%(prog)s    │ │
│ │                      [options] [COMMANDS]', description='buildtest is a  │ │
│ │                      HPC testing framework for building and running      │ │
│ │                      tests.', formatter_class=<class                     │ │
│ │                      'argparse.RawDescriptionHelpFormatter'>,            │ │
│ │                      conflict_handler='error', add_help=True)            │ │
│ │        report_file = None                                                │ │
│ │             system = <buildtest.system.BuildTestSystem object at         │ │
│ │                      0x7f6c47b02dd0>                                     │ │
│ │ validate_executors = True                                                │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
│                                                                              │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/b │
│ uildtest/cli/build.py:550 in __init__                                        │
│                                                                              │
│    547 │   │   │                                                             │
│    548 │   │   │   if rebuild > 50:                                          │
│    549 │   │   │   │   raise BuildTestError(                                 │
│ ❱  550 │   │   │   │   │   f"--rebuild {rebuild} exceeds maximum rebuild lim │
│    551 │   │   │   │   )                                                     │
│    552 │   │                                                                 │
│    553 │   │   if timeout:                                                   │
│                                                                              │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │            account = None                                                │ │
│ │         buildspecs = ['tutorials/test_status/pass_returncode.yml']       │ │
│ │   buildtest_system = <buildtest.system.BuildTestSystem object at         │ │
│ │                      0x7f6c47b02dd0>                                     │ │
│ │      configuration = <buildtest.config.SiteConfiguration object at       │ │
│ │                      0x7f6c47eb9850>                                     │ │
│ │ exclude_buildspecs = None                                                │ │
│ │      executor_type = None                                                │ │
│ │          executors = None                                                │ │
│ │  filter_buildspecs = None                                                │ │
│ │         helpfilter = False                                               │ │
│ │        maxpendtime = None                                                │ │
│ │        modulepurge = False                                               │ │
│ │            modules = None                                                │ │
│ │           numnodes = None                                                │ │
│ │           numprocs = None                                                │ │
│ │      poll_interval = None                                                │ │
│ │            rebuild = 51                                                  │ │
│ │    remove_stagedir = False                                               │ │
│ │        report_file = None                                                │ │
│ │              rerun = False                                               │ │
│ │              retry = 1                                                   │ │
│ │               self = <buildtest.cli.build.BuildTest object at            │ │
│ │                      0x7f6c47aa6510>                                     │ │
│ │              stage = None                                                │ │
│ │               tags = None                                                │ │
│ │            testdir = None                                                │ │
│ │            timeout = None                                                │ │
│ │     unload_modules = None                                                │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
╰──────────────────────────────────────────────────────────────────────────────╯
BuildTestError: '--rebuild 51 exceeds maximum rebuild limit of 50'

Rerun Last command

The buildtest build --rerun command can be used to rerun last successful buildtest build command, this can be useful if you want to repeat a certain build without having to remember the command or going through your command history to find the command you ran. When using this option all other options passed to buildtest will be ignored. In order to use –rerun option you must run buildtest build command such that buildtest can rerun your last successful command.

Let’s start by building a simple test.

buildtest build -b tutorials/vars.yml
$ buildtest build -b tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:33                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/b8a43f49: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/b8a43f49
variables_bash/b8a43f49: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/b8a43f49/stage
variables_bash/b8a43f49: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/b8a43f49/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/b8a43f49 does not have any dependencies adding test to queue
variables_bash/b8a43f49: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/b8a43f49: Test completed in 0.009286 seconds
variables_bash/b8a43f49: Test completed with returncode: 0
variables_bash/b8a43f49: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/b8a43f49/variables_bash.out
variables_bash/b8a43f49: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/b8a43f49/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/b8a43f49]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.009286 │
│ sh/b8a43f49  │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_w0lqecl4.log

Next let’s rerun the same command via buildtest build --rerun and take note that it will rerun same command as before

buildtest build --rerun
$ buildtest build --rerun
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:34                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/7f5728b7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/7f5728b7
variables_bash/7f5728b7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/7f5728b7/stage
variables_bash/7f5728b7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/7f5728b7/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/7f5728b7 does not have any dependencies adding test to queue
variables_bash/7f5728b7: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/7f5728b7: Test completed in 0.009327 seconds
variables_bash/7f5728b7: Test completed with returncode: 0
variables_bash/7f5728b7: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/7f5728b7/variables_bash.out
variables_bash/7f5728b7: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/7f5728b7/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/7f5728b7]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.009327 │
│ sh/7f5728b7  │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_avwtp0g_.log

If you pass additional options with --rerun it will simply be ignored. In this case -t python --stage=build will not be read by buildtest instead we will rerun same command.

buildtest build --rerun -t python --stage=build
$ buildtest build --rerun -t python --stage=build
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:34                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/vars.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ variables… │ generic.l… │ None     │ None  │ None  │ Declare    │ /home/doc… │
│            │            │          │       │       │ shell      │            │
│            │            │          │       │       │ variables  │            │
│            │            │          │       │       │ in bash    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/eb1dcd91: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/eb1dcd91
variables_bash/eb1dcd91: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/eb1dcd91/stage
variables_bash/eb1dcd91: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/eb1dcd91/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/eb1dcd91 does not have any dependencies adding test to queue
variables_bash/eb1dcd91: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/eb1dcd91: Test completed in 0.009432 seconds
variables_bash/eb1dcd91: Test completed with returncode: 0
variables_bash/eb1dcd91: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/eb1dcd91/variables_bash.out
variables_bash/eb1dcd91: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/vars/variables_bash/eb1dcd91/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/eb1dcd91]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 0.009432 │
│ sh/eb1dcd91  │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_p8bmw9qi.log

Note

The buildtest clean will erase all history of builds and if you run buildtest build --rerun will raise an exception

Specify Modules in command line

If your system supports modules such as environment-modules or Lmod you can specify a list of modules to load (module load) in the test via buildtest build --modules. You can specify a comma separated list of modules to load, for example if you want to load gcc and python module in your test you can run buildtest build --modules gcc,python. You may specify full name of module with version for instance you want test to load gcc/9.3.0 and python/3.7 you can run buildtest build --modules gcc/9.3.0,python/3.7.

If you want test to run module purge before running test you can specify buildtest build --module-purge option. If you specify --module-purge and --modules then module purge will be run prior to loading any modules.

Similarly, you can unload modules before running any test via buildtest build --unload-modules which is a list of modules to run module unload command and works similar to --modules option. Buildtest will unload modules before loading modules if both –modules and –unload-modules are specified. If –module-purge is also specified then we run module purge first before loading/unloading any modules.

Use Alternate Configuration file

If you want to use an alternate configuration file when building test you can use buildtest -c <config> build. buildtest will prefer configuration file on command line over the user configuration ($HOME/.buildtest/config.yml). For more details see Which configuration file does buildtest read?.

Removing Stage Directory

buildtest will write the tests in stage directory where test will be executed, typically buildtest will keep the stage directory but if you want to remove the directory you can use buildtest build --remove-stagedir.

Specify Project Account for batch jobs

For batch jobs you typically require one to specify a project account in order to charge jobs depending on your scheduler you can use buildtest build --account option and specify an account name. The command line argument --account will override configuration setting. For more details see Specifying Project Account

Test Timeout

Buildtest can terminate test based on timeout value specified via --timeout option which can be used to terminate long running test. The timeout is in seconds and value must be a positive integer which is applied to all test that are run via buildtest build command. If test exceeds the timeout value, then process will be terminated.

To demonstrate this behavior, we will run the following test with a timeout of 1 sec which is expected to fail. Take note of the test returncode of test.

buildtest build -b tutorials/sleep.yml --timeout 1
$ buildtest build -b tutorials/sleep.yml --timeout 1
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:35                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/sleep.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ sleep/757… │ generic.l… │ None     │ None  │ None  │ sleep 2    │ /home/doc… │
│            │            │          │       │       │ seconds    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/757fba1a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/757fba1a
sleep/757fba1a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/757fba1a/stage
sleep/757fba1a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/757fba1a/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/757fba1a does not have any dependencies adding test to queue
sleep/757fba1a: Running Test via command: bash --norc --noprofile -eo pipefail sleep_build.sh
sleep/757fba1a: Test completed in 1.00356 seconds
sleep/757fba1a: Test completed with returncode: -9
sleep/757fba1a: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/757fba1a/sleep.out
sleep/757fba1a: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/757fba1a/sleep.err
In this iteration we are going to run the following tests: [sleep/757fba1a]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━┓
┃               ┃              ┃        ┃ checks        ┃            ┃         ┃
┃               ┃              ┃        ┃ (ReturnCode,  ┃            ┃         ┃
┃               ┃              ┃        ┃ Regex,        ┃            ┃         ┃
┃ builder       ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━┩
│ sleep/757fba1 │ generic.loc… │ FAIL   │ N/A N/A N/A   │ -9         │ 1.00356 │
│ a             │              │        │               │            │         │
└───────────────┴──────────────┴────────┴───────────────┴────────────┴─────────┘



Passed Tests: 0/1 Percentage: 0.000%
Failed Tests: 1/1 Percentage: 100.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_pjxrrnl6.log

Now if we run this test with a higher timeout value we will see this test will pass, if no timeout is specified then test will run until completion.

buildtest build -b tutorials/sleep.yml --timeout 10
$ buildtest build -b tutorials/sleep.yml --timeout 10
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│                                                                              │
│ User:               docs                                                     │
│ Hostname:           build-18279078-project-280831-buildtest                  │
│ Platform:           Linux                                                    │
│ Current Time:       2022/10/07 18:36:36                                      │
│ buildtest path:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version:  0.15.0                                                   │
│ python path:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version:     3.7.13                                                   │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory:     /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File:        /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command:            /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
───────────────────────────  Discovering Buildspecs ────────────────────────────
                             Discovered buildspecs                              
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec                                                                    ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/… ║
╚══════════════════════════════════════════════════════════════════════════════╝


Total Discovered Buildspecs:  1
Total Excluded Buildspecs:  0
Detected Buildspecs after exclusion:  1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 1 buildspecs
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/tutorials/sleep.yml: VALID
Total builder objects created: 1
Total compiler builder: 0
Total script builder: 1
Total spack builder: 0
                             Script Builder Details                             
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder    ┃ executor   ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ sleep/681… │ generic.l… │ None     │ None  │ None  │ sleep 2    │ /home/doc… │
│            │            │          │       │       │ seconds    │            │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/681e0989: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/681e0989
sleep/681e0989: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/681e0989/stage
sleep/681e0989: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/681e0989/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/681e0989 does not have any dependencies adding test to queue
sleep/681e0989: Running Test via command: bash --norc --noprofile -eo pipefail sleep_build.sh
sleep/681e0989: Test completed in 2.020545 seconds
sleep/681e0989: Test completed with returncode: 0
sleep/681e0989: Writing output file -  /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/681e0989/sleep.out
sleep/681e0989: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/tests/generic.local.bash/sleep/sleep/681e0989/sleep.err
In this iteration we are going to run the following tests: [sleep/681e0989]
                                  Test Summary                                  
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃              ┃              ┃        ┃ checks        ┃            ┃          ┃
┃              ┃              ┃        ┃ (ReturnCode,  ┃            ┃          ┃
┃              ┃              ┃        ┃ Regex,        ┃            ┃          ┃
┃ builder      ┃ executor     ┃ status ┃ Runtime)      ┃ returnCode ┃ runtime  ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ sleep/681e09 │ generic.loc… │ PASS   │ N/A N/A N/A   │ 0          │ 2.020545 │
│ 89           │              │        │               │            │          │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘



Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%


Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/devel/var/logs/buildtest_8povri8s.log