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