build/run-library.sh

   1 #!/bin/bash
   2 # Copyright (C) The Arvados Authors. All rights reserved.
   3 #
   4 # SPDX-License-Identifier: AGPL-3.0
   5
   6 # A library of functions shared by the various scripts in this directory.
   7
   8 # This is the timestamp about when we merged changed to include licenses
   9 # with Arvados packages.  We use it as a heuristic to add revisions for
  10 # older packages.
  11 LICENSE_PACKAGE_TS=20151208015500
  12
  13 if [[ -z "$ARVADOS_BUILDING_VERSION" ]]; then
  14     RAILS_PACKAGE_ITERATION=8
  15 else
  16     RAILS_PACKAGE_ITERATION="$ARVADOS_BUILDING_ITERATION"
  17 fi
  18
  19 debug_echo () {
  20     echo "$@" >"$STDOUT_IF_DEBUG"
  21 }
  22
  23 find_easy_install() {
  24     for version_suffix in "$@"; do
  25         if "easy_install$version_suffix" --version >/dev/null 2>&1; then
  26             echo "easy_install$version_suffix"
  27             return 0
  28         fi
  29     done
  30     cat >&2 <<EOF
  31 $helpmessage
  32
  33 Error: easy_install$1 (from Python setuptools module) not found
  34
  35 EOF
  36     exit 1
  37 }
  38
  39 format_last_commit_here() {
  40     local format="$1"; shift
  41     TZ=UTC git log -n1 --first-parent "--format=format:$format" .
  42 }
  43
  44 version_from_git() {
  45     # Output the version being built, or if we're building a
  46     # dev/prerelease, output a version number based on the git log for
  47     # the current working directory.
  48     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
  49         echo "$ARVADOS_BUILDING_VERSION"
  50         return
  51     fi
  52
  53     local git_ts git_hash prefix
  54     if [[ -n "$1" ]] ; then
  55         prefix="$1"
  56     else
  57         prefix="0.1"
  58     fi
  59
  60     declare $(format_last_commit_here "git_ts=%ct git_hash=%h")
  61     ARVADOS_BUILDING_VERSION="$(git describe --abbrev=0).$(date -ud "@$git_ts" +%Y%m%d%H%M%S)"
  62     echo "$ARVADOS_BUILDING_VERSION"
  63 }
  64
  65 nohash_version_from_git() {
  66     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
  67         echo "$ARVADOS_BUILDING_VERSION"
  68         return
  69     fi
  70     version_from_git $1 | cut -d. -f1-4
  71 }
  72
  73 timestamp_from_git() {
  74     format_last_commit_here "%ct"
  75 }
  76
  77 handle_python_package () {
  78   # This function assumes the current working directory is the python package directory
  79   if [ -n "$(find dist -name "*-$(nohash_version_from_git).tar.gz" -print -quit)" ]; then
  80     # This package doesn't need rebuilding.
  81     return
  82   fi
  83   # Make sure only to use sdist - that's the only format pip can deal with (sigh)
  84   python setup.py $DASHQ_UNLESS_DEBUG sdist
  85 }
  86
  87 handle_ruby_gem() {
  88     local gem_name="$1"; shift
  89     local gem_version="$(nohash_version_from_git)"
  90     local gem_src_dir="$(pwd)"
  91
  92     if [[ -n "$ONLY_BUILD" ]] && [[ "$gem_name" != "$ONLY_BUILD" ]] ; then
  93         return 0
  94     fi
  95
  96     if ! [[ -e "${gem_name}-${gem_version}.gem" ]]; then
  97         find -maxdepth 1 -name "${gem_name}-*.gem" -delete
  98
  99         # -q appears to be broken in gem version 2.2.2
 100         $GEM build "$gem_name.gemspec" $DASHQ_UNLESS_DEBUG >"$STDOUT_IF_DEBUG" 2>"$STDERR_IF_DEBUG"
 101     fi
 102 }
 103
 104 # Usage: package_go_binary services/foo arvados-foo "Compute foo to arbitrary precision"
 105 package_go_binary() {
 106     local src_path="$1"; shift
 107     local prog="$1"; shift
 108     local description="$1"; shift
 109     local license_file="${1:-agpl-3.0.txt}"; shift
 110
 111     if [[ -n "$ONLY_BUILD" ]] && [[ "$prog" != "$ONLY_BUILD" ]] ; then
 112         return 0
 113     fi
 114
 115     debug_echo "package_go_binary $src_path as $prog"
 116
 117     local basename="${src_path##*/}"
 118
 119     mkdir -p "$GOPATH/src/git.curoverse.com"
 120     ln -sfn "$WORKSPACE" "$GOPATH/src/git.curoverse.com/arvados.git"
 121     (cd "$GOPATH/src/git.curoverse.com/arvados.git" && "$GOPATH/bin/govendor" sync -v)
 122
 123     cd "$GOPATH/src/git.curoverse.com/arvados.git/$src_path"
 124     local version="$(version_from_git)"
 125     local timestamp="$(timestamp_from_git)"
 126
 127     # Update the version number and build a new package if the vendor
 128     # bundle has changed, or the command imports anything from the
 129     # Arvados SDK and the SDK has changed.
 130     declare -a checkdirs=(vendor)
 131     if grep -qr git.curoverse.com/arvados .; then
 132         checkdirs+=(sdk/go lib)
 133     fi
 134     for dir in ${checkdirs[@]}; do
 135         cd "$GOPATH/src/git.curoverse.com/arvados.git/$dir"
 136         ts="$(timestamp_from_git)"
 137         if [[ "$ts" -gt "$timestamp" ]]; then
 138             version=$(version_from_git)
 139             timestamp="$ts"
 140         fi
 141     done
 142
 143     cd $WORKSPACE/packages/$TARGET
 144     test_package_presence $prog $version go
 145
 146     if [[ "$?" != "0" ]]; then
 147       return 1
 148     fi
 149
 150     go get -ldflags "-X main.version=${version}" "git.curoverse.com/arvados.git/$src_path"
 151
 152     local -a switches=()
 153     systemd_unit="$WORKSPACE/${src_path}/${prog}.service"
 154     if [[ -e "${systemd_unit}" ]]; then
 155         switches+=(
 156             --after-install "${WORKSPACE}/build/go-python-package-scripts/postinst"
 157             --before-remove "${WORKSPACE}/build/go-python-package-scripts/prerm"
 158             "${systemd_unit}=/lib/systemd/system/${prog}.service")
 159     fi
 160     switches+=("$WORKSPACE/${license_file}=/usr/share/doc/$prog/${license_file}")
 161
 162     fpm_build "$GOPATH/bin/${basename}=/usr/bin/${prog}" "${prog}" 'Curoverse, Inc.' dir "${version}" "--url=https://arvados.org" "--license=GNU Affero General Public License, version 3.0" "--description=${description}" "${switches[@]}"
 163 }
 164
 165 default_iteration() {
 166     if [[ -n "$ARVADOS_BUILDING_VERSION" ]]; then
 167         echo "$ARVADOS_BUILDING_ITERATION"
 168         return
 169     fi
 170     local package_name="$1"; shift
 171     local package_version="$1"; shift
 172     local package_type="$1"; shift
 173     local iteration=1
 174     if [[ $package_version =~ ^0\.1\.([0-9]{14})(\.|$) ]] && \
 175            [[ ${BASH_REMATCH[1]} -le $LICENSE_PACKAGE_TS ]]; then
 176         iteration=2
 177     fi
 178     if [[ $package_type =~ ^python ]]; then
 179       # Fix --iteration for #9242.
 180       iteration=2
 181     fi
 182     echo $iteration
 183 }
 184
 185 _build_rails_package_scripts() {
 186     local pkgname="$1"; shift
 187     local destdir="$1"; shift
 188     local srcdir="$RUN_BUILD_PACKAGES_PATH/rails-package-scripts"
 189     for scriptname in postinst prerm postrm; do
 190         cat "$srcdir/$pkgname.sh" "$srcdir/step2.sh" "$srcdir/$scriptname.sh" \
 191             >"$destdir/$scriptname" || return $?
 192     done
 193 }
 194
 195 test_rails_package_presence() {
 196   local pkgname="$1"; shift
 197   local srcdir="$1"; shift
 198
 199   if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
 200     return 1
 201   fi
 202
 203   tmppwd=`pwd`
 204
 205   cd $srcdir
 206
 207   local version="$(version_from_git)"
 208
 209   cd $tmppwd
 210
 211   test_package_presence $pkgname $version rails "$RAILS_PACKAGE_ITERATION"
 212 }
 213
 214 test_package_presence() {
 215     local pkgname="$1"; shift
 216     local version="$1"; shift
 217     local pkgtype="$1"; shift
 218     local iteration="$1"; shift
 219     local arch="$1"; shift
 220
 221     if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
 222         return 1
 223     fi
 224
 225     if [[ "$iteration" == "" ]]; then
 226         iteration="$(default_iteration "$pkgname" "$version" "$pkgtype")"
 227     fi
 228
 229     if [[ "$arch" == "" ]]; then
 230       rpm_architecture="x86_64"
 231       deb_architecture="amd64"
 232
 233       if [[ "$pkgtype" =~ ^(python|python3)$ ]]; then
 234         rpm_architecture="noarch"
 235         deb_architecture="all"
 236       fi
 237
 238       if [[ "$pkgtype" =~ ^(src)$ ]]; then
 239         rpm_architecture="noarch"
 240         deb_architecture="all"
 241       fi
 242
 243       # These python packages have binary components
 244       if [[ "$pkgname" =~ (ruamel|ciso|pycrypto|pyyaml) ]]; then
 245         rpm_architecture="x86_64"
 246         deb_architecture="amd64"
 247       fi
 248     else
 249       rpm_architecture=$arch
 250       deb_architecture=$arch
 251     fi
 252
 253     if [[ "$FORMAT" == "deb" ]]; then
 254         local complete_pkgname="${pkgname}_$version${iteration:+-$iteration}_$deb_architecture.deb"
 255     else
 256         # rpm packages get iteration 1 if we don't supply one
 257         iteration=${iteration:-1}
 258         local complete_pkgname="$pkgname-$version-${iteration}.$rpm_architecture.rpm"
 259     fi
 260
 261     # See if we can skip building the package, only if it already exists in the
 262     # processed/ directory. If so, move it back to the packages directory to make
 263     # sure it gets picked up by the test and/or upload steps.
 264     # Get the list of packages from the repos
 265
 266     if [[ "$FORMAT" == "deb" ]]; then
 267       debian_distros="jessie precise stretch trusty wheezy xenial"
 268
 269       for D in ${debian_distros}; do
 270         if [ ${pkgname:0:3} = "lib" ]; then
 271           repo_subdir=${pkgname:0:4}
 272         else
 273           repo_subdir=${pkgname:0:1}
 274         fi
 275
 276         repo_pkg_list=$(curl -o - http://apt.arvados.org/pool/${D}/main/${repo_subdir}/)
 277         echo ${repo_pkg_list} |grep -q ${complete_pkgname}
 278         if [ $? -eq 0 ]; then
 279           echo "Package $complete_pkgname exists, not rebuilding!"
 280           curl -o ./${complete_pkgname} http://apt.arvados.org/pool/${D}/main/${repo_subdir}/${complete_pkgname}
 281           return 1
 282         else
 283           echo "Package $complete_pkgname not found, building"
 284           return 0
 285         fi
 286       done
 287     else
 288       centos_repo="http://rpm.arvados.org/CentOS/7/dev/x86_64/"
 289
 290       repo_pkg_list=$(curl -o - ${centos_repo})
 291       echo ${repo_pkg_list} |grep -q ${complete_pkgname}
 292       if [ $? -eq 0 ]; then
 293         echo "Package $complete_pkgname exists, not rebuilding!"
 294         curl -o ./${complete_pkgname} ${centos_repo}${complete_pkgname}
 295         return 1
 296       else
 297         echo "Package $complete_pkgname not found, building"
 298         return 0
 299       fi
 300     fi
 301 }
 302
 303 handle_rails_package() {
 304     local pkgname="$1"; shift
 305
 306     if [[ -n "$ONLY_BUILD" ]] && [[ "$pkgname" != "$ONLY_BUILD" ]] ; then
 307         return 0
 308     fi
 309     local srcdir="$1"; shift
 310     cd "$srcdir"
 311     local license_path="$1"; shift
 312     local version="$(version_from_git)"
 313     echo "$version" >package-build.version
 314     local scripts_dir="$(mktemp --tmpdir -d "$pkgname-XXXXXXXX.scripts")" && \
 315     (
 316         set -e
 317         _build_rails_package_scripts "$pkgname" "$scripts_dir"
 318         cd "$srcdir"
 319         mkdir -p tmp
 320         git rev-parse HEAD >git-commit.version
 321         bundle package --all
 322     )
 323     if [[ 0 != "$?" ]] || ! cd "$WORKSPACE/packages/$TARGET"; then
 324         echo "ERROR: $pkgname package prep failed" >&2
 325         rm -rf "$scripts_dir"
 326         EXITCODE=1
 327         return 1
 328     fi
 329     local railsdir="/var/www/${pkgname%-server}/current"
 330     local -a pos_args=("$srcdir/=$railsdir" "$pkgname" "Curoverse, Inc." dir "$version")
 331     local license_arg="$license_path=$railsdir/$(basename "$license_path")"
 332     local -a switches=(--after-install "$scripts_dir/postinst"
 333                        --before-remove "$scripts_dir/prerm"
 334                        --after-remove "$scripts_dir/postrm")
 335     if [[ -z "$ARVADOS_BUILDING_VERSION" ]]; then
 336         switches+=(--iteration $RAILS_PACKAGE_ITERATION)
 337     fi
 338     # For some reason fpm excludes need to not start with /.
 339     local exclude_root="${railsdir#/}"
 340     # .git and packages are for the SSO server, which is built from its
 341     # repository root.
 342     local -a exclude_list=(.git packages tmp log coverage Capfile\* \
 343                            config/deploy\* config/application.yml)
 344     # for arvados-workbench, we need to have the (dummy) config/database.yml in the package
 345     if  [[ "$pkgname" != "arvados-workbench" ]]; then
 346       exclude_list+=('config/database.yml')
 347     fi
 348     for exclude in ${exclude_list[@]}; do
 349         switches+=(-x "$exclude_root/$exclude")
 350     done
 351     fpm_build "${pos_args[@]}" "${switches[@]}" \
 352               -x "$exclude_root/vendor/cache-*" \
 353               -x "$exclude_root/vendor/bundle" "$@" "$license_arg"
 354     rm -rf "$scripts_dir"
 355 }
 356
 357 # Build packages for everything
 358 fpm_build () {
 359   # The package source.  Depending on the source type, this can be a
 360   # path, or the name of the package in an upstream repository (e.g.,
 361   # pip).
 362   PACKAGE=$1
 363   shift
 364   # The name of the package to build.
 365   PACKAGE_NAME=$1
 366   shift
 367   # Optional: the vendor of the package.  Should be "Curoverse, Inc." for
 368   # packages of our own software.  Passed to fpm --vendor.
 369   VENDOR=$1
 370   shift
 371   # The type of source package.  Passed to fpm -s.  Default "python".
 372   PACKAGE_TYPE=${1:-python}
 373   shift
 374   # Optional: the package version number.  Passed to fpm -v.
 375   VERSION=$1
 376   shift
 377
 378   if [[ -n "$ONLY_BUILD" ]] && [[ "$PACKAGE_NAME" != "$ONLY_BUILD" ]] && [[ "$PACKAGE" != "$ONLY_BUILD" ]] ; then
 379       return 0
 380   fi
 381
 382   local default_iteration_value="$(default_iteration "$PACKAGE" "$VERSION" "$PACKAGE_TYPE")"
 383   local python=""
 384
 385   case "$PACKAGE_TYPE" in
 386       python)
 387           # All Arvados Python2 packages depend on Python 2.7.
 388           # Make sure we build with that for consistency.
 389           python=python2.7
 390           set -- "$@" --python-bin python2.7 \
 391               --python-easyinstall "$EASY_INSTALL2" \
 392               --python-package-name-prefix "$PYTHON2_PKG_PREFIX" \
 393               --prefix "$PYTHON2_PREFIX" \
 394               --python-install-lib "$PYTHON2_INSTALL_LIB" \
 395               --python-install-data . \
 396               --exclude "${PYTHON2_INSTALL_LIB#/}/tests" \
 397               --depends "$PYTHON2_PACKAGE"
 398           ;;
 399       python3)
 400           # fpm does not actually support a python3 package type.  Instead
 401           # we recognize it as a convenience shortcut to add several
 402           # necessary arguments to fpm's command line later, after we're
 403           # done handling positional arguments.
 404           PACKAGE_TYPE=python
 405           python=python3
 406           set -- "$@" --python-bin python3 \
 407               --python-easyinstall "$EASY_INSTALL3" \
 408               --python-package-name-prefix "$PYTHON3_PKG_PREFIX" \
 409               --prefix "$PYTHON3_PREFIX" \
 410               --python-install-lib "$PYTHON3_INSTALL_LIB" \
 411               --python-install-data . \
 412               --exclude "${PYTHON3_INSTALL_LIB#/}/tests" \
 413               --depends "$PYTHON3_PACKAGE"
 414           ;;
 415   esac
 416
 417   declare -a COMMAND_ARR=("fpm" "--maintainer=Ward Vandewege <ward@curoverse.com>" "-s" "$PACKAGE_TYPE" "-t" "$FORMAT")
 418   if [ python = "$PACKAGE_TYPE" ] && [ deb = "$FORMAT" ]; then
 419       # Dependencies are built from setup.py.  Since setup.py will never
 420       # refer to Debian package iterations, it doesn't make sense to
 421       # enforce those in the .deb dependencies.
 422       COMMAND_ARR+=(--deb-ignore-iteration-in-dependencies)
 423   fi
 424
 425   # 12271 - As FPM-generated packages don't include scripts by default, the
 426   # packages cleanup on upgrade depends on files being listed on the %files
 427   # section in the generated SPEC files. To remove DIRECTORIES, they need to
 428   # be listed in that sectiontoo, so we need to add this parameter to properly
 429   # remove lingering dirs. But this only works for python2: if used on
 430   # python33, it includes dirs like /opt/rh/python33 that belong to
 431   # other packages.
 432   if [[ "$FORMAT" = rpm ]] && [[ "$python" = python2.7 ]]; then
 433     COMMAND_ARR+=('--rpm-auto-add-directories')
 434   fi
 435
 436   if [[ "${DEBUG:-0}" != "0" ]]; then
 437     COMMAND_ARR+=('--verbose' '--log' 'info')
 438   fi
 439
 440   if [[ -n "$PACKAGE_NAME" ]]; then
 441     COMMAND_ARR+=('-n' "$PACKAGE_NAME")
 442   fi
 443
 444   if [[ "$VENDOR" != "" ]]; then
 445     COMMAND_ARR+=('--vendor' "$VENDOR")
 446   fi
 447
 448   if [[ "$VERSION" != "" ]]; then
 449     COMMAND_ARR+=('-v' "$VERSION")
 450   fi
 451   if [[ -n "$default_iteration_value" ]]; then
 452       # We can always add an --iteration here.  If another one is specified in $@,
 453       # that will take precedence, as desired.
 454       COMMAND_ARR+=(--iteration "$default_iteration_value")
 455   fi
 456
 457   if [[ python = "$PACKAGE_TYPE" ]] && [[ -e "${PACKAGE}/${PACKAGE_NAME}.service" ]]
 458   then
 459       COMMAND_ARR+=(
 460           --after-install "${WORKSPACE}/build/go-python-package-scripts/postinst"
 461           --before-remove "${WORKSPACE}/build/go-python-package-scripts/prerm"
 462       )
 463   fi
 464
 465   # Append --depends X and other arguments specified by fpm-info.sh in
 466   # the package source dir. These are added last so they can override
 467   # the arguments added by this script.
 468   declare -a fpm_args=()
 469   declare -a build_depends=()
 470   declare -a fpm_depends=()
 471   declare -a fpm_exclude=()
 472   declare -a fpm_dirs=(
 473       # source dir part of 'dir' package ("/source=/dest" => "/source"):
 474       "${PACKAGE%%=/*}"
 475       # backports ("llfuse>=1.0" => "backports/python-llfuse")
 476       "${WORKSPACE}/backports/${PACKAGE_TYPE}-${PACKAGE%%[<=>]*}")
 477   if [[ -n "$PACKAGE_NAME" ]]; then
 478       fpm_dirs+=("${WORKSPACE}/backports/${PACKAGE_NAME}")
 479   fi
 480   for pkgdir in "${fpm_dirs[@]}"; do
 481       fpminfo="$pkgdir/fpm-info.sh"
 482       if [[ -e "$fpminfo" ]]; then
 483           debug_echo "Loading fpm overrides from $fpminfo"
 484           source "$fpminfo"
 485           break
 486       fi
 487   done
 488   for pkg in "${build_depends[@]}"; do
 489       if [[ $TARGET =~ debian|ubuntu ]]; then
 490           pkg_deb=$(ls "$WORKSPACE/packages/$TARGET/$pkg_"*.deb | sort -rg | awk 'NR==1')
 491           if [[ -e $pkg_deb ]]; then
 492               echo "Installing build_dep $pkg from $pkg_deb"
 493               dpkg -i "$pkg_deb"
 494           else
 495               echo "Attemping to install build_dep $pkg using apt-get"
 496               apt-get install -y "$pkg"
 497           fi
 498           apt-get -y -f install
 499       else
 500           pkg_rpm=$(ls "$WORKSPACE/packages/$TARGET/$pkg"-[0-9]*.rpm | sort -rg | awk 'NR==1')
 501           if [[ -e $pkg_rpm ]]; then
 502               echo "Installing build_dep $pkg from $pkg_rpm"
 503               rpm -i "$pkg_rpm"
 504           else
 505               echo "Attemping to install build_dep $pkg"
 506               rpm -i "$pkg"
 507           fi
 508       fi
 509   done
 510   for i in "${fpm_depends[@]}"; do
 511     COMMAND_ARR+=('--depends' "$i")
 512   done
 513   for i in "${fpm_exclude[@]}"; do
 514     COMMAND_ARR+=('--exclude' "$i")
 515   done
 516
 517   # Append remaining function arguments directly to fpm's command line.
 518   for i; do
 519     COMMAND_ARR+=("$i")
 520   done
 521
 522   COMMAND_ARR+=("${fpm_args[@]}")
 523
 524   COMMAND_ARR+=("$PACKAGE")
 525
 526   debug_echo -e "\n${COMMAND_ARR[@]}\n"
 527
 528   FPM_RESULTS=$("${COMMAND_ARR[@]}")
 529   FPM_EXIT_CODE=$?
 530
 531   fpm_verify $FPM_EXIT_CODE $FPM_RESULTS
 532
 533   # if something went wrong and debug is off, print out the fpm command that errored
 534   if [[ 0 -ne $? ]] && [[ "$STDOUT_IF_DEBUG" == "/dev/null" ]]; then
 535     echo -e "\n${COMMAND_ARR[@]}\n"
 536   fi
 537 }
 538
 539 # verify build results
 540 fpm_verify () {
 541   FPM_EXIT_CODE=$1
 542   shift
 543   FPM_RESULTS=$@
 544
 545   FPM_PACKAGE_NAME=''
 546   if [[ $FPM_RESULTS =~ ([A-Za-z0-9_\.-]*\.)(deb|rpm) ]]; then
 547     FPM_PACKAGE_NAME=${BASH_REMATCH[1]}${BASH_REMATCH[2]}
 548   fi
 549
 550   if [[ "$FPM_PACKAGE_NAME" == "" ]]; then
 551     EXITCODE=1
 552     echo
 553     echo "Error: $PACKAGE: Unable to figure out package name from fpm results:"
 554     echo
 555     echo $FPM_RESULTS
 556     echo
 557     return 1
 558   elif [[ "$FPM_RESULTS" =~ "File already exists" ]]; then
 559     echo "Package $FPM_PACKAGE_NAME exists, not rebuilding"
 560     return 0
 561   elif [[ 0 -ne "$FPM_EXIT_CODE" ]]; then
 562     EXITCODE=1
 563     echo "Error building package for $1:\n $FPM_RESULTS"
 564     return 1
 565   fi
 566 }
 567
 568 install_package() {
 569   PACKAGES=$@
 570   if [[ "$FORMAT" == "deb" ]]; then
 571     $SUDO apt-get install $PACKAGES --yes
 572   elif [[ "$FORMAT" == "rpm" ]]; then
 573     $SUDO yum -q -y install $PACKAGES
 574   fi
 575 }
 576
 577 title () {
 578     txt="********** $1 **********"
 579     printf "\n%*s%s\n\n" $((($COLUMNS-${#txt})/2)) "" "$txt"
 580 }
 581
 582 checkexit() {
 583     if [[ "$1" != "0" ]]; then
 584         title "!!!!!! $2 FAILED !!!!!!"
 585         failures+=("$2 (`timer`)")
 586     else
 587         successes+=("$2 (`timer`)")
 588     fi
 589 }
 590
 591 timer_reset() {
 592     t0=$SECONDS
 593 }
 594
 595 timer() {
 596     echo -n "$(($SECONDS - $t0))s"
 597 }
 598
 599 report_outcomes() {
 600     for x in "${successes[@]}"
 601     do
 602         echo "Pass: $x"
 603     done
 604
 605     if [[ ${#failures[@]} == 0 ]]
 606     then
 607         echo "All test suites passed."
 608     else
 609         echo "Failures (${#failures[@]}):"
 610         for x in "${failures[@]}"
 611         do
 612             echo "Fail: $x"
 613         done
 614     fi
 615 }