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