Upgrade to Django 1.5
[fnpdjango.git] / bin / git-archive-all.sh
1 #!/bin/bash -
2 #
3 # File:        git-archive-all.sh
4 #
5 # Description: A utility script that builds an archive file(s) of all
6 #              git repositories and submodules in the current path.
7 #              Useful for creating a single tarfile of a git super-
8 #              project that contains other submodules.
9 #
10 # Examples:    Use git-archive-all.sh to create archive distributions
11 #              from git repositories. To use, simply do:
12 #
13 #                  cd $GIT_DIR; git-archive-all.sh
14 #
15 #              where $GIT_DIR is the root of your git superproject.
16 #
17 # License:     GPL3
18 #
19 ###############################################################################
20 #
21 # This program is free software; you can redistribute it and/or modify
22 # it under the terms of the GNU General Public License as published by
23 # the Free Software Foundation; either version 2 of the License, or
24 # (at your option) any later version.
25 #
26 # This program is distributed in the hope that it will be useful,
27 # but WITHOUT ANY WARRANTY; without even the implied warranty of
28 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
29 # GNU General Public License for more details.
30 #
31 # You should have received a copy of the GNU General Public License
32 # along with this program; if not, write to the Free Software
33 # Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA
34 #
35 ###############################################################################
36
37 # DEBUGGING
38 set -e
39 set -C # noclobber
40
41 # TRAP SIGNALS
42 trap 'cleanup' QUIT EXIT
43
44 # For security reasons, explicitly set the internal field separator
45 # to newline, space, tab
46 OLD_IFS=$IFS
47 IFS='
48         '
49
50 function cleanup () {
51     rm -f $TMPFILE
52     rm -f $TOARCHIVE
53     IFS="$OLD_IFS"
54 }
55
56 function usage () {
57     echo "Usage is as follows:"
58     echo
59     echo "$PROGRAM <--version>"
60     echo "    Prints the program version number on a line by itself and exits."
61     echo
62     echo "$PROGRAM <--usage|--help|-?>"
63     echo "    Prints this usage output and exits."
64     echo
65     echo "$PROGRAM [--format <fmt>] [--prefix <path>] [--separate|-s] [output_file]"
66     echo "    Creates an archive for the entire git superproject, and its submodules"
67     echo "    using the passed parameters, described below."
68     echo
69     echo "    If '--format' is specified, the archive is created with the named"
70     echo "    git archiver backend. Obviously, this must be a backend that git-archive"
71     echo "    understands. The format defaults to 'tar' if not specified."
72     echo
73     echo "    If '--prefix' is specified, the archive's superproject and all submodules"
74     echo "    are created with the <path> prefix named. The default is to not use one."
75     echo
76     echo "    If '--separate' or '-s' is specified, individual archives will be created"
77     echo "    for each of the superproject itself and its submodules. The default is to"
78     echo "    concatenate individual archives into one larger archive."
79     echo
80     echo "    If 'output_file' is specified, the resulting archive is created as the"
81     echo "    file named. This parameter is essentially a path that must be writeable."
82     echo "    When combined with '--separate' ('-s') this path must refer to a directory."
83     echo "    Without this parameter or when combined with '--separate' the resulting"
84     echo "    archive(s) are named with a dot-separated path of the archived directory and"
85     echo "    a file extension equal to their format (e.g., 'superdir.submodule1dir.tar')."
86 }
87
88 function version () {
89     echo "$PROGRAM version $VERSION"
90 }
91
92 # Internal variables and initializations.
93 readonly PROGRAM=`basename "$0"`
94 readonly VERSION=0.2
95
96 OLD_PWD="`pwd`"
97 TMPDIR=${TMPDIR:-/tmp}
98 TMPFILE=`mktemp "$TMPDIR/$PROGRAM.XXXXXX"` # Create a place to store our work's progress
99 TOARCHIVE=`mktemp "$TMPDIR/$PROGRAM.toarchive.XXXXXX"`
100 OUT_FILE=$OLD_PWD # assume "this directory" without a name change by default
101 SEPARATE=0
102
103 FORMAT=tar
104 PREFIX=
105 TREEISH=HEAD
106
107 # RETURN VALUES/EXIT STATUS CODES
108 readonly E_BAD_OPTION=254
109 readonly E_UNKNOWN=255
110
111 # Process command-line arguments.
112 while test $# -gt 0; do
113     case $1 in
114         --format )
115             shift
116             FORMAT="$1"
117             shift
118             ;;
119
120         --prefix )
121             shift
122             PREFIX="$1"
123             shift
124             ;;
125
126         --separate | -s )
127             shift
128             SEPARATE=1
129             ;;
130
131         --version )
132             version
133             exit
134             ;;
135
136         -? | --usage | --help )
137             usage
138             exit
139             ;;
140
141         -* )
142             echo "Unrecognized option: $1" >&2
143             usage
144             exit $E_BAD_OPTION
145             ;;
146
147         * )
148             break
149             ;;
150     esac
151 done
152
153 if [ ! -z "$1" ]; then
154     OUT_FILE="$1"
155     shift
156 fi
157
158 # Validate parameters; error early, error often.
159 if [ $SEPARATE -eq 1 -a ! -d $OUT_FILE ]; then
160     echo "When creating multiple archives, your destination must be a directory."
161     echo "If it's not, you risk being surprised when your files are overwritten."
162     exit 1
163 elif [ `git config -l | grep -q '^core\.bare=false'; echo $?` -ne 0 ]; then
164     echo "$PROGRAM must be run from a git working copy (i.e., not a bare repository)."
165     exit 1
166 elif ! git rev-parse HEAD &> /dev/null; then
167     echo "You must have some commit in the git working copy."
168     exit 1
169 fi
170
171 # Create the superproject's git-archive
172 git archive --format=$FORMAT --prefix="$PREFIX" $TREEISH > $TMPDIR/$(basename $(pwd)).$FORMAT
173 echo $TMPDIR/$(basename $(pwd)).$FORMAT >| $TMPFILE # clobber on purpose
174 superfile=`head -n 1 $TMPFILE`
175
176 set +e
177 # find all '.git' dirs, these show us the remaining to-be-archived dirs
178 find . -name '.git' -type d -print | sed -e 's/^\.\///' -e 's/\.git$//' | grep -v '^$' >> $TOARCHIVE
179 set -e
180
181 while read path; do
182     TREEISH=$(git submodule | grep "^ .*${path%/} " | cut -d ' ' -f 2) # git-submodule does not list trailing slashes in $path
183     cd "$path"
184     git archive --format=$FORMAT --prefix="${PREFIX}$path" ${TREEISH:-HEAD} > "$TMPDIR"/"$(echo "$path" | sed -e 's/\//./g')"$FORMAT
185     if [ $FORMAT == 'zip' ]; then
186         # delete the empty directory entry; zipped submodules won't unzip if we don't do this
187         zip -d "$(tail -n 1 $TMPFILE)" "${PREFIX}${path%/}" >/dev/null # remove trailing '/'
188     fi
189     echo "$TMPDIR"/"$(echo "$path" | sed -e 's/\//./g')"$FORMAT >> $TMPFILE
190     cd "$OLD_PWD"
191 done < $TOARCHIVE
192 # Concatenate archives into a super-archive.
193 if [ $SEPARATE -eq 0 ]; then
194     if [ $FORMAT == 'tar' ]; then
195         sed -e '1d' $TMPFILE | while read file; do
196             tar --concatenate -f "$superfile" "$file" && rm -f "$file"
197         done
198     elif [ $FORMAT == 'zip' ]; then
199         sed -e '1d' $TMPFILE | while read file; do
200             # zip incorrectly stores the full path, so cd and then grow
201             cd `dirname "$file"`
202             zip -g "$superfile" `basename "$file"` && rm -f "$file"
203         done
204         cd "$OLD_PWD"
205     fi
206
207     echo "$superfile" >| $TMPFILE # clobber on purpose
208 fi
209
210 while read file; do
211     mv "$file" "$OUT_FILE"
212 done < $TMPFILE