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