Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / python / cpython3 / d8faa3654c2887eaa146dcdb553a9f9793bd2e5a / . / Misc / build.sh
blob: a6ba927d7d8df20613d53c15e0a73c546e118632 [file] [log] [blame]
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]1#!/bin/sh
2
3## Script to build and test the latest python from svn. It basically
4## does this:
5## svn up ; ./configure ; make ; make test ; make install ; cd Doc ; make
6##
7## Logs are kept and rsync'ed to the host. If there are test failure(s),
8## information about the failure(s) is mailed.
9##
10## This script is run on the PSF's machine as user neal via crontab.
11##
12## Yes, this script would probably be easier in python, but then
13## there's a bootstrap problem. What if Python doesn't build?
14##
15## This script should be fairly clean Bourne shell, ie not too many
16## bash-isms. We should try to keep it portable to other Unixes.
17## Even though it will probably only run on Linux. I'm sure there are
18## several GNU-isms currently (date +%s and readlink).
19##
20## Perhaps this script should be broken up into 2 (or more) components.
21## Building doc is orthogonal to the rest of the python build/test.
22##
23
24## FIXME: we should detect test hangs (eg, if they take more than 45 minutes)
25
26## FIXME: we should run valgrind
27## FIXME: we should run code coverage
28
29## Utilities invoked in this script include:
Neal Norwitzd3a58672006-01-02 23:22:41 +0000[diff] [blame]30## basename, date, dirname, expr, grep, readlink, uname
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]31## cksum, make, mutt, rsync, svn
32
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]33## remember where did we started from
34DIR=`dirname $0`
35if [ "$DIR" = "" ]; then
36 DIR="."
37fi
38
39## make directory absolute
40DIR=`readlink -f $DIR`
Neal Norwitzd3a58672006-01-02 23:22:41 +0000[diff] [blame]41FULLPATHNAME="$DIR/`basename $0`"
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]42## we want Misc/..
43DIR=`dirname $DIR`
44
45## Configurable options
46
47FAILURE_SUBJECT="Python Regression Test Failures"
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]48#FAILURE_MAILTO="YOUR_ACCOUNT@gmail.com"
Neal Norwitzf415d5f2006-02-19 18:48:19 +0000[diff] [blame]49FAILURE_MAILTO="python-checkins@python.org"
Guido van Rossumd8faa362007-04-27 19:54:29 +0000[diff] [blame^]50#FAILURE_CC="optional--uncomment and set to desired address"
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]51
52REMOTE_SYSTEM="neal@dinsdale.python.org"
53REMOTE_DIR="/data/ftp.python.org/pub/docs.python.org/dev/"
54RESULT_FILE="$DIR/build/index.html"
55INSTALL_DIR="/tmp/python-test/local"
56RSYNC_OPTS="-aC -e ssh"
57
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]58# Always run the installed version of Python.
59PYTHON=$INSTALL_DIR/bin/python
60
61# Python options and regression test program that should always be run.
Thomas Wouters00ee7ba2006-08-21 19:07:27 +0000[diff] [blame]62REGRTEST_ARGS="-E -tt $INSTALL_DIR/lib/python2.6/test/regrtest.py"
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]63
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]64REFLOG="build/reflog.txt.out"
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000[diff] [blame]65# These tests are not stable and falsely report leaks sometimes.
Neal Norwitzf415d5f2006-02-19 18:48:19 +0000[diff] [blame]66# The entire leak report will be mailed if any test not in this list leaks.
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000[diff] [blame]67# Note: test_XXX (none currently) really leak, but are disabled
68# so we don't send spam. Any test which really leaks should only
69# be listed here if there are also test cases under Lib/test/leakers.
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]70LEAKY_TESTS="test_(XXX)" # Currently no tests should report spurious leaks.
Neal Norwitzf415d5f2006-02-19 18:48:19 +0000[diff] [blame]71
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000[diff] [blame]72# Skip these tests altogether when looking for leaks. These tests
73# do not need to be stored above in LEAKY_TESTS too.
74# test_compiler almost never finishes with the same number of refs
75# since it depends on other modules, skip it.
76# test_logging causes hangs, skip it.
77LEAKY_SKIPS="-x test_compiler test_logging"
78
79# Change this flag to "yes" for old releases to only update/build the docs.
Neal Norwitz88b78d82006-02-14 08:14:16 +0000[diff] [blame]80BUILD_DISABLED="no"
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]81
82## utility functions
83current_time() {
84 date +%s
85}
86
87update_status() {
88 now=`current_time`
89 time=`expr $now - $3`
90 echo "<li><a href=\"$2\">$1</a> <font size=\"-1\">($time seconds)</font></li>" >> $RESULT_FILE
91}
92
93mail_on_failure() {
94 if [ "$NUM_FAILURES" != "0" ]; then
Guido van Rossumd8faa362007-04-27 19:54:29 +0000[diff] [blame^]95 dest=$FAILURE_MAILTO
96 # FAILURE_CC is optional.
97 if [ "$FAILURE_CC" != "" ]; then
98 dest="$dest -c $FAILURE_CC"
99 fi
100 mutt -s "$FAILURE_SUBJECT $1 ($NUM_FAILURES)" $dest < $2
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]101 fi
102}
103
104## setup
105cd $DIR
106mkdir -p build
107rm -f $RESULT_FILE build/*.out
108rm -rf $INSTALL_DIR
109
110## create results file
111TITLE="Automated Python Build Results"
Neal Norwitzb8967592006-01-16 04:37:22 +0000[diff] [blame]112echo "<html>" >> $RESULT_FILE
113echo " <head>" >> $RESULT_FILE
114echo " <title>$TITLE</title>" >> $RESULT_FILE
115echo " <meta http-equiv=\"refresh\" content=\"43200\">" >> $RESULT_FILE
116echo " </head>" >> $RESULT_FILE
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]117echo "<body>" >> $RESULT_FILE
118echo "<h2>Automated Python Build Results</h2>" >> $RESULT_FILE
119echo "<table>" >> $RESULT_FILE
120echo " <tr>" >> $RESULT_FILE
121echo " <td>Built on:</td><td>`date`</td>" >> $RESULT_FILE
122echo " </tr><tr>" >> $RESULT_FILE
123echo " <td>Hostname:</td><td>`uname -n`</td>" >> $RESULT_FILE
124echo " </tr><tr>" >> $RESULT_FILE
125echo " <td>Platform:</td><td>`uname -srmpo`</td>" >> $RESULT_FILE
126echo " </tr>" >> $RESULT_FILE
127echo "</table>" >> $RESULT_FILE
128echo "<ul>" >> $RESULT_FILE
129
130## update, build, and test
131ORIG_CHECKSUM=`cksum $FULLPATHNAME`
132F=svn-update.out
133start=`current_time`
134svn update >& build/$F
135err=$?
136update_status "Updating" "$F" $start
Neal Norwitz88b78d82006-02-14 08:14:16 +0000[diff] [blame]137if [ $err = 0 -a "$BUILD_DISABLED" != "yes" ]; then
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]138 ## FIXME: we should check if this file has changed.
139 ## If it has changed, we should re-run the script to pick up changes.
140 if [ "$ORIG_CHECKSUM" != "$ORIG_CHECKSUM" ]; then
141 exec $FULLPATHNAME $@
142 fi
143
144 F=svn-stat.out
145 start=`current_time`
146 svn stat >& build/$F
147 ## ignore some of the diffs
148 NUM_DIFFS=`egrep -vc '^. (@test|db_home|Lib/test/(regrtest\.py|db_home))$' build/$F`
149 update_status "svn stat ($NUM_DIFFS possibly important diffs)" "$F" $start
150
151 F=configure.out
152 start=`current_time`
153 ./configure --prefix=$INSTALL_DIR --with-pydebug >& build/$F
154 err=$?
155 update_status "Configuring" "$F" $start
156 if [ $err = 0 ]; then
157 F=make.out
158 start=`current_time`
159 make >& build/$F
160 err=$?
161 warnings=`grep warning build/$F | egrep -vc "te?mpnam(_r|)' is dangerous,"`
162 update_status "Building ($warnings warnings)" "$F" $start
163 if [ $err = 0 ]; then
Neal Norwitzd19a4d42006-01-02 22:10:10 +0000[diff] [blame]164 ## make install
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]165 F=make-install.out
166 start=`current_time`
167 make install >& build/$F
168 update_status "Installing" "$F" $start
169
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]170 if [ ! -x $PYTHON ]; then
171 ln -s ${PYTHON}2.* $PYTHON
172 fi
173
Neal Norwitzd19a4d42006-01-02 22:10:10 +0000[diff] [blame]174 ## make and run basic tests
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]175 F=make-test.out
176 start=`current_time`
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]177 $PYTHON $REGRTEST_ARGS >& build/$F
Neal Norwitz79415522006-02-15 06:07:32 +0000[diff] [blame]178 NUM_FAILURES=`grep -ic " failed:" build/$F`
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]179 update_status "Testing basics ($NUM_FAILURES failures)" "$F" $start
Neal Norwitz02c408d2006-01-03 02:18:01 +0000[diff] [blame]180 mail_on_failure "basics" build/$F
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]181
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]182 F=make-test-opt.out
183 start=`current_time`
184 $PYTHON -O $REGRTEST_ARGS >& build/$F
185 NUM_FAILURES=`grep -ic " failed:" build/$F`
186 update_status "Testing opt ($NUM_FAILURES failures)" "$F" $start
187 mail_on_failure "opt" build/$F
188
Neal Norwitzd19a4d42006-01-02 22:10:10 +0000[diff] [blame]189 ## run the tests looking for leaks
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]190 F=make-test-refleak.out
191 start=`current_time`
Thomas Wouters49fd7fa2006-04-21 10:40:58 +0000[diff] [blame]192 ## ensure that the reflog exists so the grep doesn't fail
193 touch $REFLOG
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]194 $PYTHON $REGRTEST_ARGS -R 4:3:$REFLOG -u network $LEAKY_SKIPS >& build/$F
Neal Norwitzf415d5f2006-02-19 18:48:19 +0000[diff] [blame]195 NUM_FAILURES=`egrep -vc "$LEAKY_TESTS" $REFLOG`
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]196 update_status "Testing refleaks ($NUM_FAILURES failures)" "$F" $start
197 mail_on_failure "refleak" $REFLOG
198
Neal Norwitzd19a4d42006-01-02 22:10:10 +0000[diff] [blame]199 ## now try to run all the tests
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]200 F=make-testall.out
201 start=`current_time`
Neal Norwitzd19a4d42006-01-02 22:10:10 +0000[diff] [blame]202 ## skip curses when running from cron since there's no terminal
203 ## skip sound since it's not setup on the PSF box (/dev/dsp)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]204 $PYTHON $REGRTEST_ARGS -uall -x test_curses test_linuxaudiodev test_ossaudiodev >& build/$F
Neal Norwitz79415522006-02-15 06:07:32 +0000[diff] [blame]205 NUM_FAILURES=`grep -ic " failed:" build/$F`
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]206 update_status "Testing all except curses and sound ($NUM_FAILURES failures)" "$F" $start
Neal Norwitzd3a58672006-01-02 23:22:41 +0000[diff] [blame]207 mail_on_failure "all" build/$F
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]208 fi
209 fi
210fi
211
212
213## make doc
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000[diff] [blame]214cd $DIR/Doc
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]215F="make-doc.out"
216start=`current_time`
Guido van Rossumd8faa362007-04-27 19:54:29 +0000[diff] [blame^]217# Doc/commontex/boilerplate.tex is expected to always have an outstanding
218# modification for the date. When a release is cut, a conflict occurs.
219# This allows us to detect this problem and not try to build the docs
220# which will definitely fail with a conflict.
221CONFLICTED_FILE=commontex/boilerplate.tex
222conflict_count=`grep -c "<<<" $CONFLICTED_FILE`
223if [ $conflict_count != 0 ]; then
224 echo "Conflict detected in $CONFLICTED_FILE. Doc build skipped." > ../build/$F
225 err=1
226else
227 make >& ../build/$F
228 err=$?
229fi
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]230update_status "Making doc" "$F" $start
231if [ $err != 0 ]; then
232 NUM_FAILURES=1
233 mail_on_failure "doc" ../build/$F
234fi
235
236echo "</ul>" >> $RESULT_FILE
237echo "</body>" >> $RESULT_FILE
238echo "</html>" >> $RESULT_FILE
239
240## copy results
Neal Norwitz88b78d82006-02-14 08:14:16 +0000[diff] [blame]241rsync $RSYNC_OPTS html/* $REMOTE_SYSTEM:$REMOTE_DIR
Neal Norwitz461aa5b2006-01-02 20:07:16 +0000[diff] [blame]242cd ../build
243rsync $RSYNC_OPTS index.html *.out $REMOTE_SYSTEM:$REMOTE_DIR/results/
244