Building Test (buildtest build)¶
This reference 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.
When you clone buildtest, you also get a set of buildspecs that you can run on your
system. The buildtest build command is used for building and running tests.
Buildtest will read one or more buildspecs file that adheres to one of the
buildtest schemas. For a complete list of build options please run buildtest build --help.
Note
buildtest bd is an alias for buildtest build command.
Build Usage¶
buildtest build --help
$ buildtest build --help
usage: buildtest [options] [COMMANDS] build [-h] [-b BUILDSPEC] [-x EXCLUDE]
[-e EXECUTOR] [-t TAGS] [--rerun]
[-f FILTER] [--helpfilter]
[-et {local,batch}]
[--module-purge] [-m MODULES]
[-u UNLOAD_MODULES]
[--account ACCOUNT]
[--maxpendtime MAXPENDTIME]
[--pollinterval POLLINTERVAL]
[--procs PROCS [PROCS ...]]
[--nodes NODES [NODES ...]]
[--disable-executor-check]
[--limit LIMIT]
[--remove-stagedir]
[--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.
--limit LIMIT Limit number of tests that can be run.
--remove-stagedir Remove stage directory after job completion.
--rebuild REBUILD Rebuild test X number of times. Must be a positive
number between [1-50]
--retry RETRY Retry failed jobs
-s {parse,build}, --stage {parse,build}
Control behavior of buildtest build to stop execution
after 'parse' or 'build' stage
--testdir TESTDIR Specify a custom test directory where to write tests.
This overrides configuration file and default
location.
--timeout TIMEOUT Specify test timeout in number of seconds
Building a Test¶
To build a test, we use the --buildspec or short option -b to specify the
path to buildspec file. Let’s see some examples, first we specify a full path to buildspec file.
In this example, buildtest will discover buildspecs followed by
parsing the test with appropriate schema and generate a shell script that is run
by buildtest. You can learn more about build and test process.
buildtest build -b $BUILDTEST_ROOT/tutorials/vars.yml
$ buildtest build -b $BUILDTEST_ROOT/tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:56:23 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/1f342859: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859
variables_bash/1f342859: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859/stage
variables_bash/1f342859: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/1f342859 does not have any dependencies adding test to queue
variables_bash/1f342859: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859/stage
variables_bash/1f342859: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/1f342859: Test completed in 0.014923 seconds
variables_bash/1f342859: Test completed with returncode: 0
variables_bash/1f342859: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859/variables_bash.out
variables_bash/1f342859: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/1f342859/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/1f342859]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.014923 │
│ sh/1f342859 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_6twtusu_.log
Note
buildtest will only read buildspecs with .yml extension, if you specify a
.yaml it will be ignored by buildtest.
The --buildspec option can be used to specify a file or directory path. If you want
to build multiple buildspecs in a directory you can specify the directory path
and buildtest will recursively search for all .yml files. In the next example,
we build all tests in directory general_tests/configuration.
buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/
$ buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:04 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 4
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 4
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 4
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/ulimits.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/disk_usage.yml: VALID
Total builder objects created: 9
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ kernel_… │ script │ generic… │ None │ None │ None │ Retrieve │ /home/… │
│ │ │ │ │ │ │ Kernel │ │
│ │ │ │ │ │ │ Swap │ │
│ │ │ │ │ │ │ Usage │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ systemd… │ script │ generic… │ None │ None │ None │ check if │ /home/… │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ target │ │
│ │ │ │ │ │ │ is │ │
│ │ │ │ │ │ │ multi-u… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ file │ │
│ │ │ │ │ │ │ lock is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ cputime │ │
│ │ │ │ │ │ │ is set │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ stack │ │
│ │ │ │ │ │ │ size is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ virtual │ │
│ │ │ │ │ │ │ memory │ │
│ │ │ │ │ │ │ size and │ │
│ │ │ │ │ │ │ check if │ │
│ │ │ │ │ │ │ its set │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ unlimit… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ open │ │
│ │ │ │ │ │ │ file │ │
│ │ │ │ │ │ │ descrip… │ │
│ │ │ │ │ │ │ limit is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ 4096 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ max │ │
│ │ │ │ │ │ │ number │ │
│ │ │ │ │ │ │ of user │ │
│ │ │ │ │ │ │ process │ │
│ │ │ │ │ │ │ limit is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ 2048 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ root_di… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ root │ │
│ │ │ │ │ │ │ disk │ │
│ │ │ │ │ │ │ usage │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ report │ │
│ │ │ │ │ │ │ if it │ │
│ │ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ │ thresho… │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
kernel_swapusage/5840dc7e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e
kernel_swapusage/5840dc7e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e/stage
kernel_swapusage/5840dc7e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e/kernel_swapusage_build.sh
systemd_default_target/42a510ff: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff
systemd_default_target/42a510ff: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff/stage
systemd_default_target/42a510ff: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff/systemd_default_target_build.sh
ulimit_filelock_unlimited/f301c581: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581
ulimit_filelock_unlimited/f301c581: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/stage
ulimit_filelock_unlimited/f301c581: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/ulimit_filelock_unlimited_build.sh
ulimit_cputime_unlimited/609ccaad: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad
ulimit_cputime_unlimited/609ccaad: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/stage
ulimit_cputime_unlimited/609ccaad: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/af28779b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b
ulimit_stacksize_unlimited/af28779b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/stage
ulimit_stacksize_unlimited/af28779b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/ulimit_stacksize_unlimited_build.sh
ulimit_vmsize_unlimited/695ca5be: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be
ulimit_vmsize_unlimited/695ca5be: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/stage
ulimit_vmsize_unlimited/695ca5be: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/e496695b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b
ulimit_filedescriptor_4096/e496695b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/stage
ulimit_filedescriptor_4096/e496695b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/ulimit_filedescriptor_4096_build.sh
ulimit_max_user_process_2048/06f19935: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935
ulimit_max_user_process_2048/06f19935: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/stage
ulimit_max_user_process_2048/06f19935: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/ulimit_max_user_process_2048_build.sh
root_disk_usage/8a732a83: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83
root_disk_usage/8a732a83: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83/stage
root_disk_usage/8a732a83: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83/root_disk_usage_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
ulimit_cputime_unlimited/609ccaad does not have any dependencies adding test to queue
kernel_swapusage/5840dc7e does not have any dependencies adding test to queue
systemd_default_target/42a510ff does not have any dependencies adding test to queue
ulimit_filedescriptor_4096/e496695b does not have any dependencies adding test to queue
ulimit_max_user_process_2048/06f19935 does not have any dependencies adding test to queue
ulimit_vmsize_unlimited/695ca5be does not have any dependencies adding test to queue
ulimit_stacksize_unlimited/af28779b does not have any dependencies adding test to queue
ulimit_filelock_unlimited/f301c581 does not have any dependencies adding test to queue
root_disk_usage/8a732a83 does not have any dependencies adding test to queue
ulimit_cputime_unlimited/609ccaad: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/stage
ulimit_cputime_unlimited/609ccaad: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/609ccaad: Test completed in 0.005748 seconds
ulimit_cputime_unlimited/609ccaad: Test completed with returncode: 0
ulimit_cputime_unlimited/609ccaad: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/609ccaad: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/609ccaad: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/609ccaad/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/609ccaad: Regular Expression Match - Success!
ulimit_filelock_unlimited/f301c581: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/stage
ulimit_filelock_unlimited/f301c581: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/f301c581: Test completed in 0.005362 seconds
ulimit_filelock_unlimited/f301c581: Test completed with returncode: 0
ulimit_filelock_unlimited/f301c581: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/f301c581: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/f301c581: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/f301c581/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/f301c581: Regular Expression Match - Success!
kernel_swapusage/5840dc7e: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e/stage
kernel_swapusage/5840dc7e: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/5840dc7e: Test completed in 0.006186 seconds
kernel_swapusage/5840dc7e: Test completed with returncode: 255
kernel_swapusage/5840dc7e: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e/kernel_swapusage.out
kernel_swapusage/5840dc7e: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/5840dc7e/kernel_swapusage.err
ulimit_stacksize_unlimited/af28779b: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/stage
ulimit_stacksize_unlimited/af28779b: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/af28779b: Test completed in 0.00542 seconds
ulimit_stacksize_unlimited/af28779b: Test completed with returncode: 0
ulimit_stacksize_unlimited/af28779b: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/af28779b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/af28779b: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/af28779b/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/af28779b: Regular Expression Match - Failed!
ulimit_max_user_process_2048/06f19935: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/stage
ulimit_max_user_process_2048/06f19935: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/06f19935: Test completed in 0.005537 seconds
ulimit_max_user_process_2048/06f19935: Test completed with returncode: 0
ulimit_max_user_process_2048/06f19935: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/06f19935: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/ulimit_max_user_process_2048.err
ulimit_max_user_process_2048/06f19935: performing regular expression - '^2048$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/06f19935/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/06f19935: Regular Expression Match - Failed!
ulimit_vmsize_unlimited/695ca5be: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/stage
ulimit_vmsize_unlimited/695ca5be: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/695ca5be: Test completed in 0.005509 seconds
ulimit_vmsize_unlimited/695ca5be: Test completed with returncode: 0
ulimit_vmsize_unlimited/695ca5be: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/695ca5be: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/695ca5be: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/695ca5be/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/695ca5be: Regular Expression Match - Success!
ulimit_filedescriptor_4096/e496695b: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/stage
ulimit_filedescriptor_4096/e496695b: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/e496695b: Test completed in 0.005994 seconds
ulimit_filedescriptor_4096/e496695b: Test completed with returncode: 0
ulimit_filedescriptor_4096/e496695b: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/e496695b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/e496695b: performing regular expression - '^4096$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/e496695b/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/e496695b: Regular Expression Match - Failed!
systemd_default_target/42a510ff: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff/stage
systemd_default_target/42a510ff: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/42a510ff: Test completed in 0.008409 seconds
systemd_default_target/42a510ff: Test completed with returncode: 1
systemd_default_target/42a510ff: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff/systemd_default_target.out
systemd_default_target/42a510ff: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/42a510ff/systemd_default_target.err
root_disk_usage/8a732a83: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83/stage
root_disk_usage/8a732a83: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/8a732a83: Test completed in 0.009467 seconds
root_disk_usage/8a732a83: Test completed with returncode: 0
root_disk_usage/8a732a83: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83/root_disk_usage.out
root_disk_usage/8a732a83: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/8a732a83/root_disk_usage.err
In this iteration we are going to run the following tests: [ulimit_cputime_unlimited/609ccaad, ulimit_filelock_unlimited/f301c581, kernel_swapusage/5840dc7e, ulimit_stacksize_unlimited/af28779b, ulimit_max_user_process_2048/06f19935, ulimit_vmsize_unlimited/695ca5be, ulimit_filedescriptor_4096/e496695b, systemd_default_target/42a510ff, root_disk_usage/8a732a83]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ ulimit_cputi │ generic.loc… │ PASS │ False True │ 0 │ 0.005748 │
│ me_unlimited │ │ │ False │ │ │
│ /609ccaad │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL │ False False │ 0 │ 0.005994 │
│ escriptor_40 │ │ │ False │ │ │
│ 96/e496695b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.006186 │
│ sage/5840dc7 │ │ │ │ │ │
│ e │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS │ False True │ 0 │ 0.005509 │
│ e_unlimited/ │ │ │ False │ │ │
│ 695ca5be │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.008409 │
│ ult_target/4 │ │ │ │ │ │
│ 2a510ff │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filel │ generic.loc… │ PASS │ False True │ 0 │ 0.005362 │
│ ock_unlimite │ │ │ False │ │ │
│ d/f301c581 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_stack │ generic.loc… │ FAIL │ False False │ 0 │ 0.00542 │
│ size_unlimit │ │ │ False │ │ │
│ ed/af28779b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL │ False False │ 0 │ 0.005537 │
│ ser_process_ │ │ │ False │ │ │
│ 2048/06f1993 │ │ │ │ │ │
│ 5 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.009467 │
│ age/8a732a83 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 4/9 Percentage: 44.444%
Failed Tests: 5/9 Percentage: 55.556%
Adding 9 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_gln3au3w.log
Building Multiple Buildspecs¶
You can append -b option to build multiple buildspecs in the same
command. Buildtest will discover buildspecs for every argument (-b) and accumulate
a list of buildspecs to run. In this example, we instruct buildtest to build
a buildspec file and all buildspecs in a directory path.
buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/ -b $BUILDTEST_ROOT/tutorials/vars.yml
$ buildtest build -b $BUILDTEST_ROOT/general_tests/configuration/ -b $BUILDTEST_ROOT/tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:05 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 5
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 5
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 5
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/ulimits.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/disk_usage.yml: VALID
Total builder objects created: 10
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ systemd… │ script │ generic… │ None │ None │ None │ check if │ /home/… │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ target │ │
│ │ │ │ │ │ │ is │ │
│ │ │ │ │ │ │ multi-u… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ kernel_… │ script │ generic… │ None │ None │ None │ Retrieve │ /home/… │
│ │ │ │ │ │ │ Kernel │ │
│ │ │ │ │ │ │ Swap │ │
│ │ │ │ │ │ │ Usage │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ file │ │
│ │ │ │ │ │ │ lock is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ cputime │ │
│ │ │ │ │ │ │ is set │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ stack │ │
│ │ │ │ │ │ │ size is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ unlimit… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ ulimits │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ virtual │ │
│ │ │ │ │ │ │ memory │ │
│ │ │ │ │ │ │ size and │ │
│ │ │ │ │ │ │ check if │ │
│ │ │ │ │ │ │ its set │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ unlimit… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check if │ /home/… │
│ │ │ │ │ │ │ open │ │
│ │ │ │ │ │ │ file │ │
│ │ │ │ │ │ │ descrip… │ │
│ │ │ │ │ │ │ limit is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ 4096 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ ulimit_… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ max │ │
│ │ │ │ │ │ │ number │ │
│ │ │ │ │ │ │ of user │ │
│ │ │ │ │ │ │ process │ │
│ │ │ │ │ │ │ limit is │ │
│ │ │ │ │ │ │ set to │ │
│ │ │ │ │ │ │ 2048 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ root_di… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ root │ │
│ │ │ │ │ │ │ disk │ │
│ │ │ │ │ │ │ usage │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ report │ │
│ │ │ │ │ │ │ if it │ │
│ │ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ │ thresho… │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/3bd0b96a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a
variables_bash/3bd0b96a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a/stage
variables_bash/3bd0b96a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a/variables_bash_build.sh
systemd_default_target/0b33673c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c
systemd_default_target/0b33673c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c/stage
systemd_default_target/0b33673c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c/systemd_default_target_build.sh
kernel_swapusage/71a392c4: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4
kernel_swapusage/71a392c4: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4/stage
kernel_swapusage/71a392c4: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4/kernel_swapusage_build.sh
ulimit_filelock_unlimited/c05a16f4: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4
ulimit_filelock_unlimited/c05a16f4: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/stage
ulimit_filelock_unlimited/c05a16f4: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/ulimit_filelock_unlimited_build.sh
ulimit_cputime_unlimited/d61fca73: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73
ulimit_cputime_unlimited/d61fca73: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/stage
ulimit_cputime_unlimited/d61fca73: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/ulimit_cputime_unlimited_build.sh
ulimit_stacksize_unlimited/4a2e6f4c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c
ulimit_stacksize_unlimited/4a2e6f4c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/stage
ulimit_stacksize_unlimited/4a2e6f4c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/ulimit_stacksize_unlimited_build.sh
ulimit_vmsize_unlimited/e26582b3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3
ulimit_vmsize_unlimited/e26582b3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/stage
ulimit_vmsize_unlimited/e26582b3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/ulimit_vmsize_unlimited_build.sh
ulimit_filedescriptor_4096/64901320: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320
ulimit_filedescriptor_4096/64901320: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/stage
ulimit_filedescriptor_4096/64901320: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/ulimit_filedescriptor_4096_build.sh
ulimit_max_user_process_2048/16754c2f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f
ulimit_max_user_process_2048/16754c2f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/stage
ulimit_max_user_process_2048/16754c2f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/ulimit_max_user_process_2048_build.sh
root_disk_usage/af0a8d36: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36
root_disk_usage/af0a8d36: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36/stage
root_disk_usage/af0a8d36: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36/root_disk_usage_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
ulimit_max_user_process_2048/16754c2f does not have any dependencies adding test to queue
systemd_default_target/0b33673c does not have any dependencies adding test to queue
kernel_swapusage/71a392c4 does not have any dependencies adding test to queue
ulimit_stacksize_unlimited/4a2e6f4c does not have any dependencies adding test to queue
ulimit_filedescriptor_4096/64901320 does not have any dependencies adding test to queue
root_disk_usage/af0a8d36 does not have any dependencies adding test to queue
ulimit_cputime_unlimited/d61fca73 does not have any dependencies adding test to queue
variables_bash/3bd0b96a does not have any dependencies adding test to queue
ulimit_vmsize_unlimited/e26582b3 does not have any dependencies adding test to queue
ulimit_filelock_unlimited/c05a16f4 does not have any dependencies adding test to queue
ulimit_max_user_process_2048/16754c2f: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/stage
ulimit_max_user_process_2048/16754c2f: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_max_user_process_2048_build.sh
ulimit_max_user_process_2048/16754c2f: Test completed in 0.005617 seconds
ulimit_max_user_process_2048/16754c2f: Test completed with returncode: 0
ulimit_max_user_process_2048/16754c2f: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/16754c2f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/ulimit_max_user_process_2048.err
ulimit_max_user_process_2048/16754c2f: performing regular expression - '^2048$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_max_user_process_2048/16754c2f/ulimit_max_user_process_2048.out
ulimit_max_user_process_2048/16754c2f: Regular Expression Match - Failed!
systemd_default_target/0b33673c: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c/stage
systemd_default_target/0b33673c: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/0b33673c: Test completed in 0.007635 seconds
systemd_default_target/0b33673c: Test completed with returncode: 1
systemd_default_target/0b33673c: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c/systemd_default_target.out
systemd_default_target/0b33673c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/0b33673c/systemd_default_target.err
kernel_swapusage/71a392c4: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4/stage
kernel_swapusage/71a392c4: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/71a392c4: Test completed in 0.006017 seconds
kernel_swapusage/71a392c4: Test completed with returncode: 255
kernel_swapusage/71a392c4: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4/kernel_swapusage.out
kernel_swapusage/71a392c4: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/71a392c4/kernel_swapusage.err
ulimit_stacksize_unlimited/4a2e6f4c: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/stage
ulimit_stacksize_unlimited/4a2e6f4c: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_stacksize_unlimited_build.sh
ulimit_stacksize_unlimited/4a2e6f4c: Test completed in 0.005142 seconds
ulimit_stacksize_unlimited/4a2e6f4c: Test completed with returncode: 0
ulimit_stacksize_unlimited/4a2e6f4c: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/4a2e6f4c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/ulimit_stacksize_unlimited.err
ulimit_stacksize_unlimited/4a2e6f4c: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_stacksize_unlimited/4a2e6f4c/ulimit_stacksize_unlimited.out
ulimit_stacksize_unlimited/4a2e6f4c: Regular Expression Match - Failed!
ulimit_filedescriptor_4096/64901320: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/stage
ulimit_filedescriptor_4096/64901320: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filedescriptor_4096_build.sh
ulimit_filedescriptor_4096/64901320: Test completed in 0.005103 seconds
ulimit_filedescriptor_4096/64901320: Test completed with returncode: 0
ulimit_filedescriptor_4096/64901320: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/64901320: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/ulimit_filedescriptor_4096.err
ulimit_filedescriptor_4096/64901320: performing regular expression - '^4096$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filedescriptor_4096/64901320/ulimit_filedescriptor_4096.out
ulimit_filedescriptor_4096/64901320: Regular Expression Match - Failed!
root_disk_usage/af0a8d36: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36/stage
root_disk_usage/af0a8d36: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/af0a8d36: Test completed in 0.008663 seconds
root_disk_usage/af0a8d36: Test completed with returncode: 0
root_disk_usage/af0a8d36: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36/root_disk_usage.out
root_disk_usage/af0a8d36: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/af0a8d36/root_disk_usage.err
ulimit_cputime_unlimited/d61fca73: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/stage
ulimit_cputime_unlimited/d61fca73: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_cputime_unlimited_build.sh
ulimit_cputime_unlimited/d61fca73: Test completed in 0.005401 seconds
ulimit_cputime_unlimited/d61fca73: Test completed with returncode: 0
ulimit_cputime_unlimited/d61fca73: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/d61fca73: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/ulimit_cputime_unlimited.err
ulimit_cputime_unlimited/d61fca73: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_cputime_unlimited/d61fca73/ulimit_cputime_unlimited.out
ulimit_cputime_unlimited/d61fca73: Regular Expression Match - Success!
variables_bash/3bd0b96a: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a/stage
variables_bash/3bd0b96a: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/3bd0b96a: Test completed in 0.008976 seconds
variables_bash/3bd0b96a: Test completed with returncode: 0
variables_bash/3bd0b96a: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a/variables_bash.out
variables_bash/3bd0b96a: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/3bd0b96a/variables_bash.err
ulimit_vmsize_unlimited/e26582b3: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/stage
ulimit_vmsize_unlimited/e26582b3: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_vmsize_unlimited_build.sh
ulimit_vmsize_unlimited/e26582b3: Test completed in 0.005858 seconds
ulimit_vmsize_unlimited/e26582b3: Test completed with returncode: 0
ulimit_vmsize_unlimited/e26582b3: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/e26582b3: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/ulimit_vmsize_unlimited.err
ulimit_vmsize_unlimited/e26582b3: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_vmsize_unlimited/e26582b3/ulimit_vmsize_unlimited.out
ulimit_vmsize_unlimited/e26582b3: Regular Expression Match - Success!
ulimit_filelock_unlimited/c05a16f4: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/stage
ulimit_filelock_unlimited/c05a16f4: Running Test via command: bash --norc --noprofile -eo pipefail ulimit_filelock_unlimited_build.sh
ulimit_filelock_unlimited/c05a16f4: Test completed in 0.006107 seconds
ulimit_filelock_unlimited/c05a16f4: Test completed with returncode: 0
ulimit_filelock_unlimited/c05a16f4: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/c05a16f4: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/ulimit_filelock_unlimited.err
ulimit_filelock_unlimited/c05a16f4: performing regular expression - '^unlimited$' on file: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ulimits/ulimit_filelock_unlimited/c05a16f4/ulimit_filelock_unlimited.out
ulimit_filelock_unlimited/c05a16f4: Regular Expression Match - Success!
In this iteration we are going to run the following tests: [ulimit_max_user_process_2048/16754c2f, systemd_default_target/0b33673c, kernel_swapusage/71a392c4, ulimit_stacksize_unlimited/4a2e6f4c, ulimit_filedescriptor_4096/64901320, root_disk_usage/af0a8d36, ulimit_cputime_unlimited/d61fca73, variables_bash/3bd0b96a, ulimit_vmsize_unlimited/e26582b3, ulimit_filelock_unlimited/c05a16f4]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ ulimit_filel │ generic.loc… │ PASS │ False True │ 0 │ 0.006107 │
│ ock_unlimite │ │ │ False │ │ │
│ d/c05a16f4 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_vmsiz │ generic.loc… │ PASS │ False True │ 0 │ 0.005858 │
│ e_unlimited/ │ │ │ False │ │ │
│ e26582b3 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.006017 │
│ sage/71a392c │ │ │ │ │ │
│ 4 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_stack │ generic.loc… │ FAIL │ False False │ 0 │ 0.005142 │
│ size_unlimit │ │ │ False │ │ │
│ ed/4a2e6f4c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_filed │ generic.loc… │ FAIL │ False False │ 0 │ 0.005103 │
│ escriptor_40 │ │ │ False │ │ │
│ 96/64901320 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008663 │
│ age/af0a8d36 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.007635 │
│ ult_target/0 │ │ │ │ │ │
│ b33673c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_cputi │ generic.loc… │ PASS │ False True │ 0 │ 0.005401 │
│ me_unlimited │ │ │ False │ │ │
│ /d61fca73 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008976 │
│ sh/3bd0b96a │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ ulimit_max_u │ generic.loc… │ FAIL │ False False │ 0 │ 0.005617 │
│ ser_process_ │ │ │ False │ │ │
│ 2048/16754c2 │ │ │ │ │ │
│ f │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 5/10 Percentage: 50.000%
Failed Tests: 5/10 Percentage: 50.000%
Adding 10 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_an0hytl8.log
Excluding Buildspecs¶
So far we learned how to build buildspecs by file and directory path using the -b
option. Next, we will discuss how one may exclude buildspecs which behaves similar to
-b option. You can exclude buildspecs via --exclude or short option -x
which can be useful when you want to exclude certain files or sub directory.
For example we can build all buildspecs in tutorials but exclude file tutorials/vars.yml
by running:
$ buildtest build -b tutorials -x tutorials/vars.yml
buildtest will discover all buildspecs and then exclude any buildspecs specified
by -x option. You can specify -x multiple times just like -b option.
For example, we can undo discovery by passing same option to -b and -x as follows
buildtest bd -b tutorials/ -x tutorials/
$ buildtest bd -b tutorials/ -x tutorials/ ╭───────────────────────────── buildtest summary ──────────────────────────────╮ │ │ │ User: docs │ │ Hostname: build-19701871-project-280831-buildtest │ │ Platform: Linux │ │ Current Time: 2023/03/07 15:57:06 │ │ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ buildtest version: 1.3 │ │ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ python version: 3.7.15 │ │ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ │ ╰──────────────────────────────────────────────────────────────────────────────╯ There are no Buildspec files to process.
Buildtest will stop immediately if there are no Buildspecs to process, this is true if you were to specify files instead of directory.
In this example, we build all buildspecs in a directory but exclude a file. Buildtest
will report the excluded buildspecs in the output and -x option can be appended multiple times.
The -x can be a file or a directory and behaves similar to -b option.
buildtest bd -b general_tests/configuration/ -x general_tests/configuration/ulimits.yml
$ buildtest bd -b general_tests/configuration/ -x general_tests/configuration/ulimits.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:07 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Excluded buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/g… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 4
Total Excluded Buildspecs: 1
Detected Buildspecs after exclusion: 3
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 3
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/kernel_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/systemd-default-target.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/general_tests/configuration/disk_usage.yml: VALID
Total builder objects created: 3
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ kernel_… │ script │ generic… │ None │ None │ None │ Retrieve │ /home/… │
│ │ │ │ │ │ │ Kernel │ │
│ │ │ │ │ │ │ Swap │ │
│ │ │ │ │ │ │ Usage │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ systemd… │ script │ generic… │ None │ None │ None │ check if │ /home/… │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ target │ │
│ │ │ │ │ │ │ is │ │
│ │ │ │ │ │ │ multi-u… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ root_di… │ script │ generic… │ None │ None │ None │ Check │ /home/… │
│ │ │ │ │ │ │ root │ │
│ │ │ │ │ │ │ disk │ │
│ │ │ │ │ │ │ usage │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ report │ │
│ │ │ │ │ │ │ if it │ │
│ │ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ │ thresho… │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
kernel_swapusage/046840c1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1
kernel_swapusage/046840c1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1/stage
kernel_swapusage/046840c1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1/kernel_swapusage_build.sh
systemd_default_target/52962794: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794
systemd_default_target/52962794: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794/stage
systemd_default_target/52962794: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794/systemd_default_target_build.sh
root_disk_usage/cc458f0b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b
root_disk_usage/cc458f0b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b/stage
root_disk_usage/cc458f0b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b/root_disk_usage_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
kernel_swapusage/046840c1 does not have any dependencies adding test to queue
systemd_default_target/52962794 does not have any dependencies adding test to queue
root_disk_usage/cc458f0b does not have any dependencies adding test to queue
kernel_swapusage/046840c1: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1/stage
kernel_swapusage/046840c1: Running Test via command: bash --norc --noprofile -eo pipefail kernel_swapusage_build.sh
kernel_swapusage/046840c1: Test completed in 0.006533 seconds
kernel_swapusage/046840c1: Test completed with returncode: 255
kernel_swapusage/046840c1: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1/kernel_swapusage.out
kernel_swapusage/046840c1: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/kernel_state/kernel_swapusage/046840c1/kernel_swapusage.err
systemd_default_target/52962794: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794/stage
systemd_default_target/52962794: Running Test via command: bash --norc --noprofile -eo pipefail systemd_default_target_build.sh
systemd_default_target/52962794: Test completed in 0.007503 seconds
systemd_default_target/52962794: Test completed with returncode: 1
systemd_default_target/52962794: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794/systemd_default_target.out
systemd_default_target/52962794: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/systemd-default-target/systemd_default_target/52962794/systemd_default_target.err
root_disk_usage/cc458f0b: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b/stage
root_disk_usage/cc458f0b: Running Test via command: bash --norc --noprofile -eo pipefail root_disk_usage_build.sh
root_disk_usage/cc458f0b: Test completed in 0.00867 seconds
root_disk_usage/cc458f0b: Test completed with returncode: 0
root_disk_usage/cc458f0b: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b/root_disk_usage.out
root_disk_usage/cc458f0b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/disk_usage/root_disk_usage/cc458f0b/root_disk_usage.err
In this iteration we are going to run the following tests: [kernel_swapusage/046840c1, systemd_default_target/52962794, root_disk_usage/cc458f0b]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ systemd_defa │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.007503 │
│ ult_target/5 │ │ │ │ │ │
│ 2962794 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ kernel_swapu │ generic.loc… │ FAIL │ N/A N/A N/A │ 255 │ 0.006533 │
│ sage/046840c │ │ │ │ │ │
│ 1 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ root_disk_us │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.00867 │
│ age/cc458f0b │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/3 Percentage: 33.333%
Failed Tests: 2/3 Percentage: 66.667%
Adding 3 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_le4kxp_3.log
Building By Tags¶
buildtest can perform builds by tags by using --tags or short option (-t).
In order to use this feature, buildtest must load buildspecs in cache which can be run
via buildtest buildspec find. If you are unsure of the available tags you can
run buildtest buildspec find --tags or let buildtest tab-complete the available tags. For more details
see Querying buildspec tags.
Let’s assume you want to build by tag name network, buildtest
will attempt to find all tests that contain tags: ['network'] in the buildspec
which is loaded in the buildcache cache. If a test matches the tag name, the test
will be picked up during the discover process.
buildtest build -t network
$ buildtest build -t network
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:07 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=network
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/tags_example.yml: VALID
Total builder objects created: 2
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ string_… │ script │ generic… │ None │ None │ None │ tags can │ /home/… │
│ │ │ │ │ │ │ be a │ │
│ │ │ │ │ │ │ string │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ list_of… │ script │ generic… │ None │ None │ None │ tags can │ /home/… │
│ │ │ │ │ │ │ be a │ │
│ │ │ │ │ │ │ list of │ │
│ │ │ │ │ │ │ strings │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
string_tag/40297681: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681
string_tag/40297681: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681/stage
string_tag/40297681: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681/string_tag_build.sh
list_of_strings_tags/b104818f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f
list_of_strings_tags/b104818f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f/stage
list_of_strings_tags/b104818f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f/list_of_strings_tags_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
string_tag/40297681 does not have any dependencies adding test to queue
list_of_strings_tags/b104818f does not have any dependencies adding test to queue
string_tag/40297681: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681/stage
string_tag/40297681: Running Test via command: bash --norc --noprofile -eo pipefail string_tag_build.sh
string_tag/40297681: Test completed in 0.006186 seconds
string_tag/40297681: Test completed with returncode: 0
string_tag/40297681: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681/string_tag.out
string_tag/40297681: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/40297681/string_tag.err
list_of_strings_tags/b104818f: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f/stage
list_of_strings_tags/b104818f: Running Test via command: bash --norc --noprofile -eo pipefail list_of_strings_tags_build.sh
list_of_strings_tags/b104818f: Test completed in 3.032654 seconds
list_of_strings_tags/b104818f: Test completed with returncode: 0
list_of_strings_tags/b104818f: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f/list_of_strings_tags.out
list_of_strings_tags/b104818f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/b104818f/list_of_strings_tags.err
In this iteration we are going to run the following tests: [string_tag/40297681, list_of_strings_tags/b104818f]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ string_tag/4 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.006186 │
│ 0297681 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ list_of_stri │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 3.032654 │
│ ngs_tags/b10 │ │ │ │ │ │
│ 4818f │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%
Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_3_qaehfe.log
You can build by multiple tags by specifying --tags multiple times. In next
example we build all tests with tag name pass and python.
buildtest build -t python -t pass
$ buildtest build -t python -t pass
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:11 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 3
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 3
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 3
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
Total builder objects created: 6
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ python_… │ script │ generic… │ None │ None │ None │ Hello │ /home/… │
│ │ │ │ │ │ │ World │ │
│ │ │ │ │ │ │ python │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
python_hello/481cc21b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b
python_hello/481cc21b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b/stage
python_hello/481cc21b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b/python_hello_build.sh
exit1_fail/bb1bbe79: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79
exit1_fail/bb1bbe79: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79/stage
exit1_fail/bb1bbe79: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79/exit1_fail_build.sh
exit1_pass/6784bb71: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71
exit1_pass/6784bb71: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71/stage
exit1_pass/6784bb71: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71/exit1_pass_build.sh
returncode_list_mismatch/2e63412b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b
returncode_list_mismatch/2e63412b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b/stage
returncode_list_mismatch/2e63412b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b/returncode_list_mismatch_build.sh
returncode_int_match/d424c6f6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6
returncode_int_match/d424c6f6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6/stage
returncode_int_match/d424c6f6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6/returncode_int_match_build.sh
circle_area/24e55eda: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda
circle_area/24e55eda: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda/stage
circle_area/24e55eda: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda/circle_area_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
python_hello/481cc21b does not have any dependencies adding test to queue
circle_area/24e55eda does not have any dependencies adding test to queue
exit1_pass/6784bb71 does not have any dependencies adding test to queue
returncode_list_mismatch/2e63412b does not have any dependencies adding test to queue
returncode_int_match/d424c6f6 does not have any dependencies adding test to queue
exit1_fail/bb1bbe79 does not have any dependencies adding test to queue
python_hello/481cc21b: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b/stage
python_hello/481cc21b: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/481cc21b: Test completed in 0.030576 seconds
python_hello/481cc21b: Test completed with returncode: 0
python_hello/481cc21b: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b/python_hello.out
python_hello/481cc21b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/481cc21b/python_hello.err
circle_area/24e55eda: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda/stage
circle_area/24e55eda: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/24e55eda: Test completed in 0.029789 seconds
circle_area/24e55eda: Test completed with returncode: 0
circle_area/24e55eda: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda/circle_area.out
circle_area/24e55eda: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/24e55eda/circle_area.err
exit1_pass/6784bb71: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71/stage
exit1_pass/6784bb71: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/6784bb71: Test completed in 0.005185 seconds
exit1_pass/6784bb71: Test completed with returncode: 1
exit1_pass/6784bb71: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71/exit1_pass.out
exit1_pass/6784bb71: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/6784bb71/exit1_pass.err
exit1_pass/6784bb71: Checking returncode - 1 is matched in list [1]
returncode_list_mismatch/2e63412b: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b/stage
returncode_list_mismatch/2e63412b: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/2e63412b: Test completed in 0.005052 seconds
returncode_list_mismatch/2e63412b: Test completed with returncode: 2
returncode_list_mismatch/2e63412b: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b/returncode_list_mismatch.out
returncode_list_mismatch/2e63412b: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/2e63412b/returncode_list_mismatch.err
returncode_list_mismatch/2e63412b: Checking returncode - 2 is matched in list [1, 3]
returncode_int_match/d424c6f6: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6/stage
returncode_int_match/d424c6f6: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/d424c6f6: Test completed in 0.005059 seconds
returncode_int_match/d424c6f6: Test completed with returncode: 128
returncode_int_match/d424c6f6: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6/returncode_int_match.out
returncode_int_match/d424c6f6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/d424c6f6/returncode_int_match.err
returncode_int_match/d424c6f6: Checking returncode - 128 is matched in list [128]
exit1_fail/bb1bbe79: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79/stage
exit1_fail/bb1bbe79: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/bb1bbe79: Test completed in 0.005114 seconds
exit1_fail/bb1bbe79: Test completed with returncode: 1
exit1_fail/bb1bbe79: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79/exit1_fail.out
exit1_fail/bb1bbe79: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/bb1bbe79/exit1_fail.err
In this iteration we are going to run the following tests: [python_hello/481cc21b, circle_area/24e55eda, exit1_pass/6784bb71, returncode_list_mismatch/2e63412b, returncode_int_match/d424c6f6, exit1_fail/bb1bbe79]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ exit1_fail/b │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005114 │
│ b1bbe79 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030576 │
│ /481cc21b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.029789 │
│ 24e55eda │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/6 │ generic.loc… │ PASS │ True False │ 1 │ 0.005185 │
│ 784bb71 │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005052 │
│ ist_mismatch │ │ │ False │ │ │
│ /2e63412b │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005059 │
│ nt_match/d42 │ │ │ False │ │ │
│ 4c6f6 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 4/6 Percentage: 66.667%
Failed Tests: 2/6 Percentage: 33.333%
Adding 6 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_9ri_vlwj.log
When multiple tags are specified, we search each tag independently and if it’s
found in the buildspec cache we retrieve the buildspec file and add file to queue.
This queue is a list of buildspecs that buildtest will process (i.e parse, build, run).
You can query tags from buildspecs cache to see all available
tags by running buildtest buildspec find --tags.
Note
The --tags is used for discovering buildspec file and not filtering tests
by tag.
You can combine --tags with --buildspec to discover buildspecs in a single command.
buildtest will query tags and buildspecs independently and combine all discovered
buildspecs together.
buildtest build --tags pass --buildspec tutorials/python-hello.yml
$ buildtest build --tags pass --buildspec tutorials/python-hello.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:12 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 2
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
Total builder objects created: 5
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ python_… │ script │ generic… │ None │ None │ None │ Hello │ /home/… │
│ │ │ │ │ │ │ World │ │
│ │ │ │ │ │ │ python │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/cc050ee6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6
exit1_fail/cc050ee6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6/stage
exit1_fail/cc050ee6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6/exit1_fail_build.sh
exit1_pass/ce3db79f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f
exit1_pass/ce3db79f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f/stage
exit1_pass/ce3db79f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f/exit1_pass_build.sh
returncode_list_mismatch/586d32e1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1
returncode_list_mismatch/586d32e1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1/stage
returncode_list_mismatch/586d32e1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1/returncode_list_mismatch_build.sh
returncode_int_match/140435b0: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0
returncode_int_match/140435b0: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0/stage
returncode_int_match/140435b0: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0/returncode_int_match_build.sh
python_hello/d54df9c4: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4
python_hello/d54df9c4: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4/stage
python_hello/d54df9c4: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4/python_hello_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
python_hello/d54df9c4 does not have any dependencies adding test to queue
exit1_pass/ce3db79f does not have any dependencies adding test to queue
returncode_list_mismatch/586d32e1 does not have any dependencies adding test to queue
exit1_fail/cc050ee6 does not have any dependencies adding test to queue
returncode_int_match/140435b0 does not have any dependencies adding test to queue
python_hello/d54df9c4: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4/stage
python_hello/d54df9c4: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/d54df9c4: Test completed in 0.030351 seconds
python_hello/d54df9c4: Test completed with returncode: 0
python_hello/d54df9c4: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4/python_hello.out
python_hello/d54df9c4: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/d54df9c4/python_hello.err
exit1_pass/ce3db79f: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f/stage
exit1_pass/ce3db79f: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/ce3db79f: Test completed in 0.005343 seconds
exit1_pass/ce3db79f: Test completed with returncode: 1
exit1_pass/ce3db79f: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f/exit1_pass.out
exit1_pass/ce3db79f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/ce3db79f/exit1_pass.err
exit1_pass/ce3db79f: Checking returncode - 1 is matched in list [1]
returncode_list_mismatch/586d32e1: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1/stage
returncode_list_mismatch/586d32e1: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/586d32e1: Test completed in 0.005039 seconds
returncode_list_mismatch/586d32e1: Test completed with returncode: 2
returncode_list_mismatch/586d32e1: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1/returncode_list_mismatch.out
returncode_list_mismatch/586d32e1: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/586d32e1/returncode_list_mismatch.err
returncode_list_mismatch/586d32e1: Checking returncode - 2 is matched in list [1, 3]
returncode_int_match/140435b0: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0/stage
returncode_int_match/140435b0: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/140435b0: Test completed in 0.005137 seconds
returncode_int_match/140435b0: Test completed with returncode: 128
returncode_int_match/140435b0: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0/returncode_int_match.out
returncode_int_match/140435b0: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/140435b0/returncode_int_match.err
returncode_int_match/140435b0: Checking returncode - 128 is matched in list [128]
exit1_fail/cc050ee6: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6/stage
exit1_fail/cc050ee6: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/cc050ee6: Test completed in 0.005103 seconds
exit1_fail/cc050ee6: Test completed with returncode: 1
exit1_fail/cc050ee6: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6/exit1_fail.out
exit1_fail/cc050ee6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/cc050ee6/exit1_fail.err
In this iteration we are going to run the following tests: [python_hello/d54df9c4, exit1_pass/ce3db79f, returncode_list_mismatch/586d32e1, returncode_int_match/140435b0, exit1_fail/cc050ee6]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005137 │
│ nt_match/140 │ │ │ False │ │ │
│ 435b0 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/c │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005103 │
│ c050ee6 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030351 │
│ /d54df9c4 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/c │ generic.loc… │ PASS │ True False │ 1 │ 0.005343 │
│ e3db79f │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005039 │
│ ist_mismatch │ │ │ False │ │ │
│ /586d32e1 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 3/5 Percentage: 60.000%
Failed Tests: 2/5 Percentage: 40.000%
Adding 5 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_lg16957x.log
As you may see, there are several ways to build buildspecs with buildtest. Tags is great way to build a whole collection of tests if you don’t know path to all the files. You can specify multiple tags per buildspecs to classify how test can be run.
Building by Executors¶
Every buildspec is associated to an executor which is responsible for running the test.
You can instruct buildtest to run all tests by given executor via --executor option or short option -e.
For instance, if you want to build all test associated to executor generic.local.csh you can run:
$ buildtest build --executor generic.local.csh
buildtest will query buildspec cache for the executor name and retrieve a list of buildspecs with matching executor name. To see a list of available executors in buildspec cache see querying buildspec executor.
Note
By default all tests are run in buildspec file. The buildtest build --executor option discovers
buildspecs if one of the test matches the executor name. The --executor option
is not filtering tests but only discovering buildspecs.
In this example we run all tests that are associated to generic.local.csh executor.
buildtest build --executor generic.local.csh
$ buildtest build --executor generic.local.csh
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:13 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs by Executor=generic.local.csh
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspecs ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 2
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/environment.yml: VALID
Total builder objects created: 4
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ csh_she… │ script │ generic… │ None │ None │ None │ csh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ bash_en… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ (bash) │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ csh_env… │ script │ generic… │ None │ None │ None │ csh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ declare │ │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ tcsh_en… │ script │ generic… │ None │ None │ None │ tcsh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ declare │ │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
csh_shell/c6d8dac6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6
csh_shell/c6d8dac6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6/stage
csh_shell/c6d8dac6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6/csh_shell_build.sh
bash_env_variables/4cf80b4d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d
bash_env_variables/4cf80b4d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d/stage
bash_env_variables/4cf80b4d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d/bash_env_variables_build.sh
csh_env_declaration/f297dad8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8
csh_env_declaration/f297dad8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8/stage
csh_env_declaration/f297dad8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8/csh_env_declaration_build.sh
tcsh_env_declaration/1a5898f3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3
tcsh_env_declaration/1a5898f3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3/stage
tcsh_env_declaration/1a5898f3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3/tcsh_env_declaration_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
bash_env_variables/4cf80b4d does not have any dependencies adding test to queue
tcsh_env_declaration/1a5898f3 does not have any dependencies adding test to queue
csh_shell/c6d8dac6 does not have any dependencies adding test to queue
csh_env_declaration/f297dad8 does not have any dependencies adding test to queue
bash_env_variables/4cf80b4d: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d/stage
bash_env_variables/4cf80b4d: Running Test via command: bash --norc --noprofile -eo pipefail bash_env_variables_build.sh
bash_env_variables/4cf80b4d: Test completed in 0.007456 seconds
bash_env_variables/4cf80b4d: Test completed with returncode: 0
bash_env_variables/4cf80b4d: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d/bash_env_variables.out
bash_env_variables/4cf80b4d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/4cf80b4d/bash_env_variables.err
csh_shell/c6d8dac6: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6/stage
csh_shell/c6d8dac6: Running Test via command: csh -e csh_shell_build.sh
csh_shell/c6d8dac6: Test completed in 4.202235 seconds
csh_shell/c6d8dac6: Test completed with returncode: 0
csh_shell/c6d8dac6: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6/csh_shell.out
csh_shell/c6d8dac6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/c6d8dac6/csh_shell.err
tcsh_env_declaration/1a5898f3: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3/stage
tcsh_env_declaration/1a5898f3: Running Test via command: csh -e tcsh_env_declaration_build.sh
tcsh_env_declaration/1a5898f3: Test completed in 2.096669 seconds
tcsh_env_declaration/1a5898f3: Test completed with returncode: 1
tcsh_env_declaration/1a5898f3: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3/tcsh_env_declaration.out
tcsh_env_declaration/1a5898f3: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/1a5898f3/tcsh_env_declaration.err
csh_env_declaration/f297dad8: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8/stage
csh_env_declaration/f297dad8: Running Test via command: csh -e csh_env_declaration_build.sh
csh_env_declaration/f297dad8: Test completed in 4.191337 seconds
csh_env_declaration/f297dad8: Test completed with returncode: 0
csh_env_declaration/f297dad8: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8/csh_env_declaration.out
csh_env_declaration/f297dad8: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/f297dad8/csh_env_declaration.err
In this iteration we are going to run the following tests: [bash_env_variables/4cf80b4d, csh_shell/c6d8dac6, tcsh_env_declaration/1a5898f3, csh_env_declaration/f297dad8]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ csh_shell/c6 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 4.202235 │
│ d8dac6 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ bash_env_var │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.007456 │
│ iables/4cf80 │ │ │ │ │ │
│ b4d │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ tcsh_env_dec │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 2.096669 │
│ laration/1a5 │ │ │ │ │ │
│ 898f3 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ csh_env_decl │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 4.191337 │
│ aration/f297 │ │ │ │ │ │
│ dad8 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 3/4 Percentage: 75.000%
Failed Tests: 1/4 Percentage: 25.000%
Adding 4 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_fogdjtwm.log
Note
The --executor option can be appended to discover tests by multiple executors.
Filtering Buildspecs¶
buildtest has support for filtering buildspecs based on certain attributes defined in buildspec file. Upon Discover Buildspecs, buildtest
will filter out tests or entire buildspec files. The buildtest build --filter option can be used to filter buildspecs which expects a single
key=value pair. Currently, buildtest can filter tests based on tags, type and maintainers.
To see all available filter fields you can run buildtest build --helpfilter and buildtest will
report the fields followed by description.
buildtest build --helpfilter
$ buildtest build --helpfilter
Buildtest Filters
┏━━━━━━━━━━━━━┳━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ Field ┃ Description ┃
┡━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ tags │ Filter tests by 'tag' field │
│ type │ Filter test by 'type' field │
│ maintainers │ Filter test by 'maintainers' field │
└─────────────┴────────────────────────────────────┘
In this example, we will discover all buildspecs based on tagname pass and then filter each test by tagname pass specified by --filter tags=pass.
buildtest build -t pass --filter tags=pass
$ buildtest build -t pass --filter tags=pass
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:24 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=pass
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
[exit1_fail][/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/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/v1.3/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/v1.3/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 2
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_pass/fc5b236f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f
exit1_pass/fc5b236f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f/stage
exit1_pass/fc5b236f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f/exit1_pass_build.sh
returncode_int_match/5692d86d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d
returncode_int_match/5692d86d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d/stage
returncode_int_match/5692d86d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
returncode_int_match/5692d86d does not have any dependencies adding test to queue
exit1_pass/fc5b236f does not have any dependencies adding test to queue
returncode_int_match/5692d86d: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d/stage
returncode_int_match/5692d86d: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/5692d86d: Test completed in 0.005442 seconds
returncode_int_match/5692d86d: Test completed with returncode: 128
returncode_int_match/5692d86d: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d/returncode_int_match.out
returncode_int_match/5692d86d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5692d86d/returncode_int_match.err
returncode_int_match/5692d86d: Checking returncode - 128 is matched in list [128]
exit1_pass/fc5b236f: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f/stage
exit1_pass/fc5b236f: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/fc5b236f: Test completed in 0.005075 seconds
exit1_pass/fc5b236f: Test completed with returncode: 1
exit1_pass/fc5b236f: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f/exit1_pass.out
exit1_pass/fc5b236f: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/fc5b236f/exit1_pass.err
exit1_pass/fc5b236f: Checking returncode - 1 is matched in list [1]
In this iteration we are going to run the following tests: [returncode_int_match/5692d86d, exit1_pass/fc5b236f]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005442 │
│ nt_match/569 │ │ │ False │ │ │
│ 2d86d │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/f │ generic.loc… │ PASS │ True False │ 1 │ 0.005075 │
│ c5b236f │ │ │ False │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%
Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_fds0n5cr.log
buildtest can run filter tests by maintainers, this can be useful if you want to run tests that you are maintainer. The maintainers field is
set per buildspec and not each test. You can filter maintiners via --filter maintainers=<MAINTAINER_NAME>. If the maintainers field is not specified
the buildspec will be filtered out if --filter maintainers is specified. In this next example, we will build all tests for maintainer
@shahzebsiddiqui.
buildtest build -b tutorials --filter maintainers=@shahzebsiddiqui
$ buildtest build -b tutorials --filter maintainers=@shahzebsiddiqui
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:25 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 52
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 52
────────────────────────────── Parsing Buildspecs ──────────────────────────────
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_scheduler.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/gcc_version.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/burstbuffer_datawarp_executors.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex3.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/add_numbers.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/tags_example.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_file_traverse_limit.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/csh_shell_examples.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ne.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/status_regex.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_lt.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_le.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq_exceptions.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/sleep.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_tests.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/summary_example.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/explicit_state.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/environment.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_exists_with_number.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_filetype.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/status_by_executors.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/regex_on_filename.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_buildspec.yml: skipping all test since 'skip' is defined
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/exists.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executors_var_env_declaration.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_range.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_gt.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ge.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex4.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/is_symlink.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex2.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/metrics_regex.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_regex_script.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_executor.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex1.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_and_dir_check.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shebang.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/contains.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/maintainers_example.yml: unable to find maintainer: @shahzebsiddiqui in buildspec which contains the following maintainers: ['@johndoe', '@bobsmith'] therefore we skip this test
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_pattern.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/runtime_status_test.yml: skipping test because 'maintainers' field is not specified in buildspec.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shell_examples.yml: skipping test because 'maintainers' field is not specified in buildspec.
Valid Buildspecs: 49
Invalid Buildspecs: 3
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/burstbuffer_datawarp_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_file_traverse_limit.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ne.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_lt.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_le.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq_exceptions.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_exists_with_number.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_filetype.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/regex_on_filename.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_buildspec.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/exists.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_range.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_gt.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ge.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/is_symlink.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_and_dir_check.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/contains.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_pattern.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_buildspec_section.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_exists_exception.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_tags.yml: INVALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ hello_w… │ script │ generic… │ None │ None │ None │ hello │ /home/… │
│ │ │ │ │ │ │ world │ │
│ │ │ │ │ │ │ example │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
hello_world/963ca3d2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2
hello_world/963ca3d2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2/stage
hello_world/963ca3d2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2/hello_world_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
hello_world/963ca3d2 does not have any dependencies adding test to queue
hello_world/963ca3d2: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2/stage
hello_world/963ca3d2: Running Test via command: bash --norc --noprofile -eo pipefail hello_world_build.sh
hello_world/963ca3d2: Test completed in 0.005478 seconds
hello_world/963ca3d2: Test completed with returncode: 0
hello_world/963ca3d2: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2/hello_world.out
hello_world/963ca3d2: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/963ca3d2/hello_world.err
In this iteration we are going to run the following tests: [hello_world/963ca3d2]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ hello_world/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.005478 │
│ 963ca3d2 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_n4vswnwj.log
Please see Query Maintainers (buildtest buildspec maintainers) on list of maintainers and breakdown of buildspecs by maintainers.
We can also filter tests by type field in the buildspec which corresponds to the schema type. In this next example, we filter all tests by script schema type by
passing option --filter type=script. We inform buildtest to stop after build stage (--stage=build) for more details see Configure Build Stages.
buildtest build -b tutorials --filter type=script --stage=build
$ buildtest build -b tutorials --filter type=script --stage=build
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:26 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 52
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 52
────────────────────────────── Parsing Buildspecs ──────────────────────────────
skip: skipping test due to 'skip' property.
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_buildspec.yml: skipping all test since 'skip' is defined
Valid Buildspecs: 49
Invalid Buildspecs: 3
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/maintainers_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/status_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/explicit_state.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/add_numbers.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/shebang.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/status_by_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_and_dir_check.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/is_symlink.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_lt.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/tags_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/runtime_status_test.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_le.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_exists_with_number.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/hello_world.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_scheduler.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/contains.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex4.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_gt.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/exists.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_executor.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ge.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_ne.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/burstbuffer_datawarp_executors.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex1.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex3.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/csh_shell_examples.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/sleep.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/gcc_version.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_tests.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/summary_example.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/skip_buildspec.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/regex_on_filename.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/environment.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executors_var_env_declaration.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_pattern.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_range.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/job_dependency/ex2.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/perf_checks/assert_eq_exceptions.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_filetype.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_count_file_traverse_limit.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/multi_executors/executor_regex_script.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/metrics_regex.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/file_exists_exception.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_tags.yml: INVALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_buildspec_section.yml: INVALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
└──────────────────────────────────────────────────────────────────────────────┘
Total builder objects created: 88
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ foo_bar… │ script │ generic… │ None │ None │ None │ prints │ /home/… │
│ │ │ │ │ │ │ variable │ │
│ │ │ │ │ │ │ $FOO │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ Pass │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ based on │ │
│ │ │ │ │ │ │ regular │ │
│ │ │ │ │ │ │ express… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ Pass │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ based on │ │
│ │ │ │ │ │ │ regular │ │
│ │ │ │ │ │ │ express… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ _bin_sh… │ script │ generic… │ None │ None │ None │ /bin/sh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ _bin_ba… │ script │ generic… │ None │ None │ None │ /bin/ba… │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ bash_sh… │ script │ generic… │ None │ None │ None │ bash │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ sh_shel… │ script │ generic… │ None │ None │ None │ sh shell │ /home/… │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ shell_o… │ script │ generic… │ None │ None │ None │ shell │ /home/… │
│ │ │ │ │ │ │ options │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ python_… │ script │ generic… │ None │ None │ None │ Hello │ /home/… │
│ │ │ │ │ │ │ World │ │
│ │ │ │ │ │ │ python │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ always_… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ always │ │
│ │ │ │ │ │ │ 'PASS' │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ always_… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ always │ │
│ │ │ │ │ │ │ 'FAIL' │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ test_fa… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ 'FAIL' │ │
│ │ │ │ │ │ │ even if │ │
│ │ │ │ │ │ │ we have │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ match │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ test_pa… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ 'PASS' │ │
│ │ │ │ │ │ │ even if │ │
│ │ │ │ │ │ │ we have │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ mismatch │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ add_num… │ script │ generic… │ None │ None │ None │ Add X+Y │ /home/… │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ bash_lo… │ script │ generic… │ None │ None │ None │ customi… │ /home/… │
│ │ │ │ │ │ │ shebang │ │
│ │ │ │ │ │ │ line │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ bash │ │
│ │ │ │ │ │ │ login │ │
│ │ │ │ │ │ │ shell │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ bash_no… │ script │ generic… │ None │ None │ None │ customi… │ /home/… │
│ │ │ │ │ │ │ shebang │ │
│ │ │ │ │ │ │ line │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ bash │ │
│ │ │ │ │ │ │ (nonlog… │ │
│ │ │ │ │ │ │ shell │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ define │ /home/… │
│ │ │ │ │ │ │ status │ │
│ │ │ │ │ │ │ per │ │
│ │ │ │ │ │ │ executor │ │
│ │ │ │ │ │ │ type. │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ define │ /home/… │
│ │ │ │ │ │ │ status │ │
│ │ │ │ │ │ │ per │ │
│ │ │ │ │ │ │ executor │ │
│ │ │ │ │ │ │ type. │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_an… │ script │ generic… │ None │ None │ None │ status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ for │ │
│ │ │ │ │ │ │ files │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ directo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ combine… │ script │ generic… │ None │ None │ None │ status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ for │ │
│ │ │ │ │ │ │ files │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ directo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ symlink… │ script │ generic… │ None │ None │ None │ status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ based on │ │
│ │ │ │ │ │ │ symbolic │ │
│ │ │ │ │ │ │ link │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Run │ /home/… │
│ │ │ │ │ │ │ stream │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ metrics │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ using │ │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ less │ │
│ │ │ │ │ │ │ than │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ string_… │ script │ generic… │ None │ None │ None │ tags can │ /home/… │
│ │ │ │ │ │ │ be a │ │
│ │ │ │ │ │ │ string │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ list_of… │ script │ generic… │ None │ None │ None │ tags can │ /home/… │
│ │ │ │ │ │ │ be a │ │
│ │ │ │ │ │ │ list of │ │
│ │ │ │ │ │ │ strings │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ timelim… │ script │ generic… │ None │ None │ None │ Run a │ /home/… │
│ │ │ │ │ │ │ sleep │ │
│ │ │ │ │ │ │ job for │ │
│ │ │ │ │ │ │ 2 │ │
│ │ │ │ │ │ │ seconds │ │
│ │ │ │ │ │ │ and test │ │
│ │ │ │ │ │ │ pass if │ │
│ │ │ │ │ │ │ its │ │
│ │ │ │ │ │ │ within │ │
│ │ │ │ │ │ │ 1.0-3.0… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ timelim… │ script │ generic… │ None │ None │ None │ Run a │ /home/… │
│ │ │ │ │ │ │ sleep │ │
│ │ │ │ │ │ │ job for │ │
│ │ │ │ │ │ │ 2 │ │
│ │ │ │ │ │ │ seconds │ │
│ │ │ │ │ │ │ and test │ │
│ │ │ │ │ │ │ pass if │ │
│ │ │ │ │ │ │ its │ │
│ │ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ │ min time │ │
│ │ │ │ │ │ │ of 1.0 │ │
│ │ │ │ │ │ │ sec │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ timelim… │ script │ generic… │ None │ None │ None │ Run a │ /home/… │
│ │ │ │ │ │ │ sleep │ │
│ │ │ │ │ │ │ job for │ │
│ │ │ │ │ │ │ 2 │ │
│ │ │ │ │ │ │ seconds │ │
│ │ │ │ │ │ │ and test │ │
│ │ │ │ │ │ │ pass if │ │
│ │ │ │ │ │ │ it's │ │
│ │ │ │ │ │ │ within │ │
│ │ │ │ │ │ │ max │ │
│ │ │ │ │ │ │ time: │ │
│ │ │ │ │ │ │ 5.0 sec │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ timelim… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ fails │ │
│ │ │ │ │ │ │ because │ │
│ │ │ │ │ │ │ it runs │ │
│ │ │ │ │ │ │ less │ │
│ │ │ │ │ │ │ than │ │
│ │ │ │ │ │ │ mintime │ │
│ │ │ │ │ │ │ of 10 │ │
│ │ │ │ │ │ │ second │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ timelim… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ fails │ │
│ │ │ │ │ │ │ because │ │
│ │ │ │ │ │ │ it │ │
│ │ │ │ │ │ │ exceeds │ │
│ │ │ │ │ │ │ maxtime │ │
│ │ │ │ │ │ │ of 1.0 │ │
│ │ │ │ │ │ │ second │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Run │ /home/… │
│ │ │ │ │ │ │ stream │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ metrics │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ using │ │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ less │ │
│ │ │ │ │ │ │ than │ │
│ │ │ │ │ │ │ equal │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_ex… │ script │ generic… │ None │ None │ None │ this │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ pass │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ hello_w… │ script │ generic… │ None │ None │ None │ hello │ /home/… │
│ │ │ │ │ │ │ world │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ executo… │ script │ generic… │ None │ None │ None │ Declari… │ /home/… │
│ │ │ │ │ │ │ env and │ │
│ │ │ │ │ │ │ vars by │ │
│ │ │ │ │ │ │ executo… │ │
│ │ │ │ │ │ │ section │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ executo… │ script │ generic… │ None │ None │ None │ Declari… │ /home/… │
│ │ │ │ │ │ │ env and │ │
│ │ │ │ │ │ │ vars by │ │
│ │ │ │ │ │ │ executo… │ │
│ │ │ │ │ │ │ section │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_co… │ script │ generic… │ None │ None │ None │ file │ /home/… │
│ │ │ │ │ │ │ count │ │
│ │ │ │ │ │ │ check in │ │
│ │ │ │ │ │ │ directo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_co… │ script │ generic… │ None │ None │ None │ file │ /home/… │
│ │ │ │ │ │ │ count by │ │
│ │ │ │ │ │ │ extensi… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ contain… │ script │ generic… │ None │ None │ None │ Status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ based on │ │
│ │ │ │ │ │ │ contains │ │
│ │ │ │ │ │ │ and not │ │
│ │ │ │ │ │ │ contains │ │
│ │ │ │ │ │ │ where │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ pass │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ based on │ │
│ │ │ │ │ │ │ contains │ │
│ │ │ │ │ │ │ where │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ fails │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ runtime… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ sleep 5 │ │
│ │ │ │ │ │ │ second │ │
│ │ │ │ │ │ │ but will │ │
│ │ │ │ │ │ │ fail due │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ runtime │ │
│ │ │ │ │ │ │ 2sec │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ runtime… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ when │ │
│ │ │ │ │ │ │ runtime… │ │
│ │ │ │ │ │ │ is PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ runtime… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ when │ │
│ │ │ │ │ │ │ runtime… │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Run │ /home/… │
│ │ │ │ │ │ │ stream │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ metrics │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ using │ │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ greater │ │
│ │ │ │ │ │ │ than. │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ based │ │
│ │ │ │ │ │ │ for file │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ directo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ status_… │ script │ generic… │ None │ None │ None │ status │ /home/… │
│ │ │ │ │ │ │ check │ │
│ │ │ │ │ │ │ failure │ │
│ │ │ │ │ │ │ for │ │
│ │ │ │ │ │ │ existen… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ stream_… │ script │ generic… │ None │ None │ None │ Run │ /home/… │
│ │ │ │ │ │ │ stream │ │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ metrics │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ using │ │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ greater │ │
│ │ │ │ │ │ │ equal │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Test for │ /home/… │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ not │ │
│ │ │ │ │ │ │ equal │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ create_… │ script │ generic… │ None │ None │ None │ Create a │ /home/… │
│ │ │ │ │ │ │ burst │ │
│ │ │ │ │ │ │ buffer │ │
│ │ │ │ │ │ │ for │ │
│ │ │ │ │ │ │ multiple │ │
│ │ │ │ │ │ │ executo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ create_… │ script │ generic… │ None │ None │ None │ Create a │ /home/… │
│ │ │ │ │ │ │ burst │ │
│ │ │ │ │ │ │ buffer │ │
│ │ │ │ │ │ │ for │ │
│ │ │ │ │ │ │ multiple │ │
│ │ │ │ │ │ │ executo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ jobA/25… │ script │ generic… │ None │ None │ None │ no job │ /home/… │
│ │ │ │ │ │ │ depende… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ jobB/59… │ script │ generic… │ None │ None │ None │ job │ /home/… │
│ │ │ │ │ │ │ depende… │ │
│ │ │ │ │ │ │ on jobA │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ jobC/97… │ script │ generic… │ None │ None │ None │ job │ /home/… │
│ │ │ │ │ │ │ depende… │ │
│ │ │ │ │ │ │ on jobA │ │
│ │ │ │ │ │ │ and jobB │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ pass_te… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ always │ │
│ │ │ │ │ │ │ pass │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ fail_te… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ if test │ │
│ │ │ │ │ │ │ 'pass_t… │ │
│ │ │ │ │ │ │ is in │ │
│ │ │ │ │ │ │ state │ │
│ │ │ │ │ │ │ 'PASS' │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ pass_an… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ if │ │
│ │ │ │ │ │ │ pass_te… │ │
│ │ │ │ │ │ │ is │ │
│ │ │ │ │ │ │ 'PASS' │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ fail_te… │ │
│ │ │ │ │ │ │ is │ │
│ │ │ │ │ │ │ 'FAIL' │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ final_t… │ script │ generic… │ None │ None │ None │ Test │ /home/… │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ after │ │
│ │ │ │ │ │ │ 'pass_t… │ │
│ │ │ │ │ │ │ 'fail_t… │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ 'pass_a… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ csh_she… │ script │ generic… │ None │ None │ None │ csh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ sleep/3… │ script │ generic… │ None │ None │ None │ sleep 2 │ /home/… │
│ │ │ │ │ │ │ seconds │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ gcc_ver… │ script │ generic… │ None │ None │ None │ Print │ /home/… │
│ │ │ │ │ │ │ gcc │ │
│ │ │ │ │ │ │ version │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ unskipp… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test is │ │
│ │ │ │ │ │ │ not │ │
│ │ │ │ │ │ │ skipped │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ summary… │ script │ generic… │ None │ None │ None │ The │ /home/… │
│ │ │ │ │ │ │ summary │ │
│ │ │ │ │ │ │ field │ │
│ │ │ │ │ │ │ can be a │ │
│ │ │ │ │ │ │ multi-l… │ │
│ │ │ │ │ │ │ string │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ exceed │ │
│ │ │ │ │ │ │ 80 char │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ regex_o… │ script │ generic… │ None │ None │ None │ Test │ /home/… │
│ │ │ │ │ │ │ regex on │ │
│ │ │ │ │ │ │ multiple │ │
│ │ │ │ │ │ │ files │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ regex_o… │ script │ generic… │ None │ None │ None │ Test │ /home/… │
│ │ │ │ │ │ │ regex on │ │
│ │ │ │ │ │ │ directo… │ │
│ │ │ │ │ │ │ is not │ │
│ │ │ │ │ │ │ support… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_ex… │ script │ generic… │ None │ None │ None │ Test │ /home/… │
│ │ │ │ │ │ │ regex │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ variable │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ expansi… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ bash_en… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ (bash) │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ csh_env… │ script │ generic… │ None │ None │ None │ csh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ declare │ │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ tcsh_en… │ script │ generic… │ None │ None │ None │ tcsh │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ example │ │
│ │ │ │ │ │ │ to │ │
│ │ │ │ │ │ │ declare │ │
│ │ │ │ │ │ │ environ… │ │
│ │ │ │ │ │ │ variabl… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ executo… │ script │ generic… │ None │ None │ None │ Declari… │ /home/… │
│ │ │ │ │ │ │ env and │ │
│ │ │ │ │ │ │ vars by │ │
│ │ │ │ │ │ │ executo… │ │
│ │ │ │ │ │ │ section │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ executo… │ script │ generic… │ None │ None │ None │ Declari… │ /home/… │
│ │ │ │ │ │ │ env and │ │
│ │ │ │ │ │ │ vars by │ │
│ │ │ │ │ │ │ executo… │ │
│ │ │ │ │ │ │ section │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_co… │ script │ generic… │ None │ None │ None │ file │ /home/… │
│ │ │ │ │ │ │ count by │ │
│ │ │ │ │ │ │ express… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_ex… │ script │ generic… │ None │ None │ None │ file │ /home/… │
│ │ │ │ │ │ │ count by │ │
│ │ │ │ │ │ │ file │ │
│ │ │ │ │ │ │ extensi… │ │
│ │ │ │ │ │ │ and file │ │
│ │ │ │ │ │ │ pattern │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Example │ /home/… │
│ │ │ │ │ │ │ on │ │
│ │ │ │ │ │ │ assert_… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ test1/9… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ pass │ │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ exit 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ test2/6… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ if test1 │ │
│ │ │ │ │ │ │ has │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ test3/c… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will run │ │
│ │ │ │ │ │ │ if test1 │ │
│ │ │ │ │ │ │ has │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 and │ │
│ │ │ │ │ │ │ test2 │ │
│ │ │ │ │ │ │ has │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 2 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ Test for │ /home/… │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ equality │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ An │ /home/… │
│ │ │ │ │ │ │ invalid │ │
│ │ │ │ │ │ │ metric │ │
│ │ │ │ │ │ │ name │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ cause │ │
│ │ │ │ │ │ │ failure │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ assert_… │ script │ generic… │ None │ None │ None │ This │ /home/… │
│ │ │ │ │ │ │ test │ │
│ │ │ │ │ │ │ will │ │
│ │ │ │ │ │ │ fail │ │
│ │ │ │ │ │ │ because │ │
│ │ │ │ │ │ │ there is │ │
│ │ │ │ │ │ │ a │ │
│ │ │ │ │ │ │ mismatch │ │
│ │ │ │ │ │ │ in │ │
│ │ │ │ │ │ │ metric x │ │
│ │ │ │ │ │ │ assert │ │
│ │ │ │ │ │ │ equality │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_co… │ script │ generic… │ None │ None │ None │ Count │ /home/… │
│ │ │ │ │ │ │ the │ │
│ │ │ │ │ │ │ number │ │
│ │ │ │ │ │ │ of │ │
│ │ │ │ │ │ │ directo… │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ symbolic │ │
│ │ │ │ │ │ │ links │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ file_tr… │ script │ generic… │ None │ None │ None │ Use of │ /home/… │
│ │ │ │ │ │ │ file_tr… │ │
│ │ │ │ │ │ │ to limit │ │
│ │ │ │ │ │ │ number │ │
│ │ │ │ │ │ │ of files │ │
│ │ │ │ │ │ │ searched │ │
│ │ │ │ │ │ │ in a │ │
│ │ │ │ │ │ │ directo… │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ multipl… │ script │ generic… │ None │ None │ None │ run test │ /home/… │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ executor │ │
│ │ │ │ │ │ │ generic… │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ generic… │ │
│ │ │ │ │ │ │ executor │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ multipl… │ script │ generic… │ None │ None │ None │ run test │ /home/… │
│ │ │ │ │ │ │ with │ │
│ │ │ │ │ │ │ executor │ │
│ │ │ │ │ │ │ generic… │ │
│ │ │ │ │ │ │ and │ │
│ │ │ │ │ │ │ generic… │ │
│ │ │ │ │ │ │ executor │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ metric_… │ script │ generic… │ None │ None │ None │ capture │ /home/… │
│ │ │ │ │ │ │ result │ │
│ │ │ │ │ │ │ metric │ │
│ │ │ │ │ │ │ from │ │
│ │ │ │ │ │ │ output │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
foo_bar/926d564d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/maintainers_example/foo_bar/926d564d
foo_bar/926d564d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/maintainers_example/foo_bar/926d564d/stage
foo_bar/926d564d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/maintainers_example/foo_bar/926d564d/foo_bar_build.sh
status_regex_pass/54d545b5: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_pass/54d545b5
status_regex_pass/54d545b5: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_pass/54d545b5/stage
status_regex_pass/54d545b5: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_pass/54d545b5/status_regex_pass_build.sh
status_regex_fail/963c1b74: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_fail/963c1b74
status_regex_fail/963c1b74: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_fail/963c1b74/stage
status_regex_fail/963c1b74: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_regex/status_regex_fail/963c1b74/status_regex_fail_build.sh
_bin_sh_shell/a662c7ab: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/a662c7ab
_bin_sh_shell/a662c7ab: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/a662c7ab/stage
_bin_sh_shell/a662c7ab: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/_bin_sh_shell/a662c7ab/_bin_sh_shell_build.sh
_bin_bash_shell/92d3fa48: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/92d3fa48
_bin_bash_shell/92d3fa48: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/92d3fa48/stage
_bin_bash_shell/92d3fa48: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/_bin_bash_shell/92d3fa48/_bin_bash_shell_build.sh
bash_shell/87a0fdd2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/bash_shell/87a0fdd2
bash_shell/87a0fdd2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/bash_shell/87a0fdd2/stage
bash_shell/87a0fdd2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shell_examples/bash_shell/87a0fdd2/bash_shell_build.sh
sh_shell/19fb9251: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/sh_shell/19fb9251
sh_shell/19fb9251: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/sh_shell/19fb9251/stage
sh_shell/19fb9251: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/sh_shell/19fb9251/sh_shell_build.sh
shell_options/c752b6a8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/shell_options/c752b6a8
shell_options/c752b6a8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/shell_options/c752b6a8/stage
shell_options/c752b6a8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/shell_examples/shell_options/c752b6a8/shell_options_build.sh
python_hello/0ffcff34: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/0ffcff34
python_hello/0ffcff34: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/0ffcff34/stage
python_hello/0ffcff34: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/0ffcff34/python_hello_build.sh
always_pass/421e6d59: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_pass/421e6d59
always_pass/421e6d59: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_pass/421e6d59/stage
always_pass/421e6d59: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_pass/421e6d59/always_pass_build.sh
always_fail/e19181fa: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_fail/e19181fa
always_fail/e19181fa: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_fail/e19181fa/stage
always_fail/e19181fa: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/always_fail/e19181fa/always_fail_build.sh
test_fail_returncode_match/3fa40a07: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/3fa40a07
test_fail_returncode_match/3fa40a07: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/3fa40a07/stage
test_fail_returncode_match/3fa40a07: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_fail_returncode_match/3fa40a07/test_fail_returncode_match_build.sh
test_pass_returncode_mismatch/50dbcd70: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/50dbcd70
test_pass_returncode_mismatch/50dbcd70: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/50dbcd70/stage
test_pass_returncode_mismatch/50dbcd70: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/explicit_state/test_pass_returncode_mismatch/50dbcd70/test_pass_returncode_mismatch_build.sh
add_numbers/5d36272c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/add_numbers/add_numbers/5d36272c
add_numbers/5d36272c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/add_numbers/add_numbers/5d36272c/stage
add_numbers/5d36272c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/add_numbers/add_numbers/5d36272c/add_numbers_build.sh
bash_login_shebang/8c65b055: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_login_shebang/8c65b055
bash_login_shebang/8c65b055: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_login_shebang/8c65b055/stage
bash_login_shebang/8c65b055: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_login_shebang/8c65b055/bash_login_shebang_build.sh
bash_nonlogin_shebang/91a134dc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/91a134dc
bash_nonlogin_shebang/91a134dc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/91a134dc/stage
bash_nonlogin_shebang/91a134dc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/shebang/bash_nonlogin_shebang/91a134dc/bash_nonlogin_shebang_build.sh
status_returncode_by_executors/c9b8042d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/c9b8042d
status_returncode_by_executors/c9b8042d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/c9b8042d/stage
status_returncode_by_executors/c9b8042d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/status_by_executors/status_returncode_by_executors/c9b8042d/status_returncode_by_executors_build.sh
status_returncode_by_executors/6f470c64: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/6f470c64
status_returncode_by_executors/6f470c64: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/6f470c64/stage
status_returncode_by_executors/6f470c64: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/status_by_executors/status_returncode_by_executors/6f470c64/status_returncode_by_executors_build.sh
file_and_dir_checks/c84e8acc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/file_and_dir_checks/c84e8acc
file_and_dir_checks/c84e8acc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/file_and_dir_checks/c84e8acc/stage
file_and_dir_checks/c84e8acc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/file_and_dir_checks/c84e8acc/file_and_dir_checks_build.sh
combined_file_and_dir_checks/64c7284e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/combined_file_and_dir_checks/64c7284e
combined_file_and_dir_checks/64c7284e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/combined_file_and_dir_checks/64c7284e/stage
combined_file_and_dir_checks/64c7284e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_and_dir_check/combined_file_and_dir_checks/64c7284e/combined_file_and_dir_checks_build.sh
symlink_test/63e26eb9: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/is_symlink/symlink_test/63e26eb9
symlink_test/63e26eb9: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/is_symlink/symlink_test/63e26eb9/stage
symlink_test/63e26eb9: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/is_symlink/symlink_test/63e26eb9/symlink_test_build.sh
assert_lt_example/69938360: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_lt/assert_lt_example/69938360
assert_lt_example/69938360: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_lt/assert_lt_example/69938360/stage
assert_lt_example/69938360: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_lt/assert_lt_example/69938360/assert_lt_example_build.sh
string_tag/426ec03c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/426ec03c
string_tag/426ec03c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/426ec03c/stage
string_tag/426ec03c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/string_tag/426ec03c/string_tag_build.sh
list_of_strings_tags/a20320f3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/a20320f3
list_of_strings_tags/a20320f3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/a20320f3/stage
list_of_strings_tags/a20320f3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/tags_example/list_of_strings_tags/a20320f3/list_of_strings_tags_build.sh
timelimit_min_max/f48d446c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/f48d446c
timelimit_min_max/f48d446c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/f48d446c/stage
timelimit_min_max/f48d446c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_max/f48d446c/timelimit_min_max_build.sh
timelimit_min/fdae2dad: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min/fdae2dad
timelimit_min/fdae2dad: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min/fdae2dad/stage
timelimit_min/fdae2dad: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min/fdae2dad/timelimit_min_build.sh
timelimit_max/edbf2d04: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max/edbf2d04
timelimit_max/edbf2d04: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max/edbf2d04/stage
timelimit_max/edbf2d04: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max/edbf2d04/timelimit_max_build.sh
timelimit_min_fail/b5474ae3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/b5474ae3
timelimit_min_fail/b5474ae3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/b5474ae3/stage
timelimit_min_fail/b5474ae3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_min_fail/b5474ae3/timelimit_min_fail_build.sh
timelimit_max_fail/930643cf: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/930643cf
timelimit_max_fail/930643cf: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/930643cf/stage
timelimit_max_fail/930643cf: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/runtime_status_test/timelimit_max_fail/930643cf/timelimit_max_fail_build.sh
assert_le_example/1a019bdc: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_le/assert_le_example/1a019bdc
assert_le_example/1a019bdc: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_le/assert_le_example/1a019bdc/stage
assert_le_example/1a019bdc: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_le/assert_le_example/1a019bdc/assert_le_example_build.sh
file_exists_pass/9b8778fb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_exists_with_number/file_exists_pass/9b8778fb
file_exists_pass/9b8778fb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_exists_with_number/file_exists_pass/9b8778fb/stage
file_exists_pass/9b8778fb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_exists_with_number/file_exists_pass/9b8778fb/file_exists_pass_build.sh
hello_world/b609fb9a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/b609fb9a
hello_world/b609fb9a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/b609fb9a/stage
hello_world/b609fb9a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/hello_world/hello_world/b609fb9a/hello_world_build.sh
executors_sbatch_declaration/9358b73a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/9358b73a
executors_sbatch_declaration/9358b73a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/9358b73a/stage
executors_sbatch_declaration/9358b73a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_scheduler/executors_sbatch_declaration/9358b73a/executors_sbatch_declaration_build.sh
executors_sbatch_declaration/cac99819: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/cac99819
executors_sbatch_declaration/cac99819: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/cac99819/stage
executors_sbatch_declaration/cac99819: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_scheduler/executors_sbatch_declaration/cac99819/executors_sbatch_declaration_build.sh
file_count_on_directory/3c5e908f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_on_directory/3c5e908f
file_count_on_directory/3c5e908f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_on_directory/3c5e908f/stage
file_count_on_directory/3c5e908f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_on_directory/3c5e908f/file_count_on_directory_build.sh
file_count_by_extension/fa89140a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_by_extension/fa89140a
file_count_by_extension/fa89140a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_by_extension/fa89140a/stage
file_count_by_extension/fa89140a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count/file_count_by_extension/fa89140a/file_count_by_extension_build.sh
contains_and_not_contains/8c435956: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/contains_and_not_contains/8c435956
contains_and_not_contains/8c435956: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/contains_and_not_contains/8c435956/stage
contains_and_not_contains/8c435956: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/contains_and_not_contains/8c435956/contains_and_not_contains_build.sh
assert_contains_fail/5b7137fa: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/assert_contains_fail/5b7137fa
assert_contains_fail/5b7137fa: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/assert_contains_fail/5b7137fa/stage
assert_contains_fail/5b7137fa: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/contains/assert_contains_fail/5b7137fa/assert_contains_fail_build.sh
runtime_test/44e1df9a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test/44e1df9a
runtime_test/44e1df9a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test/44e1df9a/stage
runtime_test/44e1df9a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test/44e1df9a/runtime_test_build.sh
runtime_test_pass/9d206b0d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_pass/9d206b0d
runtime_test_pass/9d206b0d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_pass/9d206b0d/stage
runtime_test_pass/9d206b0d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_pass/9d206b0d/runtime_test_pass_build.sh
runtime_test_fail/87fd6d22: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_fail/87fd6d22
runtime_test_fail/87fd6d22: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_fail/87fd6d22/stage
runtime_test_fail/87fd6d22: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex4/runtime_test_fail/87fd6d22/runtime_test_fail_build.sh
assert_gt_example/a8bc5886: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_gt/assert_gt_example/a8bc5886
assert_gt_example/a8bc5886: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_gt/assert_gt_example/a8bc5886/stage
assert_gt_example/a8bc5886: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_gt/assert_gt_example/a8bc5886/assert_gt_example_build.sh
status_exists/f0a49d7d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists/f0a49d7d
status_exists/f0a49d7d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists/f0a49d7d/stage
status_exists/f0a49d7d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists/f0a49d7d/status_exists_build.sh
status_exists_failure/cf0bb080: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists_failure/cf0bb080
status_exists_failure/cf0bb080: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists_failure/cf0bb080/stage
status_exists_failure/cf0bb080: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/exists/status_exists_failure/cf0bb080/status_exists_failure_build.sh
stream_test/a7203077: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ge/stream_test/a7203077
stream_test/a7203077: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ge/stream_test/a7203077/stage
stream_test/a7203077: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ge/stream_test/a7203077/stream_test_build.sh
assert_ne_example/9b9bc6e8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ne/assert_ne_example/9b9bc6e8
assert_ne_example/9b9bc6e8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ne/assert_ne_example/9b9bc6e8/stage
assert_ne_example/9b9bc6e8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_ne/assert_ne_example/9b9bc6e8/assert_ne_example_build.sh
create_burst_buffer_executors/5c17c200: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/5c17c200
create_burst_buffer_executors/5c17c200: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/5c17c200/stage
create_burst_buffer_executors/5c17c200: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/burstbuffer_datawarp_executors/create_burst_buffer_executors/5c17c200/create_burst_buffer_executors_build.sh
create_burst_buffer_executors/c0b3848f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/c0b3848f
create_burst_buffer_executors/c0b3848f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/c0b3848f/stage
create_burst_buffer_executors/c0b3848f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/burstbuffer_datawarp_executors/create_burst_buffer_executors/c0b3848f/create_burst_buffer_executors_build.sh
jobA/25f9e797: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobA/25f9e797
jobA/25f9e797: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobA/25f9e797/stage
jobA/25f9e797: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobA/25f9e797/jobA_build.sh
jobB/59488983: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobB/59488983
jobB/59488983: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobB/59488983/stage
jobB/59488983: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobB/59488983/jobB_build.sh
jobC/97b9211a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobC/97b9211a
jobC/97b9211a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobC/97b9211a/stage
jobC/97b9211a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex1/jobC/97b9211a/jobC_build.sh
circle_area/00febb5b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/00febb5b
circle_area/00febb5b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/00febb5b/stage
circle_area/00febb5b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/00febb5b/circle_area_build.sh
pass_test/3a628fe3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_test/3a628fe3
pass_test/3a628fe3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_test/3a628fe3/stage
pass_test/3a628fe3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_test/3a628fe3/pass_test_build.sh
fail_test/bf5102f9: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/fail_test/bf5102f9
fail_test/bf5102f9: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/fail_test/bf5102f9/stage
fail_test/bf5102f9: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/fail_test/bf5102f9/fail_test_build.sh
pass_and_fail_test/f3fe886b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_and_fail_test/f3fe886b
pass_and_fail_test/f3fe886b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_and_fail_test/f3fe886b/stage
pass_and_fail_test/f3fe886b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/pass_and_fail_test/f3fe886b/pass_and_fail_test_build.sh
final_test/46005c92: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/final_test/46005c92
final_test/46005c92: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/final_test/46005c92/stage
final_test/46005c92: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex3/final_test/46005c92/final_test_build.sh
csh_shell/a2e5a89e: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a2e5a89e
csh_shell/a2e5a89e: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a2e5a89e/stage
csh_shell/a2e5a89e: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/csh_shell_examples/csh_shell/a2e5a89e/csh_shell_build.sh
sleep/35d474d0: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/35d474d0
sleep/35d474d0: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/35d474d0/stage
sleep/35d474d0: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/35d474d0/sleep_build.sh
exit1_fail/1e5399bb: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/1e5399bb
exit1_fail/1e5399bb: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/1e5399bb/stage
exit1_fail/1e5399bb: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/1e5399bb/exit1_fail_build.sh
exit1_pass/5428735c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/5428735c
exit1_pass/5428735c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/5428735c/stage
exit1_pass/5428735c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/5428735c/exit1_pass_build.sh
returncode_list_mismatch/04cb46cd: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/04cb46cd
returncode_list_mismatch/04cb46cd: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/04cb46cd/stage
returncode_list_mismatch/04cb46cd: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/04cb46cd/returncode_list_mismatch_build.sh
returncode_int_match/5221221b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5221221b
returncode_int_match/5221221b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5221221b/stage
returncode_int_match/5221221b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/5221221b/returncode_int_match_build.sh
gcc_version/a55e3d3c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/gcc_version/gcc_version/a55e3d3c
gcc_version/a55e3d3c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/gcc_version/gcc_version/a55e3d3c/stage
gcc_version/a55e3d3c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/gcc_version/gcc_version/a55e3d3c/gcc_version_build.sh
unskipped/bae7dc06: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/skip_tests/unskipped/bae7dc06
unskipped/bae7dc06: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/skip_tests/unskipped/bae7dc06/stage
unskipped/bae7dc06: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/skip_tests/unskipped/bae7dc06/unskipped_build.sh
summary_example/57370da6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/summary_example/summary_example/57370da6
summary_example/57370da6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/summary_example/summary_example/57370da6/stage
summary_example/57370da6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/summary_example/summary_example/57370da6/summary_example_build.sh
regex_on_multiple_files/cf0ed98b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_multiple_files/cf0ed98b
regex_on_multiple_files/cf0ed98b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_multiple_files/cf0ed98b/stage
regex_on_multiple_files/cf0ed98b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_multiple_files/cf0ed98b/regex_on_multiple_files_build.sh
regex_on_directory_not_supported/6f6f40b1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_directory_not_supported/6f6f40b1
regex_on_directory_not_supported/6f6f40b1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_directory_not_supported/6f6f40b1/stage
regex_on_directory_not_supported/6f6f40b1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/regex_on_directory_not_supported/6f6f40b1/regex_on_directory_not_supported_build.sh
file_expansion_supported/674c1057: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/file_expansion_supported/674c1057
file_expansion_supported/674c1057: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/file_expansion_supported/674c1057/stage
file_expansion_supported/674c1057: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/regex_on_filename/file_expansion_supported/674c1057/file_expansion_supported_build.sh
bash_env_variables/22778a40: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/22778a40
bash_env_variables/22778a40: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/22778a40/stage
bash_env_variables/22778a40: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/environment/bash_env_variables/22778a40/bash_env_variables_build.sh
csh_env_declaration/74f4c994: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/74f4c994
csh_env_declaration/74f4c994: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/74f4c994/stage
csh_env_declaration/74f4c994: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/csh_env_declaration/74f4c994/csh_env_declaration_build.sh
tcsh_env_declaration/4b3b9c36: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/4b3b9c36
tcsh_env_declaration/4b3b9c36: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/4b3b9c36/stage
tcsh_env_declaration/4b3b9c36: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.csh/environment/tcsh_env_declaration/4b3b9c36/tcsh_env_declaration_build.sh
executors_vars_env_declaration/e0e7728f: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e0e7728f
executors_vars_env_declaration/e0e7728f: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e0e7728f/stage
executors_vars_env_declaration/e0e7728f: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executors_var_env_declaration/executors_vars_env_declaration/e0e7728f/executors_vars_env_declaration_build.sh
executors_vars_env_declaration/4446fe07: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/4446fe07
executors_vars_env_declaration/4446fe07: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/4446fe07/stage
executors_vars_env_declaration/4446fe07: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executors_var_env_declaration/executors_vars_env_declaration/4446fe07/executors_vars_env_declaration_build.sh
file_count_by_expression/359d56ca: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_count_by_expression/359d56ca
file_count_by_expression/359d56ca: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_count_by_expression/359d56ca/stage
file_count_by_expression/359d56ca: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_count_by_expression/359d56ca/file_count_by_expression_build.sh
file_extension_and_filepattern/68558f4d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_extension_and_filepattern/68558f4d
file_extension_and_filepattern/68558f4d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_extension_and_filepattern/68558f4d/stage
file_extension_and_filepattern/68558f4d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_pattern/file_extension_and_filepattern/68558f4d/file_extension_and_filepattern_build.sh
assert_range_ex/50b2fa0a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_range/assert_range_ex/50b2fa0a
assert_range_ex/50b2fa0a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_range/assert_range_ex/50b2fa0a/stage
assert_range_ex/50b2fa0a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_range/assert_range_ex/50b2fa0a/assert_range_ex_build.sh
test1/9124c39a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test1/9124c39a
test1/9124c39a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test1/9124c39a/stage
test1/9124c39a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test1/9124c39a/test1_build.sh
test2/65ab2b20: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test2/65ab2b20
test2/65ab2b20: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test2/65ab2b20/stage
test2/65ab2b20: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test2/65ab2b20/test2_build.sh
test3/cc5ebbb8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test3/cc5ebbb8
test3/cc5ebbb8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test3/cc5ebbb8/stage
test3/cc5ebbb8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/ex2/test3/cc5ebbb8/test3_build.sh
assert_eq_example/b6259eb8: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq/assert_eq_example/b6259eb8
assert_eq_example/b6259eb8: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq/assert_eq_example/b6259eb8/stage
assert_eq_example/b6259eb8: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq/assert_eq_example/b6259eb8/assert_eq_example_build.sh
assert_eq_invalid_metric/3b876b76: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_invalid_metric/3b876b76
assert_eq_invalid_metric/3b876b76: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_invalid_metric/3b876b76/stage
assert_eq_invalid_metric/3b876b76: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_invalid_metric/3b876b76/assert_eq_invalid_metric_build.sh
assert_eq_mismatch/98a77773: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_mismatch/98a77773
assert_eq_mismatch/98a77773: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_mismatch/98a77773/stage
assert_eq_mismatch/98a77773: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/assert_eq_exceptions/assert_eq_mismatch/98a77773/assert_eq_mismatch_build.sh
file_count_by_filetype/7c82f46a: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_filetype/file_count_by_filetype/7c82f46a
file_count_by_filetype/7c82f46a: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_filetype/file_count_by_filetype/7c82f46a/stage
file_count_by_filetype/7c82f46a: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_filetype/file_count_by_filetype/7c82f46a/file_count_by_filetype_build.sh
file_traverse_limit/faa5c9f3: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_file_traverse_limit/file_traverse_limit/faa5c9f3
file_traverse_limit/faa5c9f3: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_file_traverse_limit/file_traverse_limit/faa5c9f3/stage
file_traverse_limit/faa5c9f3: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/file_count_file_traverse_limit/file_traverse_limit/faa5c9f3/file_traverse_limit_build.sh
variables_bash/f9c48577: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/f9c48577
variables_bash/f9c48577: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/f9c48577/stage
variables_bash/f9c48577: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/f9c48577/variables_bash_build.sh
multiple_executors/00740096: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_regex_script/multiple_executors/00740096
multiple_executors/00740096: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_regex_script/multiple_executors/00740096/stage
multiple_executors/00740096: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/executor_regex_script/multiple_executors/00740096/multiple_executors_build.sh
multiple_executors/96abb62b: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_regex_script/multiple_executors/96abb62b
multiple_executors/96abb62b: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_regex_script/multiple_executors/96abb62b/stage
multiple_executors/96abb62b: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/executor_regex_script/multiple_executors/96abb62b/multiple_executors_build.sh
metric_regex_example/fede4021: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/metrics_regex/metric_regex_example/fede4021
metric_regex_example/fede4021: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/metrics_regex/metric_regex_example/fede4021/stage
metric_regex_example/fede4021: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.sh/metrics_regex/metric_regex_example/fede4021/metric_regex_example_build.sh
Filter By Executor Type¶
In a HPC environment, you may want to run test locally on a login node or perhaps you only want to run batch jobs given a list of buildspecs specified on command line.
This can be done in buildtest via option buildtest build –executor-type which takes one of two values local or batch. If you want to filter all tests
by local executor you can do buildtest build --executor-type local. buildtest will filter test based on the executor property defined in the buildspec. Let’s assume
we want to run all test by python tag on local executor you can do the following:
buildtest build -t python --executor-type local
$ buildtest build -t python --executor-type local
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:27 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 2
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
Total builder objects created: 2
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ python_… │ script │ generic… │ None │ None │ None │ Hello │ /home/… │
│ │ │ │ │ │ │ World │ │
│ │ │ │ │ │ │ python │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
circle_area/bc12a181: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181
circle_area/bc12a181: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181/stage
circle_area/bc12a181: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181/circle_area_build.sh
python_hello/c960b7ca: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca
python_hello/c960b7ca: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca/stage
python_hello/c960b7ca: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca/python_hello_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
circle_area/bc12a181 does not have any dependencies adding test to queue
python_hello/c960b7ca does not have any dependencies adding test to queue
circle_area/bc12a181: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181/stage
circle_area/bc12a181: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/bc12a181: Test completed in 0.03024 seconds
circle_area/bc12a181: Test completed with returncode: 0
circle_area/bc12a181: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181/circle_area.out
circle_area/bc12a181: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/bc12a181/circle_area.err
python_hello/c960b7ca: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca/stage
python_hello/c960b7ca: Running Test via command: bash --norc --noprofile -eo pipefail python_hello_build.sh
python_hello/c960b7ca: Test completed in 0.029029 seconds
python_hello/c960b7ca: Test completed with returncode: 0
python_hello/c960b7ca: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca/python_hello.out
python_hello/c960b7ca: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-hello/python_hello/c960b7ca/python_hello.err
In this iteration we are going to run the following tests: [circle_area/bc12a181, python_hello/c960b7ca]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.03024 │
│ bc12a181 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ python_hello │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.029029 │
│ /c960b7ca │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 2/2 Percentage: 100.000%
Failed Tests: 0/2 Percentage: 0.000%
Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_ggniio4p.log
Now let’s say we want to rerun same command but now only run test that are batch, we can specify --executor-type batch and buildtest will filter tests
by executor and find all batch executors. In this case we see that all tests were filtered out and we have no test run.
buildtest build -t python --executor-type batch
$ buildtest build -t python --executor-type batch
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:28 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=python
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 2
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 2
────────────────────────────── Parsing Buildspecs ──────────────────────────────
circle_area/ad4e538f is excluded since its not using batch executor
python_hello/a5d6e3fe is excluded since its not using batch executor
Valid Buildspecs: 2
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-hello.yml: VALID
Buildspecs Filtered out
┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓
┃ buildspecs ┃
┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │
└──────────────────────────────────────────────────────────────────────────────┘
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/v1.3/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
Configure Build Stages¶
We can control behavior of buildtest build command to stop at certain phase
using --stage option. The –stage option accepts parse or build, which
will instruct buildtest to stop at parse or build phase of the pipeline.
Buildtest will validate all the buildspecs in the parse stage, so you can
instruct buildtest to stop at parse stage via --stage=parse. This can be useful
when debugging buildspecs that are invalid. In this example below, we instruct
buildtest to stop after parse stage.
buildtest build -b tutorials/vars.yml --stage=parse
$ buildtest build -b tutorials/vars.yml --stage=parse
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:28 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
Likewise, if you want to troubleshoot your test script without running them you can
use --stage=build which will stop after build phase. This can
be used when you are writing buildspec to troubleshoot how test is generated.
In this next example, we inform buildtest to stop after build stage.
buildtest build -b tutorials/vars.yml --stage=build
$ buildtest build -b tutorials/vars.yml --stage=build
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:29 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/4faae032: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/4faae032
variables_bash/4faae032: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/4faae032/stage
variables_bash/4faae032: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/4faae032/variables_bash_build.sh
Invalid Buildspecs¶
buildtest will skip any buildspecs that fail to validate, in that case the test script will not be generated. Here is an example where we have an invalid buildspec.
buildtest build -b tutorials/invalid_buildspec_section.yml
$ buildtest build -b tutorials/invalid_buildspec_section.yml ╭───────────────────────────── buildtest summary ──────────────────────────────╮ │ │ │ User: docs │ │ Hostname: build-19701871-project-280831-buildtest │ │ Platform: Linux │ │ Current Time: 2023/03/07 15:57:29 │ │ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ buildtest version: 1.3 │ │ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ python version: 3.7.15 │ │ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ │ ╰──────────────────────────────────────────────────────────────────────────────╯ ─────────────────────────── Discovering Buildspecs ──────────────────────────── Discovered buildspecs ╔══════════════════════════════════════════════════════════════════════════════╗ ║ buildspec ║ ╟──────────────────────────────────────────────────────────────────────────────╢ ║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║ ╚══════════════════════════════════════════════════════════════════════════════╝ Total Discovered Buildspecs: 1 Total Excluded Buildspecs: 0 Detected Buildspecs after exclusion: 1 ────────────────────────────── Parsing Buildspecs ────────────────────────────── Valid Buildspecs: 0 Invalid Buildspecs: 1 /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_buildspec_section.yml: INVALID buildtest is unable to create any tests because there are no valid buildspecs. Please see logfile: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/buildtest.log
buildtest may skip tests from running if buildspec specifies an invalid executor name since buildtest needs to know this in order to delegate test to Executor class responsible for running the test. Here is an example where test failed to run since we provided invalid executor.
buildtest build -b tutorials/invalid_executor.yml
$ buildtest build -b tutorials/invalid_executor.yml ╭───────────────────────────── buildtest summary ──────────────────────────────╮ │ │ │ User: docs │ │ Hostname: build-19701871-project-280831-buildtest │ │ Platform: Linux │ │ Current Time: 2023/03/07 15:57:30 │ │ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ buildtest version: 1.3 │ │ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ python version: 3.7.15 │ │ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │ │ │ ╰──────────────────────────────────────────────────────────────────────────────╯ ─────────────────────────── Discovering Buildspecs ──────────────────────────── Discovered buildspecs ╔══════════════════════════════════════════════════════════════════════════════╗ ║ buildspec ║ ╟──────────────────────────────────────────────────────────────────────────────╢ ║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║ ╚══════════════════════════════════════════════════════════════════════════════╝ Total Discovered Buildspecs: 1 Total Excluded Buildspecs: 0 Detected Buildspecs after exclusion: 1 ────────────────────────────── Parsing Buildspecs ────────────────────────────── Valid Buildspecs: 1 Invalid Buildspecs: 0 /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/invalid_executor.yml: VALID Buildspecs Filtered out ┏━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ buildspecs ┃ ┡━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┩ │ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… │ └──────────────────────────────────────────────────────────────────────────────┘ 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/v1.3/var/buildtest.log
Rebuild Tests¶
buildtest can rebuild tests using the --rebuild option which can be useful if
you want to test a particular test multiple times. The rebuild option works across
all discovered buildspecs and create a new test instance (unique id) and test directory
path. To demonstrate we will build tutorials/python-shell.yml three times using
--rebuild=3.
buildtest build -b tutorials/python-shell.yml --rebuild=3
$ buildtest build -b tutorials/python-shell.yml --rebuild=3
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:30 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/python-shell.yml: VALID
Total builder objects created: 3
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ circle_… │ script │ generic… │ None │ None │ None │ Calcula… │ /home/… │
│ │ │ │ │ │ │ circle │ │
│ │ │ │ │ │ │ of area │ │
│ │ │ │ │ │ │ given a │ │
│ │ │ │ │ │ │ radius │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
circle_area/b195a223: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223
circle_area/b195a223: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223/stage
circle_area/b195a223: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223/circle_area_build.sh
circle_area/a3712fc1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1
circle_area/a3712fc1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1/stage
circle_area/a3712fc1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1/circle_area_build.sh
circle_area/395392b6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6
circle_area/395392b6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6/stage
circle_area/395392b6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6/circle_area_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
circle_area/395392b6 does not have any dependencies adding test to queue
circle_area/a3712fc1 does not have any dependencies adding test to queue
circle_area/b195a223 does not have any dependencies adding test to queue
circle_area/a3712fc1: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1/stage
circle_area/a3712fc1: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/a3712fc1: Test completed in 0.0302 seconds
circle_area/a3712fc1: Test completed with returncode: 0
circle_area/a3712fc1: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1/circle_area.out
circle_area/a3712fc1: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/a3712fc1/circle_area.err
circle_area/b195a223: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223/stage
circle_area/b195a223: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/b195a223: Test completed in 0.029349 seconds
circle_area/b195a223: Test completed with returncode: 0
circle_area/b195a223: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223/circle_area.out
circle_area/b195a223: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/b195a223/circle_area.err
circle_area/395392b6: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6/stage
circle_area/395392b6: Running Test via command: bash --norc --noprofile -eo pipefail circle_area_build.sh
circle_area/395392b6: Test completed in 0.030051 seconds
circle_area/395392b6: Test completed with returncode: 0
circle_area/395392b6: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6/circle_area.out
circle_area/395392b6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/python-shell/circle_area/395392b6/circle_area.err
In this iteration we are going to run the following tests: [circle_area/a3712fc1, circle_area/b195a223, circle_area/395392b6]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.029349 │
│ b195a223 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.0302 │
│ a3712fc1 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ circle_area/ │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.030051 │
│ 395392b6 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 3/3 Percentage: 100.000%
Failed Tests: 0/3 Percentage: 0.000%
Adding 3 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_roex9_ma.log
The rebuild works with all options including: --buildspec, --exclude, --tags
and --executor. buildtest will perform rebuild for all discovered tests, for instance in
this next example we will discover all tests by tag name fail and each test is rebuild twice.
buildtest build -t fail --rebuild 2
$ buildtest build -t fail --rebuild 2
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:31 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Buildspecs By Tag=fail
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 8
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/e8122c1c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c
exit1_fail/e8122c1c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c/stage
exit1_fail/e8122c1c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c/exit1_fail_build.sh
exit1_pass/12de1521: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521
exit1_pass/12de1521: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521/stage
exit1_pass/12de1521: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521/exit1_pass_build.sh
returncode_list_mismatch/63b9b558: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558
returncode_list_mismatch/63b9b558: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558/stage
returncode_list_mismatch/63b9b558: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558/returncode_list_mismatch_build.sh
returncode_int_match/a963c856: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856
returncode_int_match/a963c856: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856/stage
returncode_int_match/a963c856: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856/returncode_int_match_build.sh
exit1_fail/9c9a73c1: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1
exit1_fail/9c9a73c1: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1/stage
exit1_fail/9c9a73c1: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1/exit1_fail_build.sh
exit1_pass/dd50593d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d
exit1_pass/dd50593d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d/stage
exit1_pass/dd50593d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d/exit1_pass_build.sh
returncode_list_mismatch/339f07dd: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd
returncode_list_mismatch/339f07dd: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd/stage
returncode_list_mismatch/339f07dd: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd/returncode_list_mismatch_build.sh
returncode_int_match/f0f0f483: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483
returncode_int_match/f0f0f483: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483/stage
returncode_int_match/f0f0f483: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_pass/12de1521 does not have any dependencies adding test to queue
exit1_fail/e8122c1c does not have any dependencies adding test to queue
exit1_fail/9c9a73c1 does not have any dependencies adding test to queue
returncode_list_mismatch/63b9b558 does not have any dependencies adding test to queue
exit1_pass/dd50593d does not have any dependencies adding test to queue
returncode_list_mismatch/339f07dd does not have any dependencies adding test to queue
returncode_int_match/a963c856 does not have any dependencies adding test to queue
returncode_int_match/f0f0f483 does not have any dependencies adding test to queue
exit1_pass/12de1521: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521/stage
exit1_pass/12de1521: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/12de1521: Test completed in 0.005417 seconds
exit1_pass/12de1521: Test completed with returncode: 1
exit1_pass/12de1521: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521/exit1_pass.out
exit1_pass/12de1521: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/12de1521/exit1_pass.err
exit1_pass/12de1521: Checking returncode - 1 is matched in list [1]
exit1_fail/e8122c1c: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c/stage
exit1_fail/e8122c1c: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/e8122c1c: Test completed in 0.005131 seconds
exit1_fail/e8122c1c: Test completed with returncode: 1
exit1_fail/e8122c1c: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c/exit1_fail.out
exit1_fail/e8122c1c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/e8122c1c/exit1_fail.err
exit1_pass/dd50593d: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d/stage
exit1_pass/dd50593d: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/dd50593d: Test completed in 0.005544 seconds
exit1_pass/dd50593d: Test completed with returncode: 1
exit1_pass/dd50593d: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d/exit1_pass.out
exit1_pass/dd50593d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/dd50593d/exit1_pass.err
exit1_pass/dd50593d: Checking returncode - 1 is matched in list [1]
exit1_fail/9c9a73c1: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1/stage
exit1_fail/9c9a73c1: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/9c9a73c1: Test completed in 0.005018 seconds
exit1_fail/9c9a73c1: Test completed with returncode: 1
exit1_fail/9c9a73c1: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1/exit1_fail.out
exit1_fail/9c9a73c1: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/9c9a73c1/exit1_fail.err
returncode_list_mismatch/63b9b558: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558/stage
returncode_list_mismatch/63b9b558: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/63b9b558: Test completed in 0.005055 seconds
returncode_list_mismatch/63b9b558: Test completed with returncode: 2
returncode_list_mismatch/63b9b558: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558/returncode_list_mismatch.out
returncode_list_mismatch/63b9b558: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/63b9b558/returncode_list_mismatch.err
returncode_list_mismatch/63b9b558: Checking returncode - 2 is matched in list [1, 3]
returncode_list_mismatch/339f07dd: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd/stage
returncode_list_mismatch/339f07dd: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/339f07dd: Test completed in 0.005119 seconds
returncode_list_mismatch/339f07dd: Test completed with returncode: 2
returncode_list_mismatch/339f07dd: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd/returncode_list_mismatch.out
returncode_list_mismatch/339f07dd: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/339f07dd/returncode_list_mismatch.err
returncode_list_mismatch/339f07dd: Checking returncode - 2 is matched in list [1, 3]
returncode_int_match/a963c856: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856/stage
returncode_int_match/a963c856: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/a963c856: Test completed in 0.005099 seconds
returncode_int_match/a963c856: Test completed with returncode: 128
returncode_int_match/a963c856: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856/returncode_int_match.out
returncode_int_match/a963c856: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/a963c856/returncode_int_match.err
returncode_int_match/a963c856: Checking returncode - 128 is matched in list [128]
returncode_int_match/f0f0f483: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483/stage
returncode_int_match/f0f0f483: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/f0f0f483: Test completed in 0.005159 seconds
returncode_int_match/f0f0f483: Test completed with returncode: 128
returncode_int_match/f0f0f483: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483/returncode_int_match.out
returncode_int_match/f0f0f483: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/f0f0f483/returncode_int_match.err
returncode_int_match/f0f0f483: Checking returncode - 128 is matched in list [128]
In this iteration we are going to run the following tests: [exit1_pass/12de1521, exit1_fail/e8122c1c, exit1_pass/dd50593d, exit1_fail/9c9a73c1, returncode_list_mismatch/63b9b558, returncode_list_mismatch/339f07dd, returncode_int_match/a963c856, returncode_int_match/f0f0f483]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ exit1_fail/9 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005018 │
│ c9a73c1 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/1 │ generic.loc… │ PASS │ True False │ 1 │ 0.005417 │
│ 2de1521 │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005119 │
│ ist_mismatch │ │ │ False │ │ │
│ /339f07dd │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005159 │
│ nt_match/f0f │ │ │ False │ │ │
│ 0f483 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/e │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005131 │
│ 8122c1c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/d │ generic.loc… │ PASS │ True False │ 1 │ 0.005544 │
│ d50593d │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005099 │
│ nt_match/a96 │ │ │ False │ │ │
│ 3c856 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005055 │
│ ist_mismatch │ │ │ False │ │ │
│ /63b9b558 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 4/8 Percentage: 50.000%
Failed Tests: 4/8 Percentage: 50.000%
Adding 8 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_k_tholvz.log
The rebuild option expects a range between 1-50, the --rebuild=1 is equivalent
to running without --rebuild option. We set a max limit for rebuild option to
avoid system degredation due to high workload.
If you try to exceed this bound you will get an error such as
buildtest build -b tutorials/test_status/pass_returncode.yml --rebuild 51
$ buildtest build -b tutorials/test_status/pass_returncode.yml --rebuild 51
╭───────────────────── Traceback (most recent call last) ──────────────────────╮
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/bi │
│ n/buildtest:36 in <module> │
│ │
│ 33 │
│ 34 import buildtest.main │
│ 35 │
│ ❱ 36 buildtest.main.main() │
│ 37 │
│ │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │ buildtest = <module 'buildtest' from │ │
│ │ '/home/docs/checkouts/readthedocs.org/user_builds/buil… │ │
│ │ buildtest_file = '/home/docs/checkouts/readthedocs.org/user_builds/buil… │ │
│ │ os = <module 'os' from │ │
│ │ '/home/docs/.asdf/installs/python/3.7.15/lib/python3.7… │ │
│ │ prefix = '/home/docs/checkouts/readthedocs.org/user_builds/buil… │ │
│ │ sys = <module 'sys' (built-in)> │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
│ │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/bu │
│ ildtest/main.py:174 in main │
│ │
│ 171 │ │ │ │ rerun=args.rerun, │
│ 172 │ │ │ │ executor_type=args.executor_type, │
│ 173 │ │ │ │ timeout=args.timeout, │
│ ❱ 174 │ │ │ │ limit=args.limit, │
│ 175 │ │ │ ) │
│ 176 │ │ │ cmd.build() │
│ 177 │
│ │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │ args = Namespace(account=None, │ │
│ │ buildspec=['tutorials/test_status/pass_returncode.… │ │
│ │ color=None, configfile=None, debug=False, │ │
│ │ disable_executor_check=True, editor=None, │ │
│ │ exclude=None, executor=None, executor_type=None, │ │
│ │ filter=None, helpcolor=False, helpfilter=False, │ │
│ │ limit=None, loglevel='DEBUG', logpath=False, │ │
│ │ maxpendtime=None, module_purge=False, modules=None, │ │
│ │ no_color=False, nodes=None, pollinterval=None, │ │
│ │ print_log=False, procs=None, rebuild=51, │ │
│ │ remove_stagedir=False, report=None, rerun=False, │ │
│ │ retry=1, stage=None, subcommands='build', │ │
│ │ tags=None, testdir=None, timeout=None, │ │
│ │ unload_modules=None, view_log=False) │ │
│ │ buildtest_editor = '/usr/bin/vim' │ │
│ │ config_file = None │ │
│ │ configuration = <buildtest.config.SiteConfiguration object at │ │
│ │ 0x7fbedeaeae10> │ │
│ │ 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 │ │
│ │ 0x7fbede6f0cd0> │ │
│ │ validate_executors = True │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
│ │
│ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/bu │
│ ildtest/cli/build.py:558 in __init__ │
│ │
│ 555 │ │ │ │
│ 556 │ │ │ if rebuild > 50: │
│ 557 │ │ │ │ raise BuildTestError( │
│ ❱ 558 │ │ │ │ │ f"--rebuild {rebuild} exceeds maximum rebuild lim │
│ 559 │ │ │ │ ) │
│ 560 │ │ │
│ 561 │ │ if timeout: │
│ │
│ ╭───────────────────────────────── locals ─────────────────────────────────╮ │
│ │ account = None │ │
│ │ buildspecs = ['tutorials/test_status/pass_returncode.yml'] │ │
│ │ buildtest_system = <buildtest.system.BuildTestSystem object at │ │
│ │ 0x7fbede6f0cd0> │ │
│ │ configuration = <buildtest.config.SiteConfiguration object at │ │
│ │ 0x7fbedeaeae10> │ │
│ │ exclude_buildspecs = None │ │
│ │ executor_type = None │ │
│ │ executors = None │ │
│ │ filter_buildspecs = None │ │
│ │ helpfilter = False │ │
│ │ limit = None │ │
│ │ maxpendtime = None │ │
│ │ modulepurge = False │ │
│ │ modules = None │ │
│ │ numnodes = None │ │
│ │ numprocs = None │ │
│ │ poll_interval = None │ │
│ │ rebuild = 51 │ │
│ │ remove_stagedir = False │ │
│ │ report_file = None │ │
│ │ rerun = False │ │
│ │ retry = 1 │ │
│ │ self = <buildtest.cli.build.BuildTest object at │ │
│ │ 0x7fbede693fd0> │ │
│ │ stage = None │ │
│ │ tags = None │ │
│ │ testdir = None │ │
│ │ timeout = None │ │
│ │ unload_modules = None │ │
│ ╰──────────────────────────────────────────────────────────────────────────╯ │
╰──────────────────────────────────────────────────────────────────────────────╯
BuildTestError: '--rebuild 51 exceeds maximum rebuild limit of 50'
Limit Number of Tests¶
The buildtest build command can limit the number of tests that can run via --limit option. This
can be useful when running large number of tests and you have no idea
how many tests will run. The --limit <NUM> option expects a positive number which will
limit number of tests to the total limit. If there are less tests to run than the
value specified by --limit, then buildtest will run all the test. When buildtest has more
tests to run than the value specified by --limit, then buildtest will exclude some tests.
To demonstrate this feature, we will run the same command with and without –limit option.
In first example, we will run a test that will run 4 tests.
buildtest build -b tutorials/test_status/pass_returncode.yml
$ buildtest build -b tutorials/test_status/pass_returncode.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:32 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 4
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/af986a00: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00
exit1_fail/af986a00: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00/stage
exit1_fail/af986a00: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00/exit1_fail_build.sh
exit1_pass/29cc8129: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129
exit1_pass/29cc8129: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129/stage
exit1_pass/29cc8129: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129/exit1_pass_build.sh
returncode_list_mismatch/f667265d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d
returncode_list_mismatch/f667265d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d/stage
returncode_list_mismatch/f667265d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d/returncode_list_mismatch_build.sh
returncode_int_match/dfed338d: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d
returncode_int_match/dfed338d: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d/stage
returncode_int_match/dfed338d: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d/returncode_int_match_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_pass/29cc8129 does not have any dependencies adding test to queue
exit1_fail/af986a00 does not have any dependencies adding test to queue
returncode_int_match/dfed338d does not have any dependencies adding test to queue
returncode_list_mismatch/f667265d does not have any dependencies adding test to queue
exit1_pass/29cc8129: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129/stage
exit1_pass/29cc8129: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/29cc8129: Test completed in 0.005333 seconds
exit1_pass/29cc8129: Test completed with returncode: 1
exit1_pass/29cc8129: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129/exit1_pass.out
exit1_pass/29cc8129: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/29cc8129/exit1_pass.err
exit1_pass/29cc8129: Checking returncode - 1 is matched in list [1]
exit1_fail/af986a00: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00/stage
exit1_fail/af986a00: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/af986a00: Test completed in 0.005122 seconds
exit1_fail/af986a00: Test completed with returncode: 1
exit1_fail/af986a00: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00/exit1_fail.out
exit1_fail/af986a00: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/af986a00/exit1_fail.err
returncode_int_match/dfed338d: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d/stage
returncode_int_match/dfed338d: Running Test via command: bash --norc --noprofile -eo pipefail returncode_int_match_build.sh
returncode_int_match/dfed338d: Test completed in 0.005042 seconds
returncode_int_match/dfed338d: Test completed with returncode: 128
returncode_int_match/dfed338d: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d/returncode_int_match.out
returncode_int_match/dfed338d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_int_match/dfed338d/returncode_int_match.err
returncode_int_match/dfed338d: Checking returncode - 128 is matched in list [128]
returncode_list_mismatch/f667265d: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d/stage
returncode_list_mismatch/f667265d: Running Test via command: bash --norc --noprofile -eo pipefail returncode_list_mismatch_build.sh
returncode_list_mismatch/f667265d: Test completed in 0.005035 seconds
returncode_list_mismatch/f667265d: Test completed with returncode: 2
returncode_list_mismatch/f667265d: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d/returncode_list_mismatch.out
returncode_list_mismatch/f667265d: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/returncode_list_mismatch/f667265d/returncode_list_mismatch.err
returncode_list_mismatch/f667265d: Checking returncode - 2 is matched in list [1, 3]
In this iteration we are going to run the following tests: [exit1_pass/29cc8129, exit1_fail/af986a00, returncode_int_match/dfed338d, returncode_list_mismatch/f667265d]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ returncode_l │ generic.loc… │ FAIL │ False False │ 2 │ 0.005035 │
│ ist_mismatch │ │ │ False │ │ │
│ /f667265d │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/2 │ generic.loc… │ PASS │ True False │ 1 │ 0.005333 │
│ 9cc8129 │ │ │ False │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_fail/a │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005122 │
│ f986a00 │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ returncode_i │ generic.loc… │ PASS │ True False │ 128 │ 0.005042 │
│ nt_match/dfe │ │ │ False │ │ │
│ d338d │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 2/4 Percentage: 50.000%
Failed Tests: 2/4 Percentage: 50.000%
Adding 4 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_o955lzgn.log
Now let’s run this same test with --limit=2 and notice buildtest will run 2/4 tests
buildtest build -b tutorials/test_status/pass_returncode.yml --limit=2
$ buildtest build -b tutorials/test_status/pass_returncode.yml --limit=2
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:33 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/test_status/pass_returncode.yml: VALID
Total builder objects created: 4
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ exit1_f… │ script │ generic… │ None │ None │ None │ exit 1 │ /home/… │
│ │ │ │ │ │ │ by │ │
│ │ │ │ │ │ │ default │ │
│ │ │ │ │ │ │ is FAIL │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ exit1_p… │ script │ generic… │ None │ None │ None │ report │ /home/… │
│ │ │ │ │ │ │ exit 1 │ │
│ │ │ │ │ │ │ as PASS │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 2 │ /home/… │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ since it │ │
│ │ │ │ │ │ │ failed │ │
│ │ │ │ │ │ │ to match │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 1 │ │
├──────────┼────────┼──────────┼──────────┼───────┼───────┼──────────┼─────────┤
│ returnc… │ script │ generic… │ None │ None │ None │ exit 128 │ /home/… │
│ │ │ │ │ │ │ matches │ │
│ │ │ │ │ │ │ returnc… │ │
│ │ │ │ │ │ │ 128 │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
Limit number of tests to 2 for Building and Running.
──────────────────────────────── Building Test ─────────────────────────────────
exit1_fail/398ce00c: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c
exit1_fail/398ce00c: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c/stage
exit1_fail/398ce00c: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c/exit1_fail_build.sh
exit1_pass/248f1816: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816
exit1_pass/248f1816: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816/stage
exit1_pass/248f1816: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816/exit1_pass_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
exit1_fail/398ce00c does not have any dependencies adding test to queue
exit1_pass/248f1816 does not have any dependencies adding test to queue
exit1_fail/398ce00c: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c/stage
exit1_fail/398ce00c: Running Test via command: bash --norc --noprofile -eo pipefail exit1_fail_build.sh
exit1_fail/398ce00c: Test completed in 0.005475 seconds
exit1_fail/398ce00c: Test completed with returncode: 1
exit1_fail/398ce00c: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c/exit1_fail.out
exit1_fail/398ce00c: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_fail/398ce00c/exit1_fail.err
exit1_pass/248f1816: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816/stage
exit1_pass/248f1816: Running Test via command: bash --norc --noprofile -eo pipefail exit1_pass_build.sh
exit1_pass/248f1816: Test completed in 0.005064 seconds
exit1_pass/248f1816: Test completed with returncode: 1
exit1_pass/248f1816: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816/exit1_pass.out
exit1_pass/248f1816: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/pass_returncode/exit1_pass/248f1816/exit1_pass.err
exit1_pass/248f1816: Checking returncode - 1 is matched in list [1]
In this iteration we are going to run the following tests: [exit1_fail/398ce00c, exit1_pass/248f1816]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ exit1_fail/3 │ generic.loc… │ FAIL │ N/A N/A N/A │ 1 │ 0.005475 │
│ 98ce00c │ │ │ │ │ │
├──────────────┼──────────────┼────────┼───────────────┼────────────┼──────────┤
│ exit1_pass/2 │ generic.loc… │ PASS │ True False │ 1 │ 0.005064 │
│ 48f1816 │ │ │ False │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/2 Percentage: 50.000%
Failed Tests: 1/2 Percentage: 50.000%
Adding 2 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_23g165k4.log
If you specify 0 or negative number you will get an error as follows
buildtest build -b tutorials/test_status/pass_returncode.yml --limit=0
$ buildtest build -b tutorials/test_status/pass_returncode.yml --limit=0
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]
[--maxpendtime MAXPENDTIME]
[--pollinterval POLLINTERVAL]
[--procs PROCS [PROCS ...]]
[--nodes NODES [NODES ...]]
[--disable-executor-check]
[--limit LIMIT]
[--remove-stagedir]
[--rebuild REBUILD]
[--retry RETRY] [-s {parse,build}]
[--testdir TESTDIR]
[--timeout TIMEOUT]
buildtest [options] [COMMANDS] build: error: argument --limit: Input: 0 converted to int: 0 must be a positive number
Rerun Last command¶
The buildtest build --rerun command can be used to rerun last successful buildtest build command, this can be useful if you want to repeat a certain
build without having to remember the command or going through your command history to find the command you ran. When using this option all other options passed
to buildtest will be ignored. In order to use –rerun option you must run buildtest build command such that buildtest can rerun your last successful
command.
Let’s start by building a simple test.
buildtest build -b tutorials/vars.yml
$ buildtest build -b tutorials/vars.yml
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:34 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/b7197f99: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99
variables_bash/b7197f99: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99/stage
variables_bash/b7197f99: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/b7197f99 does not have any dependencies adding test to queue
variables_bash/b7197f99: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99/stage
variables_bash/b7197f99: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/b7197f99: Test completed in 0.009125 seconds
variables_bash/b7197f99: Test completed with returncode: 0
variables_bash/b7197f99: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99/variables_bash.out
variables_bash/b7197f99: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/b7197f99/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/b7197f99]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.009125 │
│ sh/b7197f99 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_thoqpr5a.log
Next let’s rerun the same command via buildtest build --rerun and take note that it will rerun same command as before
buildtest build --rerun
$ buildtest build --rerun
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:35 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/5ccfa124: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124
variables_bash/5ccfa124: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124/stage
variables_bash/5ccfa124: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/5ccfa124 does not have any dependencies adding test to queue
variables_bash/5ccfa124: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124/stage
variables_bash/5ccfa124: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/5ccfa124: Test completed in 0.008773 seconds
variables_bash/5ccfa124: Test completed with returncode: 0
variables_bash/5ccfa124: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124/variables_bash.out
variables_bash/5ccfa124: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/5ccfa124/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/5ccfa124]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008773 │
│ sh/5ccfa124 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_3_50uzqc.log
If you pass additional options with --rerun it will simply be ignored. In this case -t python --stage=build will not be read by buildtest instead we will
rerun same command.
buildtest build --rerun -t python --stage=build
$ buildtest build --rerun -t python --stage=build
Reading content of rerun file /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/rerun.json all other options will be ignored.
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:36 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/vars.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ variabl… │ script │ generic… │ None │ None │ None │ Declare │ /home/… │
│ │ │ │ │ │ │ shell │ │
│ │ │ │ │ │ │ variabl… │ │
│ │ │ │ │ │ │ in bash │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
variables_bash/58e5e4b6: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6
variables_bash/58e5e4b6: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6/stage
variables_bash/58e5e4b6: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6/variables_bash_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
variables_bash/58e5e4b6 does not have any dependencies adding test to queue
variables_bash/58e5e4b6: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6/stage
variables_bash/58e5e4b6: Running Test via command: bash --norc --noprofile -eo pipefail variables_bash_build.sh
variables_bash/58e5e4b6: Test completed in 0.008835 seconds
variables_bash/58e5e4b6: Test completed with returncode: 0
variables_bash/58e5e4b6: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6/variables_bash.out
variables_bash/58e5e4b6: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/vars/variables_bash/58e5e4b6/variables_bash.err
In this iteration we are going to run the following tests: [variables_bash/58e5e4b6]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ variables_ba │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 0.008835 │
│ sh/58e5e4b6 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_9e0ko8fb.log
Note
The buildtest clean will erase all history of builds and if you run buildtest build --rerun will raise an exception
Specify Modules in command line¶
If your system supports modules such as environment-modules or Lmod you can specify a list
of modules to load (module load) in the test via buildtest build --modules. You can specify
a comma separated list of modules to load, for example if you want to load gcc and python module in
your test you can run buildtest build --modules gcc,python. You may specify full name of module with
version for instance you want test to load gcc/9.3.0 and python/3.7 you can run buildtest build --modules gcc/9.3.0,python/3.7.
If you want test to run module purge before running test you can specify buildtest build --module-purge option. If you specify
--module-purge and --modules then module purge will be run prior to loading any modules.
Similarly, you can unload modules before running any test via buildtest build --unload-modules which is a list of modules to run
module unload command and works similar to --modules option. Buildtest will unload modules before loading modules if both –modules and
–unload-modules are specified. If –module-purge is also specified then we run module purge first before loading/unloading any modules.
Use Alternate Configuration file¶
If you want to use an alternate configuration file when building test you can use buildtest -c <config> build.
buildtest will prefer configuration file on command line over the user configuration ($HOME/.buildtest/config.yml). For more
details see Which configuration file does buildtest read?.
Removing Stage Directory¶
buildtest will write the tests in stage directory where test will be executed, typically buildtest will keep the
stage directory but if you want to remove the directory you can use buildtest build --remove-stagedir.
Specify Project Account for batch jobs¶
For batch jobs you typically require one to specify a project account in order to charge jobs depending on your
scheduler you can use buildtest build --account option and specify an account name. The command line
argument --account will override configuration setting. For more details see Specifying Project Account
Test Timeout¶
Buildtest can terminate test based on timeout value specified via --timeout option which can be used to terminate
long running test. The timeout is in seconds and value must be a positive integer which is applied to all
test that are run via buildtest build command. If test exceeds the timeout value, then process will be terminated.
To demonstrate this behavior, we will run the following test with a timeout of 1 sec which is expected to fail. Take note of the test returncode of test.
buildtest build -b tutorials/sleep.yml --timeout 1
$ buildtest build -b tutorials/sleep.yml --timeout 1
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:36 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/sleep.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ sleep/3… │ script │ generic… │ None │ None │ None │ sleep 2 │ /home/… │
│ │ │ │ │ │ │ seconds │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/3fcdc4e2: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2
sleep/3fcdc4e2: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2/stage
sleep/3fcdc4e2: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/3fcdc4e2 does not have any dependencies adding test to queue
sleep/3fcdc4e2: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2/stage
sleep/3fcdc4e2: Running Test via command: bash --norc --noprofile -eo pipefail sleep_build.sh
sleep/3fcdc4e2: Test completed in 1.003333 seconds
sleep/3fcdc4e2: Test completed with returncode: -9
sleep/3fcdc4e2: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2/sleep.out
sleep/3fcdc4e2: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/3fcdc4e2/sleep.err
In this iteration we are going to run the following tests: [sleep/3fcdc4e2]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ sleep/3fcdc4 │ generic.loc… │ FAIL │ N/A N/A N/A │ -9 │ 1.003333 │
│ e2 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 0/1 Percentage: 0.000%
Failed Tests: 1/1 Percentage: 100.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_xufj6oac.log
Now if we run this test with a higher timeout value we will see this test will pass, if no timeout is specified then test will run until completion.
buildtest build -b tutorials/sleep.yml --timeout 10
$ buildtest build -b tutorials/sleep.yml --timeout 10
╭───────────────────────────── buildtest summary ──────────────────────────────╮
│ │
│ User: docs │
│ Hostname: build-19701871-project-280831-buildtest │
│ Platform: Linux │
│ Current Time: 2023/03/07 15:57:38 │
│ buildtest path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ buildtest version: 1.3 │
│ python path: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ python version: 3.7.15 │
│ Configuration File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Test Directory: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Report File: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ Command: /home/docs/checkouts/readthedocs.org/user_builds/buildte │
│ │
╰──────────────────────────────────────────────────────────────────────────────╯
─────────────────────────── Discovering Buildspecs ────────────────────────────
Discovered buildspecs
╔══════════════════════════════════════════════════════════════════════════════╗
║ buildspec ║
╟──────────────────────────────────────────────────────────────────────────────╢
║ /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/t… ║
╚══════════════════════════════════════════════════════════════════════════════╝
Total Discovered Buildspecs: 1
Total Excluded Buildspecs: 0
Detected Buildspecs after exclusion: 1
────────────────────────────── Parsing Buildspecs ──────────────────────────────
Valid Buildspecs: 1
Invalid Buildspecs: 0
/home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/tutorials/sleep.yml: VALID
Total builder objects created: 1
Builders by type=script
┏━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━━┳━━━━━━━┳━━━━━━━┳━━━━━━━━━━┳━━━━━━━━━┓
┃ builder ┃ type ┃ executor ┃ compiler ┃ nodes ┃ procs ┃ descrip… ┃ builds… ┃
┡━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━╇━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━┩
│ sleep/d… │ script │ generic… │ None │ None │ None │ sleep 2 │ /home/… │
│ │ │ │ │ │ │ seconds │ │
└──────────┴────────┴──────────┴──────────┴───────┴───────┴──────────┴─────────┘
──────────────────────────────── Building Test ─────────────────────────────────
sleep/d88b43c7: Creating test directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7
sleep/d88b43c7: Creating the stage directory: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7/stage
sleep/d88b43c7: Writing build script: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7/sleep_build.sh
──────────────────────────────── Running Tests ─────────────────────────────────
Spawning 1 processes for processing builders
───────────────────────────────── Iteration 1 ──────────────────────────────────
sleep/d88b43c7 does not have any dependencies adding test to queue
sleep/d88b43c7: Current Working Directory : /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7/stage
sleep/d88b43c7: Running Test via command: bash --norc --noprofile -eo pipefail sleep_build.sh
sleep/d88b43c7: Test completed in 2.019791 seconds
sleep/d88b43c7: Test completed with returncode: 0
sleep/d88b43c7: Writing output file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7/sleep.out
sleep/d88b43c7: Writing error file - /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/tests/generic.local.bash/sleep/sleep/d88b43c7/sleep.err
In this iteration we are going to run the following tests: [sleep/d88b43c7]
Test Summary
┏━━━━━━━━━━━━━━┳━━━━━━━━━━━━━━┳━━━━━━━━┳━━━━━━━━━━━━━━━┳━━━━━━━━━━━━┳━━━━━━━━━━┓
┃ ┃ ┃ ┃ checks ┃ ┃ ┃
┃ ┃ ┃ ┃ (ReturnCode, ┃ ┃ ┃
┃ ┃ ┃ ┃ Regex, ┃ ┃ ┃
┃ builder ┃ executor ┃ status ┃ Runtime) ┃ returncode ┃ runtime ┃
┡━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━┩
│ sleep/d88b43 │ generic.loc… │ PASS │ N/A N/A N/A │ 0 │ 2.019791 │
│ c7 │ │ │ │ │ │
└──────────────┴──────────────┴────────┴───────────────┴────────────┴──────────┘
Passed Tests: 1/1 Percentage: 100.000%
Failed Tests: 0/1 Percentage: 0.000%
Adding 1 test results to /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/report.json
Writing Logfile to: /home/docs/checkouts/readthedocs.org/user_builds/buildtest/checkouts/v1.3/var/logs/buildtest_vffcyf5h.log