Merge branch '21086-cert-source'
[arvados.git] / build / run-tests.sh
1 #!/bin/bash
2 # Copyright (C) The Arvados Authors. All rights reserved.
3 #
4 # SPDX-License-Identifier: AGPL-3.0
5
6 COLUMNS=80
7 . `dirname "$(readlink -f "$0")"`/run-library.sh
8
9 read -rd "\000" helpmessage <<EOF
10 $(basename $0): Install and test Arvados components.
11
12 Exit non-zero if any tests fail.
13
14 Syntax:
15         $(basename $0) WORKSPACE=/path/to/arvados [options]
16
17 Options:
18
19 --skip FOO     Do not test the FOO component.
20 --skip sanity  Skip initial dev environment sanity checks.
21 --skip install Do not run any install steps. Just run tests.
22                You should provide GOPATH, GEMHOME, and VENVDIR options
23                from a previous invocation if you use this option.
24 --only FOO     Do not test anything except the FOO component.
25 --temp DIR     Install components and dependencies under DIR instead of
26                making a new temporary directory. Implies --leave-temp.
27 --leave-temp   Do not remove GOPATH, virtualenv, and other temp dirs at exit.
28                Instead, show the path to give as --temp to reuse them in
29                subsequent invocations.
30 --repeat N     Repeat each install/test step until it succeeds N times.
31 --retry        Prompt to retry if an install or test suite fails.
32 --only-install Run specific install step
33 --short        Skip (or scale down) some slow tests.
34 --interactive  Set up, then prompt for test/install steps to perform.
35 WORKSPACE=path Arvados source tree to test.
36 CONFIGSRC=path Dir with config.yml file containing PostgreSQL section for use by tests.
37 services/api_test="TEST=test/functional/arvados/v1/collections_controller_test.rb"
38                Restrict apiserver tests to the given file
39 sdk/python_test="--test-suite tests.test_keep_locator"
40                Restrict Python SDK tests to the given class
41 apps/workbench_test="TEST=test/integration/pipeline_instances_test.rb"
42                Restrict Workbench tests to the given file
43 services/githttpd_test="-check.vv"
44                Show all log messages, even when tests pass (also works
45                with services/keepstore_test etc.)
46 ARVADOS_DEBUG=1
47                Print more debug messages
48 envvar=value   Set \$envvar to value. Primarily useful for WORKSPACE,
49                *_test, and other examples shown above.
50
51 Assuming "--skip install" is not given, all components are installed
52 into \$GOPATH, \$VENDIR, and \$GEMHOME before running any tests. Many
53 test suites depend on other components being installed, and installing
54 everything tends to be quicker than debugging dependencies.
55
56 As a special concession to the current CI server config, CONFIGSRC
57 defaults to $HOME/arvados-api-server if that directory exists.
58
59 More information and background:
60
61 https://dev.arvados.org/projects/arvados/wiki/Running_tests
62
63 Available tests:
64
65 apps/workbench (*)
66 apps/workbench_units (*)
67 apps/workbench_functionals (*)
68 apps/workbench_integration (*)
69 apps/workbench_benchmark
70 apps/workbench_profile
71 cmd/arvados-client
72 cmd/arvados-package
73 cmd/arvados-server
74 doc
75 lib/cli
76 lib/cmd
77 lib/controller
78 lib/controller/federation
79 lib/controller/railsproxy
80 lib/controller/router
81 lib/controller/rpc
82 lib/crunchstat
83 lib/crunch-run
84 lib/cloud
85 lib/cloud/azure
86 lib/cloud/cloudtest
87 lib/dispatchcloud
88 lib/dispatchcloud/container
89 lib/dispatchcloud/scheduler
90 lib/dispatchcloud/sshexecutor
91 lib/dispatchcloud/worker
92 lib/mount
93 lib/pam
94 lib/service
95 services/api
96 services/githttpd
97 services/dockercleaner
98 services/fuse
99 services/fuse:py3
100 services/health
101 services/keep-web
102 services/keepproxy
103 services/keepstore
104 services/keep-balance
105 services/login-sync
106 services/crunch-dispatch-local
107 services/crunch-dispatch-slurm
108 services/ws
109 sdk/cli
110 sdk/python
111 sdk/python:py3
112 sdk/ruby
113 sdk/go/arvados
114 sdk/go/arvadosclient
115 sdk/go/auth
116 sdk/go/dispatch
117 sdk/go/keepclient
118 sdk/go/health
119 sdk/go/httpserver
120 sdk/go/manifest
121 sdk/go/blockdigest
122 sdk/go/asyncbuf
123 sdk/go/stats
124 sdk/go/crunchrunner
125 sdk/cwl:py3
126 sdk/R
127 sdk/java-v2
128 tools/sync-groups
129 tools/crunchstat-summary
130 tools/crunchstat-summary:py3
131 tools/keep-exercise
132 tools/keep-rsync
133 tools/keep-block-check
134
135 (*) apps/workbench is shorthand for apps/workbench_units +
136     apps/workbench_functionals + apps/workbench_integration
137
138 EOF
139
140 # First make sure to remove any ARVADOS_ variables from the calling
141 # environment that could interfere with the tests.
142 unset $(env | cut -d= -f1 | grep \^ARVADOS_)
143
144 # Reset other variables that could affect our [tests'] behavior by
145 # accident.
146 GITDIR=
147 GOPATH=
148 VENVDIR=
149 VENV3DIR=
150 PYTHONPATH=
151 GEMHOME=
152 R_LIBS=
153 export LANG=en_US.UTF-8
154
155 short=
156 only_install=
157 temp=
158 temp_preserve=
159
160 ignore_sigint=
161
162 clear_temp() {
163     if [[ -z "$temp" ]]; then
164         # we did not even get as far as making a temp dir
165         :
166     elif [[ -z "$temp_preserve" ]]; then
167         # Go creates readonly dirs in the module cache, which cause
168         # "rm -rf" to fail unless we chmod first.
169         chmod -R u+w "$temp"
170         rm -rf "$temp"
171     else
172         echo "Leaving behind temp dirs in $temp"
173     fi
174 }
175
176 fatal() {
177     clear_temp
178     echo >&2 "Fatal: $* (encountered in ${FUNCNAME[1]} at ${BASH_SOURCE[1]} line ${BASH_LINENO[0]})"
179     exit 1
180 }
181
182 exit_cleanly() {
183     trap - INT
184     if which create-plot-data-from-log.sh >/dev/null; then
185         create-plot-data-from-log.sh $BUILD_NUMBER "$WORKSPACE/apps/workbench/log/test.log" "$WORKSPACE/apps/workbench/log/"
186     fi
187     rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
188     stop_services
189     rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
190     report_outcomes
191     clear_temp
192     exit ${#failures}
193 }
194
195 sanity_checks() {
196     [[ -n "${skip[sanity]}" ]] && return 0
197     ( [[ -n "$WORKSPACE" ]] && [[ -d "$WORKSPACE/services" ]] ) \
198         || fatal "WORKSPACE environment variable not set to a source directory (see: $0 --help)"
199     [[ -z "$CONFIGSRC" ]] || [[ -s "$CONFIGSRC/config.yml" ]] \
200         || fatal "CONFIGSRC is $CONFIGSRC but '$CONFIGSRC/config.yml' is empty or not found (see: $0 --help)"
201     echo Checking dependencies:
202     echo "locale: ${LANG}"
203     [[ "$(locale charmap)" = "UTF-8" ]] \
204         || fatal "Locale '${LANG}' is broken/missing. Try: echo ${LANG} | sudo tee -a /etc/locale.gen && sudo locale-gen"
205     echo -n 'ruby: '
206     ruby -v \
207         || fatal "No ruby. Install >=2.1.9 (using rbenv, rvm, or source)"
208     echo -n 'go: '
209     go version \
210         || fatal "No go binary. See http://golang.org/doc/install"
211     [[ $(go version) =~ go1.([0-9]+) ]] && [[ ${BASH_REMATCH[1]} -ge 12 ]] \
212         || fatal "Go >= 1.12 required. See http://golang.org/doc/install"
213     echo -n 'gcc: '
214     gcc --version | egrep ^gcc \
215         || fatal "No gcc. Try: apt-get install build-essential"
216     echo -n 'fuse.h: '
217     find /usr/include -path '*fuse/fuse.h' | egrep --max-count=1 . \
218         || fatal "No fuse/fuse.h. Try: apt-get install libfuse-dev"
219     echo -n 'gnutls.h: '
220     find /usr/include -path '*gnutls/gnutls.h' | egrep --max-count=1 . \
221         || fatal "No gnutls/gnutls.h. Try: apt-get install libgnutls28-dev"
222     echo -n 'virtualenv: '
223     python3 -m venv -h | egrep --max-count=1 . \
224         || fatal "No virtualenv. Try: apt-get install python3-venv"
225     echo -n 'Python3 pyconfig.h: '
226     find /usr/include -path '*/python3*/pyconfig.h' | egrep --max-count=1 . \
227         || fatal "No Python3 pyconfig.h. Try: apt-get install python3-dev"
228     which netstat \
229         || fatal "No netstat. Try: apt-get install net-tools"
230     echo -n 'nginx: '
231     PATH="$PATH:/sbin:/usr/sbin:/usr/local/sbin" nginx -v \
232         || fatal "No nginx. Try: apt-get install nginx"
233     echo -n 'gitolite: '
234     which gitolite \
235         || fatal "No gitolite. Try: apt-get install gitolite3"
236     echo -n 'npm: '
237     npm --version \
238         || fatal "No npm. Try: wget -O- https://nodejs.org/dist/v10.23.1/node-v10.23.1-linux-x64.tar.xz | sudo tar -C /usr/local -xJf - && sudo ln -s ../node-v10.23.1-linux-x64/bin/{node,npm} /usr/local/bin/"
239     echo -n 'cadaver: '
240     cadaver --version | grep -w cadaver \
241           || fatal "No cadaver. Try: apt-get install cadaver"
242     echo -n 'libattr1 xattr.h: '
243     find /usr/include -path '*/attr/xattr.h' | egrep --max-count=1 . \
244         || fatal "No libattr1 xattr.h. Try: apt-get install libattr1-dev"
245     echo -n 'libcurl curl.h: '
246     find /usr/include -path '*/curl/curl.h' | egrep --max-count=1 . \
247         || fatal "No libcurl curl.h. Try: apt-get install libcurl4-gnutls-dev"
248     echo -n 'libpq libpq-fe.h: '
249     find /usr/include -path '*/postgresql/libpq-fe.h' | egrep --max-count=1 . \
250         || fatal "No libpq libpq-fe.h. Try: apt-get install libpq-dev"
251     echo -n 'libpam pam_appl.h: '
252     find /usr/include -path '*/security/pam_appl.h' | egrep --max-count=1 . \
253         || fatal "No libpam pam_appl.h. Try: apt-get install libpam0g-dev"
254     echo -n 'postgresql: '
255     psql --version || fatal "No postgresql. Try: apt-get install postgresql postgresql-client-common"
256     echo -n 'phantomjs: '
257     phantomjs --version || fatal "No phantomjs. Try: apt-get install phantomjs"
258     echo -n 'xvfb: '
259     which Xvfb || fatal "No xvfb. Try: apt-get install xvfb"
260     echo -n 'graphviz: '
261     dot -V || fatal "No graphviz. Try: apt-get install graphviz"
262     echo -n 'geckodriver: '
263     geckodriver --version | grep ^geckodriver || echo "No geckodriver. Try: arvados-server install"
264     echo -n 'singularity: '
265     singularity --version || fatal "No singularity. Try: arvados-server install"
266     echo -n 'docker client: '
267     docker --version || echo "No docker client. Try: arvados-server install"
268     echo -n 'docker server: '
269     docker info --format='{{.ServerVersion}}' || echo "No docker server. Try: arvados-server install"
270
271     if [[ "$NEED_SDK_R" = true ]]; then
272       # R SDK stuff
273       echo -n 'R: '
274       which Rscript || fatal "No Rscript. Try: apt-get install r-base"
275       echo -n 'testthat: '
276       Rscript -e "library('testthat')" || fatal "No testthat. Try: apt-get install r-cran-testthat"
277       # needed for roxygen2, needed for devtools, needed for R sdk
278       pkg-config --exists libxml-2.0 || fatal "No libxml2. Try: apt-get install libxml2-dev"
279       # needed for pkgdown, builds R SDK doc pages
280       which pandoc || fatal "No pandoc. Try: apt-get install pandoc"
281     fi
282     echo 'procs with /dev/fuse open:'
283     find /proc/*/fd -lname /dev/fuse 2>/dev/null | cut -d/ -f3 | xargs --no-run-if-empty ps -lywww
284     echo 'grep fuse /proc/self/mountinfo:'
285     grep fuse /proc/self/mountinfo
286 }
287
288 rotate_logfile() {
289   # i.e.  rotate_logfile "$WORKSPACE/apps/workbench/log/" "test.log"
290   # $BUILD_NUMBER is set by Jenkins if this script is being called as part of a Jenkins run
291   if [[ -f "$1/$2" ]]; then
292     THEDATE=`date +%Y%m%d%H%M%S`
293     mv "$1/$2" "$1/$THEDATE-$BUILD_NUMBER-$2"
294     gzip "$1/$THEDATE-$BUILD_NUMBER-$2"
295   fi
296 }
297
298 declare -a failures
299 declare -A skip
300 declare -A only
301 declare -A testargs
302 skip[apps/workbench_profile]=1
303
304 while [[ -n "$1" ]]
305 do
306     arg="$1"; shift
307     case "$arg" in
308         --help)
309             echo >&2 "$helpmessage"
310             echo >&2
311             exit 1
312             ;;
313         --skip)
314             skip[$1]=1; shift
315             ;;
316         --only)
317             only[$1]=1; skip[$1]=""; shift
318             ;;
319         --short)
320             short=1
321             ;;
322         --interactive)
323             interactive=1
324             ;;
325         --skip-install)
326             skip[install]=1
327             ;;
328         --only-install)
329             only_install="$1"; shift
330             ;;
331         --temp)
332             temp="$1"; shift
333             temp_preserve=1
334             ;;
335         --leave-temp)
336             temp_preserve=1
337             ;;
338         --repeat)
339             repeat=$((${1}+0)); shift
340             ;;
341         --retry)
342             retry=1
343             ;;
344         *_test=*)
345             suite="${arg%%_test=*}"
346             args="${arg#*=}"
347             testargs["$suite"]="$args"
348             ;;
349         *=*)
350             eval export $(echo $arg | cut -d= -f1)=\"$(echo $arg | cut -d= -f2-)\"
351             ;;
352         *)
353             echo >&2 "$0: Unrecognized option: '$arg'. Try: $0 --help"
354             exit 1
355             ;;
356     esac
357 done
358
359 # R SDK installation is very slow (~360s in a clean environment) and only
360 # required when testing it. Skip that step if it is not needed.
361 NEED_SDK_R=true
362
363 if [[ ${#only[@]} -ne 0 ]] &&
364    [[ -z "${only['sdk/R']}" && -z "${only['doc']}" ]]; then
365   NEED_SDK_R=false
366 fi
367
368 if [[ ${skip["sdk/R"]} == 1 && ${skip["doc"]} == 1 ]]; then
369   NEED_SDK_R=false
370 fi
371
372 if [[ $NEED_SDK_R == false ]]; then
373         echo "R SDK not needed, it will not be installed."
374 fi
375
376 checkpidfile() {
377     svc="$1"
378     pid="$(cat "$WORKSPACE/tmp/${svc}.pid")"
379     if [[ -z "$pid" ]] || ! kill -0 "$pid"; then
380         tail $WORKSPACE/tmp/${1}*.log
381         echo "${svc} pid ${pid} not running"
382         return 1
383     fi
384     echo "${svc} pid ${pid} ok"
385 }
386
387 checkhealth() {
388     svc="$1"
389     base=$("${VENV3DIR}/bin/python3" -c "import yaml; print(list(yaml.safe_load(open('$ARVADOS_CONFIG','r'))['Clusters']['zzzzz']['Services']['$1']['InternalURLs'].keys())[0])")
390     url="$base/_health/ping"
391     if ! curl -Ss -H "Authorization: Bearer e687950a23c3a9bceec28c6223a06c79" "${url}" | tee -a /dev/stderr | grep '"OK"'; then
392         echo "${url} failed"
393         return 1
394     fi
395 }
396
397 checkdiscoverydoc() {
398     dd="https://${1}/discovery/v1/apis/arvados/v1/rest"
399     if ! (set -o pipefail; curl -fsk "$dd" | grep -q ^{ ); then
400         echo >&2 "ERROR: could not retrieve discovery doc from RailsAPI at $dd"
401         tail -v $WORKSPACE/tmp/railsapi.log
402         return 1
403     fi
404     echo "${dd} ok"
405 }
406
407 start_services() {
408     if [[ -n "$ARVADOS_TEST_API_HOST" ]]; then
409         return 0
410     fi
411     . "$VENV3DIR/bin/activate"
412     echo 'Starting API, controller, keepproxy, keep-web, githttpd, ws, and nginx ssl proxy...'
413     if [[ ! -d "$WORKSPACE/services/api/log" ]]; then
414         mkdir -p "$WORKSPACE/services/api/log"
415     fi
416     # Remove empty api.pid file if it exists
417     if [[ -f "$WORKSPACE/tmp/api.pid" && ! -s "$WORKSPACE/tmp/api.pid" ]]; then
418         rm -f "$WORKSPACE/tmp/api.pid"
419     fi
420     all_services_stopped=
421     fail=1
422
423     cd "$WORKSPACE" \
424         && eval $(python3 sdk/python/tests/run_test_server.py start --auth admin) \
425         && export ARVADOS_TEST_API_HOST="$ARVADOS_API_HOST" \
426         && export ARVADOS_TEST_API_INSTALLED="$$" \
427         && checkpidfile api \
428         && checkdiscoverydoc $ARVADOS_API_HOST \
429         && eval $(python3 sdk/python/tests/run_test_server.py start_nginx) \
430         && checkpidfile nginx \
431         && python3 sdk/python/tests/run_test_server.py start_controller \
432         && checkpidfile controller \
433         && checkhealth Controller \
434         && checkdiscoverydoc $ARVADOS_API_HOST \
435         && python3 sdk/python/tests/run_test_server.py start_keep_proxy \
436         && checkpidfile keepproxy \
437         && python3 sdk/python/tests/run_test_server.py start_keep-web \
438         && checkpidfile keep-web \
439         && checkhealth WebDAV \
440         && python3 sdk/python/tests/run_test_server.py start_githttpd \
441         && checkpidfile githttpd \
442         && checkhealth GitHTTP \
443         && python3 sdk/python/tests/run_test_server.py start_ws \
444         && checkpidfile ws \
445         && export ARVADOS_TEST_PROXY_SERVICES=1 \
446         && (env | egrep ^ARVADOS) \
447         && fail=0
448     deactivate
449     if [[ $fail != 0 ]]; then
450         unset ARVADOS_TEST_API_HOST
451     fi
452     return $fail
453 }
454
455 stop_services() {
456     if [[ -n "$all_services_stopped" ]]; then
457         return
458     fi
459     unset ARVADOS_TEST_API_HOST ARVADOS_TEST_PROXY_SERVICES
460     . "$VENV3DIR/bin/activate" || return
461     cd "$WORKSPACE" \
462         && python3 sdk/python/tests/run_test_server.py stop_nginx \
463         && python3 sdk/python/tests/run_test_server.py stop_githttpd \
464         && python3 sdk/python/tests/run_test_server.py stop_ws \
465         && python3 sdk/python/tests/run_test_server.py stop_keep-web \
466         && python3 sdk/python/tests/run_test_server.py stop_keep_proxy \
467         && python3 sdk/python/tests/run_test_server.py stop_controller \
468         && python3 sdk/python/tests/run_test_server.py stop \
469         && all_services_stopped=1
470     deactivate
471     unset ARVADOS_CONFIG
472 }
473
474 interrupt() {
475     if [[ -n "$ignore_sigint" ]]; then
476         echo >&2 "ignored SIGINT"
477         return
478     fi
479     failures+=("($(basename $0) interrupted)")
480     exit_cleanly
481 }
482 trap interrupt INT
483
484 setup_ruby_environment() {
485     if [[ -s "$HOME/.rvm/scripts/rvm" ]] ; then
486         source "$HOME/.rvm/scripts/rvm"
487         using_rvm=true
488     elif [[ -s "/usr/local/rvm/scripts/rvm" ]] ; then
489         source "/usr/local/rvm/scripts/rvm"
490         using_rvm=true
491     else
492         using_rvm=false
493     fi
494
495     if [[ "$using_rvm" == true ]]; then
496         # If rvm is in use, we can't just put separate "dependencies"
497         # and "gems-under-test" paths to GEM_PATH: passenger resets
498         # the environment to the "current gemset", which would lose
499         # our GEM_PATH and prevent our test suites from running ruby
500         # programs (for example, the Workbench test suite could not
501         # boot an API server or run arv). Instead, we have to make an
502         # rvm gemset and use it for everything.
503
504         [[ `type rvm | head -n1` == "rvm is a function" ]] \
505             || fatal 'rvm check'
506
507         # Put rvm's favorite path back in first place (overriding
508         # virtualenv, which just put itself there). Ignore rvm's
509         # complaint about not being in first place already.
510         rvm use @default 2>/dev/null
511
512         # Create (if needed) and switch to an @arvados-tests-* gemset,
513         # salting the gemset name so it doesn't interfere with
514         # concurrent builds in other workspaces. Leave the choice of
515         # ruby to the caller.
516         gemset="arvados-tests-$(echo -n "${WORKSPACE}" | md5sum | head -c16)"
517         rvm use "@${gemset}" --create \
518             || fatal 'rvm gemset setup'
519
520         rvm env
521         (bundle version | grep -q 2.2.19) || gem install --no-document bundler -v 2.2.19
522         bundle="$(which bundle)"
523         echo "$bundle"
524         "$bundle" version | grep 2.2.19 || fatal 'install bundler'
525     else
526         # When our "bundle install"s need to install new gems to
527         # satisfy dependencies, we want them to go where "gem install
528         # --user-install" would put them. (However, if the caller has
529         # already set GEM_HOME, we assume that's where dependencies
530         # should be installed, and we should leave it alone.)
531
532         if [ -z "$GEM_HOME" ]; then
533             user_gempath="$(gem env gempath)"
534             export GEM_HOME="${user_gempath%%:*}"
535         fi
536         PATH="$(gem env gemdir)/bin:$PATH"
537
538         # When we build and install our own gems, we install them in our
539         # $GEMHOME tmpdir, and we want them to be at the front of GEM_PATH and
540         # PATH so integration tests prefer them over other versions that
541         # happen to be installed in $user_gempath, system dirs, etc.
542
543         tmpdir_gem_home="$(env - PATH="$PATH" HOME="$GEMHOME" gem env gempath | cut -f1 -d:)"
544         PATH="$tmpdir_gem_home/bin:$PATH"
545         export GEM_PATH="$tmpdir_gem_home:$(gem env gempath)"
546
547         echo "Will install dependencies to $(gem env gemdir)"
548         echo "Will install bundler and arvados gems to $tmpdir_gem_home"
549         echo "Gem search path is GEM_PATH=$GEM_PATH"
550         bundle="bundle"
551         (
552             export HOME=$GEMHOME
553             versions=(2.2.19)
554             for v in ${versions[@]}; do
555                 if ! gem list --installed --version "${v}" bundler >/dev/null; then
556                     gem install --no-document --user $(for v in ${versions[@]}; do echo bundler:${v}; done)
557                     break
558                 fi
559             done
560             "$bundle" version | tee /dev/stderr | grep -q 'version 2'
561         ) || fatal 'install bundler'
562         if test -d /var/lib/arvados-arvbox/ ; then
563             # Inside arvbox, use bundler-installed binstubs.  The
564             # system bundler and rail's own bin/bundle refuse to work.
565             # I don't know why.
566             bundle=binstubs/bundle
567         fi
568     fi
569 }
570
571 with_test_gemset() {
572     if [[ "$using_rvm" == true ]]; then
573         "$@"
574     else
575         GEM_HOME="$tmpdir_gem_home" GEM_PATH="$tmpdir_gem_home" "$@"
576     fi
577 }
578
579 gem_uninstall_if_exists() {
580     if gem list "$1\$" | egrep '^\w'; then
581         gem uninstall --force --all --executables "$1"
582     fi
583 }
584
585 setup_virtualenv() {
586     local venvdest="$1"; shift
587     if ! [[ -e "$venvdest/bin/activate" ]] || ! [[ -e "$venvdest/bin/pip3" ]]; then
588         python3 -m venv "$@" "$venvdest" || fatal "virtualenv $venvdest failed"
589     elif [[ -n "$short" ]]; then
590         return
591     fi
592     "$venvdest/bin/pip3" install --no-cache-dir 'setuptools>=18.5' 'pip>=7'
593 }
594
595 initialize() {
596     # If dependencies like ruby, go, etc. are installed in
597     # /var/lib/arvados -- presumably by "arvados-server install" --
598     # then we want to use those versions, instead of whatever happens
599     # to be installed in /usr.
600     PATH="/var/lib/arvados/bin:${PATH}"
601     sanity_checks
602
603     echo "WORKSPACE=$WORKSPACE"
604
605     # Clean up .pyc files that may exist in the workspace
606     cd "$WORKSPACE"
607     find -name '*.pyc' -delete
608
609     if [[ -z "$temp" ]]; then
610         temp="$(mktemp -d)"
611     fi
612
613     # Set up temporary install dirs (unless existing dirs were supplied)
614     for tmpdir in VENV3DIR GOPATH GEMHOME R_LIBS
615     do
616         if [[ -z "${!tmpdir}" ]]; then
617             eval "$tmpdir"="$temp/$tmpdir"
618         fi
619         if ! [[ -d "${!tmpdir}" ]]; then
620             mkdir "${!tmpdir}" || fatal "can't create ${!tmpdir} (does $temp exist?)"
621         fi
622     done
623
624     rm -vf "${WORKSPACE}/tmp/*.log"
625
626     export R_LIBS
627
628     export GOPATH
629     # Make sure our compiled binaries under test override anything
630     # else that might be in the environment.
631     export PATH=$GOPATH/bin:$PATH
632
633     # Jenkins config requires that glob tmp/*.log match something. Ensure
634     # that happens even if we don't end up running services that set up
635     # logging.
636     mkdir -p "${WORKSPACE}/tmp/" || fatal "could not mkdir ${WORKSPACE}/tmp"
637     touch "${WORKSPACE}/tmp/controller.log" || fatal "could not touch ${WORKSPACE}/tmp/controller.log"
638
639     unset http_proxy https_proxy no_proxy
640
641     # Note: this must be the last time we change PATH, otherwise rvm will
642     # whine a lot.
643     setup_ruby_environment
644
645     echo "PATH is $PATH"
646 }
647
648 install_env() {
649     go mod download || fatal "Go deps failed"
650     which goimports >/dev/null || go install golang.org/x/tools/cmd/goimports@latest || fatal "Go setup failed"
651
652     setup_virtualenv "$VENV3DIR"
653     . "$VENV3DIR/bin/activate"
654
655     # PyYAML is a test requirement used by run_test_server.py and needed for
656     # other, non-Python tests.
657     # pdoc is needed to build PySDK documentation.
658     # We run `setup.py build` first to generate _version.py.
659     env -C "$WORKSPACE/sdk/python" python3 setup.py build \
660         && python3 -m pip install "$WORKSPACE/sdk/python" \
661         && python3 -m pip install PyYAML pdoc \
662         || fatal "installing Python SDK and related dependencies failed"
663 }
664
665 retry() {
666     remain="${repeat}"
667     while :
668     do
669         if ${@}; then
670             if [[ "$remain" -gt 1 ]]; then
671                 remain=$((${remain}-1))
672                 title "(repeating ${remain} more times)"
673             else
674                 break
675             fi
676         elif [[ "$retry" == 1 ]]; then
677             read -p 'Try again? [Y/n] ' x
678             if [[ "$x" != "y" ]] && [[ "$x" != "" ]]
679             then
680                 break
681             fi
682         else
683             break
684         fi
685     done
686 }
687
688 do_test() {
689     case "${1}" in
690         apps/workbench_units | apps/workbench_functionals | apps/workbench_integration)
691             suite=apps/workbench
692             ;;
693         *)
694             suite="${1}"
695             ;;
696     esac
697     if [[ -n "${skip[$suite]}" || \
698               -n "${skip[$1]}" || \
699               (${#only[@]} -ne 0 && ${only[$suite]} -eq 0 && ${only[$1]} -eq 0) ]]; then
700         return 0
701     fi
702     case "${1}" in
703         services/api)
704             stop_services
705             check_arvados_config "$1"
706             ;;
707         gofmt | doc | lib/cli | lib/cloud/azure | lib/cloud/ec2 | lib/cloud/cloudtest | lib/cmd | lib/dispatchcloud/sshexecutor | lib/dispatchcloud/worker)
708             check_arvados_config "$1"
709             # don't care whether services are running
710             ;;
711         *)
712             check_arvados_config "$1"
713             if ! start_services; then
714                 checkexit 1 "$1 tests"
715                 title "test $1 -- failed to start services"
716                 return 1
717             fi
718             ;;
719     esac
720     retry do_test_once ${@}
721 }
722
723 go_ldflags() {
724     version=${ARVADOS_VERSION:-$(git log -n1 --format=%H)-dev}
725     echo "-X git.arvados.org/arvados.git/lib/cmd.version=${version} -X main.version=${version} -s -w"
726 }
727
728 do_test_once() {
729     unset result
730
731     title "test $1"
732     timer_reset
733
734     result=
735     if which deactivate >/dev/null; then deactivate; fi
736     if ! . "$VENV3DIR/bin/activate"
737     then
738         result=1
739     elif [[ "$2" == "go" ]]
740     then
741         covername="coverage-$(echo "$1" | sed -e 's/\//_/g')"
742         coverflags=("-covermode=count" "-coverprofile=$WORKSPACE/tmp/.$covername.tmp")
743         testflags=()
744         if [[ "$1" == "cmd/arvados-package" ]]; then
745             testflags+=("-timeout" "20m")
746         fi
747         # We do "go install" here to catch compilation errors
748         # before trying "go test". Otherwise, coverage-reporting
749         # mode makes Go show the wrong line numbers when reporting
750         # compilation errors.
751         go install -ldflags "$(go_ldflags)" "$WORKSPACE/$1" && \
752             cd "$WORKSPACE/$1" && \
753             if [[ -n "${testargs[$1]}" ]]
754         then
755             # "go test -check.vv giturl" doesn't work, but this
756             # does:
757             go test ${short:+-short} ${testflags[@]} ${testargs[$1]}
758         else
759             # The above form gets verbose even when testargs is
760             # empty, so use this form in such cases:
761             go test ${short:+-short} ${testflags[@]} ${coverflags[@]} "git.arvados.org/arvados.git/$1"
762         fi
763         result=${result:-$?}
764         if [[ -f "$WORKSPACE/tmp/.$covername.tmp" ]]
765         then
766             go tool cover -html="$WORKSPACE/tmp/.$covername.tmp" -o "$WORKSPACE/tmp/$covername.html"
767             rm "$WORKSPACE/tmp/.$covername.tmp"
768         fi
769         [[ $result = 0 ]] && gofmt -e -d *.go
770     elif [[ "$2" == "pip" ]]
771     then
772         tries=0
773         cd "$WORKSPACE/$1" && while :
774         do
775             tries=$((${tries}+1))
776             # $3 can name a path directory for us to use, including trailing
777             # slash; e.g., the bin/ subdirectory of a virtualenv.
778             if [[ -e "${3}activate" ]]; then
779                 . "${3}activate"
780             fi
781             python setup.py ${short:+--short-tests-only} test ${testargs[$1]}
782             result=$?
783             if [[ ${tries} < 3 && ${result} == 137 ]]
784             then
785                 printf '\n*****\n%s tests killed -- retrying\n*****\n\n' "$1"
786                 continue
787             else
788                 break
789             fi
790         done
791     elif [[ "$2" != "" ]]
792     then
793         "test_$2"
794     else
795         "test_$1"
796     fi
797     result=${result:-$?}
798     checkexit $result "$1 tests"
799     title "test $1 -- `timer`"
800     return $result
801 }
802
803 check_arvados_config() {
804     if [[ "$1" = "env" ]] ; then
805         return
806     fi
807     if [[ -z "$ARVADOS_CONFIG" ]] ; then
808         # Create config file.  The run_test_server script requires PyYAML,
809         # so virtualenv needs to be active.  Downstream steps like
810         # workbench install which require a valid config.yml.
811         if [[ ! -s "$VENV3DIR/bin/activate" ]] ; then
812             install_env
813         fi
814         . "$VENV3DIR/bin/activate"
815         cd "$WORKSPACE"
816         eval $(python3 sdk/python/tests/run_test_server.py setup_config)
817         deactivate
818     fi
819 }
820
821 do_install() {
822     if [[ -n "${skip[install]}" || ( -n "${only_install}" && "${only_install}" != "${1}" && "${only_install}" != "${2}" ) ]]; then
823         return 0
824     fi
825     check_arvados_config "$1"
826     retry do_install_once ${@}
827 }
828
829 do_install_once() {
830     title "install $1"
831     timer_reset
832
833     result=
834     if which deactivate >/dev/null; then deactivate; fi
835     if [[ "$1" != "env" ]] && ! . "$VENV3DIR/bin/activate"; then
836         result=1
837     elif [[ "$2" == "go" ]]
838     then
839         go install -ldflags "$(go_ldflags)" "$WORKSPACE/$1"
840     elif [[ "$2" == "pip" ]]
841     then
842         # $3 can name a path directory for us to use, including trailing
843         # slash; e.g., the bin/ subdirectory of a virtualenv.
844
845         # Need to change to a different directory after creating
846         # the source dist package to avoid a pip bug.
847         # see https://arvados.org/issues/5766 for details.
848
849         # Also need to install twice, because if it believes the package is
850         # already installed, pip it won't install it.  So the first "pip
851         # install" ensures that the dependencies are met, the second "pip
852         # install" ensures that we've actually installed the local package
853         # we just built.
854         cd "$WORKSPACE/$1" \
855             && "${3}python3" setup.py sdist rotate --keep=1 --match .tar.gz \
856             && cd "$WORKSPACE" \
857             && "${3}pip3" install --no-cache-dir "$WORKSPACE/$1/dist"/*.tar.gz \
858             && "${3}pip3" install --no-cache-dir --no-deps --ignore-installed "$WORKSPACE/$1/dist"/*.tar.gz
859     elif [[ "$2" != "" ]]
860     then
861         "install_$2"
862     else
863         "install_$1"
864     fi
865     result=${result:-$?}
866     checkexit $result "$1 install"
867     title "install $1 -- `timer`"
868     return $result
869 }
870
871 bundle_install_trylocal() {
872     (
873         set -e
874         echo "(Running bundle install --local. 'could not find package' messages are OK.)"
875         if ! "$bundle" install --local --no-deployment; then
876             echo "(Running bundle install again, without --local.)"
877             "$bundle" install --no-deployment
878         fi
879         "$bundle" package
880     )
881 }
882
883 install_doc() {
884     cd "$WORKSPACE/doc" \
885         && bundle_install_trylocal \
886         && rm -rf .site
887 }
888
889 install_gem() {
890     gemname=$1
891     srcpath=$2
892     with_test_gemset gem_uninstall_if_exists "$gemname" \
893         && cd "$WORKSPACE/$srcpath" \
894         && bundle_install_trylocal \
895         && gem build "$gemname.gemspec" \
896         && with_test_gemset gem install --no-document $(ls -t "$gemname"-*.gem|head -n1)
897 }
898
899 install_sdk/ruby() {
900     install_gem arvados sdk/ruby
901 }
902
903 install_sdk/R() {
904   if [[ "$NEED_SDK_R" = true ]]; then
905     cd "$WORKSPACE/sdk/R" \
906        && Rscript --vanilla install_deps.R
907   fi
908 }
909
910 install_sdk/cli() {
911     install_gem arvados-cli sdk/cli
912 }
913
914 install_services/login-sync() {
915     install_gem arvados sdk/ruby
916     install_gem arvados-login-sync services/login-sync
917 }
918
919 install_services/api() {
920     stop_services
921     check_arvados_config "services/api"
922     cd "$WORKSPACE/services/api" \
923         && RAILS_ENV=test bundle_install_trylocal \
924             || return 1
925
926     rm -f config/environments/test.rb
927     cp config/environments/test.rb.example config/environments/test.rb
928
929     # Clear out any lingering postgresql connections to the test
930     # database, so that we can drop it. This assumes the current user
931     # is a postgresql superuser.
932     cd "$WORKSPACE/services/api" \
933         && test_database=$("${VENV3DIR}/bin/python3" -c "import yaml; print(yaml.safe_load(open('$ARVADOS_CONFIG','r'))['Clusters']['zzzzz']['PostgreSQL']['Connection']['dbname'])") \
934         && psql "$test_database" -c "SELECT pg_terminate_backend (pg_stat_activity.pid::int) FROM pg_stat_activity WHERE pg_stat_activity.datname = '$test_database';" 2>/dev/null
935
936     mkdir -p "$WORKSPACE/services/api/tmp/pids"
937
938     cert="$WORKSPACE/services/api/tmp/self-signed"
939     if [[ ! -e "$cert.pem" || "$(date -r "$cert.pem" +%s)" -lt 1512659226 ]]; then
940         (
941             dir="$WORKSPACE/services/api/tmp"
942             set -e
943             openssl req -newkey rsa:2048 -nodes -subj '/C=US/ST=State/L=City/CN=localhost' -out "$cert.csr" -keyout "$cert.key" </dev/null
944             openssl x509 -req -in "$cert.csr" -signkey "$cert.key" -out "$cert.pem" -days 3650 -extfile <(printf 'subjectAltName=DNS:localhost,DNS:::1,DNS:0.0.0.0,DNS:127.0.0.1,IP:::1,IP:0.0.0.0,IP:127.0.0.1')
945         ) || return 1
946     fi
947
948     cd "$WORKSPACE/services/api" \
949         && rm -rf tmp/git \
950         && mkdir -p tmp/git \
951         && cd tmp/git \
952         && tar xf ../../test/test.git.tar \
953         && mkdir -p internal.git \
954         && git --git-dir internal.git init \
955             || return 1
956
957     (
958         set -ex
959         cd "$WORKSPACE/services/api"
960         export RAILS_ENV=test
961         if bin/rails db:environment:set ; then
962             bin/rake db:drop
963         fi
964         bin/rake db:setup
965         bin/rake db:fixtures:load
966     ) || return 1
967 }
968
969 declare -a pythonstuff
970 pythonstuff=(
971     sdk/python:py3
972     sdk/cwl:py3
973     services/dockercleaner:py3
974     services/fuse:py3
975     tools/crunchstat-summary:py3
976 )
977
978 declare -a gostuff
979 gostuff=($(cd "$WORKSPACE" && git ls-files | grep '\.go$' | sed -e 's/\/[^\/]*$//' | sort -u))
980
981 install_apps/workbench() {
982     cd "$WORKSPACE/apps/workbench" \
983         && mkdir -p tmp/cache \
984         && RAILS_ENV=test bundle_install_trylocal \
985         && RAILS_ENV=test RAILS_GROUPS=assets "$bundle" exec rake npm:install
986 }
987
988 test_doc() {
989     (
990         set -e
991         cd "$WORKSPACE/doc"
992         ARVADOS_API_HOST=pirca.arvadosapi.com
993         # Make sure python-epydoc is installed or the next line won't
994         # do much good!
995         PYTHONPATH=$WORKSPACE/sdk/python/ "$bundle" exec rake linkchecker baseurl=file://$WORKSPACE/doc/.site/ arvados_workbench_host=https://workbench.$ARVADOS_API_HOST arvados_api_host=$ARVADOS_API_HOST
996     )
997 }
998
999 test_gofmt() {
1000     cd "$WORKSPACE" || return 1
1001     dirs=$(ls -d */ | egrep -v 'vendor|tmp')
1002     [[ -z "$(gofmt -e -d $dirs | tee -a /dev/stderr)" ]]
1003 }
1004
1005 test_services/api() {
1006     rm -f "$WORKSPACE/services/api/git-commit.version"
1007     cd "$WORKSPACE/services/api" \
1008         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake test TESTOPTS=\'-v -d\' ${testargs[services/api]}
1009 }
1010
1011 test_sdk/ruby() {
1012     cd "$WORKSPACE/sdk/ruby" \
1013         && "$bundle" exec rake test TESTOPTS=-v ${testargs[sdk/ruby]}
1014 }
1015
1016 test_sdk/R() {
1017   if [[ "$NEED_SDK_R" = true ]]; then
1018     cd "$WORKSPACE/sdk/R" \
1019         && Rscript --vanilla run_test.R
1020   fi
1021 }
1022
1023 test_sdk/cli() {
1024     cd "$WORKSPACE/sdk/cli" \
1025         && mkdir -p /tmp/keep \
1026         && KEEP_LOCAL_STORE=/tmp/keep "$bundle" exec rake test TESTOPTS=-v ${testargs[sdk/cli]}
1027 }
1028
1029 test_sdk/java-v2() {
1030     cd "$WORKSPACE/sdk/java-v2" && gradle test ${testargs[sdk/java-v2]}
1031 }
1032
1033 test_services/login-sync() {
1034     cd "$WORKSPACE/services/login-sync" \
1035         && "$bundle" exec rake test TESTOPTS=-v ${testargs[services/login-sync]}
1036 }
1037
1038 test_apps/workbench_units() {
1039     local TASK="test:units"
1040     cd "$WORKSPACE/apps/workbench" \
1041         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_units]}
1042 }
1043
1044 test_apps/workbench_functionals() {
1045     local TASK="test:functionals"
1046     cd "$WORKSPACE/apps/workbench" \
1047         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_functionals]}
1048 }
1049
1050 test_apps/workbench_integration() {
1051     local TASK="test:integration"
1052     cd "$WORKSPACE/apps/workbench" \
1053         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} TESTOPTS=\'-v -d\' ${testargs[apps/workbench]} ${testargs[apps/workbench_integration]}
1054 }
1055
1056 test_apps/workbench_benchmark() {
1057     local TASK="test:benchmark"
1058     cd "$WORKSPACE/apps/workbench" \
1059         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} ${testargs[apps/workbench_benchmark]}
1060 }
1061
1062 test_apps/workbench_profile() {
1063     local TASK="test:profile"
1064     cd "$WORKSPACE/apps/workbench" \
1065         && eval env RAILS_ENV=test ${short:+RAILS_TEST_SHORT=1} "$bundle" exec rake ${TASK} ${testargs[apps/workbench_profile]}
1066 }
1067
1068 install_deps() {
1069     # Install parts needed by test suites
1070     do_install env
1071     do_install cmd/arvados-server go
1072     do_install sdk/cli
1073     do_install sdk/python pip "${VENV3DIR}/bin/"
1074     do_install sdk/ruby
1075     do_install services/api
1076     do_install services/keepproxy go
1077     do_install services/keep-web go
1078 }
1079
1080 install_all() {
1081     do_install env
1082     do_install doc
1083     do_install sdk/ruby
1084     do_install sdk/R
1085     do_install sdk/cli
1086     do_install services/login-sync
1087     for p in "${pythonstuff[@]}"
1088     do
1089        dir=${p%:py3}
1090        if [[ -z ${skip[python3]} ]]; then
1091            do_install ${dir} pip "$VENV3DIR/bin/"
1092        fi
1093     done
1094     for g in "${gostuff[@]}"
1095     do
1096         do_install "$g" go
1097     done
1098     do_install services/api
1099     do_install apps/workbench
1100 }
1101
1102 test_all() {
1103     stop_services
1104     do_test services/api
1105
1106     # Shortcut for when we're only running apiserver tests. This saves a bit of time,
1107     # because we don't need to start up the api server for subsequent tests.
1108     if [ ! -z "$only" ] && [ "$only" == "services/api" ]; then
1109         rotate_logfile "$WORKSPACE/services/api/log/" "test.log"
1110         exit_cleanly
1111     fi
1112
1113     do_test gofmt
1114     do_test doc
1115     do_test sdk/ruby
1116     do_test sdk/R
1117     do_test sdk/cli
1118     do_test services/login-sync
1119     do_test sdk/java-v2
1120     for p in "${pythonstuff[@]}"
1121     do
1122         dir=${p%:py3}
1123         if [[ -z ${skip[python3]} ]]; then
1124             do_test ${dir} pip "$VENV3DIR/bin/"
1125         fi
1126     done
1127
1128     for g in "${gostuff[@]}"
1129     do
1130         do_test "$g" go
1131     done
1132     do_test apps/workbench_units
1133     do_test apps/workbench_functionals
1134     do_test apps/workbench_integration
1135     do_test apps/workbench_benchmark
1136     do_test apps/workbench_profile
1137 }
1138
1139 test_go() {
1140     do_test gofmt
1141     for g in "${gostuff[@]}"
1142     do
1143         do_test "$g" go
1144     done
1145 }
1146
1147 help_interactive() {
1148     echo "== Interactive commands:"
1149     echo "TARGET                 (short for 'test DIR')"
1150     echo "test TARGET"
1151     echo "10 test TARGET         (run test 10 times)"
1152     echo "test TARGET:py3        (test with python3)"
1153     echo "test TARGET -check.vv  (pass arguments to test)"
1154     echo "install TARGET"
1155     echo "install env            (go/python libs)"
1156     echo "install deps           (go/python libs + arvados components needed for integration tests)"
1157     echo "reset                  (...services used by integration tests)"
1158     echo "exit"
1159     echo "== Test targets:"
1160     echo "${!testfuncargs[@]}" | tr ' ' '\n' | sort | column
1161 }
1162
1163 initialize
1164
1165 declare -A testfuncargs=()
1166 for g in "${gostuff[@]}"; do
1167     testfuncargs[$g]="$g go"
1168 done
1169 for p in "${pythonstuff[@]}"; do
1170     dir=${p%:py3}
1171     testfuncargs[$dir:py3]="$dir pip $VENV3DIR/bin/"
1172 done
1173
1174 testfuncargs["sdk/cli"]="sdk/cli"
1175 testfuncargs["sdk/R"]="sdk/R"
1176 testfuncargs["sdk/java-v2"]="sdk/java-v2"
1177 testfuncargs["apps/workbench_units"]="apps/workbench_units"
1178 testfuncargs["apps/workbench_functionals"]="apps/workbench_functionals"
1179 testfuncargs["apps/workbench_integration"]="apps/workbench_integration"
1180 testfuncargs["apps/workbench_benchmark"]="apps/workbench_benchmark"
1181 testfuncargs["apps/workbench_profile"]="apps/workbench_profile"
1182
1183 if [[ -z ${interactive} ]]; then
1184     install_all
1185     test_all
1186 else
1187     skip=()
1188     only=()
1189     only_install=()
1190     if [[ -e "$VENV3DIR/bin/activate" ]]; then stop_services; fi
1191     setnextcmd() {
1192         if [[ "$TERM" = dumb ]]; then
1193             # assume emacs, or something, is offering a history buffer
1194             # and pre-populating the command will only cause trouble
1195             nextcmd=
1196         elif [[ ! -e "$VENV3DIR/bin/activate" ]]; then
1197             nextcmd="install deps"
1198         else
1199             nextcmd=""
1200         fi
1201     }
1202     echo
1203     help_interactive
1204     nextcmd="install deps"
1205     setnextcmd
1206     HISTFILE="$WORKSPACE/tmp/.history"
1207     history -r
1208     ignore_sigint=1
1209     while read -p 'What next? ' -e -i "$nextcmd" nextcmd; do
1210         history -s "$nextcmd"
1211         history -w
1212         count=1
1213         if [[ "${nextcmd}" =~ ^[0-9] ]]; then
1214           read count nextcmd <<<"${nextcmd}"
1215         fi
1216         read verb target opts <<<"${nextcmd}"
1217         target="${target%/}"
1218         target="${target/\/:/:}"
1219         case "${verb}" in
1220             "exit" | "quit")
1221                 exit_cleanly
1222                 ;;
1223             "reset")
1224                 stop_services
1225                 ;;
1226             "test" | "install")
1227                 case "$target" in
1228                     "")
1229                         help_interactive
1230                         ;;
1231                     all | deps)
1232                         ${verb}_${target}
1233                         ;;
1234                     *)
1235                         argstarget=${target%:py3}
1236                         testargs["$argstarget"]="${opts}"
1237                         tt="${testfuncargs[${target}]}"
1238                         tt="${tt:-$target}"
1239                         while [ $count -gt 0 ]; do
1240                           do_$verb $tt
1241                           let "count=count-1"
1242                         done
1243                         ;;
1244                 esac
1245                 ;;
1246             "" | "help" | *)
1247                 help_interactive
1248                 ;;
1249         esac
1250         if [[ ${#successes[@]} -gt 0 || ${#failures[@]} -gt 0 ]]; then
1251             report_outcomes
1252             successes=()
1253             failures=()
1254         fi
1255         cd "$WORKSPACE"
1256         setnextcmd
1257     done
1258     echo
1259 fi
1260 exit_cleanly