Files
buildbot/common/validate.sh
2017-11-09 21:03:53 +01:00

274 lines
8.0 KiB
Bash
Executable File

#! /bin/bash
TEST='buildbot.test buildbot_worker.test'
# if stdout is a terminal define some colors
# validate.sh can be run as hook from GUI git clients, such as git-gui
if test -t 1; then
# plain
_ESC=$'\e'
GREEN="$_ESC[0;32m"
MAGENTA="$_ESC[0;35m"
RED="$_ESC[0;31m"
LTCYAN="$_ESC[1;36m"
YELLOW="$_ESC[1;33m"
NORM="$_ESC[0;0m"
fi
## parse options
quick=false
no_js=false
help=false
while [ $# -gt 0 ]; do
case $1 in
--quick) quick=true ;;
--no-js) no_js=true ;;
--help) help=true ;;
-*) echo "$0: error - unrecognized option $1" 1>&2; help=true ;;
*) REVRANGE="$1..HEAD" ;;
esac
shift
done
if $help; then
echo "USAGE: common/validate.sh [oldrev] [--quick] [--no-js] [--help]"
echo " This script will test a set of patches (oldrev..HEAD) for basic acceptability as a patch"
echo " Run it in an activated virtualenv with the current Buildbot installed, as well as"
echo " sphinx, flake8, mock, and so on"
echo "To use a different directory for tests, pass TRIALTMP=/path as an env variable"
echo "if --quick is passed validate will skip unit tests and concentrate on coding style"
echo "if --no-js is passed validate will skip tests that require Node and NPM"
echo "if --help is passed validate will output this message and exit"
echo "if no oldrev is passed validate will assume master...HEAD"
exit 1
fi
[ -z "$REVRANGE" ] && REVRANGE="master..HEAD"
status() {
echo "${LTCYAN}-- ${*} --${NORM}"
}
ok=true
problem_summary=""
not_ok() {
ok=false
echo "${RED}** ${*} **${NORM}"
problem_summary="$problem_summary"$'\n'"${RED}**${NORM} ${*}"
}
warning() {
echo "${YELLOW}** ${*} **${NORM}"
problem_summary="$problem_summary"$'\n'"${YELLOW}**${NORM} ${*} (warning)"
}
check_tabs() {
git diff "$REVRANGE" | grep -q $'+.*\t'
}
check_long_lines() {
# only check python files
local long_lines=false
for f in $(git diff --name-only --stat "$REVRANGE" | grep '.py$'); do
# don't try to check removed files
[ ! -f "$f" ] && continue
if [ $(git diff "$REVRANGE" $f | grep -E -c '^\+.{80}') != 0 ]; then
echo " $f"
long_lines=true
fi
done
$long_lines
}
check_yield_defer_returnValue() {
local yields=false
if git diff "$REVRANGE" | grep '+.*yield defer.returnValue'; then
yields=true
fi
$yields
}
check_relnotes() {
if git diff --exit-code "$REVRANGE" master/docs/relnotes/index.rst >/dev/null 2>&1; then
return 1
else
return 0
fi
}
check_sa_Table() {
local bad_files=$(git grep -l 'sa\.Table(' | grep '\.py$' | grep -v '^master/buildbot/util/sautils\.py$')
if [ -n "${bad_files}" ]; then
echo "${YELLOW}Source files found containing 'sa.Table':${NORM}"
for f in $bad_files; do
echo " ${YELLOW}*${NORM} $f"
done
echo "${YELLOW}import buildbot.util.sautils and use sautils.Table instead.${NORM}"
return 1
fi
return 0
}
run_tests() {
if [ -n "${TRIALTMP}" ]; then
TEMP_DIRECTORY_OPT="--temp-directory ${TRIALTMP}"
else
warning "please provide a TRIALTMP env variable pointing to a ramfs for 30x speed up of the integration tests"
fi
find . -name \*.pyc -exec rm {} \;
trial --reporter text ${TEMP_DIRECTORY_OPT} ${TEST}
}
if ! git diff --no-ext-diff --quiet --exit-code; then
not_ok "changed files in working copy"
if ! $quick; then
exit 1
fi
fi
# get a list of changed files, used below; this uses a tempfile to work around
# shell behavior when piping to 'while'
tempfile=$(mktemp -t tmp.XXXXXX)
trap "rm -f ${tempfile}; exit 1" 1 2 3 15
git diff --name-only $REVRANGE | grep '\.py$' | grep -v '\(^master/docs\|/setup\.py\)' > ${tempfile}
py_files=()
while read line; do
if test -f "${line}"; then
py_files+=($line)
fi
done < ${tempfile}
echo "${MAGENTA}Validating the following commits:${NORM}"
git log "$REVRANGE" --pretty=oneline || exit 1
if ! $quick && ! $no_js; then
for module in www/base www/console_view www/grid_view www/waterfall_view www/codeparameter www/wsgi_dashboards;
do
status "running 'setup.py develop' for $module"
if ! (cd $module; python setup.py develop >/dev/null ); then
warning "$module/setup.py failed; retrying with cleared libs/"
rm -rf "$module/libs"
(cd $module; python setup.py develop >/dev/null ) || not_ok "$module/setup.py failed"
fi
done
else
warning "Skipping JavaScript Tests"
fi
if ! $quick; then
status "running Python tests"
run_tests || not_ok "Python tests failed"
elif [ -z `command -v cctrial` ]; then
warning "Skipping Python Tests ('pip install cctrial' for quick tests)"
else
cctrial -H buildbot buildbot_worker || not_ok "Python tests failed"
fi
status "checking formatting"
check_tabs && not_ok "$REVRANGE adds tabs"
check_long_lines && warning "$REVRANGE adds long lines"
check_yield_defer_returnValue && not_ok "$REVRANGE yields defer.returnValue"
status "checking for use of sa.Table"
check_sa_Table || warning "use (buildbot.util.)sautils.Table instead of sa.Table"
status "checking for release notes"
check_relnotes || warning "$REVRANGE does not add release notes"
if [ ${#py_files[@]} -ne 0 ]; then
status "checking import module convention in modified files"
if [[ -z `command -v isort` ]]; then
warning "isort is not installed"
else
if ! isort ${py_files[@]}; then
warning "unable to run isort on modified files"
else
if ! git diff --quiet --exit-code ${py_files[@]}; then
not_ok "isort made changes"
fi
fi
fi
fi
status "running autopep8"
if [[ -z `command -v autopep8` ]]; then
warning "autopep8 is not installed"
elif [[ ! -f common/flake8rc ]]; then
warning "common/flake8rc not found"
else
changes_made=false
for filename in ${py_files[@]}; do
LINEWIDTH=$(grep -E "max-line-length" common/flake8rc | sed 's/ //g' | cut -d'=' -f 2)
# even if we don't enforce errors, if they can be fixed automatically, that's better..
IGNORES=E123,E501,W6
# ignore is not None for SQLAlchemy code..
if [[ "$filename" =~ "/db/" ]]; then
IGNORES=$IGNORES,E711,E712
fi
autopep8 --in-place --max-line-length=$LINEWIDTH --ignore=$IGNORES "$filename"
if ! git diff --quiet --exit-code "$filename"; then
changes_made=true
fi
done
if ${changes_made}; then
not_ok "autopep8 made changes"
fi
fi
status "running flake8"
if [[ -z `command -v flake8` ]]; then
warning "flake8 is not installed"
else
flake8_ok=true
for filename in ${py_files[@]}; do
if ! flake8 --config=common/flake8rc "$filename"; then
flake8_ok=false
fi
done
$flake8_ok || not_ok "flake8 failed"
fi
status "running pylint"
if [[ -z `command -v pylint` ]]; then
warning "pylint is not installed"
elif [[ ! -f common/pylintrc ]]; then
warning "common/pylintrc not found"
else
pylint_ok=true
for filename in ${py_files[@]}; do
if ! pylint --rcfile=common/pylintrc --disable=R,line-too-long \
--enable=W0611 --output-format=text --reports=no \
--spelling-private-dict-file=common/code_spelling_ignore_words.txt \
"$filename"; then
pylint_ok=false
fi
done
$pylint_ok || not_ok "pylint failed"
fi
if git diff --name-only $REVRANGE | grep ^master/docs/ ; then
status "building docs"
# Don't clean builddir if built in quick mode
if ! $quick ; then
make -C master/docs clean || not_ok "docs cleanup failed"
fi
make -C master/docs VERSION=latest html || not_ok "docs failed"
else
status "not building docs, because it was not changed"
fi
echo ""
if $ok; then
if [ -z "${problem_summary}" ]; then
echo "${GREEN}GOOD!${NORM}"
else
echo "${YELLOW}WARNINGS${NORM}${problem_summary}"
fi
exit 0
else
echo "${RED}NO GOOD!${NORM}${problem_summary}"
exit 1
fi