Deprecate run_test.sh

per nova commint 2dc5d9f8632c83c9bc7ee6871c6631edf69a5570
indicated run_tests.sh should be deprecated to avoid confusion
to people and encourage usage of tox.

Change-Id: I23940b4da55226f6fa4504ed3839cc6620d0f579

run_tests.sh

@@ -2,163 +2,45 @@
 
 set -eu
 
-function usage {
+cat <<EOF
-  echo "Usage: $0 [OPTION]..."
+run_tests.sh is deprecated and this script will be removed
-  echo "Run python-novaclient test suite"
+before the Mitaka release. All tests should be run through
-  echo ""
+tox.
-  echo "  -V, --virtual-env        Always use virtualenv.  Install automatically if not present"
-  echo "  -N, --no-virtual-env     Don't use virtualenv.  Run tests in local environment"
-  echo "  -s, --no-site-packages   Isolate the virtualenv from the global Python environment"
-  echo "  -x, --stop               Stop running tests after the first error or failure."
-  echo "  -f, --force              Force a clean re-build of the virtual environment. Useful when dependencies have been added."
-  echo "  -p, --pep8               Just run pep8"
-  echo "  -P, --no-pep8            Don't run pep8"
-  echo "  -c, --coverage           Generate coverage report"
-  echo "  -h, --help               Print this usage message"
-  echo "  --hide-elapsed           Don't print the elapsed time for each test along with slow test list"
-  echo ""
-  echo "Note: with no options specified, the script will try to run the tests in a virtual environment,"
-  echo "      If no virtualenv is found, the script will ask if you would like to create one.  If you "
-  echo "      prefer to run tests NOT in a virtual environment, simply pass the -N option."
-  exit
-}
 
-function process_option {
+To run style checks:
-  case "$1" in
-    -h|--help) usage;;
-    -V|--virtual-env) always_venv=1; never_venv=0;;
-    -N|--no-virtual-env) always_venv=0; never_venv=1;;
-    -s|--no-site-packages) no_site_packages=1;;
-    -f|--force) force=1;;
-    -p|--pep8) just_pep8=1;;
-    -P|--no-pep8) no_pep8=1;;
-    -c|--coverage) coverage=1;;
-    -*) testropts="$testropts $1";;
-    *) testrargs="$testrargs $1"
-  esac
-}
 
-venv=.venv
+ tox -e pep8
-with_venv=tools/with_venv.sh
-always_venv=0
-never_venv=0
-force=0
-no_site_packages=0
-installvenvopts=
-testrargs=
-testropts=
-wrapper=""
-just_pep8=0
-no_pep8=0
-coverage=0
 
-LANG=en_US.UTF-8
+To run python 2.7 unit tests
-LANGUAGE=en_US:en
-LC_ALL=C
 
-for arg in "$@"; do
+ tox -e py27
-  process_option $arg
-done
 
-if [ $no_site_packages -eq 1 ]; then
+To run functional tests
-  installvenvopts="--no-site-packages"
-fi
 
-function init_testr {
+ tox -e functional
-  if [ ! -d .testrepository ]; then
-    ${wrapper} testr init
-  fi
-}
 
-function run_tests {
+To run a subset of any of these tests:
-  # Cleanup *pyc
-  ${wrapper} find . -type f -name "*.pyc" -delete
 
-  if [ $coverage -eq 1 ]; then
+ tox -e py27 someregex
-    # Do not test test_coverage_ext when gathering coverage.
-    if [ "x$testrargs" = "x" ]; then
-      testrargs="^(?!.*test_coverage_ext).*$"
-    fi
-    export PYTHON="${wrapper} coverage run --source novaclient --parallel-mode"
-  fi
-  # Just run the test suites in current environment
-  set +e
-  TESTRTESTS="$TESTRTESTS $testrargs"
-  echo "Running \`${wrapper} $TESTRTESTS\`"
-  ${wrapper} $TESTRTESTS
-  RESULT=$?
-  set -e
 
-  copy_subunit_log
+ i.e.: tox -e py27 test_servers
 
-  return $RESULT
+Use following to replace './run_test.sh -8' to do pep8 check with changed files
-}
 
-function copy_subunit_log {
+ tox -e pep8 -- -HEAD
-  LOGNAME=`cat .testrepository/next-stream`
-  LOGNAME=$(($LOGNAME - 1))
-  LOGNAME=".testrepository/${LOGNAME}"
-  cp $LOGNAME subunit.log
-}
 
-function run_pep8 {
+Additional tox targets are available in tox.ini. For more information
-  echo "Running flake8 ..."
+see:
-  ${wrapper} flake8
+http://docs.openstack.org/project-team-guide/project-setup/python.html
-}
 
-TESTRTESTS="testr run --parallel $testropts"
+NOTE: if you really really don't want to use tox to run tests, you
+can instead use:
 
-if [ $never_venv -eq 0 ]
+ testr run
-then
-  # Remove the virtual environment if --force used
-  if [ $force -eq 1 ]; then
-    echo "Cleaning virtualenv..."
-    rm -rf ${venv}
-  fi
-  if [ -e ${venv} ]; then
-    wrapper="${with_venv}"
-  else
-    if [ $always_venv -eq 1 ]; then
-      # Automatically install the virtualenv
-      python tools/install_venv.py $installvenvopts
-      wrapper="${with_venv}"
-    else
-      echo -e "No virtual environment found...create one? (Y/n) \c"
-      read use_ve
-      if [ "x$use_ve" = "xY" -o "x$use_ve" = "x" -o "x$use_ve" = "xy" ]; then
-        # Install the virtualenv and run the test suite in it
-        python tools/install_venv.py $installvenvopts
-        wrapper=${with_venv}
-      fi
-    fi
-  fi
-fi
 
-# Delete old coverage data from previous runs
+Documentation on using testr directly can be found at
-if [ $coverage -eq 1 ]; then
+http://testrepository.readthedocs.org/en/latest/MANUAL.html
-    ${wrapper} coverage erase
-fi
 
-if [ $just_pep8 -eq 1 ]; then
+EOF
-    run_pep8
-    exit
-fi
 
-init_testr
+exit 1
-run_tests
-
-# NOTE(sirp): we only want to run pep8 when we're running the full-test suite,
-# not when we're running tests individually. To handle this, we need to
-# distinguish between options (noseopts), which begin with a '-', and
-# arguments (testrargs).
-if [ -z "$testrargs" ]; then
-  if [ $no_pep8 -eq 0 ]; then
-    run_pep8
-  fi
-fi
-
-if [ $coverage -eq 1 ]; then
-    echo "Generating coverage report in covhtml/"
-    ${wrapper} coverage combine
-    ${wrapper} coverage html --include='novaclient/*' --omit='novaclient/openstack/common/*' -d covhtml -i
-fi