]>
Commit | Line | Data |
---|---|---|
70c7ac22 LH |
1 | #!/bin/sh |
2 | # | |
ecda0723 | 3 | # git-submodules.sh: add, init, update or list git submodules |
70c7ac22 LH |
4 | # |
5 | # Copyright (c) 2007 Lars Hjemli | |
6 | ||
ecda0723 | 7 | USAGE='[--quiet] [--cached] [add <repo> [-b branch]|status|init|update] [--] [<path>...]' |
8f321a39 | 8 | OPTIONS_SPEC= |
70c7ac22 LH |
9 | . git-sh-setup |
10 | require_work_tree | |
11 | ||
5c08dbbd | 12 | command= |
ecda0723 | 13 | branch= |
70c7ac22 LH |
14 | quiet= |
15 | cached= | |
16 | ||
17 | # | |
18 | # print stuff on stdout unless -q was specified | |
19 | # | |
20 | say() | |
21 | { | |
22 | if test -z "$quiet" | |
23 | then | |
24 | echo "$@" | |
25 | fi | |
26 | } | |
27 | ||
ecda0723 SV |
28 | # NEEDSWORK: identical function exists in get_repo_base in clone.sh |
29 | get_repo_base() { | |
30 | ( | |
31 | cd "`/bin/pwd`" && | |
32 | cd "$1" || cd "$1.git" && | |
33 | { | |
34 | cd .git | |
35 | pwd | |
36 | } | |
37 | ) 2>/dev/null | |
38 | } | |
39 | ||
f31a522a ML |
40 | # Resolve relative url by appending to parent's url |
41 | resolve_relative_url () | |
42 | { | |
43 | branch="$(git symbolic-ref HEAD 2>/dev/null)" | |
44 | remote="$(git config branch.${branch#refs/heads/}.remote)" | |
45 | remote="${remote:-origin}" | |
46 | remoteurl="$(git config remote.$remote.url)" || | |
47 | die "remote ($remote) does not have a url in .git/config" | |
48 | url="$1" | |
49 | while test -n "$url" | |
50 | do | |
51 | case "$url" in | |
52 | ../*) | |
53 | url="${url#../}" | |
54 | remoteurl="${remoteurl%/*}" | |
55 | ;; | |
56 | ./*) | |
57 | url="${url#./}" | |
58 | ;; | |
59 | *) | |
60 | break;; | |
61 | esac | |
62 | done | |
63 | echo "$remoteurl/$url" | |
64 | } | |
65 | ||
941987a5 LH |
66 | # |
67 | # Map submodule path to submodule name | |
68 | # | |
69 | # $1 = path | |
70 | # | |
71 | module_name() | |
72 | { | |
537601ac | 73 | # Do we have "submodule.<something>.path = $1" defined in .gitmodules file? |
4f2e94c0 | 74 | re=$(printf '%s' "$1" | sed -e 's/[].[^$\\*]/\\&/g') |
537601ac JH |
75 | name=$( GIT_CONFIG=.gitmodules \ |
76 | git config --get-regexp '^submodule\..*\.path$' | | |
77 | sed -n -e 's|^submodule\.\(.*\)\.path '"$re"'$|\1|p' ) | |
941987a5 LH |
78 | test -z "$name" && |
79 | die "No submodule mapping found in .gitmodules for path '$path'" | |
80 | echo "$name" | |
81 | } | |
33aa6fff LH |
82 | |
83 | # | |
84 | # Clone a submodule | |
85 | # | |
23a485e3 | 86 | # Prior to calling, cmd_update checks that a possibly existing |
ecda0723 | 87 | # path is not a git repository. |
23a485e3 | 88 | # Likewise, cmd_add checks that path does not exist at all, |
ecda0723 SV |
89 | # since it is the location of a new submodule. |
90 | # | |
33aa6fff LH |
91 | module_clone() |
92 | { | |
93 | path=$1 | |
94 | url=$2 | |
95 | ||
96 | # If there already is a directory at the submodule path, | |
97 | # expect it to be empty (since that is the default checkout | |
98 | # action) and try to remove it. | |
99 | # Note: if $path is a symlink to a directory the test will | |
100 | # succeed but the rmdir will fail. We might want to fix this. | |
101 | if test -d "$path" | |
102 | then | |
103 | rmdir "$path" 2>/dev/null || | |
104 | die "Directory '$path' exist, but is neither empty nor a git repository" | |
105 | fi | |
106 | ||
107 | test -e "$path" && | |
108 | die "A file already exist at path '$path'" | |
109 | ||
110 | git-clone -n "$url" "$path" || | |
941987a5 | 111 | die "Clone of '$url' into submodule path '$path' failed" |
33aa6fff LH |
112 | } |
113 | ||
ecda0723 SV |
114 | # |
115 | # Add a new submodule to the working tree, .gitmodules and the index | |
116 | # | |
117 | # $@ = repo [path] | |
118 | # | |
119 | # optional branch is stored in global branch variable | |
120 | # | |
23a485e3 | 121 | cmd_add() |
ecda0723 | 122 | { |
5c08dbbd JH |
123 | # parse $args after "submodule ... add". |
124 | while test $# -ne 0 | |
125 | do | |
126 | case "$1" in | |
127 | -b | --branch) | |
128 | case "$2" in '') usage ;; esac | |
129 | branch=$2 | |
130 | shift | |
131 | ;; | |
132 | -q|--quiet) | |
133 | quiet=1 | |
134 | ;; | |
135 | --) | |
136 | shift | |
137 | break | |
138 | ;; | |
139 | -*) | |
140 | usage | |
141 | ;; | |
142 | *) | |
143 | break | |
144 | ;; | |
145 | esac | |
146 | shift | |
147 | done | |
148 | ||
ecda0723 SV |
149 | repo=$1 |
150 | path=$2 | |
151 | ||
152 | if test -z "$repo"; then | |
153 | usage | |
154 | fi | |
155 | ||
f31a522a ML |
156 | case "$repo" in |
157 | ./*|../*) | |
158 | # dereference source url relative to parent's url | |
159 | realrepo="$(resolve_relative_url $repo)" ;; | |
160 | *) | |
161 | # Turn the source into an absolute path if | |
162 | # it is local | |
163 | if base=$(get_repo_base "$repo"); then | |
164 | repo="$base" | |
f31a522a | 165 | fi |
fe50eef5 | 166 | realrepo=$repo |
f31a522a ML |
167 | ;; |
168 | esac | |
ecda0723 SV |
169 | |
170 | # Guess path from repo if not specified or strip trailing slashes | |
171 | if test -z "$path"; then | |
172 | path=$(echo "$repo" | sed -e 's|/*$||' -e 's|:*/*\.git$||' -e 's|.*[/:]||g') | |
173 | else | |
174 | path=$(echo "$path" | sed -e 's|/*$||') | |
175 | fi | |
176 | ||
177 | test -e "$path" && | |
178 | die "'$path' already exists" | |
179 | ||
5be60078 | 180 | git ls-files --error-unmatch "$path" > /dev/null 2>&1 && |
ecda0723 SV |
181 | die "'$path' already exists in the index" |
182 | ||
f31a522a | 183 | module_clone "$path" "$realrepo" || exit |
51884080 | 184 | (unset GIT_DIR; cd "$path" && git checkout -q ${branch:+-b "$branch" "origin/$branch"}) || |
ecda0723 SV |
185 | die "Unable to checkout submodule '$path'" |
186 | git add "$path" || | |
187 | die "Failed to add submodule '$path'" | |
188 | ||
189 | GIT_CONFIG=.gitmodules git config submodule."$path".path "$path" && | |
190 | GIT_CONFIG=.gitmodules git config submodule."$path".url "$repo" && | |
191 | git add .gitmodules || | |
192 | die "Failed to register submodule '$path'" | |
193 | } | |
194 | ||
70c7ac22 | 195 | # |
211b7f19 | 196 | # Register submodules in .git/config |
70c7ac22 LH |
197 | # |
198 | # $@ = requested paths (default to all) | |
199 | # | |
23a485e3 | 200 | cmd_init() |
70c7ac22 | 201 | { |
5c08dbbd JH |
202 | # parse $args after "submodule ... init". |
203 | while test $# -ne 0 | |
204 | do | |
205 | case "$1" in | |
206 | -q|--quiet) | |
207 | quiet=1 | |
208 | ;; | |
209 | --) | |
210 | shift | |
211 | break | |
212 | ;; | |
213 | -*) | |
214 | usage | |
215 | ;; | |
216 | *) | |
217 | break | |
218 | ;; | |
219 | esac | |
220 | shift | |
221 | done | |
222 | ||
70c7ac22 LH |
223 | git ls-files --stage -- "$@" | grep -e '^160000 ' | |
224 | while read mode sha1 stage path | |
225 | do | |
211b7f19 | 226 | # Skip already registered paths |
941987a5 | 227 | name=$(module_name "$path") || exit |
5be60078 | 228 | url=$(git config submodule."$name".url) |
211b7f19 | 229 | test -z "$url" || continue |
70c7ac22 | 230 | |
5be60078 | 231 | url=$(GIT_CONFIG=.gitmodules git config submodule."$name".url) |
70c7ac22 | 232 | test -z "$url" && |
941987a5 | 233 | die "No url found for submodule path '$path' in .gitmodules" |
70c7ac22 | 234 | |
f31a522a ML |
235 | # Possibly a url relative to parent |
236 | case "$url" in | |
237 | ./*|../*) | |
238 | url="$(resolve_relative_url "$url")" | |
239 | ;; | |
240 | esac | |
241 | ||
5be60078 | 242 | git config submodule."$name".url "$url" || |
941987a5 | 243 | die "Failed to register url for submodule path '$path'" |
70c7ac22 | 244 | |
941987a5 | 245 | say "Submodule '$name' ($url) registered for path '$path'" |
70c7ac22 LH |
246 | done |
247 | } | |
248 | ||
249 | # | |
211b7f19 | 250 | # Update each submodule path to correct revision, using clone and checkout as needed |
70c7ac22 LH |
251 | # |
252 | # $@ = requested paths (default to all) | |
253 | # | |
23a485e3 | 254 | cmd_update() |
70c7ac22 | 255 | { |
5c08dbbd JH |
256 | # parse $args after "submodule ... update". |
257 | while test $# -ne 0 | |
258 | do | |
259 | case "$1" in | |
260 | -q|--quiet) | |
261 | quiet=1 | |
262 | ;; | |
263 | --) | |
264 | shift | |
265 | break | |
266 | ;; | |
267 | -*) | |
268 | usage | |
269 | ;; | |
270 | *) | |
271 | break | |
272 | ;; | |
273 | esac | |
274 | shift | |
275 | done | |
276 | ||
70c7ac22 LH |
277 | git ls-files --stage -- "$@" | grep -e '^160000 ' | |
278 | while read mode sha1 stage path | |
279 | do | |
941987a5 | 280 | name=$(module_name "$path") || exit |
5be60078 | 281 | url=$(git config submodule."$name".url) |
211b7f19 | 282 | if test -z "$url" |
70c7ac22 LH |
283 | then |
284 | # Only mention uninitialized submodules when its | |
285 | # path have been specified | |
286 | test "$#" != "0" && | |
941987a5 | 287 | say "Submodule path '$path' not initialized" |
211b7f19 LH |
288 | continue |
289 | fi | |
290 | ||
291 | if ! test -d "$path"/.git | |
292 | then | |
293 | module_clone "$path" "$url" || exit | |
bf2d8246 LH |
294 | subsha1= |
295 | else | |
51884080 | 296 | subsha1=$(unset GIT_DIR; cd "$path" && |
5be60078 | 297 | git rev-parse --verify HEAD) || |
941987a5 | 298 | die "Unable to find current revision in submodule path '$path'" |
70c7ac22 | 299 | fi |
211b7f19 | 300 | |
70c7ac22 LH |
301 | if test "$subsha1" != "$sha1" |
302 | then | |
51884080 | 303 | (unset GIT_DIR; cd "$path" && git-fetch && |
70c7ac22 | 304 | git-checkout -q "$sha1") || |
941987a5 | 305 | die "Unable to checkout '$sha1' in submodule path '$path'" |
70c7ac22 | 306 | |
941987a5 | 307 | say "Submodule path '$path': checked out '$sha1'" |
70c7ac22 LH |
308 | fi |
309 | done | |
310 | } | |
311 | ||
bffe71f4 EM |
312 | set_name_rev () { |
313 | revname=$( ( | |
51884080 | 314 | unset GIT_DIR |
bffe71f4 | 315 | cd "$1" && { |
5be60078 JH |
316 | git describe "$2" 2>/dev/null || |
317 | git describe --tags "$2" 2>/dev/null || | |
318 | git describe --contains --tags "$2" | |
bffe71f4 EM |
319 | } |
320 | ) ) | |
321 | test -z "$revname" || revname=" ($revname)" | |
322 | } | |
323 | ||
70c7ac22 | 324 | # |
941987a5 | 325 | # List all submodules, prefixed with: |
70c7ac22 LH |
326 | # - submodule not initialized |
327 | # + different revision checked out | |
328 | # | |
329 | # If --cached was specified the revision in the index will be printed | |
330 | # instead of the currently checked out revision. | |
331 | # | |
332 | # $@ = requested paths (default to all) | |
333 | # | |
23a485e3 | 334 | cmd_status() |
70c7ac22 | 335 | { |
5c08dbbd JH |
336 | # parse $args after "submodule ... status". |
337 | while test $# -ne 0 | |
338 | do | |
339 | case "$1" in | |
340 | -q|--quiet) | |
341 | quiet=1 | |
342 | ;; | |
343 | --cached) | |
344 | cached=1 | |
345 | ;; | |
346 | --) | |
347 | shift | |
348 | break | |
349 | ;; | |
350 | -*) | |
351 | usage | |
352 | ;; | |
353 | *) | |
354 | break | |
355 | ;; | |
356 | esac | |
357 | shift | |
358 | done | |
359 | ||
70c7ac22 LH |
360 | git ls-files --stage -- "$@" | grep -e '^160000 ' | |
361 | while read mode sha1 stage path | |
362 | do | |
941987a5 | 363 | name=$(module_name "$path") || exit |
5be60078 | 364 | url=$(git config submodule."$name".url) |
941987a5 | 365 | if test -z "url" || ! test -d "$path"/.git |
70c7ac22 LH |
366 | then |
367 | say "-$sha1 $path" | |
368 | continue; | |
369 | fi | |
41c7c1bd | 370 | set_name_rev "$path" "$sha1" |
70c7ac22 LH |
371 | if git diff-files --quiet -- "$path" |
372 | then | |
bffe71f4 | 373 | say " $sha1 $path$revname" |
70c7ac22 LH |
374 | else |
375 | if test -z "$cached" | |
376 | then | |
51884080 | 377 | sha1=$(unset GIT_DIR; cd "$path" && git rev-parse --verify HEAD) |
41c7c1bd | 378 | set_name_rev "$path" "$sha1" |
70c7ac22 | 379 | fi |
bffe71f4 | 380 | say "+$sha1 $path$revname" |
70c7ac22 LH |
381 | fi |
382 | done | |
383 | } | |
384 | ||
5c08dbbd JH |
385 | # This loop parses the command line arguments to find the |
386 | # subcommand name to dispatch. Parsing of the subcommand specific | |
387 | # options are primarily done by the subcommand implementations. | |
388 | # Subcommand specific options such as --branch and --cached are | |
389 | # parsed here as well, for backward compatibility. | |
390 | ||
391 | while test $# != 0 && test -z "$command" | |
70c7ac22 LH |
392 | do |
393 | case "$1" in | |
5c08dbbd JH |
394 | add | init | update | status) |
395 | command=$1 | |
70c7ac22 LH |
396 | ;; |
397 | -q|--quiet) | |
398 | quiet=1 | |
399 | ;; | |
ecda0723 SV |
400 | -b|--branch) |
401 | case "$2" in | |
402 | '') | |
403 | usage | |
404 | ;; | |
405 | esac | |
406 | branch="$2"; shift | |
407 | ;; | |
70c7ac22 LH |
408 | --cached) |
409 | cached=1 | |
410 | ;; | |
411 | --) | |
412 | break | |
413 | ;; | |
414 | -*) | |
415 | usage | |
416 | ;; | |
417 | *) | |
418 | break | |
419 | ;; | |
420 | esac | |
421 | shift | |
422 | done | |
423 | ||
5c08dbbd JH |
424 | # No command word defaults to "status" |
425 | test -n "$command" || command=status | |
426 | ||
427 | # "-b branch" is accepted only by "add" | |
428 | if test -n "$branch" && test "$command" != add | |
429 | then | |
ecda0723 | 430 | usage |
5c08dbbd JH |
431 | fi |
432 | ||
433 | # "--cached" is accepted only by "status" | |
434 | if test -n "$cached" && test "$command" != status | |
435 | then | |
70c7ac22 | 436 | usage |
5c08dbbd JH |
437 | fi |
438 | ||
439 | "cmd_$command" "$@" |