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
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] [-k]
[--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.
-k, --keep-stage-dir Keep 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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:37:31 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b /home/docs/checkouts/readthedocs │
│ .org/user_builds/buildtest/checkouts/v0.15.0/tutorials/vars.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/272ee591: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/272ee591
variables_bash/272ee591: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/272ee591/stage
variables_bash/272ee591: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/272ee591/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/272ee591 does not have any dependencies adding test to queue
variables_bash/272ee591: Running Test via command: bash --norc --noprofile -eo
pipefail variables_bash_build.sh
variables_bash/272ee591: Test completed in 0.010049 seconds
variables_bash/272ee591: Test completed with returncode: 0
variables_bash/272ee591: Writing output file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/v
ariables_bash/272ee591/variables_bash.out
variables_bash/272ee591: Writing error file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/var
iables_bash/272ee591/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/272ee591]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.010049 │
│ sh/272ee591 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_t1me5pr5.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 general_tests/configuration/
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:25 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b general_tests/configuration/ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/gen
eral_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/ulimits.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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 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… │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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/7157276c: Creating test directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ke
rnel_state/kernel_swapusage/7157276c
kernel_swapusage/7157276c: Creating the stage directory: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/kernel_state/kernel_swapusage/7157276c/stage
kernel_swapusage/7157276c: Writing build script: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kerne
l_state/kernel_swapusage/7157276c/kernel_swapusage_build.sh
root_disk_usage/53d7ab71: Creating test directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/dis
k_usage/root_disk_usage/53d7ab71
root_disk_usage/53d7ab71: Creating the stage directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/disk_usage/root_disk_usage/53d7ab71/stage
root_disk_usage/53d7ab71: Writing build script: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_u
sage/root_disk_usage/53d7ab71/root_disk_usage_build.sh
systemd_default_target/15d8d29e: Creating test directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/systemd-default-target/systemd_default_target/15d8d29e
systemd_default_target/15d8d29e: Creating the stage directory: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.bash/systemd-default-target/systemd_default_target/15d8d29e/stage
systemd_default_target/15d8d29e: Writing build script: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/systemd-default-target/systemd_default_target/15d8d29e/systemd_default_target_b
uild.sh
ulimit_filelock_unlimited/18e2c9e7: Creating test directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/ulimits/ulimit_filelock_unlimited/18e2c9e7
ulimit_filelock_unlimited/18e2c9e7: Creating the stage directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.bash/ulimits/ulimit_filelock_unlimited/18e2c9e7/stage
ulimit_filelock_unlimited/18e2c9e7: Writing build script: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_filelock_unlimited/18e2c9e7/ulimit_filelock_unlimited_build.s
h
ulimit_cputime_unlimited/c3cf7d08: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_cputime_unlimited/c3cf7d08
ulimit_cputime_unlimited/c3cf7d08: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/ulimits/ulimit_cputime_unlimited/c3cf7d08/stage
ulimit_cputime_unlimited/c3cf7d08: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_cputime_unlimited/c3cf7d08/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/d2576e86: Creating test directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_stacksize_unlimited/d2576e86
ulimit_stacksize_unlimited/d2576e86: Creating the stage directory: /home/docs/ch
eckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generi
c.local.bash/ulimits/ulimit_stacksize_unlimited/d2576e86/stage
ulimit_stacksize_unlimited/d2576e86: Writing build script: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_stacksize_unlimited/d2576e86/ulimit_stacksize_unlimited_buil
d.sh
ulimit_vmsize_unlimited/ebaac7b0: Creating test directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_vmsize_unlimited/ebaac7b0
ulimit_vmsize_unlimited/ebaac7b0: Creating the stage directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.bash/ulimits/ulimit_vmsize_unlimited/ebaac7b0/stage
ulimit_vmsize_unlimited/ebaac7b0: Writing build script: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/ulimits/ulimit_vmsize_unlimited/ebaac7b0/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/5d00ac91: Creating test directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_filedescriptor_4096/5d00ac91
ulimit_filedescriptor_4096/5d00ac91: Creating the stage directory: /home/docs/ch
eckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generi
c.local.bash/ulimits/ulimit_filedescriptor_4096/5d00ac91/stage
ulimit_filedescriptor_4096/5d00ac91: Writing build script: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_filedescriptor_4096/5d00ac91/ulimit_filedescriptor_4096_buil
d.sh
ulimit_max_user_process_2048/13a393be: Creating test directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.bash/ulimits/ulimit_max_user_process_2048/13a393be
ulimit_max_user_process_2048/13a393be: Creating the stage directory: /home/docs/
checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/gene
ric.local.bash/ulimits/ulimit_max_user_process_2048/13a393be/stage
ulimit_max_user_process_2048/13a393be: Writing build script: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/ulimits/ulimit_max_user_process_2048/13a393be/ulimit_max_user_process_204
8_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
root_disk_usage/53d7ab71 does not have any dependencies adding test to queue
kernel_swapusage/7157276c does not have any dependencies adding test to queue
ulimit_cputime_unlimited/c3cf7d08 does not have any dependencies adding test to
queue
ulimit_filelock_unlimited/18e2c9e7 does not have any dependencies adding test to
queue
ulimit_filedescriptor_4096/5d00ac91 does not have any dependencies adding test
to queue
systemd_default_target/15d8d29e does not have any dependencies adding test to
queue
ulimit_stacksize_unlimited/d2576e86 does not have any dependencies adding test
to queue
ulimit_vmsize_unlimited/ebaac7b0 does not have any dependencies adding test to
queue
ulimit_max_user_process_2048/13a393be does not have any dependencies adding test
to queue
root_disk_usage/53d7ab71: Running Test via command: bash --norc --noprofile -eo
pipefail root_disk_usage_build.sh
root_disk_usage/53d7ab71: Test completed in 0.010167 seconds
root_disk_usage/53d7ab71: Test completed with returncode: 0
root_disk_usage/53d7ab71: Writing output file - /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_
usage/root_disk_usage/53d7ab71/root_disk_usage.out
root_disk_usage/53d7ab71: Writing error file - /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_us
age/root_disk_usage/53d7ab71/root_disk_usage.err
kernel_swapusage/7157276c: Running Test via command: bash --norc --noprofile -eo
pipefail kernel_swapusage_build.sh
kernel_swapusage/7157276c: Test completed in 0.105682 seconds
kernel_swapusage/7157276c: Test completed with returncode: 255
kernel_swapusage/7157276c: Writing output file - /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kern
el_state/kernel_swapusage/7157276c/kernel_swapusage.out
kernel_swapusage/7157276c: Writing error file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kernel
_state/kernel_swapusage/7157276c/kernel_swapusage.err
ulimit_cputime_unlimited/c3cf7d08: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/c3cf7d08: Test completed in 0.005398 seconds
ulimit_cputime_unlimited/c3cf7d08: Test completed with returncode: 0
ulimit_cputime_unlimited/c3cf7d08: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_cputime_unlimited/c3cf7d08/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/c3cf7d08: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/ulimits/ulimit_cputime_unlimited/c3cf7d08/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/c3cf7d08: performing regular expression - '^unlimited$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/c3cf7d08/uli
mit_cputime_unlimited.out
ulimit_cputime_unlimited/c3cf7d08: Regular Expression Match - Success!
ulimit_filelock_unlimited/18e2c9e7: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/18e2c9e7: Test completed in 0.005134 seconds
ulimit_filelock_unlimited/18e2c9e7: Test completed with returncode: 0
ulimit_filelock_unlimited/18e2c9e7: Writing output file - /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_filelock_unlimited/18e2c9e7/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/18e2c9e7: Writing error file - /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_filelock_unlimited/18e2c9e7/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/18e2c9e7: performing regular expression -
'^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtes
t/checkouts/v0.15.0/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimit
ed/18e2c9e7/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/18e2c9e7: Regular Expression Match - Success!
ulimit_filedescriptor_4096/5d00ac91: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/5d00ac91: Test completed in 0.005173 seconds
ulimit_filedescriptor_4096/5d00ac91: Test completed with returncode: 0
ulimit_filedescriptor_4096/5d00ac91: Writing output file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_filedescriptor_4096/5d00ac91/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/5d00ac91: Writing error file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_filedescriptor_4096/5d00ac91/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/5d00ac91: performing regular expression - '^4096$' on
file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15
.0/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/5d00ac91/ulim
it_filedescriptor_4096.out
ulimit_filedescriptor_4096/5d00ac91: Regular Expression Match - Failed!
systemd_default_target/15d8d29e: Running Test via command: bash --norc
--noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/15d8d29e: Test completed in 0.130304 seconds
systemd_default_target/15d8d29e: Test completed with returncode: 1
systemd_default_target/15d8d29e: Writing output file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/systemd-default-target/systemd_default_target/15d8d29e/systemd_default_target.
out
systemd_default_target/15d8d29e: Writing error file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
systemd-default-target/systemd_default_target/15d8d29e/systemd_default_target.er
r
ulimit_stacksize_unlimited/d2576e86: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/d2576e86: Test completed in 0.005569 seconds
ulimit_stacksize_unlimited/d2576e86: Test completed with returncode: 0
ulimit_stacksize_unlimited/d2576e86: Writing output file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_stacksize_unlimited/d2576e86/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/d2576e86: Writing error file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_stacksize_unlimited/d2576e86/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/d2576e86: performing regular expression -
'^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtes
t/checkouts/v0.15.0/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimi
ted/d2576e86/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/d2576e86: Regular Expression Match - Failed!
ulimit_vmsize_unlimited/ebaac7b0: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/ebaac7b0: Test completed in 0.005231 seconds
ulimit_vmsize_unlimited/ebaac7b0: Test completed with returncode: 0
ulimit_vmsize_unlimited/ebaac7b0: Writing output file - /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_vmsize_unlimited/ebaac7b0/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/ebaac7b0: Writing error file - /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/ulimits/ulimit_vmsize_unlimited/ebaac7b0/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/ebaac7b0: performing regular expression - '^unlimited$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/ebaac7b0/ulim
it_vmsize_unlimited.out
ulimit_vmsize_unlimited/ebaac7b0: Regular Expression Match - Success!
ulimit_max_user_process_2048/13a393be: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/13a393be: Test completed in 0.005362 seconds
ulimit_max_user_process_2048/13a393be: Test completed with returncode: 0
ulimit_max_user_process_2048/13a393be: Writing output file - /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_max_user_process_2048/13a393be/ulimit_max_user_process_20
48.out
ulimit_max_user_process_2048/13a393be: Writing error file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_max_user_process_2048/13a393be/ulimit_max_user_process_2048
.err
ulimit_max_user_process_2048/13a393be: performing regular expression - '^2048$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/13a393be
/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/13a393be: Regular Expression Match - Failed!
In this iteration we are going to run the following tests: [root_disk_usage/53d7ab71, kernel_swapusage/7157276c, ulimit_cputime_unlimited/c3cf7d08, ulimit_filelock_unlimited/18e2c9e7, ulimit_filedescriptor_4096/5d00ac91, systemd_default_target/15d8d29e, ulimit_stacksize_unlimited/d2576e86, ulimit_vmsize_unlimited/ebaac7b0, ulimit_max_user_process_2048/13a393be]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.105682 │
│ sage/7157276 │ │ │ │ │ │
│ c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS │ False True │ 0 │ 0.005231 │
│ e_unlimited/ │ │ │ False │ │ │
│ ebaac7b0 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_cputi │ generic.loc… │ PASS │ False True │ 0 │ 0.005398 │
│ me_unlimited │ │ │ False │ │ │
│ /c3cf7d08 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filel │ generic.loc… │ PASS │ False True │ 0 │ 0.005134 │
│ ock_unlimite │ │ │ False │ │ │
│ d/18e2c9e7 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL │ False False │ 0 │ 0.005173 │
│ escriptor_40 │ │ │ False │ │ │
│ 96/5d00ac91 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.130304 │
│ ult_target/1 │ │ │ │ │ │
│ 5d8d29e │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_stack │ generic.loc… │ FAIL │ False False │ 0 │ 0.005569 │
│ size_unlimit │ │ │ False │ │ │
│ ed/d2576e86 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL │ False False │ 0 │ 0.005362 │
│ ser_process_ │ │ │ False │ │ │
│ 2048/13a393b │ │ │ │ │ │
│ e │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.010167 │
│ age/53d7ab71 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_h15emell.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 general_tests/configuration/ -b tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:26 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b general_tests/configuration/ -b │
│ tutorials/vars.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/gen
eral_tests/configuration/ulimits.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/kernel_state.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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ systemd_d… │ generic.l… │ None │ None │ None │ check if │ /home/doc… │
│ │ │ │ │ │ default │ │
│ │ │ │ │ │ target is │ │
│ │ │ │ │ │ multi-use… │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ kernel_sw… │ generic.l… │ None │ None │ None │ Retrieve │ /home/doc… │
│ │ │ │ │ │ Kernel │ │
│ │ │ │ │ │ Swap Usage │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
ulimit_filelock_unlimited/ddd039cd: Creating test directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/ulimits/ulimit_filelock_unlimited/ddd039cd
ulimit_filelock_unlimited/ddd039cd: Creating the stage directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.bash/ulimits/ulimit_filelock_unlimited/ddd039cd/stage
ulimit_filelock_unlimited/ddd039cd: Writing build script: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_filelock_unlimited/ddd039cd/ulimit_filelock_unlimited_build.s
h
ulimit_cputime_unlimited/1d58f147: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_cputime_unlimited/1d58f147
ulimit_cputime_unlimited/1d58f147: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/ulimits/ulimit_cputime_unlimited/1d58f147/stage
ulimit_cputime_unlimited/1d58f147: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_cputime_unlimited/1d58f147/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/90a1e1af: Creating test directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_stacksize_unlimited/90a1e1af
ulimit_stacksize_unlimited/90a1e1af: Creating the stage directory: /home/docs/ch
eckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generi
c.local.bash/ulimits/ulimit_stacksize_unlimited/90a1e1af/stage
ulimit_stacksize_unlimited/90a1e1af: Writing build script: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_stacksize_unlimited/90a1e1af/ulimit_stacksize_unlimited_buil
d.sh
ulimit_vmsize_unlimited/6c5fbe0c: Creating test directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_vmsize_unlimited/6c5fbe0c
ulimit_vmsize_unlimited/6c5fbe0c: Creating the stage directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.bash/ulimits/ulimit_vmsize_unlimited/6c5fbe0c/stage
ulimit_vmsize_unlimited/6c5fbe0c: Writing build script: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/ulimits/ulimit_vmsize_unlimited/6c5fbe0c/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/5744546e: Creating test directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_filedescriptor_4096/5744546e
ulimit_filedescriptor_4096/5744546e: Creating the stage directory: /home/docs/ch
eckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generi
c.local.bash/ulimits/ulimit_filedescriptor_4096/5744546e/stage
ulimit_filedescriptor_4096/5744546e: Writing build script: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_filedescriptor_4096/5744546e/ulimit_filedescriptor_4096_buil
d.sh
ulimit_max_user_process_2048/4238cc61: Creating test directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.bash/ulimits/ulimit_max_user_process_2048/4238cc61
ulimit_max_user_process_2048/4238cc61: Creating the stage directory: /home/docs/
checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/gene
ric.local.bash/ulimits/ulimit_max_user_process_2048/4238cc61/stage
ulimit_max_user_process_2048/4238cc61: Writing build script: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/ulimits/ulimit_max_user_process_2048/4238cc61/ulimit_max_user_process_204
8_build.sh
systemd_default_target/e55308ef: Creating test directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/systemd-default-target/systemd_default_target/e55308ef
systemd_default_target/e55308ef: Creating the stage directory: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.bash/systemd-default-target/systemd_default_target/e55308ef/stage
systemd_default_target/e55308ef: Writing build script: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/systemd-default-target/systemd_default_target/e55308ef/systemd_default_target_b
uild.sh
root_disk_usage/9179b0d2: Creating test directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/dis
k_usage/root_disk_usage/9179b0d2
root_disk_usage/9179b0d2: Creating the stage directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/disk_usage/root_disk_usage/9179b0d2/stage
root_disk_usage/9179b0d2: Writing build script: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_u
sage/root_disk_usage/9179b0d2/root_disk_usage_build.sh
variables_bash/e63eab39: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/e63eab39
variables_bash/e63eab39: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/e63eab39/stage
variables_bash/e63eab39: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/e63eab39/variables_bash_build.sh
kernel_swapusage/e7c0ebd3: Creating test directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ke
rnel_state/kernel_swapusage/e7c0ebd3
kernel_swapusage/e7c0ebd3: Creating the stage directory: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/kernel_state/kernel_swapusage/e7c0ebd3/stage
kernel_swapusage/e7c0ebd3: Writing build script: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kerne
l_state/kernel_swapusage/e7c0ebd3/kernel_swapusage_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
ulimit_filelock_unlimited/ddd039cd does not have any dependencies adding test to
queue
ulimit_max_user_process_2048/4238cc61 does not have any dependencies adding test
to queue
ulimit_filedescriptor_4096/5744546e does not have any dependencies adding test
to queue
systemd_default_target/e55308ef does not have any dependencies adding test to
queue
ulimit_stacksize_unlimited/90a1e1af does not have any dependencies adding test
to queue
ulimit_cputime_unlimited/1d58f147 does not have any dependencies adding test to
queue
kernel_swapusage/e7c0ebd3 does not have any dependencies adding test to queue
variables_bash/e63eab39 does not have any dependencies adding test to queue
ulimit_vmsize_unlimited/6c5fbe0c does not have any dependencies adding test to
queue
root_disk_usage/9179b0d2 does not have any dependencies adding test to queue
ulimit_filelock_unlimited/ddd039cd: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/ddd039cd: Test completed in 0.005525 seconds
ulimit_filelock_unlimited/ddd039cd: Test completed with returncode: 0
ulimit_filelock_unlimited/ddd039cd: Writing output file - /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ulimits/ulimit_filelock_unlimited/ddd039cd/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/ddd039cd: Writing error file - /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_filelock_unlimited/ddd039cd/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/ddd039cd: performing regular expression -
'^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtes
t/checkouts/v0.15.0/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimit
ed/ddd039cd/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/ddd039cd: Regular Expression Match - Success!
ulimit_max_user_process_2048/4238cc61: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/4238cc61: Test completed in 0.005393 seconds
ulimit_max_user_process_2048/4238cc61: Test completed with returncode: 0
ulimit_max_user_process_2048/4238cc61: Writing output file - /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/ulimits/ulimit_max_user_process_2048/4238cc61/ulimit_max_user_process_20
48.out
ulimit_max_user_process_2048/4238cc61: Writing error file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_max_user_process_2048/4238cc61/ulimit_max_user_process_2048
.err
ulimit_max_user_process_2048/4238cc61: performing regular expression - '^2048$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/4238cc61
/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/4238cc61: Regular Expression Match - Failed!
systemd_default_target/e55308ef: Running Test via command: bash --norc
--noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/e55308ef: Test completed in 0.007566 seconds
systemd_default_target/e55308ef: Test completed with returncode: 1
systemd_default_target/e55308ef: Writing output file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/systemd-default-target/systemd_default_target/e55308ef/systemd_default_target.
out
systemd_default_target/e55308ef: Writing error file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
systemd-default-target/systemd_default_target/e55308ef/systemd_default_target.er
r
ulimit_filedescriptor_4096/5744546e: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/5744546e: Test completed in 0.00512 seconds
ulimit_filedescriptor_4096/5744546e: Test completed with returncode: 0
ulimit_filedescriptor_4096/5744546e: Writing output file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_filedescriptor_4096/5744546e/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/5744546e: Writing error file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_filedescriptor_4096/5744546e/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/5744546e: performing regular expression - '^4096$' on
file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15
.0/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/5744546e/ulim
it_filedescriptor_4096.out
ulimit_filedescriptor_4096/5744546e: Regular Expression Match - Failed!
ulimit_stacksize_unlimited/90a1e1af: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/90a1e1af: Test completed in 0.005164 seconds
ulimit_stacksize_unlimited/90a1e1af: Test completed with returncode: 0
ulimit_stacksize_unlimited/90a1e1af: Writing output file - /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/ulimits/ulimit_stacksize_unlimited/90a1e1af/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/90a1e1af: Writing error file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_stacksize_unlimited/90a1e1af/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/90a1e1af: performing regular expression -
'^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtes
t/checkouts/v0.15.0/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimi
ted/90a1e1af/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/90a1e1af: Regular Expression Match - Failed!
ulimit_cputime_unlimited/1d58f147: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/1d58f147: Test completed in 0.005163 seconds
ulimit_cputime_unlimited/1d58f147: Test completed with returncode: 0
ulimit_cputime_unlimited/1d58f147: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ulimits/ulimit_cputime_unlimited/1d58f147/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/1d58f147: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/ulimits/ulimit_cputime_unlimited/1d58f147/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/1d58f147: performing regular expression - '^unlimited$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/1d58f147/uli
mit_cputime_unlimited.out
ulimit_cputime_unlimited/1d58f147: Regular Expression Match - Success!
kernel_swapusage/e7c0ebd3: Running Test via command: bash --norc --noprofile -eo
pipefail kernel_swapusage_build.sh
kernel_swapusage/e7c0ebd3: Test completed in 0.006283 seconds
kernel_swapusage/e7c0ebd3: Test completed with returncode: 255
kernel_swapusage/e7c0ebd3: Writing output file - /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kern
el_state/kernel_swapusage/e7c0ebd3/kernel_swapusage.out
kernel_swapusage/e7c0ebd3: Writing error file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kernel
_state/kernel_swapusage/e7c0ebd3/kernel_swapusage.err
variables_bash/e63eab39: Running Test via command: bash --norc --noprofile -eo
pipefail variables_bash_build.sh
variables_bash/e63eab39: Test completed in 0.008703 seconds
variables_bash/e63eab39: Test completed with returncode: 0
variables_bash/e63eab39: Writing output file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/v
ariables_bash/e63eab39/variables_bash.out
variables_bash/e63eab39: Writing error file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/var
iables_bash/e63eab39/variables_bash.err
ulimit_vmsize_unlimited/6c5fbe0c: Running Test via command: bash --norc
--noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/6c5fbe0c: Test completed in 0.005614 seconds
ulimit_vmsize_unlimited/6c5fbe0c: Test completed with returncode: 0
ulimit_vmsize_unlimited/6c5fbe0c: Writing output file - /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/ulimits/ulimit_vmsize_unlimited/6c5fbe0c/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/6c5fbe0c: Writing error file - /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/ulimits/ulimit_vmsize_unlimited/6c5fbe0c/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/6c5fbe0c: performing regular expression - '^unlimited$'
on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0
.15.0/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/6c5fbe0c/ulim
it_vmsize_unlimited.out
ulimit_vmsize_unlimited/6c5fbe0c: Regular Expression Match - Success!
root_disk_usage/9179b0d2: Running Test via command: bash --norc --noprofile -eo
pipefail root_disk_usage_build.sh
root_disk_usage/9179b0d2: Test completed in 0.009222 seconds
root_disk_usage/9179b0d2: Test completed with returncode: 0
root_disk_usage/9179b0d2: Writing output file - /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_
usage/root_disk_usage/9179b0d2/root_disk_usage.out
root_disk_usage/9179b0d2: Writing error file - /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_us
age/root_disk_usage/9179b0d2/root_disk_usage.err
In this iteration we are going to run the following tests: [ulimit_filelock_unlimited/ddd039cd, ulimit_max_user_process_2048/4238cc61, systemd_default_target/e55308ef, ulimit_filedescriptor_4096/5744546e, ulimit_stacksize_unlimited/90a1e1af, ulimit_cputime_unlimited/1d58f147, kernel_swapusage/e7c0ebd3, variables_bash/e63eab39, ulimit_vmsize_unlimited/6c5fbe0c, root_disk_usage/9179b0d2]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ ulimit_stack │ generic.loc… │ FAIL │ False False │ 0 │ 0.005164 │
│ size_unlimit │ │ │ False │ │ │
│ ed/90a1e1af │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL │ False False │ 0 │ 0.00512 │
│ escriptor_40 │ │ │ False │ │ │
│ 96/5744546e │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS │ False True │ 0 │ 0.005614 │
│ e_unlimited/ │ │ │ False │ │ │
│ 6c5fbe0c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008703 │
│ sh/e63eab39 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.007566 │
│ ult_target/e │ │ │ │ │ │
│ 55308ef │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filel │ generic.loc… │ PASS │ False True │ 0 │ 0.005525 │
│ ock_unlimite │ │ │ False │ │ │
│ d/ddd039cd │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_cputi │ generic.loc… │ PASS │ False True │ 0 │ 0.005163 │
│ me_unlimited │ │ │ False │ │ │
│ /1d58f147 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.009222 │
│ age/9179b0d2 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.006283 │
│ sage/e7c0ebd │ │ │ │ │ │
│ 3 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL │ False False │ 0 │ 0.005393 │
│ ser_process_ │ │ │ False │ │ │
│ 2048/4238cc6 │ │ │ │ │ │
│ 1 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/build
test/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_wr0fx1oi.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:27 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest bd -b tutorials/ -x tutorials/ │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:27 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest bd -b general_tests/configuration/ -x │
│ general_tests/configuration/ulimits.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Excluded buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/gen
eral_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/disk_usage.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/gen
eral_tests/configuration/kernel_state.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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ systemd_d… │ generic.l… │ None │ None │ None │ check if │ /home/doc… │
│ │ │ │ │ │ default │ │
│ │ │ │ │ │ target is │ │
│ │ │ │ │ │ multi-use… │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ root_disk… │ generic.l… │ None │ None │ None │ Check root │ /home/doc… │
│ │ │ │ │ │ disk usage │ │
│ │ │ │ │ │ and report │ │
│ │ │ │ │ │ if it │ │
│ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ threshold │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ kernel_sw… │ generic.l… │ None │ None │ None │ Retrieve │ /home/doc… │
│ │ │ │ │ │ Kernel │ │
│ │ │ │ │ │ Swap Usage │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
systemd_default_target/ba85aacd: Creating test directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/systemd-default-target/systemd_default_target/ba85aacd
systemd_default_target/ba85aacd: Creating the stage directory: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.bash/systemd-default-target/systemd_default_target/ba85aacd/stage
systemd_default_target/ba85aacd: Writing build script: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/systemd-default-target/systemd_default_target/ba85aacd/systemd_default_target_b
uild.sh
root_disk_usage/585f174b: Creating test directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/dis
k_usage/root_disk_usage/585f174b
root_disk_usage/585f174b: Creating the stage directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/disk_usage/root_disk_usage/585f174b/stage
root_disk_usage/585f174b: Writing build script: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_u
sage/root_disk_usage/585f174b/root_disk_usage_build.sh
kernel_swapusage/4819e73e: Creating test directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ke
rnel_state/kernel_swapusage/4819e73e
kernel_swapusage/4819e73e: Creating the stage directory: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/kernel_state/kernel_swapusage/4819e73e/stage
kernel_swapusage/4819e73e: Writing build script: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kerne
l_state/kernel_swapusage/4819e73e/kernel_swapusage_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
root_disk_usage/585f174b does not have any dependencies adding test to queue
kernel_swapusage/4819e73e does not have any dependencies adding test to queue
systemd_default_target/ba85aacd does not have any dependencies adding test to
queue
root_disk_usage/585f174b: Running Test via command: bash --norc --noprofile -eo
pipefail root_disk_usage_build.sh
root_disk_usage/585f174b: Test completed in 0.008999 seconds
root_disk_usage/585f174b: Test completed with returncode: 0
root_disk_usage/585f174b: Writing output file - /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_
usage/root_disk_usage/585f174b/root_disk_usage.out
root_disk_usage/585f174b: Writing error file - /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/disk_us
age/root_disk_usage/585f174b/root_disk_usage.err
kernel_swapusage/4819e73e: Running Test via command: bash --norc --noprofile -eo
pipefail kernel_swapusage_build.sh
kernel_swapusage/4819e73e: Test completed in 0.00607 seconds
kernel_swapusage/4819e73e: Test completed with returncode: 255
kernel_swapusage/4819e73e: Writing output file - /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kern
el_state/kernel_swapusage/4819e73e/kernel_swapusage.out
kernel_swapusage/4819e73e: Writing error file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/kernel
_state/kernel_swapusage/4819e73e/kernel_swapusage.err
systemd_default_target/ba85aacd: Running Test via command: bash --norc
--noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/ba85aacd: Test completed in 0.007452 seconds
systemd_default_target/ba85aacd: Test completed with returncode: 1
systemd_default_target/ba85aacd: Writing output file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/systemd-default-target/systemd_default_target/ba85aacd/systemd_default_target.
out
systemd_default_target/ba85aacd: Writing error file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
systemd-default-target/systemd_default_target/ba85aacd/systemd_default_target.er
r
In this iteration we are going to run the following tests: [root_disk_usage/585f174b, kernel_swapusage/4819e73e, systemd_default_target/ba85aacd]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008999 │
│ age/585f174b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.007452 │
│ ult_target/b │ │ │ │ │ │
│ a85aacd │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.00607 │
│ sage/4819e73 │ │ │ │ │ │
│ e │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_msp92vd9.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:28 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t network │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=network
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/27c3b8f6: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_exa
mple/string_tag/27c3b8f6
string_tag/27c3b8f6: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tag
s_example/string_tag/27c3b8f6/stage
string_tag/27c3b8f6: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_exampl
e/string_tag/27c3b8f6/string_tag_build.sh
list_of_strings_tags/8917da6b: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/tags_example/list_of_strings_tags/8917da6b
list_of_strings_tags/8917da6b: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/tags_example/list_of_strings_tags/8917da6b/stage
list_of_strings_tags/8917da6b: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/t
ags_example/list_of_strings_tags/8917da6b/list_of_strings_tags_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
list_of_strings_tags/8917da6b does not have any dependencies adding test to
queue
string_tag/27c3b8f6 does not have any dependencies adding test to queue
list_of_strings_tags/8917da6b: Running Test via command: bash --norc --noprofile
-eo pipefail list_of_strings_tags_build.sh
list_of_strings_tags/8917da6b: Test completed in 3.031709 seconds
list_of_strings_tags/8917da6b: Test completed with returncode: 0
list_of_strings_tags/8917da6b: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
tags_example/list_of_strings_tags/8917da6b/list_of_strings_tags.out
list_of_strings_tags/8917da6b: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ta
gs_example/list_of_strings_tags/8917da6b/list_of_strings_tags.err
string_tag/27c3b8f6: Running Test via command: bash --norc --noprofile -eo
pipefail string_tag_build.sh
string_tag/27c3b8f6: Test completed in 0.00632 seconds
string_tag/27c3b8f6: Test completed with returncode: 0
string_tag/27c3b8f6: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_examp
le/string_tag/27c3b8f6/string_tag.out
string_tag/27c3b8f6: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_example
/string_tag/27c3b8f6/string_tag.err
In this iteration we are going to run the following tests: [list_of_strings_tags/8917da6b, string_tag/27c3b8f6]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ list_of_stri │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 3.031709 │
│ ngs_tags/891 │ │ │ │ │ │
│ 7da6b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ string_tag/2 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.00632 │
│ 7c3b8f6 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_pgoh7u4c.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:31 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t python -t pass │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 ─────────────────────────────────
circle_area/c13151ba: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/c13151ba
circle_area/c13151ba: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/c13151ba/stage
circle_area/c13151ba: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/c13151ba/circle_area_build.sh
python_hello/c4e8b843: Creating test directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python
-hello/python_hello/c4e8b843
python_hello/c4e8b843: Creating the stage directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ython-hello/python_hello/c4e8b843/stage
python_hello/c4e8b843: Writing build script: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-he
llo/python_hello/c4e8b843/python_hello_build.sh
exit1_fail/66252312: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_fail/66252312
exit1_fail/66252312: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_fail/66252312/stage
exit1_fail/66252312: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_fail/66252312/exit1_fail_build.sh
exit1_pass/dc9c4bd4: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/dc9c4bd4
exit1_pass/dc9c4bd4: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/dc9c4bd4/stage
exit1_pass/dc9c4bd4: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/dc9c4bd4/exit1_pass_build.sh
returncode_list_mismatch/b6389efb: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/pass_returncode/returncode_list_mismatch/b6389efb
returncode_list_mismatch/b6389efb: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/pass_returncode/returncode_list_mismatch/b6389efb/stage
returncode_list_mismatch/b6389efb: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/pass_returncode/returncode_list_mismatch/b6389efb/returncode_list_mismatch_bu
ild.sh
returncode_int_match/6acfcdc2: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/6acfcdc2
returncode_int_match/6acfcdc2: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/6acfcdc2/stage
returncode_int_match/6acfcdc2: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/6acfcdc2/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
python_hello/c4e8b843 does not have any dependencies adding test to queue
circle_area/c13151ba does not have any dependencies adding test to queue
exit1_fail/66252312 does not have any dependencies adding test to queue
returncode_int_match/6acfcdc2 does not have any dependencies adding test to
queue
exit1_pass/dc9c4bd4 does not have any dependencies adding test to queue
returncode_list_mismatch/b6389efb does not have any dependencies adding test to
queue
python_hello/c4e8b843: Running Test via command: bash --norc --noprofile -eo
pipefail python_hello_build.sh
python_hello/c4e8b843: Test completed in 0.030331 seconds
python_hello/c4e8b843: Test completed with returncode: 0
python_hello/c4e8b843: Writing output file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-h
ello/python_hello/c4e8b843/python_hello.out
python_hello/c4e8b843: Writing error file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-hel
lo/python_hello/c4e8b843/python_hello.err
circle_area/c13151ba: Running Test via command: bash --norc --noprofile -eo
pipefail circle_area_build.sh
circle_area/c13151ba: Test completed in 0.02994 seconds
circle_area/c13151ba: Test completed with returncode: 0
circle_area/c13151ba: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-sh
ell/circle_area/c13151ba/circle_area.out
circle_area/c13151ba: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-shel
l/circle_area/c13151ba/circle_area.err
exit1_fail/66252312: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_fail_build.sh
exit1_fail/66252312: Test completed in 0.005137 seconds
exit1_fail/66252312: Test completed with returncode: 1
exit1_fail/66252312: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_fail/66252312/exit1_fail.out
exit1_fail/66252312: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_fail/66252312/exit1_fail.err
returncode_list_mismatch/b6389efb: Running Test via command: bash --norc
--noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/b6389efb: Test completed in 0.005152 seconds
returncode_list_mismatch/b6389efb: Test completed with returncode: 2
returncode_list_mismatch/b6389efb: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/pass_returncode/returncode_list_mismatch/b6389efb/returncode_list_mismatch.o
ut
returncode_list_mismatch/b6389efb: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_list_mismatch/b6389efb/returncode_list_mismatch.err
returncode_list_mismatch/b6389efb: Checking returncode - 2 is matched in list
[1, 3]
exit1_pass/dc9c4bd4: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_pass_build.sh
exit1_pass/dc9c4bd4: Test completed in 0.004943 seconds
exit1_pass/dc9c4bd4: Test completed with returncode: 1
exit1_pass/dc9c4bd4: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_pass/dc9c4bd4/exit1_pass.out
exit1_pass/dc9c4bd4: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_pass/dc9c4bd4/exit1_pass.err
exit1_pass/dc9c4bd4: Checking returncode - 1 is matched in list [1]
returncode_int_match/6acfcdc2: Running Test via command: bash --norc --noprofile
-eo pipefail returncode_int_match_build.sh
returncode_int_match/6acfcdc2: Test completed in 0.004994 seconds
returncode_int_match/6acfcdc2: Test completed with returncode: 128
returncode_int_match/6acfcdc2: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
pass_returncode/returncode_int_match/6acfcdc2/returncode_int_match.out
returncode_int_match/6acfcdc2: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pa
ss_returncode/returncode_int_match/6acfcdc2/returncode_int_match.err
returncode_int_match/6acfcdc2: Checking returncode - 128 is matched in list
[128]
In this iteration we are going to run the following tests: [python_hello/c4e8b843, circle_area/c13151ba, exit1_fail/66252312, returncode_list_mismatch/b6389efb, exit1_pass/dc9c4bd4, returncode_int_match/6acfcdc2]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.02994 │
│ c13151ba │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/d │ generic.loc… │ PASS │ True False │ 1 │ 0.004943 │
│ c9c4bd4 │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.004994 │
│ nt_match/6ac │ │ │ False │ │ │
│ fcdc2 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030331 │
│ /c4e8b843 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005152 │
│ ist_mismatch │ │ │ False │ │ │
│ /b6389efb │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/6 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005137 │
│ 6252312 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_k2p8q8hd.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:32 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build --tags pass --buildspec │
│ tutorials/python-hello.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/9228dbaf: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_fail/9228dbaf
exit1_fail/9228dbaf: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_fail/9228dbaf/stage
exit1_fail/9228dbaf: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_fail/9228dbaf/exit1_fail_build.sh
exit1_pass/d7a91f3f: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/d7a91f3f
exit1_pass/d7a91f3f: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/d7a91f3f/stage
exit1_pass/d7a91f3f: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/d7a91f3f/exit1_pass_build.sh
returncode_list_mismatch/cb7a368f: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/pass_returncode/returncode_list_mismatch/cb7a368f
returncode_list_mismatch/cb7a368f: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/pass_returncode/returncode_list_mismatch/cb7a368f/stage
returncode_list_mismatch/cb7a368f: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/pass_returncode/returncode_list_mismatch/cb7a368f/returncode_list_mismatch_bu
ild.sh
returncode_int_match/6e88fa1a: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/6e88fa1a
returncode_int_match/6e88fa1a: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/6e88fa1a/stage
returncode_int_match/6e88fa1a: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/6e88fa1a/returncode_int_match_build.sh
python_hello/71310f5c: Creating test directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python
-hello/python_hello/71310f5c
python_hello/71310f5c: Creating the stage directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ython-hello/python_hello/71310f5c/stage
python_hello/71310f5c: Writing build script: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-he
llo/python_hello/71310f5c/python_hello_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_pass/d7a91f3f does not have any dependencies adding test to queue
exit1_fail/9228dbaf does not have any dependencies adding test to queue
returncode_int_match/6e88fa1a does not have any dependencies adding test to
queue
python_hello/71310f5c does not have any dependencies adding test to queue
returncode_list_mismatch/cb7a368f does not have any dependencies adding test to
queue
exit1_pass/d7a91f3f: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_pass_build.sh
exit1_pass/d7a91f3f: Test completed in 0.005419 seconds
exit1_pass/d7a91f3f: Test completed with returncode: 1
exit1_pass/d7a91f3f: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_pass/d7a91f3f/exit1_pass.out
exit1_pass/d7a91f3f: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_pass/d7a91f3f/exit1_pass.err
exit1_pass/d7a91f3f: Checking returncode - 1 is matched in list [1]
exit1_fail/9228dbaf: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_fail_build.sh
exit1_fail/9228dbaf: Test completed in 0.005088 seconds
exit1_fail/9228dbaf: Test completed with returncode: 1
exit1_fail/9228dbaf: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_fail/9228dbaf/exit1_fail.out
exit1_fail/9228dbaf: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_fail/9228dbaf/exit1_fail.err
returncode_int_match/6e88fa1a: Running Test via command: bash --norc --noprofile
-eo pipefail returncode_int_match_build.sh
returncode_int_match/6e88fa1a: Test completed in 0.005113 seconds
returncode_int_match/6e88fa1a: Test completed with returncode: 128
returncode_int_match/6e88fa1a: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
pass_returncode/returncode_int_match/6e88fa1a/returncode_int_match.out
returncode_int_match/6e88fa1a: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pa
ss_returncode/returncode_int_match/6e88fa1a/returncode_int_match.err
returncode_int_match/6e88fa1a: Checking returncode - 128 is matched in list
[128]
python_hello/71310f5c: Running Test via command: bash --norc --noprofile -eo
pipefail python_hello_build.sh
python_hello/71310f5c: Test completed in 0.030162 seconds
python_hello/71310f5c: Test completed with returncode: 0
python_hello/71310f5c: Writing output file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-h
ello/python_hello/71310f5c/python_hello.out
python_hello/71310f5c: Writing error file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-hel
lo/python_hello/71310f5c/python_hello.err
returncode_list_mismatch/cb7a368f: Running Test via command: bash --norc
--noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/cb7a368f: Test completed in 0.005199 seconds
returncode_list_mismatch/cb7a368f: Test completed with returncode: 2
returncode_list_mismatch/cb7a368f: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/pass_returncode/returncode_list_mismatch/cb7a368f/returncode_list_mismatch.o
ut
returncode_list_mismatch/cb7a368f: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_list_mismatch/cb7a368f/returncode_list_mismatch.err
returncode_list_mismatch/cb7a368f: Checking returncode - 2 is matched in list
[1, 3]
In this iteration we are going to run the following tests: [exit1_pass/d7a91f3f, exit1_fail/9228dbaf, returncode_int_match/6e88fa1a, python_hello/71310f5c, returncode_list_mismatch/cb7a368f]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030162 │
│ /71310f5c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005113 │
│ nt_match/6e8 │ │ │ False │ │ │
│ 8fa1a │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/9 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005088 │
│ 228dbaf │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/d │ generic.loc… │ PASS │ True False │ 1 │ 0.005419 │
│ 7a91f3f │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005199 │
│ ist_mismatch │ │ │ False │ │ │
│ /cb7a368f │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_x9rg5lqm.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:33 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build --executor generic.local.csh │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs by Executor=generic.local.csh
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspecs ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/environment.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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ csh_shell… │ generic.l… │ None │ None │ None │ csh shell │ /home/doc… │
│ │ │ │ │ │ example │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
csh_shell/f6437214: Creating test directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_
examples/csh_shell/f6437214
csh_shell/f6437214: Creating the stage directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_s
hell_examples/csh_shell/f6437214/stage
csh_shell/f6437214: Writing build script: /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_exa
mples/csh_shell/f6437214/csh_shell_build.sh
bash_env_variables/8444c844: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
environment/bash_env_variables/8444c844
bash_env_variables/8444c844: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/environment/bash_env_variables/8444c844/stage
bash_env_variables/8444c844: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/env
ironment/bash_env_variables/8444c844/bash_env_variables_build.sh
csh_env_declaration/14b7a78f: Creating test directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/
environment/csh_env_declaration/14b7a78f
csh_env_declaration/14b7a78f: Creating the stage directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.csh/environment/csh_env_declaration/14b7a78f/stage
csh_env_declaration/14b7a78f: Writing build script: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/env
ironment/csh_env_declaration/14b7a78f/csh_env_declaration_build.sh
tcsh_env_declaration/5ae863ac: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh
/environment/tcsh_env_declaration/5ae863ac
tcsh_env_declaration/5ae863ac: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.csh/environment/tcsh_env_declaration/5ae863ac/stage
tcsh_env_declaration/5ae863ac: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/en
vironment/tcsh_env_declaration/5ae863ac/tcsh_env_declaration_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
csh_shell/f6437214 does not have any dependencies adding test to queue
tcsh_env_declaration/5ae863ac does not have any dependencies adding test to
queue
csh_env_declaration/14b7a78f does not have any dependencies adding test to queue
bash_env_variables/8444c844 does not have any dependencies adding test to queue
csh_shell/f6437214: Running Test via command: csh -e csh_shell_build.sh
csh_shell/f6437214: Test completed in 4.565706 seconds
csh_shell/f6437214: Test completed with returncode: 0
csh_shell/f6437214: Writing output file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_ex
amples/csh_shell/f6437214/csh_shell.out
csh_shell/f6437214: Writing error file - /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_exam
ples/csh_shell/f6437214/csh_shell.err
csh_env_declaration/14b7a78f: Running Test via command: csh -e
csh_env_declaration_build.sh
csh_env_declaration/14b7a78f: Test completed in 4.433391 seconds
csh_env_declaration/14b7a78f: Test completed with returncode: 0
csh_env_declaration/14b7a78f: Writing output file - /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/en
vironment/csh_env_declaration/14b7a78f/csh_env_declaration.out
csh_env_declaration/14b7a78f: Writing error file - /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/envi
ronment/csh_env_declaration/14b7a78f/csh_env_declaration.err
bash_env_variables/8444c844: Running Test via command: bash --norc --noprofile
-eo pipefail bash_env_variables_build.sh
bash_env_variables/8444c844: Test completed in 0.007392 seconds
bash_env_variables/8444c844: Test completed with returncode: 0
bash_env_variables/8444c844: Writing output file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/en
vironment/bash_env_variables/8444c844/bash_env_variables.out
bash_env_variables/8444c844: Writing error file - /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/envi
ronment/bash_env_variables/8444c844/bash_env_variables.err
tcsh_env_declaration/5ae863ac: Running Test via command: csh -e
tcsh_env_declaration_build.sh
tcsh_env_declaration/5ae863ac: Test completed in 2.220863 seconds
tcsh_env_declaration/5ae863ac: Test completed with returncode: 1
tcsh_env_declaration/5ae863ac: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/e
nvironment/tcsh_env_declaration/5ae863ac/tcsh_env_declaration.out
tcsh_env_declaration/5ae863ac: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/env
ironment/tcsh_env_declaration/5ae863ac/tcsh_env_declaration.err
In this iteration we are going to run the following tests: [csh_shell/f6437214, csh_env_declaration/14b7a78f, bash_env_variables/8444c844, tcsh_env_declaration/5ae863ac]
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.433391 │
│ aration/14b7 │ │ │ │ │ │
│ a78f │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ bash_env_var │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.007392 │
│ iables/8444c │ │ │ │ │ │
│ 844 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ csh_shell/f6 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 4.565706 │
│ 437214 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ tcsh_env_dec │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 2.220863 │
│ laration/5ae │ │ │ │ │ │
│ 863ac │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_7o1rnlzs.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 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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:45 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t pass --filter tags=pass │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/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/v0.15.0/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/v0.15.0/tut
orials/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/3d803ea5: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/3d803ea5
exit1_pass/3d803ea5: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/3d803ea5/stage
exit1_pass/3d803ea5: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/3d803ea5/exit1_pass_build.sh
returncode_int_match/c92d4c9a: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/c92d4c9a
returncode_int_match/c92d4c9a: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/c92d4c9a/stage
returncode_int_match/c92d4c9a: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/c92d4c9a/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
returncode_int_match/c92d4c9a does not have any dependencies adding test to
queue
exit1_pass/3d803ea5 does not have any dependencies adding test to queue
exit1_pass/3d803ea5: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_pass_build.sh
exit1_pass/3d803ea5: Test completed in 0.005384 seconds
exit1_pass/3d803ea5: Test completed with returncode: 1
exit1_pass/3d803ea5: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_pass/3d803ea5/exit1_pass.out
exit1_pass/3d803ea5: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_pass/3d803ea5/exit1_pass.err
exit1_pass/3d803ea5: Checking returncode - 1 is matched in list [1]
returncode_int_match/c92d4c9a: Running Test via command: bash --norc --noprofile
-eo pipefail returncode_int_match_build.sh
returncode_int_match/c92d4c9a: Test completed in 0.005084 seconds
returncode_int_match/c92d4c9a: Test completed with returncode: 128
returncode_int_match/c92d4c9a: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
pass_returncode/returncode_int_match/c92d4c9a/returncode_int_match.out
returncode_int_match/c92d4c9a: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pa
ss_returncode/returncode_int_match/c92d4c9a/returncode_int_match.err
returncode_int_match/c92d4c9a: Checking returncode - 128 is matched in list
[128]
In this iteration we are going to run the following tests: [exit1_pass/3d803ea5, returncode_int_match/c92d4c9a]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005084 │
│ nt_match/c92 │ │ │ False │ │ │
│ d4c9a │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/3 │ generic.loc… │ PASS │ True False │ 1 │ 0.005384 │
│ d803ea5 │ │ │ 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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_u1sh2q05.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:46 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials --filter │
│ maintainers=@shahzebsiddiqui │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 32
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 32
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 32 buildspecs
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex4.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/v0.15.0/tut
orials/job_dependency/ex2.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/metrics_regex.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/vars.yml: skipping test because 'maintainers' field is not specified in
buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-shell.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/v0.15.0/tut
orials/skip_tests.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex3.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/environment.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-hello.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/status_regex.yml: skipping test because 'maintainers' field
is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/v0.15.0/tut
orials/multi_executors/executor_scheduler.yml: skipping test because
'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/tags_example.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/explicit_state.yml: skipping test because 'maintainers' field
is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/add_numbers.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex1.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_executor.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shebang.yml: skipping test because 'maintainers' field is not specified
in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/summary_example.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shell_examples.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/v0.15.0/tut
orials/sleep.yml: skipping test because 'maintainers' field is not specified in
buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/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/v0.15.0/tut
orials/csh_shell_examples.yml: skipping test because 'maintainers' field is not
specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/pass_returncode.yml: skipping test because 'maintainers'
field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/gcc_version.yml: skipping test because 'maintainers' field is not
specified in buildspec.
Valid Buildspecs: 29
Invalid Buildspecs: 3
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_buildspec_section.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_tags.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/burstbuffer_datawarp_executors.yml: INVALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
└──────────────────────────────────────────────────────────────────────────────┘
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/be2dc26b: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_w
orld/hello_world/be2dc26b
hello_world/be2dc26b: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/he
llo_world/hello_world/be2dc26b/stage
hello_world/be2dc26b: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_worl
d/hello_world/be2dc26b/hello_world_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
hello_world/be2dc26b does not have any dependencies adding test to queue
hello_world/be2dc26b: Running Test via command: bash --norc --noprofile -eo
pipefail hello_world_build.sh
hello_world/be2dc26b: Test completed in 0.005457 seconds
hello_world/be2dc26b: Test completed with returncode: 0
hello_world/be2dc26b: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_wor
ld/hello_world/be2dc26b/hello_world.out
hello_world/be2dc26b: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_world
/hello_world/be2dc26b/hello_world.err
In this iteration we are going to run the following tests: [hello_world/be2dc26b]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ hello_world/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.005457 │
│ be2dc26b │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_6428g0rq.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:47 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials --filter type=script │
│ --stage=build │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 32
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 32
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 32 buildspecs
skip: skipping test due to 'skip' property.
Valid Buildspecs: 29
Invalid Buildspecs: 3
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_tags.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/burstbuffer_datawarp_executors.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/invalid_buildspec_section.yml: INVALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 60
Total compiler builder: 0
Total script builder: 60
Total spack builder: 0
Script Builder Details
┏━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━━━┓
┃ builder ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descripti… ┃ buildspecs ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ unskipped… │ generic.l… │ None │ None │ None │ This test │ /home/doc… │
│ │ │ │ │ │ is not │ │
│ │ │ │ │ │ skipped │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ sleep/612… │ generic.l… │ None │ None │ None │ sleep 2 │ /home/doc… │
│ │ │ │ │ │ seconds │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ add_numbe… │ generic.l… │ None │ None │ None │ Add X+Y │ /home/doc… │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ variables… │ generic.l… │ None │ None │ None │ Declare │ /home/doc… │
│ │ │ │ │ │ shell │ │
│ │ │ │ │ │ variables │ │
│ │ │ │ │ │ in bash │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ foo_bar/f… │ generic.l… │ None │ None │ None │ prints │ /home/doc… │
│ │ │ │ │ │ variable │ │
│ │ │ │ │ │ $FOO │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ hello_wor… │ generic.l… │ None │ None │ None │ hello │ /home/doc… │
│ │ │ │ │ │ world │ │
│ │ │ │ │ │ example │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobA/7ead… │ generic.l… │ None │ None │ None │ no job │ /home/doc… │
│ │ │ │ │ │ dependency │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobB/135e… │ generic.l… │ None │ None │ None │ job │ /home/doc… │
│ │ │ │ │ │ dependency │ │
│ │ │ │ │ │ on jobA │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ jobC/fdcc… │ generic.l… │ None │ None │ None │ job │ /home/doc… │
│ │ │ │ │ │ dependency │ │
│ │ │ │ │ │ on jobA │ │
│ │ │ │ │ │ and jobB │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ csh_shell… │ generic.l… │ None │ None │ None │ csh shell │ /home/doc… │
│ │ │ │ │ │ example │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ _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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ metric_re… │ generic.l… │ None │ None │ None │ capture │ /home/doc… │
│ │ │ │ │ │ result │ │
│ │ │ │ │ │ metric │ │
│ │ │ │ │ │ from │ │
│ │ │ │ │ │ output │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test1/bd3… │ generic.l… │ None │ None │ None │ This test │ /home/doc… │
│ │ │ │ │ │ will pass │ │
│ │ │ │ │ │ with exit │ │
│ │ │ │ │ │ 1 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test2/858… │ generic.l… │ None │ None │ None │ This test │ /home/doc… │
│ │ │ │ │ │ will run │ │
│ │ │ │ │ │ if test1 │ │
│ │ │ │ │ │ has │ │
│ │ │ │ │ │ returncode │ │
│ │ │ │ │ │ 1 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ test3/3b8… │ generic.l… │ None │ None │ None │ This test │ /home/doc… │
│ │ │ │ │ │ will run │ │
│ │ │ │ │ │ if test1 │ │
│ │ │ │ │ │ has │ │
│ │ │ │ │ │ returncode │ │
│ │ │ │ │ │ 1 and │ │
│ │ │ │ │ │ test2 has │ │
│ │ │ │ │ │ returncode │ │
│ │ │ │ │ │ 2 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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. │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ gcc_versi… │ generic.l… │ None │ None │ None │ Print gcc │ /home/doc… │
│ │ │ │ │ │ version │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ summary_e… │ generic.l… │ None │ None │ None │ The │ /home/doc… │
│ │ │ │ │ │ summary │ │
│ │ │ │ │ │ field can │ │
│ │ │ │ │ │ be a │ │
│ │ │ │ │ │ multi-line │ │
│ │ │ │ │ │ string and │ │
│ │ │ │ │ │ exceed 80 │ │
│ │ │ │ │ │ char │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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 │ │
├────────────┼────────────┼──────────┼───────┼───────┼────────────┼────────────┤
│ 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… │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
status_regex_pass/0560221f: Creating test directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/s
tatus_regex/status_regex_pass/0560221f
status_regex_pass/0560221f: Creating the stage directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/status_regex/status_regex_pass/0560221f/stage
status_regex_pass/0560221f: Writing build script: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/stat
us_regex/status_regex_pass/0560221f/status_regex_pass_build.sh
status_regex_fail/3f150d17: Creating test directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/s
tatus_regex/status_regex_fail/3f150d17
status_regex_fail/3f150d17: Creating the stage directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/status_regex/status_regex_fail/3f150d17/stage
status_regex_fail/3f150d17: Writing build script: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/stat
us_regex/status_regex_fail/3f150d17/status_regex_fail_build.sh
unskipped/b623e482: Creating test directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/skip_test
s/unskipped/b623e482
unskipped/b623e482: Creating the stage directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/skip
_tests/unskipped/b623e482/stage
unskipped/b623e482: Writing build script: /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/skip_tests/u
nskipped/b623e482/unskipped_build.sh
string_tag/0441171b: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_exa
mple/string_tag/0441171b
string_tag/0441171b: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tag
s_example/string_tag/0441171b/stage
string_tag/0441171b: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/tags_exampl
e/string_tag/0441171b/string_tag_build.sh
list_of_strings_tags/94c3e7db: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/tags_example/list_of_strings_tags/94c3e7db
list_of_strings_tags/94c3e7db: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/tags_example/list_of_strings_tags/94c3e7db/stage
list_of_strings_tags/94c3e7db: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/t
ags_example/list_of_strings_tags/94c3e7db/list_of_strings_tags_build.sh
sleep/61268d72: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/6
1268d72
sleep/61268d72: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sl
eep/61268d72/stage
sleep/61268d72: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/6126
8d72/sleep_build.sh
add_numbers/8da3bccb: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/add_num
bers/add_numbers/8da3bccb
add_numbers/8da3bccb: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ad
d_numbers/add_numbers/8da3bccb/stage
add_numbers/8da3bccb: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/add_number
s/add_numbers/8da3bccb/add_numbers_build.sh
variables_bash/25e334c9: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/25e334c9
variables_bash/25e334c9: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/25e334c9/stage
variables_bash/25e334c9: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/25e334c9/variables_bash_build.sh
foo_bar/f77a3ee3: Creating test directory: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/maintainers_e
xample/foo_bar/f77a3ee3
foo_bar/f77a3ee3: Creating the stage directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/maintain
ers_example/foo_bar/f77a3ee3/stage
foo_bar/f77a3ee3: Writing build script: /home/docs/checkouts/readthedocs.org/use
r_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/maintainers_exam
ple/foo_bar/f77a3ee3/foo_bar_build.sh
multiple_executors/cd5cfeb3: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
executor_regex_script/multiple_executors/cd5cfeb3
multiple_executors/cd5cfeb3: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/executor_regex_script/multiple_executors/cd5cfeb3/stage
multiple_executors/cd5cfeb3: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/exe
cutor_regex_script/multiple_executors/cd5cfeb3/multiple_executors_build.sh
multiple_executors/2de4baca: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/ex
ecutor_regex_script/multiple_executors/2de4baca
multiple_executors/2de4baca: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
sh/executor_regex_script/multiple_executors/2de4baca/stage
multiple_executors/2de4baca: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/execu
tor_regex_script/multiple_executors/2de4baca/multiple_executors_build.sh
hello_world/7439ba9d: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_w
orld/hello_world/7439ba9d
hello_world/7439ba9d: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/he
llo_world/hello_world/7439ba9d/stage
hello_world/7439ba9d: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/hello_worl
d/hello_world/7439ba9d/hello_world_build.sh
executors_sbatch_declaration/f6fea844: Creating test directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.bash/executor_scheduler/executors_sbatch_declaration/f6fea844
executors_sbatch_declaration/f6fea844: Creating the stage directory: /home/docs/
checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/gene
ric.local.bash/executor_scheduler/executors_sbatch_declaration/f6fea844/stage
executors_sbatch_declaration/f6fea844: Writing build script: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/executor_scheduler/executors_sbatch_declaration/f6fea844/executors_sbatch
_declaration_build.sh
executors_sbatch_declaration/60655b61: Creating test directory: /home/docs/check
outs/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.l
ocal.sh/executor_scheduler/executors_sbatch_declaration/60655b61
executors_sbatch_declaration/60655b61: Creating the stage directory: /home/docs/
checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/gene
ric.local.sh/executor_scheduler/executors_sbatch_declaration/60655b61/stage
executors_sbatch_declaration/60655b61: Writing build script: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.sh/executor_scheduler/executors_sbatch_declaration/60655b61/executors_sbatch_d
eclaration_build.sh
timelimit_min_max/0558e80b: Creating test directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/run
time_status_test/timelimit_min_max/0558e80b
timelimit_min_max/0558e80b: Creating the stage directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.s
h/runtime_status_test/timelimit_min_max/0558e80b/stage
timelimit_min_max/0558e80b: Writing build script: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runtim
e_status_test/timelimit_min_max/0558e80b/timelimit_min_max_build.sh
timelimit_min/f3675802: Creating test directory: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runtime
_status_test/timelimit_min/f3675802
timelimit_min/f3675802: Creating the stage directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/ru
ntime_status_test/timelimit_min/f3675802/stage
timelimit_min/f3675802: Writing build script: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runtime_st
atus_test/timelimit_min/f3675802/timelimit_min_build.sh
timelimit_max/e72930ba: Creating test directory: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runtime
_status_test/timelimit_max/e72930ba
timelimit_max/e72930ba: Creating the stage directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/ru
ntime_status_test/timelimit_max/e72930ba/stage
timelimit_max/e72930ba: Writing build script: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runtime_st
atus_test/timelimit_max/e72930ba/timelimit_max_build.sh
timelimit_min_fail/ae28062b: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/ru
ntime_status_test/timelimit_min_fail/ae28062b
timelimit_min_fail/ae28062b: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
sh/runtime_status_test/timelimit_min_fail/ae28062b/stage
timelimit_min_fail/ae28062b: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runti
me_status_test/timelimit_min_fail/ae28062b/timelimit_min_fail_build.sh
timelimit_max_fail/9b159c7f: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/ru
ntime_status_test/timelimit_max_fail/9b159c7f
timelimit_max_fail/9b159c7f: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
sh/runtime_status_test/timelimit_max_fail/9b159c7f/stage
timelimit_max_fail/9b159c7f: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/runti
me_status_test/timelimit_max_fail/9b159c7f/timelimit_max_fail_build.sh
executors_vars_env_declaration/7bb96f2b: Creating test directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.bash/executors_var_env_declaration/executors_vars_env_declaration/7bb96f2
b
executors_vars_env_declaration/7bb96f2b: Creating the stage directory: /home/doc
s/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/ge
neric.local.bash/executors_var_env_declaration/executors_vars_env_declaration/7b
b96f2b/stage
executors_vars_env_declaration/7bb96f2b: Writing build script: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.bash/executors_var_env_declaration/executors_vars_env_declaration/7bb96f2b/e
xecutors_vars_env_declaration_build.sh
executors_vars_env_declaration/293d2cfe: Creating test directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.sh/executors_var_env_declaration/executors_vars_env_declaration/293d2cfe
executors_vars_env_declaration/293d2cfe: Creating the stage directory: /home/doc
s/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/ge
neric.local.sh/executors_var_env_declaration/executors_vars_env_declaration/293d
2cfe/stage
executors_vars_env_declaration/293d2cfe: Writing build script: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.sh/executors_var_env_declaration/executors_vars_env_declaration/293d2cfe/exe
cutors_vars_env_declaration_build.sh
jobA/7ead9c91: Creating test directory: /home/docs/checkouts/readthedocs.org/use
r_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobA/7ead9
c91
jobA/7ead9c91: Creating the stage directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobA/
7ead9c91/stage
jobA/7ead9c91: Writing build script: /home/docs/checkouts/readthedocs.org/user_b
uilds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobA/7ead9c91
/jobA_build.sh
jobB/135edf00: Creating test directory: /home/docs/checkouts/readthedocs.org/use
r_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobB/135ed
f00
jobB/135edf00: Creating the stage directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobB/
135edf00/stage
jobB/135edf00: Writing build script: /home/docs/checkouts/readthedocs.org/user_b
uilds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobB/135edf00
/jobB_build.sh
jobC/fdcc0e05: Creating test directory: /home/docs/checkouts/readthedocs.org/use
r_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobC/fdcc0
e05
jobC/fdcc0e05: Creating the stage directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobC/
fdcc0e05/stage
jobC/fdcc0e05: Writing build script: /home/docs/checkouts/readthedocs.org/user_b
uilds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex1/jobC/fdcc0e05
/jobC_build.sh
python_hello/fd331461: Creating test directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python
-hello/python_hello/fd331461
python_hello/fd331461: Creating the stage directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ython-hello/python_hello/fd331461/stage
python_hello/fd331461: Writing build script: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-he
llo/python_hello/fd331461/python_hello_build.sh
circle_area/d50b07e6: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/d50b07e6
circle_area/d50b07e6: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/d50b07e6/stage
circle_area/d50b07e6: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/d50b07e6/circle_area_build.sh
csh_shell/67efa609: Creating test directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_
examples/csh_shell/67efa609
csh_shell/67efa609: Creating the stage directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_s
hell_examples/csh_shell/67efa609/stage
csh_shell/67efa609: Writing build script: /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/csh_shell_exa
mples/csh_shell/67efa609/csh_shell_build.sh
_bin_sh_shell/329c2655: Creating test directory: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_e
xamples/_bin_sh_shell/329c2655
_bin_sh_shell/329c2655: Creating the stage directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/sh
ell_examples/_bin_sh_shell/329c2655/stage
_bin_sh_shell/329c2655: Writing build script: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_exam
ples/_bin_sh_shell/329c2655/_bin_sh_shell_build.sh
_bin_bash_shell/b928e47b: Creating test directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/she
ll_examples/_bin_bash_shell/b928e47b
_bin_bash_shell/b928e47b: Creating the stage directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/shell_examples/_bin_bash_shell/b928e47b/stage
_bin_bash_shell/b928e47b: Writing build script: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/shell_
examples/_bin_bash_shell/b928e47b/_bin_bash_shell_build.sh
bash_shell/15b7e38f: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/shell_ex
amples/bash_shell/15b7e38f
bash_shell/15b7e38f: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/she
ll_examples/bash_shell/15b7e38f/stage
bash_shell/15b7e38f: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/shell_examp
les/bash_shell/15b7e38f/bash_shell_build.sh
sh_shell/72c2b5c0: Creating test directory: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_exampl
es/sh_shell/72c2b5c0
sh_shell/72c2b5c0: Creating the stage directory: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_e
xamples/sh_shell/72c2b5c0/stage
sh_shell/72c2b5c0: Writing build script: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_examples/
sh_shell/72c2b5c0/sh_shell_build.sh
shell_options/0fb09e83: Creating test directory: /home/docs/checkouts/readthedoc
s.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_e
xamples/shell_options/0fb09e83
shell_options/0fb09e83: Creating the stage directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/sh
ell_examples/shell_options/0fb09e83/stage
shell_options/0fb09e83: Writing build script: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/shell_exam
ples/shell_options/0fb09e83/shell_options_build.sh
exit1_fail/d075d57a: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_fail/d075d57a
exit1_fail/d075d57a: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_fail/d075d57a/stage
exit1_fail/d075d57a: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_fail/d075d57a/exit1_fail_build.sh
exit1_pass/db120d6c: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/db120d6c
exit1_pass/db120d6c: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/db120d6c/stage
exit1_pass/db120d6c: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/db120d6c/exit1_pass_build.sh
returncode_list_mismatch/3c22649a: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/pass_returncode/returncode_list_mismatch/3c22649a
returncode_list_mismatch/3c22649a: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/pass_returncode/returncode_list_mismatch/3c22649a/stage
returncode_list_mismatch/3c22649a: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/pass_returncode/returncode_list_mismatch/3c22649a/returncode_list_mismatch_bu
ild.sh
returncode_int_match/e45f9734: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/e45f9734
returncode_int_match/e45f9734: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/e45f9734/stage
returncode_int_match/e45f9734: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/e45f9734/returncode_int_match_build.sh
metric_regex_example/a1a39bfa: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/
metrics_regex/metric_regex_example/a1a39bfa
metric_regex_example/a1a39bfa: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.sh/metrics_regex/metric_regex_example/a1a39bfa/stage
metric_regex_example/a1a39bfa: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/met
rics_regex/metric_regex_example/a1a39bfa/metric_regex_example_build.sh
always_pass/d284ccae: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/explicit_
state/always_pass/d284ccae
always_pass/d284ccae: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/expl
icit_state/always_pass/d284ccae/stage
always_pass/d284ccae: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/explicit_sta
te/always_pass/d284ccae/always_pass_build.sh
always_fail/2df380a0: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/explicit_
state/always_fail/2df380a0
always_fail/2df380a0: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/expl
icit_state/always_fail/2df380a0/stage
always_fail/2df380a0: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.sh/explicit_sta
te/always_fail/2df380a0/always_fail_build.sh
test_fail_returncode_match/22c1d1df: Creating test directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.sh/explicit_state/test_fail_returncode_match/22c1d1df
test_fail_returncode_match/22c1d1df: Creating the stage directory: /home/docs/ch
eckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generi
c.local.sh/explicit_state/test_fail_returncode_match/22c1d1df/stage
test_fail_returncode_match/22c1d1df: Writing build script: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
sh/explicit_state/test_fail_returncode_match/22c1d1df/test_fail_returncode_match
_build.sh
test_pass_returncode_mismatch/b797e583: Creating test directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.sh/explicit_state/test_pass_returncode_mismatch/b797e583
test_pass_returncode_mismatch/b797e583: Creating the stage directory: /home/docs
/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/gen
eric.local.sh/explicit_state/test_pass_returncode_mismatch/b797e583/stage
test_pass_returncode_mismatch/b797e583: Writing build script: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.sh/explicit_state/test_pass_returncode_mismatch/b797e583/test_pass_returncode
_mismatch_build.sh
bash_env_variables/8ff105d3: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
environment/bash_env_variables/8ff105d3
bash_env_variables/8ff105d3: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/environment/bash_env_variables/8ff105d3/stage
bash_env_variables/8ff105d3: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/env
ironment/bash_env_variables/8ff105d3/bash_env_variables_build.sh
csh_env_declaration/97a6cc2e: Creating test directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/
environment/csh_env_declaration/97a6cc2e
csh_env_declaration/97a6cc2e: Creating the stage directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.csh/environment/csh_env_declaration/97a6cc2e/stage
csh_env_declaration/97a6cc2e: Writing build script: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/env
ironment/csh_env_declaration/97a6cc2e/csh_env_declaration_build.sh
tcsh_env_declaration/728ecaf9: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh
/environment/tcsh_env_declaration/728ecaf9
tcsh_env_declaration/728ecaf9: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.csh/environment/tcsh_env_declaration/728ecaf9/stage
tcsh_env_declaration/728ecaf9: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.csh/en
vironment/tcsh_env_declaration/728ecaf9/tcsh_env_declaration_build.sh
runtime_test/e1743949: Creating test directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex4/ru
ntime_test/e1743949
runtime_test/e1743949: Creating the stage directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/e
x4/runtime_test/e1743949/stage
runtime_test/e1743949: Writing build script: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex4/runti
me_test/e1743949/runtime_test_build.sh
runtime_test_pass/06f050fa: Creating test directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/e
x4/runtime_test_pass/06f050fa
runtime_test_pass/06f050fa: Creating the stage directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ex4/runtime_test_pass/06f050fa/stage
runtime_test_pass/06f050fa: Writing build script: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex4/
runtime_test_pass/06f050fa/runtime_test_pass_build.sh
runtime_test_fail/64954234: Creating test directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/e
x4/runtime_test_fail/64954234
runtime_test_fail/64954234: Creating the stage directory: /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/ex4/runtime_test_fail/64954234/stage
runtime_test_fail/64954234: Writing build script: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex4/
runtime_test_fail/64954234/runtime_test_fail_build.sh
test1/bd378005: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test1/bd3
78005
test1/bd378005: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test
1/bd378005/stage
test1/bd378005: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test1/bd3780
05/test1_build.sh
test2/8580443f: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test2/858
0443f
test2/8580443f: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test
2/8580443f/stage
test2/8580443f: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test2/858044
3f/test2_build.sh
test3/3b87f80f: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test3/3b8
7f80f
test3/3b87f80f: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test
3/3b87f80f/stage
test3/3b87f80f: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex2/test3/3b87f8
0f/test3_build.sh
status_returncode_by_executors/00b39435: Creating test directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.bash/status_by_executors/status_returncode_by_executors/00b39435
status_returncode_by_executors/00b39435: Creating the stage directory: /home/doc
s/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/ge
neric.local.bash/status_by_executors/status_returncode_by_executors/00b39435/sta
ge
status_returncode_by_executors/00b39435: Writing build script: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.bash/status_by_executors/status_returncode_by_executors/00b39435/status_retu
rncode_by_executors_build.sh
status_returncode_by_executors/f6f4898d: Creating test directory: /home/docs/che
ckouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic
.local.sh/status_by_executors/status_returncode_by_executors/f6f4898d
status_returncode_by_executors/f6f4898d: Creating the stage directory: /home/doc
s/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/ge
neric.local.sh/status_by_executors/status_returncode_by_executors/f6f4898d/stage
status_returncode_by_executors/f6f4898d: Writing build script: /home/docs/checko
uts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.lo
cal.sh/status_by_executors/status_returncode_by_executors/f6f4898d/status_return
code_by_executors_build.sh
gcc_version/11ec21cf: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/gcc_ver
sion/gcc_version/11ec21cf
gcc_version/11ec21cf: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/gc
c_version/gcc_version/11ec21cf/stage
gcc_version/11ec21cf: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/gcc_versio
n/gcc_version/11ec21cf/gcc_version_build.sh
summary_example/ad530af1: Creating test directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sum
mary_example/summary_example/ad530af1
summary_example/ad530af1: Creating the stage directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/summary_example/summary_example/ad530af1/stage
summary_example/ad530af1: Writing build script: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/summar
y_example/summary_example/ad530af1/summary_example_build.sh
bash_login_shebang/c2c6e318: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
shebang/bash_login_shebang/c2c6e318
bash_login_shebang/c2c6e318: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/shebang/bash_login_shebang/c2c6e318/stage
bash_login_shebang/c2c6e318: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/she
bang/bash_login_shebang/c2c6e318/bash_login_shebang_build.sh
bash_nonlogin_shebang/df6d3183: Creating test directory: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/shebang/bash_nonlogin_shebang/df6d3183
bash_nonlogin_shebang/df6d3183: Creating the stage directory: /home/docs/checkou
ts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loc
al.bash/shebang/bash_nonlogin_shebang/df6d3183/stage
bash_nonlogin_shebang/df6d3183: Writing build script: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
shebang/bash_nonlogin_shebang/df6d3183/bash_nonlogin_shebang_build.sh
pass_test/9fc5bbaa: Creating test directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/pass_
test/9fc5bbaa
pass_test/9fc5bbaa: Creating the stage directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/
pass_test/9fc5bbaa/stage
pass_test/9fc5bbaa: Writing build script: /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/pass_tes
t/9fc5bbaa/pass_test_build.sh
fail_test/c5c04cf6: Creating test directory: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/fail_
test/c5c04cf6
fail_test/c5c04cf6: Creating the stage directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/
fail_test/c5c04cf6/stage
fail_test/c5c04cf6: Writing build script: /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/fail_tes
t/c5c04cf6/fail_test_build.sh
pass_and_fail_test/3b8d2bd0: Creating test directory: /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
ex3/pass_and_fail_test/3b8d2bd0
pass_and_fail_test/3b8d2bd0: Creating the stage directory: /home/docs/checkouts/
readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.
bash/ex3/pass_and_fail_test/3b8d2bd0/stage
pass_and_fail_test/3b8d2bd0: Writing build script: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3
/pass_and_fail_test/3b8d2bd0/pass_and_fail_test_build.sh
final_test/b59f1a95: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/fina
l_test/b59f1a95
final_test/b59f1a95: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3
/final_test/b59f1a95/stage
final_test/b59f1a95: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/ex3/final_t
est/b59f1a95/final_test_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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:48 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t python --executor-type local │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-shell.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 ┃
┡━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━┩
│ 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 │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
python_hello/69cd22ea: Creating test directory: /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python
-hello/python_hello/69cd22ea
python_hello/69cd22ea: Creating the stage directory: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ython-hello/python_hello/69cd22ea/stage
python_hello/69cd22ea: Writing build script: /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-he
llo/python_hello/69cd22ea/python_hello_build.sh
circle_area/377b278d: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/377b278d
circle_area/377b278d: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/377b278d/stage
circle_area/377b278d: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/377b278d/circle_area_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
python_hello/69cd22ea does not have any dependencies adding test to queue
circle_area/377b278d does not have any dependencies adding test to queue
python_hello/69cd22ea: Running Test via command: bash --norc --noprofile -eo
pipefail python_hello_build.sh
python_hello/69cd22ea: Test completed in 0.03025 seconds
python_hello/69cd22ea: Test completed with returncode: 0
python_hello/69cd22ea: Writing output file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-h
ello/python_hello/69cd22ea/python_hello.out
python_hello/69cd22ea: Writing error file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-hel
lo/python_hello/69cd22ea/python_hello.err
circle_area/377b278d: Running Test via command: bash --norc --noprofile -eo
pipefail circle_area_build.sh
circle_area/377b278d: Test completed in 0.031651 seconds
circle_area/377b278d: Test completed with returncode: 0
circle_area/377b278d: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-sh
ell/circle_area/377b278d/circle_area.out
circle_area/377b278d: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-shel
l/circle_area/377b278d/circle_area.err
In this iteration we are going to run the following tests: [python_hello/69cd22ea, circle_area/377b278d]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.031651 │
│ 377b278d │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.03025 │
│ /69cd22ea │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_purt64at.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:48 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t python --executor-type batch │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 2
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Buildtest will parse 2 buildspecs
circle_area/5c58df52 is excluded since its not using batch executor
python_hello/a69f1967 is excluded since its not using batch executor
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/python-hello.yml: VALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
└──────────────────────────────────────────────────────────────────────────────┘
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/v0.15.0/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
-boption doesn’t exist we exit immediately.If buildspec path is a directory, traverse directory recursively to find all
.ymlextensionsIf buildspec path is a file, check if file extension is not
.yml, exit immediatelyIf user specifies
--tagsor--executorwe 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.
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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:49 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/vars.yml --stage=parse │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:49 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/vars.yml --stage=build │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/2a6910c2: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/2a6910c2
variables_bash/2a6910c2: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/2a6910c2/stage
variables_bash/2a6910c2: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/2a6910c2/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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:50 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b │
│ tutorials/invalid_buildspec_section.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/v0.15.0/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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:50 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/invalid_executor.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/invalid_executor.yml: VALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
└──────────────────────────────────────────────────────────────────────────────┘
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/v0.15.0/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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:51 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/python-shell.yml │
│ --rebuild=3 │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/3c30eaca: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/3c30eaca
circle_area/3c30eaca: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/3c30eaca/stage
circle_area/3c30eaca: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/3c30eaca/circle_area_build.sh
circle_area/8882fde2: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/8882fde2
circle_area/8882fde2: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/8882fde2/stage
circle_area/8882fde2: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/8882fde2/circle_area_build.sh
circle_area/423e6cf0: Creating test directory: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-
shell/circle_area/423e6cf0
circle_area/423e6cf0: Creating the stage directory: /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/py
thon-shell/circle_area/423e6cf0/stage
circle_area/423e6cf0: Writing build script: /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-she
ll/circle_area/423e6cf0/circle_area_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
circle_area/423e6cf0 does not have any dependencies adding test to queue
circle_area/3c30eaca does not have any dependencies adding test to queue
circle_area/8882fde2 does not have any dependencies adding test to queue
circle_area/3c30eaca: Running Test via command: bash --norc --noprofile -eo
pipefail circle_area_build.sh
circle_area/3c30eaca: Test completed in 0.030675 seconds
circle_area/3c30eaca: Test completed with returncode: 0
circle_area/3c30eaca: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-sh
ell/circle_area/3c30eaca/circle_area.out
circle_area/3c30eaca: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-shel
l/circle_area/3c30eaca/circle_area.err
circle_area/8882fde2: Running Test via command: bash --norc --noprofile -eo
pipefail circle_area_build.sh
circle_area/8882fde2: Test completed in 0.029671 seconds
circle_area/8882fde2: Test completed with returncode: 0
circle_area/8882fde2: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-sh
ell/circle_area/8882fde2/circle_area.out
circle_area/8882fde2: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-shel
l/circle_area/8882fde2/circle_area.err
circle_area/423e6cf0: Running Test via command: bash --norc --noprofile -eo
pipefail circle_area_build.sh
circle_area/423e6cf0: Test completed in 0.029582 seconds
circle_area/423e6cf0: Test completed with returncode: 0
circle_area/423e6cf0: Writing output file - /home/docs/checkouts/readthedocs.or
g/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-sh
ell/circle_area/423e6cf0/circle_area.out
circle_area/423e6cf0: Writing error file - /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/python-shel
l/circle_area/423e6cf0/circle_area.err
In this iteration we are going to run the following tests: [circle_area/3c30eaca, circle_area/8882fde2, circle_area/423e6cf0]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.029582 │
│ 423e6cf0 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030675 │
│ 3c30eaca │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.029671 │
│ 8882fde2 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_xpgwkubl.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:51 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -t fail --rebuild 2 │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=fail
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/tut
orials/test_status/pass_returncode.yml: VALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… │
└──────────────────────────────────────────────────────────────────────────────┘
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/2c6464ef: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_fail/2c6464ef
exit1_fail/2c6464ef: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_fail/2c6464ef/stage
exit1_fail/2c6464ef: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_fail/2c6464ef/exit1_fail_build.sh
exit1_pass/78bd339b: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/78bd339b
exit1_pass/78bd339b: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/78bd339b/stage
exit1_pass/78bd339b: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/78bd339b/exit1_pass_build.sh
returncode_list_mismatch/39309f1f: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/pass_returncode/returncode_list_mismatch/39309f1f
returncode_list_mismatch/39309f1f: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/pass_returncode/returncode_list_mismatch/39309f1f/stage
returncode_list_mismatch/39309f1f: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/pass_returncode/returncode_list_mismatch/39309f1f/returncode_list_mismatch_bu
ild.sh
returncode_int_match/d2a0f605: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/d2a0f605
returncode_int_match/d2a0f605: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/d2a0f605/stage
returncode_int_match/d2a0f605: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/d2a0f605/returncode_int_match_build.sh
exit1_fail/17745c36: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_fail/17745c36
exit1_fail/17745c36: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_fail/17745c36/stage
exit1_fail/17745c36: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_fail/17745c36/exit1_fail_build.sh
exit1_pass/de90386b: Creating test directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_ret
urncode/exit1_pass/de90386b
exit1_pass/de90386b: Creating the stage directory: /home/docs/checkouts/readthed
ocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pas
s_returncode/exit1_pass/de90386b/stage
exit1_pass/de90386b: Writing build script: /home/docs/checkouts/readthedocs.org/
user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_return
code/exit1_pass/de90386b/exit1_pass_build.sh
returncode_list_mismatch/2e9d0800: Creating test directory: /home/docs/checkouts
/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local
.bash/pass_returncode/returncode_list_mismatch/2e9d0800
returncode_list_mismatch/2e9d0800: Creating the stage directory: /home/docs/chec
kouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.
local.bash/pass_returncode/returncode_list_mismatch/2e9d0800/stage
returncode_list_mismatch/2e9d0800: Writing build script: /home/docs/checkouts/re
adthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.ba
sh/pass_returncode/returncode_list_mismatch/2e9d0800/returncode_list_mismatch_bu
ild.sh
returncode_int_match/30fe5ae1: Creating test directory: /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_int_match/30fe5ae1
returncode_int_match/30fe5ae1: Creating the stage directory: /home/docs/checkout
s/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.loca
l.bash/pass_returncode/returncode_int_match/30fe5ae1/stage
returncode_int_match/30fe5ae1: Writing build script: /home/docs/checkouts/readth
edocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/p
ass_returncode/returncode_int_match/30fe5ae1/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
returncode_list_mismatch/2e9d0800 does not have any dependencies adding test to
queue
exit1_pass/de90386b does not have any dependencies adding test to queue
exit1_pass/78bd339b does not have any dependencies adding test to queue
exit1_fail/2c6464ef does not have any dependencies adding test to queue
returncode_list_mismatch/39309f1f does not have any dependencies adding test to
queue
returncode_int_match/30fe5ae1 does not have any dependencies adding test to
queue
exit1_fail/17745c36 does not have any dependencies adding test to queue
returncode_int_match/d2a0f605 does not have any dependencies adding test to
queue
returncode_list_mismatch/2e9d0800: Running Test via command: bash --norc
--noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/2e9d0800: Test completed in 0.00555 seconds
returncode_list_mismatch/2e9d0800: Test completed with returncode: 2
returncode_list_mismatch/2e9d0800: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/pass_returncode/returncode_list_mismatch/2e9d0800/returncode_list_mismatch.o
ut
returncode_list_mismatch/2e9d0800: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_list_mismatch/2e9d0800/returncode_list_mismatch.err
returncode_list_mismatch/2e9d0800: Checking returncode - 2 is matched in list
[1, 3]
exit1_pass/de90386b: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_pass_build.sh
exit1_pass/de90386b: Test completed in 0.005227 seconds
exit1_pass/de90386b: Test completed with returncode: 1
exit1_pass/de90386b: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_pass/de90386b/exit1_pass.out
exit1_pass/de90386b: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_pass/de90386b/exit1_pass.err
exit1_pass/de90386b: Checking returncode - 1 is matched in list [1]
exit1_pass/78bd339b: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_pass_build.sh
exit1_pass/78bd339b: Test completed in 0.005021 seconds
exit1_pass/78bd339b: Test completed with returncode: 1
exit1_pass/78bd339b: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_pass/78bd339b/exit1_pass.out
exit1_pass/78bd339b: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_pass/78bd339b/exit1_pass.err
exit1_pass/78bd339b: Checking returncode - 1 is matched in list [1]
returncode_list_mismatch/39309f1f: Running Test via command: bash --norc
--noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/39309f1f: Test completed in 0.005009 seconds
returncode_list_mismatch/39309f1f: Test completed with returncode: 2
returncode_list_mismatch/39309f1f: Writing output file - /home/docs/checkouts/r
eadthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.b
ash/pass_returncode/returncode_list_mismatch/39309f1f/returncode_list_mismatch.o
ut
returncode_list_mismatch/39309f1f: Writing error file - /home/docs/checkouts/rea
dthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bas
h/pass_returncode/returncode_list_mismatch/39309f1f/returncode_list_mismatch.err
returncode_list_mismatch/39309f1f: Checking returncode - 2 is matched in list
[1, 3]
exit1_fail/2c6464ef: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_fail_build.sh
exit1_fail/2c6464ef: Test completed in 0.005013 seconds
exit1_fail/2c6464ef: Test completed with returncode: 1
exit1_fail/2c6464ef: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_fail/2c6464ef/exit1_fail.out
exit1_fail/2c6464ef: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_fail/2c6464ef/exit1_fail.err
returncode_int_match/30fe5ae1: Running Test via command: bash --norc --noprofile
-eo pipefail returncode_int_match_build.sh
returncode_int_match/30fe5ae1: Test completed in 0.005069 seconds
returncode_int_match/30fe5ae1: Test completed with returncode: 128
returncode_int_match/30fe5ae1: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
pass_returncode/returncode_int_match/30fe5ae1/returncode_int_match.out
returncode_int_match/30fe5ae1: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pa
ss_returncode/returncode_int_match/30fe5ae1/returncode_int_match.err
returncode_int_match/30fe5ae1: Checking returncode - 128 is matched in list
[128]
exit1_fail/17745c36: Running Test via command: bash --norc --noprofile -eo
pipefail exit1_fail_build.sh
exit1_fail/17745c36: Test completed in 0.005086 seconds
exit1_fail/17745c36: Test completed with returncode: 1
exit1_fail/17745c36: Writing output file - /home/docs/checkouts/readthedocs.org
/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_retur
ncode/exit1_fail/17745c36/exit1_fail.out
exit1_fail/17745c36: Writing error file - /home/docs/checkouts/readthedocs.org/u
ser_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pass_returnc
ode/exit1_fail/17745c36/exit1_fail.err
returncode_int_match/d2a0f605: Running Test via command: bash --norc --noprofile
-eo pipefail returncode_int_match_build.sh
returncode_int_match/d2a0f605: Test completed in 0.005197 seconds
returncode_int_match/d2a0f605: Test completed with returncode: 128
returncode_int_match/d2a0f605: Writing output file - /home/docs/checkouts/readt
hedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/
pass_returncode/returncode_int_match/d2a0f605/returncode_int_match.out
returncode_int_match/d2a0f605: Writing error file - /home/docs/checkouts/readthe
docs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/pa
ss_returncode/returncode_int_match/d2a0f605/returncode_int_match.err
returncode_int_match/d2a0f605: Checking returncode - 128 is matched in list
[128]
In this iteration we are going to run the following tests: [returncode_list_mismatch/2e9d0800, exit1_pass/de90386b, exit1_pass/78bd339b, returncode_list_mismatch/39309f1f, exit1_fail/2c6464ef, returncode_int_match/30fe5ae1, exit1_fail/17745c36, returncode_int_match/d2a0f605]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ exit1_fail/2 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005013 │
│ c6464ef │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005069 │
│ nt_match/30f │ │ │ False │ │ │
│ e5ae1 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.00555 │
│ ist_mismatch │ │ │ False │ │ │
│ /2e9d0800 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/1 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005086 │
│ 7745c36 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005197 │
│ nt_match/d2a │ │ │ False │ │ │
│ 0f605 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/7 │ generic.loc… │ PASS │ True False │ 1 │ 0.005021 │
│ 8bd339b │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005009 │
│ ist_mismatch │ │ │ False │ │ │
│ /39309f1f │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/d │ generic.loc… │ PASS │ True False │ 1 │ 0.005227 │
│ e90386b │ │ │ 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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_k2boptl0.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
╭───────────────────── Traceback (most recent call last) ──────────────────────╮
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0 │
│ /bin/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 │ │
│ │ 0x7fa02bb89210> │ │
│ │ __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/v0.15.0 │
│ /buildtest/main.py:148 in main │
│ │
│ 145 │ │ │ │ unload_modules=args.unload_modules, │
│ 146 │ │ │ │ rerun=args.rerun, │
│ 147 │ │ │ │ executor_type=args.executor_type, │
│ ❱ 148 │ │ │ │ timeout=args.timeout, │
│ 149 │ │ │ ) │
│ 150 │ │ │ cmd.build() │
│ 151 │
│ │
│ ╭───────────────────────────────── 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, │ │
│ │ keep_stage_dir=False, lastlog=False, │ │
│ │ maxpendtime=None, module_purge=False, modules=None, │ │
│ │ no_color=False, nodes=None, pollinterval=None, │ │
│ │ procs=None, rebuild=51, report=None, rerun=False, │ │
│ │ retry=1, stage=None, subcommands='build', │ │
│ │ tags=None, testdir=None, timeout=None, │ │
│ │ unload_modules=None) │ │
│ │ buildtest_editor = '/usr/bin/vim' │ │
│ │ config_file = None │ │
│ │ configuration = <buildtest.config.SiteConfiguration object at │ │
│ │ 0x7fa029b62890> │ │
│ │ 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 │ │
│ │ 0x7fa029b62fd0> │ │
│ │ validate_executors = True │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
│ │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0 │
│ /buildtest/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 │ │
│ │ 0x7fa029b62fd0> │ │
│ │ configuration = <buildtest.config.SiteConfiguration object at │ │
│ │ 0x7fa029b62890> │ │
│ │ exclude_buildspecs = None │ │
│ │ executor_type = None │ │
│ │ executors = None │ │
│ │ filter_buildspecs = None │ │
│ │ helpfilter = False │ │
│ │ keep_stage_dir = False │ │
│ │ maxpendtime = None │ │
│ │ modulepurge = False │ │
│ │ modules = None │ │
│ │ numnodes = None │ │
│ │ numprocs = None │ │
│ │ poll_interval = None │ │
│ │ rebuild = 51 │ │
│ │ report_file = None │ │
│ │ rerun = False │ │
│ │ retry = 1 │ │
│ │ self = <buildtest.cli.build.BuildTest object at │ │
│ │ 0x7fa029afff50> │ │
│ │ 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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:53 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/vars.yml │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/7250a603: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/7250a603
variables_bash/7250a603: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/7250a603/stage
variables_bash/7250a603: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/7250a603/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/7250a603 does not have any dependencies adding test to queue
variables_bash/7250a603: Running Test via command: bash --norc --noprofile -eo
pipefail variables_bash_build.sh
variables_bash/7250a603: Test completed in 0.008886 seconds
variables_bash/7250a603: Test completed with returncode: 0
variables_bash/7250a603: Writing output file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/v
ariables_bash/7250a603/variables_bash.out
variables_bash/7250a603: Writing error file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/var
iables_bash/7250a603/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/7250a603]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008886 │
│ sh/7250a603 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_smj9bp3o.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
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/b
uildtest/checkouts/v0.15.0/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:53 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build --rerun │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/182dde6b: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/182dde6b
variables_bash/182dde6b: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/182dde6b/stage
variables_bash/182dde6b: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/182dde6b/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/182dde6b does not have any dependencies adding test to queue
variables_bash/182dde6b: Running Test via command: bash --norc --noprofile -eo
pipefail variables_bash_build.sh
variables_bash/182dde6b: Test completed in 0.009069 seconds
variables_bash/182dde6b: Test completed with returncode: 0
variables_bash/182dde6b: Writing output file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/v
ariables_bash/182dde6b/variables_bash.out
variables_bash/182dde6b: Writing error file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/var
iables_bash/182dde6b/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/182dde6b]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.009069 │
│ sh/182dde6b │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_24wokdyd.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
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/b
uildtest/checkouts/v0.15.0/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:54 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build --rerun -t python --stage=build │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/14eff1ce: Creating test directory: /home/docs/checkouts/readthedo
cs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars
/variables_bash/14eff1ce
variables_bash/14eff1ce: Creating the stage directory: /home/docs/checkouts/read
thedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash
/vars/variables_bash/14eff1ce/stage
variables_bash/14eff1ce: Writing build script: /home/docs/checkouts/readthedocs.
org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/va
riables_bash/14eff1ce/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/14eff1ce does not have any dependencies adding test to queue
variables_bash/14eff1ce: Running Test via command: bash --norc --noprofile -eo
pipefail variables_bash_build.sh
variables_bash/14eff1ce: Test completed in 0.008847 seconds
variables_bash/14eff1ce: Test completed with returncode: 0
variables_bash/14eff1ce: Writing output file - /home/docs/checkouts/readthedocs
.org/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/v
ariables_bash/14eff1ce/variables_bash.out
variables_bash/14eff1ce: Writing error file - /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/vars/var
iables_bash/14eff1ce/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/14eff1ce]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008847 │
│ sh/14eff1ce │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_2huuxmu8.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?.
Keeping Stage Directory¶
buildtest will create setup the test environment in the stage directory where test will be executed. Once
test is complete, buildtest will remove the stage directory. If you
want to preserve the stage directory you can use buildtest build --keep-stage-dir, this
is only useful if you want to run the test manually
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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:55 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/sleep.yml --timeout 1 │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/d3e… │ generic.l… │ None │ None │ None │ sleep 2 │ /home/doc… │
│ │ │ │ │ │ seconds │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/d3e2c211: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/d
3e2c211
sleep/d3e2c211: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sl
eep/d3e2c211/stage
sleep/d3e2c211: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/d3e2
c211/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/d3e2c211 does not have any dependencies adding test to queue
sleep/d3e2c211: Running Test via command: bash --norc --noprofile -eo pipefail
sleep_build.sh
sleep/d3e2c211: Test completed in 1.003268 seconds
sleep/d3e2c211: Test completed with returncode: -9
sleep/d3e2c211: Writing output file - /home/docs/checkouts/readthedocs.org/user
_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/d3e
2c211/sleep.out
sleep/d3e2c211: Writing error file - /home/docs/checkouts/readthedocs.org/user_b
uilds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/d3e2c
211/sleep.err
In this iteration we are going to run the following tests: [sleep/d3e2c211]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ sleep/d3e2c2 │ generic.loc… │ FAIL │ N/A N/A N/A │ -9 │ 1.003268 │
│ 11 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_e7fim7vp.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 summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-17326554-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2022/07/01 00:38:56 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest │
│ buildtest version: 0.15.0 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/envs/v0.15.0/bin/python3 │
│ python version: 3.7.13 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/buildtest/settings/config.yml │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/tests │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/var/report.json │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ st/checkouts/v0.15.0/bin/buildtest build -b tutorials/sleep.yml --timeout 10 │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.… ║
╚══════════════════════════════════════════════════════════════════════════════╝
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/v0.15.0/tut
orials/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/a57… │ generic.l… │ None │ None │ None │ sleep 2 │ /home/doc… │
│ │ │ │ │ │ seconds │ │
└────────────┴────────────┴──────────┴───────┴───────┴────────────┴────────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/a57ce033: Creating test directory: /home/docs/checkouts/readthedocs.org/us
er_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/a
57ce033
sleep/a57ce033: Creating the stage directory: /home/docs/checkouts/readthedocs.o
rg/user_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sl
eep/a57ce033/stage
sleep/a57ce033: Writing build script: /home/docs/checkouts/readthedocs.org/user_
builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/a57c
e033/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/a57ce033 does not have any dependencies adding test to queue
sleep/a57ce033: Running Test via command: bash --norc --noprofile -eo pipefail
sleep_build.sh
sleep/a57ce033: Test completed in 2.019321 seconds
sleep/a57ce033: Test completed with returncode: 0
sleep/a57ce033: Writing output file - /home/docs/checkouts/readthedocs.org/user
_builds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/a57
ce033/sleep.out
sleep/a57ce033: Writing error file - /home/docs/checkouts/readthedocs.org/user_b
uilds/buildtest/checkouts/v0.15.0/var/tests/generic.local.bash/sleep/sleep/a57ce
033/sleep.err
In this iteration we are going to run the following tests: [sleep/a57ce033]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returnCode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ sleep/a57ce0 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 2.019321 │
│ 33 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
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/buildt
est/checkouts/v0.15.0/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v0.15.0/var/logs/buildtest_uw3e0ayt.log