]>
Commit | Line | Data |
---|---|---|
70c7ac22 LH |
1 | #!/bin/sh |
2 | # | |
4c8a9db6 | 3 | # git-submodule.sh: add, init, update or list git submodules |
70c7ac22 LH |
4 | # |
5 | # Copyright (c) 2007 Lars Hjemli | |
6 | ||
1d5bec8b | 7 | dashless=$(basename "$0" | sed -e 's/-/ /') |
681b036f | 8 | USAGE="[--quiet] add [-b <branch>] [-f|--force] [--name <name>] [--reference <repository>] [--] <repository> [<path>] |
64b19ffe | 9 | or: $dashless [--quiet] status [--cached] [--recursive] [--] [<path>...] |
1d5bec8b | 10 | or: $dashless [--quiet] init [--] [<path>...] |
f6a52799 | 11 | or: $dashless [--quiet] deinit [-f|--force] (--all| [--] <path>...) |
abed000a | 12 | or: $dashless [--quiet] update [--init] [--remote] [-N|--no-fetch] [-f|--force] [--checkout|--merge|--rebase] [--[no-]recommend-shallow] [--reference <repository>] [--recursive] [--] [<path>...] |
adc54235 | 13 | or: $dashless [--quiet] summary [--cached|--files] [--summary-limit <n>] [commit] [--] [<path>...] |
15fc56a8 | 14 | or: $dashless [--quiet] foreach [--recursive] <command> |
c32eaa8a SB |
15 | or: $dashless [--quiet] sync [--recursive] [--] [<path>...] |
16 | or: $dashless [--quiet] absorbgitdirs [--] [<path>...]" | |
8f321a39 | 17 | OPTIONS_SPEC= |
091a6eb0 | 18 | SUBDIRECTORY_OK=Yes |
70c7ac22 | 19 | . git-sh-setup |
98fcf840 | 20 | . git-parse-remote |
70c7ac22 | 21 | require_work_tree |
091a6eb0 JK |
22 | wt_prefix=$(git rev-parse --show-prefix) |
23 | cd_to_toplevel | |
70c7ac22 | 24 | |
f1762d77 BW |
25 | # Tell the rest of git that any URLs we get don't come |
26 | # directly from the user, so it can apply policy as appropriate. | |
27 | GIT_PROTOCOL_FROM_USER=0 | |
28 | export GIT_PROTOCOL_FROM_USER | |
33cfccbb | 29 | |
5c08dbbd | 30 | command= |
ecda0723 | 31 | branch= |
d27b876b | 32 | force= |
d92a3959 | 33 | reference= |
70c7ac22 | 34 | cached= |
48bb3033 GP |
35 | recursive= |
36 | init= | |
1c244f6e | 37 | files= |
06b1abb5 | 38 | remote= |
31ca3ac3 | 39 | nofetch= |
32948425 | 40 | update= |
15fc56a8 | 41 | prefix= |
73b0898d | 42 | custom_name= |
275cd184 | 43 | depth= |
72c5f883 | 44 | progress= |
a0ef2934 | 45 | dissociate= |
70c7ac22 | 46 | |
be9d0a3a HV |
47 | die_if_unmatched () |
48 | { | |
49 | if test "$1" = "#unmatched" | |
50 | then | |
c4c02bf1 | 51 | exit ${2:-1} |
be9d0a3a HV |
52 | fi |
53 | } | |
54 | ||
88ce00c3 TK |
55 | # |
56 | # Print a submodule configuration setting | |
57 | # | |
58 | # $1 = submodule name | |
59 | # $2 = option name | |
60 | # $3 = default value | |
61 | # | |
62 | # Checks in the usual git-config places first (for overrides), | |
63 | # otherwise it falls back on .gitmodules. This allows you to | |
64 | # distribute project-wide defaults in .gitmodules, while still | |
65 | # customizing individual repositories if necessary. If the option is | |
66 | # not in .gitmodules either, print a default value. | |
67 | # | |
68 | get_submodule_config () { | |
69 | name="$1" | |
70 | option="$2" | |
71 | default="$3" | |
72 | value=$(git config submodule."$name"."$option") | |
73 | if test -z "$value" | |
74 | then | |
75 | value=$(git config -f .gitmodules submodule."$name"."$option") | |
76 | fi | |
77 | printf '%s' "${value:-$default}" | |
78 | } | |
79 | ||
862ae6cd RS |
80 | isnumber() |
81 | { | |
82 | n=$(($1 + 0)) 2>/dev/null && test "$n" = "$1" | |
83 | } | |
84 | ||
14111fc4 JK |
85 | # Sanitize the local git environment for use within a submodule. We |
86 | # can't simply use clear_local_git_env since we want to preserve some | |
87 | # of the settings from GIT_CONFIG_PARAMETERS. | |
88 | sanitize_submodule_env() | |
89 | { | |
89044baa | 90 | save_config=$GIT_CONFIG_PARAMETERS |
14111fc4 | 91 | clear_local_git_env |
89044baa | 92 | GIT_CONFIG_PARAMETERS=$save_config |
860cba61 | 93 | export GIT_CONFIG_PARAMETERS |
14111fc4 JK |
94 | } |
95 | ||
ecda0723 SV |
96 | # |
97 | # Add a new submodule to the working tree, .gitmodules and the index | |
98 | # | |
ec05df35 | 99 | # $@ = repo path |
ecda0723 SV |
100 | # |
101 | # optional branch is stored in global branch variable | |
102 | # | |
23a485e3 | 103 | cmd_add() |
ecda0723 | 104 | { |
5c08dbbd | 105 | # parse $args after "submodule ... add". |
091a6eb0 | 106 | reference_path= |
5c08dbbd JH |
107 | while test $# -ne 0 |
108 | do | |
109 | case "$1" in | |
110 | -b | --branch) | |
111 | case "$2" in '') usage ;; esac | |
112 | branch=$2 | |
113 | shift | |
114 | ;; | |
d27b876b JL |
115 | -f | --force) |
116 | force=$1 | |
117 | ;; | |
5c08dbbd | 118 | -q|--quiet) |
2e6a30ef | 119 | GIT_QUIET=1 |
5c08dbbd | 120 | ;; |
6d33e1c2 CF |
121 | --progress) |
122 | progress=1 | |
123 | ;; | |
d92a3959 MT |
124 | --reference) |
125 | case "$2" in '') usage ;; esac | |
091a6eb0 | 126 | reference_path=$2 |
d92a3959 MT |
127 | shift |
128 | ;; | |
129 | --reference=*) | |
091a6eb0 | 130 | reference_path="${1#--reference=}" |
d92a3959 | 131 | ;; |
a0ef2934 CF |
132 | --dissociate) |
133 | dissociate=1 | |
134 | ;; | |
73b0898d JL |
135 | --name) |
136 | case "$2" in '') usage ;; esac | |
137 | custom_name=$2 | |
138 | shift | |
139 | ;; | |
275cd184 FG |
140 | --depth) |
141 | case "$2" in '') usage ;; esac | |
142 | depth="--depth=$2" | |
143 | shift | |
144 | ;; | |
145 | --depth=*) | |
146 | depth=$1 | |
147 | ;; | |
5c08dbbd JH |
148 | --) |
149 | shift | |
150 | break | |
151 | ;; | |
152 | -*) | |
153 | usage | |
154 | ;; | |
155 | *) | |
156 | break | |
157 | ;; | |
158 | esac | |
159 | shift | |
160 | done | |
161 | ||
091a6eb0 JK |
162 | if test -n "$reference_path" |
163 | then | |
164 | is_absolute_path "$reference_path" || | |
165 | reference_path="$wt_prefix$reference_path" | |
166 | ||
167 | reference="--reference=$reference_path" | |
168 | fi | |
169 | ||
ecda0723 | 170 | repo=$1 |
64394e3a | 171 | sm_path=$2 |
ecda0723 | 172 | |
64394e3a | 173 | if test -z "$sm_path"; then |
6a066230 | 174 | sm_path=$(printf '%s\n' "$repo" | |
1414e578 JL |
175 | sed -e 's|/$||' -e 's|:*/*\.git$||' -e 's|.*[/:]||g') |
176 | fi | |
177 | ||
496eeeb1 | 178 | if test -z "$repo" || test -z "$sm_path"; then |
ecda0723 SV |
179 | usage |
180 | fi | |
181 | ||
091a6eb0 JK |
182 | is_absolute_path "$sm_path" || sm_path="$wt_prefix$sm_path" |
183 | ||
ec05df35 ML |
184 | # assure repo is absolute or relative to parent |
185 | case "$repo" in | |
186 | ./*|../*) | |
091a6eb0 JK |
187 | test -z "$wt_prefix" || |
188 | die "$(gettext "Relative path can only be used from the toplevel of the working tree")" | |
189 | ||
ec05df35 | 190 | # dereference source url relative to parent's url |
63e95beb | 191 | realrepo=$(git submodule--helper resolve-relative-url "$repo") || exit |
ec05df35 ML |
192 | ;; |
193 | *:*|/*) | |
194 | # absolute url | |
195 | realrepo=$repo | |
196 | ;; | |
197 | *) | |
497ee872 | 198 | die "$(eval_gettext "repo URL: '\$repo' must be absolute or begin with ./|../")" |
ec05df35 ML |
199 | ;; |
200 | esac | |
201 | ||
db75ada5 MG |
202 | # normalize path: |
203 | # multiple //; leading ./; /./; /../; trailing / | |
64394e3a | 204 | sm_path=$(printf '%s/\n' "$sm_path" | |
db75ada5 MG |
205 | sed -e ' |
206 | s|//*|/|g | |
207 | s|^\(\./\)*|| | |
8196e728 | 208 | s|/\(\./\)*|/|g |
db75ada5 MG |
209 | :start |
210 | s|\([^/]*\)/\.\./|| | |
211 | tstart | |
212 | s|/*$|| | |
213 | ') | |
619acfc7 SB |
214 | if test -z "$force" |
215 | then | |
216 | git ls-files --error-unmatch "$sm_path" > /dev/null 2>&1 && | |
217 | die "$(eval_gettext "'\$sm_path' already exists in the index")" | |
218 | else | |
219 | git ls-files -s "$sm_path" | sane_grep -v "^160000" > /dev/null 2>&1 && | |
220 | die "$(eval_gettext "'\$sm_path' already exists in the index and is not a submodule")" | |
221 | fi | |
ecda0723 | 222 | |
53213994 JK |
223 | if test -z "$force" && |
224 | ! git add --dry-run --ignore-missing --no-warn-embedded-repo "$sm_path" > /dev/null 2>&1 | |
d27b876b | 225 | then |
6ff875c5 | 226 | eval_gettextln "The following path is ignored by one of your .gitignore files: |
64394e3a | 227 | \$sm_path |
6ff875c5 | 228 | Use -f if you really want to add it." >&2 |
d27b876b JL |
229 | exit 1 |
230 | fi | |
231 | ||
73b0898d JL |
232 | if test -n "$custom_name" |
233 | then | |
234 | sm_name="$custom_name" | |
235 | else | |
236 | sm_name="$sm_path" | |
237 | fi | |
238 | ||
0383bbb9 JK |
239 | if ! git submodule--helper check-name "$sm_name" |
240 | then | |
241 | die "$(eval_gettext "'$sm_name' is not a valid submodule name")" | |
242 | fi | |
243 | ||
d4264ca3 | 244 | # perhaps the path exists and is already a git repo, else clone it |
64394e3a | 245 | if test -e "$sm_path" |
d4264ca3 | 246 | then |
496eeeb1 | 247 | if test -d "$sm_path"/.git || test -f "$sm_path"/.git |
d4264ca3 | 248 | then |
64394e3a | 249 | eval_gettextln "Adding existing repo at '\$sm_path' to the index" |
d4264ca3 | 250 | else |
64394e3a | 251 | die "$(eval_gettext "'\$sm_path' already exists and is not a valid git repo")" |
d4264ca3 | 252 | fi |
c2f93917 | 253 | |
d4264ca3 | 254 | else |
4b7c286e JL |
255 | if test -d ".git/modules/$sm_name" |
256 | then | |
257 | if test -z "$force" | |
258 | then | |
0d71dbfd | 259 | eval_gettextln >&2 "A git directory for '\$sm_name' is found locally with remote(s):" |
4b7c286e | 260 | GIT_DIR=".git/modules/$sm_name" GIT_WORK_TREE=. git remote -v | grep '(fetch)' | sed -e s,^," ", -e s,' (fetch)',, >&2 |
0d71dbfd VA |
261 | die "$(eval_gettextln "\ |
262 | If you want to reuse this local git directory instead of cloning again from | |
263 | \$realrepo | |
264 | use the '--force' option. If the local git directory is not the correct repo | |
265 | or you are unsure what this means choose another name with the '--name' option.")" | |
4b7c286e | 266 | else |
0d71dbfd | 267 | eval_gettextln "Reactivating local git directory for submodule '\$sm_name'." |
4b7c286e JL |
268 | fi |
269 | fi | |
a0ef2934 | 270 | git submodule--helper clone ${GIT_QUIET:+--quiet} ${progress:+"--progress"} --prefix "$wt_prefix" --path "$sm_path" --name "$sm_name" --url "$realrepo" ${reference:+"$reference"} ${dissociate:+"--dissociate"} ${depth:+"$depth"} || exit |
d851ffb9 | 271 | ( |
14111fc4 | 272 | sanitize_submodule_env |
d851ffb9 JH |
273 | cd "$sm_path" && |
274 | # ash fails to wordsplit ${branch:+-b "$branch"...} | |
275 | case "$branch" in | |
276 | '') git checkout -f -q ;; | |
277 | ?*) git checkout -f -q -B "$branch" "origin/$branch" ;; | |
278 | esac | |
279 | ) || die "$(eval_gettext "Unable to checkout submodule '\$sm_path'")" | |
d4264ca3 | 280 | fi |
73b0898d | 281 | git config submodule."$sm_name".url "$realrepo" |
d4264ca3 | 282 | |
53213994 | 283 | git add --no-warn-embedded-repo $force "$sm_path" || |
64394e3a | 284 | die "$(eval_gettext "Failed to add submodule '\$sm_path'")" |
ecda0723 | 285 | |
73b0898d JL |
286 | git config -f .gitmodules submodule."$sm_name".path "$sm_path" && |
287 | git config -f .gitmodules submodule."$sm_name".url "$repo" && | |
b9289227 TK |
288 | if test -n "$branch" |
289 | then | |
290 | git config -f .gitmodules submodule."$sm_name".branch "$branch" | |
291 | fi && | |
31991b02 | 292 | git add --force .gitmodules || |
64394e3a | 293 | die "$(eval_gettext "Failed to register submodule '\$sm_path'")" |
1b614c07 BW |
294 | |
295 | # NEEDSWORK: In a multi-working-tree world, this needs to be | |
296 | # set in the per-worktree config. | |
297 | if git config --get submodule.active >/dev/null | |
298 | then | |
299 | # If the submodule being adding isn't already covered by the | |
300 | # current configured pathspec, set the submodule's active flag | |
301 | if ! git submodule--helper is-active "$sm_path" | |
302 | then | |
303 | git config submodule."$sm_name".active "true" | |
304 | fi | |
305 | else | |
306 | git config submodule."$sm_name".active "true" | |
307 | fi | |
ecda0723 SV |
308 | } |
309 | ||
19a31f9c ML |
310 | # |
311 | # Execute an arbitrary command sequence in each checked out | |
312 | # submodule | |
313 | # | |
314 | # $@ = command to execute | |
315 | # | |
316 | cmd_foreach() | |
317 | { | |
1d5bec8b JH |
318 | # parse $args after "submodule ... foreach". |
319 | while test $# -ne 0 | |
320 | do | |
321 | case "$1" in | |
322 | -q|--quiet) | |
323 | GIT_QUIET=1 | |
324 | ;; | |
15fc56a8 JH |
325 | --recursive) |
326 | recursive=1 | |
327 | ;; | |
1d5bec8b JH |
328 | -*) |
329 | usage | |
330 | ;; | |
331 | *) | |
332 | break | |
333 | ;; | |
334 | esac | |
335 | shift | |
336 | done | |
337 | ||
f030c96d ÆAB |
338 | toplevel=$(pwd) |
339 | ||
4dca1aa6 BC |
340 | # dup stdin so that it can be restored when running the external |
341 | # command in the subshell (and a recursive call to this function) | |
342 | exec 3<&0 | |
343 | ||
b0f4b408 SB |
344 | { |
345 | git submodule--helper list --prefix "$wt_prefix" || | |
c4c02bf1 | 346 | echo "#unmatched" $? |
b0f4b408 | 347 | } | |
cf9e55f4 | 348 | while read -r mode sha1 stage sm_path |
19a31f9c | 349 | do |
c4c02bf1 | 350 | die_if_unmatched "$mode" "$sha1" |
64394e3a | 351 | if test -e "$sm_path"/.git |
19a31f9c | 352 | then |
44431df0 | 353 | displaypath=$(git submodule--helper relative-path "$prefix$sm_path" "$wt_prefix") |
ea2fa104 | 354 | say "$(eval_gettext "Entering '\$displaypath'")" |
0ea306ef | 355 | name=$(git submodule--helper name "$sm_path") |
15fc56a8 | 356 | ( |
64394e3a | 357 | prefix="$prefix$sm_path/" |
14111fc4 | 358 | sanitize_submodule_env |
64394e3a | 359 | cd "$sm_path" && |
44431df0 | 360 | sm_path=$(git submodule--helper relative-path "$sm_path" "$wt_prefix") && |
091a6eb0 JK |
361 | # we make $path available to scripts ... |
362 | path=$sm_path && | |
1c4fb136 AK |
363 | if test $# -eq 1 |
364 | then | |
365 | eval "$1" | |
366 | else | |
367 | "$@" | |
368 | fi && | |
15fc56a8 JH |
369 | if test -n "$recursive" |
370 | then | |
371 | cmd_foreach "--recursive" "$@" | |
372 | fi | |
4dca1aa6 | 373 | ) <&3 3<&- || |
ea2fa104 | 374 | die "$(eval_gettext "Stopping at '\$displaypath'; script returned non-zero status.")" |
19a31f9c ML |
375 | fi |
376 | done | |
377 | } | |
378 | ||
70c7ac22 | 379 | # |
211b7f19 | 380 | # Register submodules in .git/config |
70c7ac22 LH |
381 | # |
382 | # $@ = requested paths (default to all) | |
383 | # | |
23a485e3 | 384 | cmd_init() |
70c7ac22 | 385 | { |
5c08dbbd JH |
386 | # parse $args after "submodule ... init". |
387 | while test $# -ne 0 | |
388 | do | |
389 | case "$1" in | |
390 | -q|--quiet) | |
2e6a30ef | 391 | GIT_QUIET=1 |
5c08dbbd JH |
392 | ;; |
393 | --) | |
394 | shift | |
395 | break | |
396 | ;; | |
397 | -*) | |
398 | usage | |
399 | ;; | |
400 | *) | |
401 | break | |
402 | ;; | |
403 | esac | |
404 | shift | |
405 | done | |
406 | ||
6e7c14e6 | 407 | git ${wt_prefix:+-C "$wt_prefix"} ${prefix:+--super-prefix "$prefix"} submodule--helper init ${GIT_QUIET:+--quiet} "$@" |
70c7ac22 LH |
408 | } |
409 | ||
cf419828 JL |
410 | # |
411 | # Unregister submodules from .git/config and remove their work tree | |
412 | # | |
cf419828 JL |
413 | cmd_deinit() |
414 | { | |
415 | # parse $args after "submodule ... deinit". | |
f6a52799 | 416 | deinit_all= |
cf419828 JL |
417 | while test $# -ne 0 |
418 | do | |
419 | case "$1" in | |
420 | -f|--force) | |
421 | force=$1 | |
422 | ;; | |
423 | -q|--quiet) | |
424 | GIT_QUIET=1 | |
425 | ;; | |
f6a52799 SB |
426 | --all) |
427 | deinit_all=t | |
428 | ;; | |
cf419828 JL |
429 | --) |
430 | shift | |
431 | break | |
432 | ;; | |
433 | -*) | |
434 | usage | |
435 | ;; | |
436 | *) | |
437 | break | |
438 | ;; | |
439 | esac | |
440 | shift | |
441 | done | |
442 | ||
2e612731 | 443 | git ${wt_prefix:+-C "$wt_prefix"} submodule--helper deinit ${GIT_QUIET:+--quiet} ${prefix:+--prefix "$prefix"} ${force:+--force} ${deinit_all:+--all} "$@" |
cf419828 JL |
444 | } |
445 | ||
fb43e31f | 446 | is_tip_reachable () ( |
01e1d544 | 447 | sanitize_submodule_env && |
fb43e31f SB |
448 | cd "$1" && |
449 | rev=$(git rev-list -n 1 "$2" --not --all 2>/dev/null) && | |
450 | test -z "$rev" | |
451 | ) | |
452 | ||
453 | fetch_in_submodule () ( | |
01e1d544 | 454 | sanitize_submodule_env && |
fb43e31f SB |
455 | cd "$1" && |
456 | case "$2" in | |
457 | '') | |
458 | git fetch ;; | |
459 | *) | |
6cbf454a SB |
460 | shift |
461 | git fetch $(get_default_remote) "$@" ;; | |
fb43e31f SB |
462 | esac |
463 | ) | |
464 | ||
70c7ac22 | 465 | # |
211b7f19 | 466 | # Update each submodule path to correct revision, using clone and checkout as needed |
70c7ac22 LH |
467 | # |
468 | # $@ = requested paths (default to all) | |
469 | # | |
23a485e3 | 470 | cmd_update() |
70c7ac22 | 471 | { |
5c08dbbd JH |
472 | # parse $args after "submodule ... update". |
473 | while test $# -ne 0 | |
474 | do | |
475 | case "$1" in | |
476 | -q|--quiet) | |
2e6a30ef | 477 | GIT_QUIET=1 |
5c08dbbd | 478 | ;; |
72c5f883 | 479 | --progress) |
c7199e3a | 480 | progress=1 |
72c5f883 | 481 | ;; |
be4d2c83 | 482 | -i|--init) |
d92a3959 | 483 | init=1 |
be4d2c83 | 484 | ;; |
06b1abb5 TK |
485 | --remote) |
486 | remote=1 | |
487 | ;; | |
31ca3ac3 | 488 | -N|--no-fetch) |
31ca3ac3 FF |
489 | nofetch=1 |
490 | ;; | |
9db31bdf NMC |
491 | -f|--force) |
492 | force=$1 | |
493 | ;; | |
ca2cedba | 494 | -r|--rebase) |
32948425 | 495 | update="rebase" |
ca2cedba | 496 | ;; |
d92a3959 MT |
497 | --reference) |
498 | case "$2" in '') usage ;; esac | |
499 | reference="--reference=$2" | |
98dbe63d | 500 | shift |
d92a3959 MT |
501 | ;; |
502 | --reference=*) | |
503 | reference="$1" | |
d92a3959 | 504 | ;; |
a0ef2934 CF |
505 | --dissociate) |
506 | dissociate=1 | |
507 | ;; | |
42b49178 | 508 | -m|--merge) |
42b49178 JH |
509 | update="merge" |
510 | ;; | |
b13fd5c1 | 511 | --recursive) |
b13fd5c1 JH |
512 | recursive=1 |
513 | ;; | |
efc5fb6a JH |
514 | --checkout) |
515 | update="checkout" | |
516 | ;; | |
abed000a SB |
517 | --recommend-shallow) |
518 | recommend_shallow="--recommend-shallow" | |
519 | ;; | |
520 | --no-recommend-shallow) | |
521 | recommend_shallow="--no-recommend-shallow" | |
522 | ;; | |
275cd184 FG |
523 | --depth) |
524 | case "$2" in '') usage ;; esac | |
525 | depth="--depth=$2" | |
526 | shift | |
527 | ;; | |
528 | --depth=*) | |
529 | depth=$1 | |
530 | ;; | |
2335b870 SB |
531 | -j|--jobs) |
532 | case "$2" in '') usage ;; esac | |
533 | jobs="--jobs=$2" | |
534 | shift | |
535 | ;; | |
536 | --jobs=*) | |
537 | jobs=$1 | |
538 | ;; | |
5c08dbbd JH |
539 | --) |
540 | shift | |
541 | break | |
542 | ;; | |
543 | -*) | |
544 | usage | |
545 | ;; | |
546 | *) | |
547 | break | |
548 | ;; | |
549 | esac | |
98dbe63d | 550 | shift |
5c08dbbd JH |
551 | done |
552 | ||
d92a3959 MT |
553 | if test -n "$init" |
554 | then | |
555 | cmd_init "--" "$@" || return | |
556 | fi | |
557 | ||
48308681 SB |
558 | { |
559 | git submodule--helper update-clone ${GIT_QUIET:+--quiet} \ | |
c7199e3a | 560 | ${progress:+"--progress"} \ |
48308681 SB |
561 | ${wt_prefix:+--prefix "$wt_prefix"} \ |
562 | ${prefix:+--recursive-prefix "$prefix"} \ | |
563 | ${update:+--update "$update"} \ | |
5f50f33e | 564 | ${reference:+"$reference"} \ |
a0ef2934 | 565 | ${dissociate:+"--dissociate"} \ |
48308681 | 566 | ${depth:+--depth "$depth"} \ |
c7199e3a CF |
567 | $recommend_shallow \ |
568 | $jobs \ | |
c4c02bf1 | 569 | "$@" || echo "#unmatched" $? |
48308681 | 570 | } | { |
15ffb7cd | 571 | err= |
cf9e55f4 | 572 | while read -r mode sha1 stage just_cloned sm_path |
70c7ac22 | 573 | do |
c4c02bf1 | 574 | die_if_unmatched "$mode" "$sha1" |
48308681 | 575 | |
0ea306ef | 576 | name=$(git submodule--helper name "$sm_path") || exit |
efc5fb6a JH |
577 | if ! test -z "$update" |
578 | then | |
579 | update_module=$update | |
580 | else | |
581 | update_module=$(git config submodule."$name".update) | |
a2aed08b TK |
582 | if test -z "$update_module" |
583 | then | |
584 | update_module="checkout" | |
585 | fi | |
efc5fb6a JH |
586 | fi |
587 | ||
44431df0 | 588 | displaypath=$(git submodule--helper relative-path "$prefix$sm_path" "$wt_prefix") |
091a6eb0 | 589 | |
48308681 | 590 | if test $just_cloned -eq 1 |
d851ffb9 | 591 | then |
bf2d8246 | 592 | subsha1= |
e7b37caf SB |
593 | case "$update_module" in |
594 | merge | rebase | none) | |
595 | update_module=checkout ;; | |
596 | esac | |
bf2d8246 | 597 | else |
14111fc4 | 598 | subsha1=$(sanitize_submodule_env; cd "$sm_path" && |
5be60078 | 599 | git rev-parse --verify HEAD) || |
091a6eb0 | 600 | die "$(eval_gettext "Unable to find current revision in submodule path '\$displaypath'")" |
70c7ac22 | 601 | fi |
211b7f19 | 602 | |
06b1abb5 TK |
603 | if test -n "$remote" |
604 | then | |
92bbe7cc | 605 | branch=$(git submodule--helper remote-branch "$sm_path") |
06b1abb5 TK |
606 | if test -z "$nofetch" |
607 | then | |
608 | # Fetch remote before determining tracking $sha1 | |
6cbf454a | 609 | fetch_in_submodule "$sm_path" $depth || |
06b1abb5 TK |
610 | die "$(eval_gettext "Unable to fetch in submodule path '\$sm_path'")" |
611 | fi | |
14111fc4 JK |
612 | remote_name=$(sanitize_submodule_env; cd "$sm_path" && get_default_remote) |
613 | sha1=$(sanitize_submodule_env; cd "$sm_path" && | |
06b1abb5 | 614 | git rev-parse --verify "${remote_name}/${branch}") || |
c87302bf | 615 | die "$(eval_gettext "Unable to find current \${remote_name}/\${branch} revision in submodule path '\$sm_path'")" |
06b1abb5 TK |
616 | fi |
617 | ||
496eeeb1 | 618 | if test "$subsha1" != "$sha1" || test -n "$force" |
70c7ac22 | 619 | then |
9db31bdf NMC |
620 | subforce=$force |
621 | # If we don't already have a -f flag and the submodule has never been checked out | |
496eeeb1 | 622 | if test -z "$subsha1" && test -z "$force" |
b9b378a0 | 623 | then |
9db31bdf | 624 | subforce="-f" |
b9b378a0 | 625 | fi |
31ca3ac3 FF |
626 | |
627 | if test -z "$nofetch" | |
628 | then | |
e5f522d6 JL |
629 | # Run fetch only if $sha1 isn't present or it |
630 | # is not reachable from a ref. | |
fb43e31f | 631 | is_tip_reachable "$sm_path" "$sha1" || |
6cbf454a | 632 | fetch_in_submodule "$sm_path" $depth || |
e30d8336 | 633 | say "$(eval_gettext "Unable to fetch in submodule path '\$displaypath'")" |
fb43e31f SB |
634 | |
635 | # Now we tried the usual fetch, but $sha1 may | |
636 | # not be reachable from any of the refs | |
637 | is_tip_reachable "$sm_path" "$sha1" || | |
6cbf454a | 638 | fetch_in_submodule "$sm_path" $depth "$sha1" || |
c87302bf | 639 | die "$(eval_gettext "Fetched in submodule path '\$displaypath', but it did not contain \$sha1. Direct fetching of that commit failed.")" |
31ca3ac3 FF |
640 | fi |
641 | ||
877449c1 | 642 | must_die_on_failure= |
32948425 | 643 | case "$update_module" in |
a2aed08b TK |
644 | checkout) |
645 | command="git checkout $subforce -q" | |
646 | die_msg="$(eval_gettext "Unable to checkout '\$sha1' in submodule path '\$displaypath'")" | |
647 | say_msg="$(eval_gettext "Submodule path '\$displaypath': checked out '\$sha1'")" | |
648 | ;; | |
32948425 JH |
649 | rebase) |
650 | command="git rebase" | |
091a6eb0 JK |
651 | die_msg="$(eval_gettext "Unable to rebase '\$sha1' in submodule path '\$displaypath'")" |
652 | say_msg="$(eval_gettext "Submodule path '\$displaypath': rebased into '\$sha1'")" | |
877449c1 | 653 | must_die_on_failure=yes |
32948425 | 654 | ;; |
42b49178 JH |
655 | merge) |
656 | command="git merge" | |
091a6eb0 JK |
657 | die_msg="$(eval_gettext "Unable to merge '\$sha1' in submodule path '\$displaypath'")" |
658 | say_msg="$(eval_gettext "Submodule path '\$displaypath': merged in '\$sha1'")" | |
877449c1 | 659 | must_die_on_failure=yes |
42b49178 | 660 | ;; |
6cb5728c CP |
661 | !*) |
662 | command="${update_module#!}" | |
b08238ac SB |
663 | die_msg="$(eval_gettext "Execution of '\$command \$sha1' failed in submodule path '\$displaypath'")" |
664 | say_msg="$(eval_gettext "Submodule path '\$displaypath': '\$command \$sha1'")" | |
6cb5728c CP |
665 | must_die_on_failure=yes |
666 | ;; | |
32948425 | 667 | *) |
a2aed08b | 668 | die "$(eval_gettext "Invalid update mode '$update_module' for submodule '$name'")" |
32948425 | 669 | esac |
70c7ac22 | 670 | |
14111fc4 | 671 | if (sanitize_submodule_env; cd "$sm_path" && $command "$sha1") |
15ffb7cd | 672 | then |
ff968f03 | 673 | say "$say_msg" |
877449c1 JH |
674 | elif test -n "$must_die_on_failure" |
675 | then | |
ff968f03 | 676 | die_with_status 2 "$die_msg" |
15ffb7cd | 677 | else |
ff968f03 | 678 | err="${err};$die_msg" |
877449c1 | 679 | continue |
15ffb7cd | 680 | fi |
70c7ac22 | 681 | fi |
b13fd5c1 JH |
682 | |
683 | if test -n "$recursive" | |
684 | then | |
75bf5e60 | 685 | ( |
44431df0 | 686 | prefix=$(git submodule--helper relative-path "$prefix$sm_path/" "$wt_prefix") |
3604242f | 687 | wt_prefix= |
14111fc4 | 688 | sanitize_submodule_env |
75bf5e60 | 689 | cd "$sm_path" && |
36141282 | 690 | eval cmd_update |
75bf5e60 | 691 | ) |
15ffb7cd FG |
692 | res=$? |
693 | if test $res -gt 0 | |
694 | then | |
091a6eb0 | 695 | die_msg="$(eval_gettext "Failed to recurse into submodule path '\$displaypath'")" |
bb9d91b4 | 696 | if test $res -ne 2 |
15ffb7cd | 697 | then |
ff968f03 | 698 | err="${err};$die_msg" |
15ffb7cd FG |
699 | continue |
700 | else | |
ff968f03 | 701 | die_with_status $res "$die_msg" |
15ffb7cd FG |
702 | fi |
703 | fi | |
b13fd5c1 | 704 | fi |
70c7ac22 | 705 | done |
15ffb7cd FG |
706 | |
707 | if test -n "$err" | |
708 | then | |
709 | OIFS=$IFS | |
710 | IFS=';' | |
711 | for e in $err | |
712 | do | |
713 | if test -n "$e" | |
714 | then | |
715 | echo >&2 "$e" | |
716 | fi | |
717 | done | |
718 | IFS=$OIFS | |
719 | exit 1 | |
720 | fi | |
721 | } | |
70c7ac22 LH |
722 | } |
723 | ||
28f9af5d PY |
724 | # |
725 | # Show commit summary for submodules in index or working tree | |
726 | # | |
727 | # If '--cached' is given, show summary between index and given commit, | |
728 | # or between working tree and given commit | |
729 | # | |
730 | # $@ = [commit (default 'HEAD'),] requested paths (default all) | |
731 | # | |
732 | cmd_summary() { | |
f2dc06a3 | 733 | summary_limit=-1 |
d0f64dd4 | 734 | for_status= |
1c244f6e | 735 | diff_cmd=diff-index |
f2dc06a3 | 736 | |
28f9af5d PY |
737 | # parse $args after "submodule ... summary". |
738 | while test $# -ne 0 | |
739 | do | |
740 | case "$1" in | |
741 | --cached) | |
742 | cached="$1" | |
743 | ;; | |
1c244f6e JL |
744 | --files) |
745 | files="$1" | |
746 | ;; | |
d0f64dd4 PY |
747 | --for-status) |
748 | for_status="$1" | |
749 | ;; | |
f2dc06a3 | 750 | -n|--summary-limit) |
862ae6cd RS |
751 | summary_limit="$2" |
752 | isnumber "$summary_limit" || usage | |
f2dc06a3 PY |
753 | shift |
754 | ;; | |
862ae6cd RS |
755 | --summary-limit=*) |
756 | summary_limit="${1#--summary-limit=}" | |
757 | isnumber "$summary_limit" || usage | |
758 | ;; | |
28f9af5d PY |
759 | --) |
760 | shift | |
761 | break | |
762 | ;; | |
763 | -*) | |
764 | usage | |
765 | ;; | |
766 | *) | |
767 | break | |
768 | ;; | |
769 | esac | |
770 | shift | |
771 | done | |
bffe71f4 | 772 | |
f2dc06a3 PY |
773 | test $summary_limit = 0 && return |
774 | ||
3deea89c | 775 | if rev=$(git rev-parse -q --verify --default HEAD ${1+"$1"}) |
28f9af5d PY |
776 | then |
777 | head=$rev | |
caa9c3ca | 778 | test $# = 0 || shift |
496eeeb1 | 779 | elif test -z "$1" || test "$1" = "HEAD" |
3deea89c | 780 | then |
14e940d7 JH |
781 | # before the first commit: compare with an empty tree |
782 | head=$(git hash-object -w -t tree --stdin </dev/null) | |
2ea6c2c9 | 783 | test -z "$1" || shift |
28f9af5d | 784 | else |
3deea89c | 785 | head="HEAD" |
28f9af5d PY |
786 | fi |
787 | ||
1c244f6e JL |
788 | if [ -n "$files" ] |
789 | then | |
790 | test -n "$cached" && | |
465d6a00 | 791 | die "$(gettext "The --cached option cannot be used with the --files option")" |
1c244f6e JL |
792 | diff_cmd=diff-files |
793 | head= | |
794 | fi | |
795 | ||
28f9af5d | 796 | cd_to_toplevel |
091a6eb0 | 797 | eval "set $(git rev-parse --sq --prefix "$wt_prefix" -- "$@")" |
28f9af5d | 798 | # Get modified modules cared by user |
18076502 | 799 | modules=$(git $diff_cmd $cached --ignore-submodules=dirty --raw $head -- "$@" | |
e1622bfc | 800 | sane_egrep '^:([0-7]* )?160000' | |
cf9e55f4 | 801 | while read -r mod_src mod_dst sha1_src sha1_dst status sm_path |
28f9af5d PY |
802 | do |
803 | # Always show modules deleted or type-changed (blob<->module) | |
496eeeb1 EP |
804 | if test "$status" = D || test "$status" = T |
805 | then | |
6a066230 | 806 | printf '%s\n' "$sm_path" |
496eeeb1 EP |
807 | continue |
808 | fi | |
927b26f8 | 809 | # Respect the ignore setting for --for-status. |
810 | if test -n "$for_status" | |
811 | then | |
0ea306ef | 812 | name=$(git submodule--helper name "$sm_path") |
927b26f8 | 813 | ignore_config=$(get_submodule_config "$name" ignore none) |
496eeeb1 | 814 | test $status != A && test $ignore_config = all && continue |
927b26f8 | 815 | fi |
28f9af5d | 816 | # Also show added or modified modules which are checked out |
974ce807 | 817 | GIT_DIR="$sm_path/.git" git rev-parse --git-dir >/dev/null 2>&1 && |
6a066230 | 818 | printf '%s\n' "$sm_path" |
28f9af5d PY |
819 | done |
820 | ) | |
1cb639e6 | 821 | |
d0f64dd4 PY |
822 | test -z "$modules" && return |
823 | ||
18076502 | 824 | git $diff_cmd $cached --ignore-submodules=dirty --raw $head -- $modules | |
e1622bfc | 825 | sane_egrep '^:([0-7]* )?160000' | |
1cb639e6 | 826 | cut -c2- | |
cf9e55f4 | 827 | while read -r mod_src mod_dst sha1_src sha1_dst status name |
1cb639e6 PY |
828 | do |
829 | if test -z "$cached" && | |
830 | test $sha1_dst = 0000000000000000000000000000000000000000 | |
831 | then | |
832 | case "$mod_dst" in | |
833 | 160000) | |
834 | sha1_dst=$(GIT_DIR="$name/.git" git rev-parse HEAD) | |
835 | ;; | |
836 | 100644 | 100755 | 120000) | |
837 | sha1_dst=$(git hash-object $name) | |
838 | ;; | |
839 | 000000) | |
840 | ;; # removed | |
841 | *) | |
842 | # unexpected type | |
6ff875c5 | 843 | eval_gettextln "unexpected mode \$mod_dst" >&2 |
1cb639e6 PY |
844 | continue ;; |
845 | esac | |
846 | fi | |
847 | missing_src= | |
848 | missing_dst= | |
849 | ||
850 | test $mod_src = 160000 && | |
974ce807 | 851 | ! GIT_DIR="$name/.git" git rev-parse -q --verify $sha1_src^0 >/dev/null && |
1cb639e6 PY |
852 | missing_src=t |
853 | ||
854 | test $mod_dst = 160000 && | |
974ce807 | 855 | ! GIT_DIR="$name/.git" git rev-parse -q --verify $sha1_dst^0 >/dev/null && |
1cb639e6 | 856 | missing_dst=t |
bffe71f4 | 857 | |
44431df0 | 858 | display_name=$(git submodule--helper relative-path "$name" "$wt_prefix") |
091a6eb0 | 859 | |
1cb639e6 PY |
860 | total_commits= |
861 | case "$missing_src,$missing_dst" in | |
862 | t,) | |
091a6eb0 | 863 | errmsg="$(eval_gettext " Warn: \$display_name doesn't contain commit \$sha1_src")" |
1cb639e6 PY |
864 | ;; |
865 | ,t) | |
091a6eb0 | 866 | errmsg="$(eval_gettext " Warn: \$display_name doesn't contain commit \$sha1_dst")" |
1cb639e6 PY |
867 | ;; |
868 | t,t) | |
091a6eb0 | 869 | errmsg="$(eval_gettext " Warn: \$display_name doesn't contain commits \$sha1_src and \$sha1_dst")" |
1cb639e6 PY |
870 | ;; |
871 | *) | |
872 | errmsg= | |
873 | total_commits=$( | |
496eeeb1 | 874 | if test $mod_src = 160000 && test $mod_dst = 160000 |
1cb639e6 PY |
875 | then |
876 | range="$sha1_src...$sha1_dst" | |
877 | elif test $mod_src = 160000 | |
878 | then | |
879 | range=$sha1_src | |
880 | else | |
881 | range=$sha1_dst | |
882 | fi | |
883 | GIT_DIR="$name/.git" \ | |
b0e621ad | 884 | git rev-list --first-parent $range -- | wc -l |
1cb639e6 | 885 | ) |
eed35595 | 886 | total_commits=" ($(($total_commits + 0)))" |
1cb639e6 PY |
887 | ;; |
888 | esac | |
889 | ||
890 | sha1_abbr_src=$(echo $sha1_src | cut -c1-7) | |
891 | sha1_abbr_dst=$(echo $sha1_dst | cut -c1-7) | |
892 | if test $status = T | |
893 | then | |
b3e73449 ÆAB |
894 | blob="$(gettext "blob")" |
895 | submodule="$(gettext "submodule")" | |
1cb639e6 PY |
896 | if test $mod_dst = 160000 |
897 | then | |
091a6eb0 | 898 | echo "* $display_name $sha1_abbr_src($blob)->$sha1_abbr_dst($submodule)$total_commits:" |
1cb639e6 | 899 | else |
091a6eb0 | 900 | echo "* $display_name $sha1_abbr_src($submodule)->$sha1_abbr_dst($blob)$total_commits:" |
1cb639e6 PY |
901 | fi |
902 | else | |
091a6eb0 | 903 | echo "* $display_name $sha1_abbr_src...$sha1_abbr_dst$total_commits:" |
1cb639e6 PY |
904 | fi |
905 | if test -n "$errmsg" | |
906 | then | |
907 | # Don't give error msg for modification whose dst is not submodule | |
908 | # i.e. deleted or changed to blob | |
909 | test $mod_dst = 160000 && echo "$errmsg" | |
910 | else | |
496eeeb1 | 911 | if test $mod_src = 160000 && test $mod_dst = 160000 |
1cb639e6 | 912 | then |
f2dc06a3 PY |
913 | limit= |
914 | test $summary_limit -gt 0 && limit="-$summary_limit" | |
1cb639e6 | 915 | GIT_DIR="$name/.git" \ |
f2dc06a3 | 916 | git log $limit --pretty='format: %m %s' \ |
1cb639e6 PY |
917 | --first-parent $sha1_src...$sha1_dst |
918 | elif test $mod_dst = 160000 | |
919 | then | |
920 | GIT_DIR="$name/.git" \ | |
921 | git log --pretty='format: > %s' -1 $sha1_dst | |
922 | else | |
923 | GIT_DIR="$name/.git" \ | |
924 | git log --pretty='format: < %s' -1 $sha1_src | |
925 | fi | |
926 | echo | |
927 | fi | |
928 | echo | |
3ba7407b | 929 | done |
28f9af5d | 930 | } |
70c7ac22 | 931 | # |
941987a5 | 932 | # List all submodules, prefixed with: |
70c7ac22 LH |
933 | # - submodule not initialized |
934 | # + different revision checked out | |
935 | # | |
936 | # If --cached was specified the revision in the index will be printed | |
937 | # instead of the currently checked out revision. | |
938 | # | |
939 | # $@ = requested paths (default to all) | |
940 | # | |
23a485e3 | 941 | cmd_status() |
70c7ac22 | 942 | { |
5c08dbbd JH |
943 | # parse $args after "submodule ... status". |
944 | while test $# -ne 0 | |
945 | do | |
946 | case "$1" in | |
947 | -q|--quiet) | |
2e6a30ef | 948 | GIT_QUIET=1 |
5c08dbbd JH |
949 | ;; |
950 | --cached) | |
951 | cached=1 | |
952 | ;; | |
64b19ffe JH |
953 | --recursive) |
954 | recursive=1 | |
955 | ;; | |
5c08dbbd JH |
956 | --) |
957 | shift | |
958 | break | |
959 | ;; | |
960 | -*) | |
961 | usage | |
962 | ;; | |
963 | *) | |
964 | break | |
965 | ;; | |
966 | esac | |
967 | shift | |
968 | done | |
969 | ||
a9f8a375 | 970 | git ${wt_prefix:+-C "$wt_prefix"} ${prefix:+--super-prefix "$prefix"} submodule--helper status ${GIT_QUIET:+--quiet} ${cached:+--cached} ${recursive:+--recursive} "$@" |
70c7ac22 | 971 | } |
2327f61e DA |
972 | # |
973 | # Sync remote urls for submodules | |
974 | # This makes the value for remote.$remote.url match the value | |
975 | # specified in .gitmodules. | |
976 | # | |
977 | cmd_sync() | |
978 | { | |
979 | while test $# -ne 0 | |
980 | do | |
981 | case "$1" in | |
982 | -q|--quiet) | |
2e6a30ef | 983 | GIT_QUIET=1 |
2327f61e DA |
984 | shift |
985 | ;; | |
82f49f29 PH |
986 | --recursive) |
987 | recursive=1 | |
988 | shift | |
989 | ;; | |
2327f61e DA |
990 | --) |
991 | shift | |
992 | break | |
993 | ;; | |
994 | -*) | |
995 | usage | |
996 | ;; | |
997 | *) | |
998 | break | |
999 | ;; | |
1000 | esac | |
1001 | done | |
e7849a96 | 1002 | |
13424764 | 1003 | git ${wt_prefix:+-C "$wt_prefix"} ${prefix:+--super-prefix "$prefix"} submodule--helper sync ${GIT_QUIET:+--quiet} ${recursive:+--recursive} "$@" |
2327f61e | 1004 | } |
70c7ac22 | 1005 | |
f6f85861 SB |
1006 | cmd_absorbgitdirs() |
1007 | { | |
1008 | git submodule--helper absorb-git-dirs --prefix "$wt_prefix" "$@" | |
1009 | } | |
1010 | ||
5c08dbbd JH |
1011 | # This loop parses the command line arguments to find the |
1012 | # subcommand name to dispatch. Parsing of the subcommand specific | |
1013 | # options are primarily done by the subcommand implementations. | |
1014 | # Subcommand specific options such as --branch and --cached are | |
1015 | # parsed here as well, for backward compatibility. | |
1016 | ||
1017 | while test $# != 0 && test -z "$command" | |
70c7ac22 LH |
1018 | do |
1019 | case "$1" in | |
f6f85861 | 1020 | add | foreach | init | deinit | update | status | summary | sync | absorbgitdirs) |
5c08dbbd | 1021 | command=$1 |
70c7ac22 LH |
1022 | ;; |
1023 | -q|--quiet) | |
2e6a30ef | 1024 | GIT_QUIET=1 |
70c7ac22 | 1025 | ;; |
ecda0723 SV |
1026 | -b|--branch) |
1027 | case "$2" in | |
1028 | '') | |
1029 | usage | |
1030 | ;; | |
1031 | esac | |
1032 | branch="$2"; shift | |
1033 | ;; | |
70c7ac22 | 1034 | --cached) |
28f9af5d | 1035 | cached="$1" |
70c7ac22 LH |
1036 | ;; |
1037 | --) | |
1038 | break | |
1039 | ;; | |
1040 | -*) | |
1041 | usage | |
1042 | ;; | |
1043 | *) | |
1044 | break | |
1045 | ;; | |
1046 | esac | |
1047 | shift | |
1048 | done | |
1049 | ||
5c08dbbd | 1050 | # No command word defaults to "status" |
af9c9f97 RR |
1051 | if test -z "$command" |
1052 | then | |
1053 | if test $# = 0 | |
1054 | then | |
1055 | command=status | |
1056 | else | |
1057 | usage | |
1058 | fi | |
1059 | fi | |
5c08dbbd JH |
1060 | |
1061 | # "-b branch" is accepted only by "add" | |
1062 | if test -n "$branch" && test "$command" != add | |
1063 | then | |
ecda0723 | 1064 | usage |
5c08dbbd JH |
1065 | fi |
1066 | ||
28f9af5d | 1067 | # "--cached" is accepted only by "status" and "summary" |
496eeeb1 | 1068 | if test -n "$cached" && test "$command" != status && test "$command" != summary |
5c08dbbd | 1069 | then |
70c7ac22 | 1070 | usage |
5c08dbbd JH |
1071 | fi |
1072 | ||
1073 | "cmd_$command" "$@" |