escript/trunk/autodocs.sh

#!/bin/bash

# Build all escript documentation on shake71 and put it on the web server
# in the proper place so the ESSCC twiki can find it. The build command is
#   scons docs

# Run this nightly on shake71 via cron, such as at 1:00 AM every night, with
# 0      1    *    *     0-6      /home/Work/Documentation_Escript/autodocs.sh >& /home/Work/Documentation_Escript/log

# This will have an error occasionally because svn checkout fails. 
# The problem may be that the certificate has expired.  If that's the
# case try an svn checkout (or svn list) by hand and accept the
# certificate.  Then the problem will be resolved.

# Requires:
#   svn checkout from shake200
#   scp to shake200 to upload new documentation to web site
#   epydoc
#   doxygen
#   latex
#   latex2html

DIR="/home/Work/Documentation_Escript"

START=`date '+%Y/%m/%d %H:%M'`
RunDate=`date '+%Y_%m_%d'`

scons='/home/Work/scons-0.96.92/bin/scons'

finish () {
  # state will be 'FAILURE' or 'SUCCESS'
  state="$1"
  date
  # Clean up the sandbox
  cd $DIR
  ### /bin/rm -rf sandbox
  END=`date '+%Y/%m/%d %H:%M'`
  cat << END_MSG | mail -s "ESYS_TESTS docs $RunDate $state" k.steube@uq.edu.au
$2.
The tests ran from $START to $END
See the log file /home/Work/Documentation_Escript/log for info
This mail was sent by $0
running via cron as $USER on `hostname`.
END_MSG
  if [ "x$state" = "xFAILURE" ]; then
    exit 1
  fi
  exit 0
}

umask 022

cd $DIR         || finish FAILURE "Could not cd to $DIR"

/bin/rm -rf sandbox
mkdir sandbox       || finish FAILURE "Could not mkdir sandbox"
cd sandbox      || finish FAILURE "Could not cd to sandbox"

echo "Checking out esys13/trunk"
svn checkout https://shake200.esscc.uq.edu.au/svn/esys13/trunk || finish FAILURE "Could not checkout esys13/trunk"

export PATH="/home/Work/latex2html-2002-2-1/bin:$PATH"
export LD_LIBRARY_PATH="$DIR/sandbox/trunk/lib:/home/Work/VTK-4.4.2/lib"
export PYTHONPATH="$DIR/sandbox/trunk"

# Generate documentation
echo "Generating documentation"

cd trunk                            || finish FAILURE "Could not cd to trunk"
mkdir release release/doc                   || finish FAILURE "Could not create release directory"
$scons dodebug=yes useMPI=no docs               || finish FAILURE "Could not run scons docs"
scp -r release/doc/* shake200:/home/www/esys/esys13/nightly || finish FAILURE "Could not copy documentation to nightly area"

echo "Cleaning up"

finish SUCCESS "Successfully ran 'scons docs' on `hostname`"

1	ksteube	1218	#!/bin/bash
2
3			# Build all escript documentation on shake71 and put it on the web server
4			# in the proper place so the ESSCC twiki can find it. The build command is
5			# scons docs
6
7	ksteube	1337	# Run this nightly on shake71 via cron, such as at 1:00 AM every night, with
8			# 0 1 * * 0-6 /home/Work/Documentation_Escript/autodocs.sh >& /home/Work/Documentation_Escript/log
9	ksteube	1218
10	ksteube	1337	# This will have an error occasionally because svn checkout fails.
11			# The problem may be that the certificate has expired. If that's the
12			# case try an svn checkout (or svn list) by hand and accept the
13			# certificate. Then the problem will be resolved.
14
15	ksteube	1218	# Requires:
16			# svn checkout from shake200
17			# scp to shake200 to upload new documentation to web site
18			# epydoc
19			# doxygen
20			# latex
21			# latex2html
22
23			DIR="/home/Work/Documentation_Escript"
24
25			START=`date '+%Y/%m/%d %H:%M'`
26	ksteube	1219	RunDate=`date '+%Y_%m_%d'`
27	ksteube	1218
28	ksteube	1219	scons='/home/Work/scons-0.96.92/bin/scons'
29
30	ksteube	1218	finish () {
31			# state will be 'FAILURE' or 'SUCCESS'
32			state="$1"
33			date
34			# Clean up the sandbox
35			cd $DIR
36			### /bin/rm -rf sandbox
37			END=`date '+%Y/%m/%d %H:%M'`
38	ksteube	1219	cat << END_MSG \| mail -s "ESYS_TESTS docs $RunDate $state" k.steube@uq.edu.au
39	ksteube	1218	$2.
40			The tests ran from $START to $END
41	ksteube	1219	See the log file /home/Work/Documentation_Escript/log for info
42	ksteube	1218	This mail was sent by $0
43	ksteube	1219	running via cron as $USER on `hostname`.
44	ksteube	1218	END_MSG
45			if [ "x$state" = "xFAILURE" ]; then
46			exit 1
47			fi
48			exit 0
49			}
50
51			umask 022
52
53			cd $DIR \|\| finish FAILURE "Could not cd to $DIR"
54
55	ksteube	1219	/bin/rm -rf sandbox
56	ksteube	1218	mkdir sandbox \|\| finish FAILURE "Could not mkdir sandbox"
57			cd sandbox \|\| finish FAILURE "Could not cd to sandbox"
58
59			echo "Checking out esys13/trunk"
60			svn checkout https://shake200.esscc.uq.edu.au/svn/esys13/trunk \|\| finish FAILURE "Could not checkout esys13/trunk"
61
62			export PATH="/home/Work/latex2html-2002-2-1/bin:$PATH"
63			export LD_LIBRARY_PATH="$DIR/sandbox/trunk/lib:/home/Work/VTK-4.4.2/lib"
64			export PYTHONPATH="$DIR/sandbox/trunk"
65
66			# Generate documentation
67			echo "Generating documentation"
68
69			cd trunk \|\| finish FAILURE "Could not cd to trunk"
70			mkdir release release/doc \|\| finish FAILURE "Could not create release directory"
71	ksteube	1219	$scons dodebug=yes useMPI=no docs \|\| finish FAILURE "Could not run scons docs"
72	ksteube	1218	scp -r release/doc/* shake200:/home/www/esys/esys13/nightly \|\| finish FAILURE "Could not copy documentation to nightly area"
73
74			echo "Cleaning up"
75
76			finish SUCCESS "Successfully ran 'scons docs' on `hostname`"
77