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