git submodule status: Add --recursive to recurse into nested submodules
In very large and hierarchically structured projects, one may encounter nested submodules. In these situations, it is valuable to not only show status for all the submodules in the current repo (which is what is currently done by 'git submodule status'), but also to show status for all submodules at all levels (i.e. recursing into nested submodules as well). This patch teaches the new --recursive option to the 'git submodule status' command. The patch also includes documentation and selftests. Signed-off-by: Johan Herland <johan@herland.net> Signed-off-by: Junio C Hamano <gitster@pobox.com>
This commit is contained in:
parent
b13fd5c1a2
commit
64b19ffedd
@ -11,7 +11,7 @@ SYNOPSIS
|
||||
[verse]
|
||||
'git submodule' [--quiet] add [-b branch]
|
||||
[--reference <repository>] [--] <repository> <path>
|
||||
'git submodule' [--quiet] status [--cached] [--] [<path>...]
|
||||
'git submodule' [--quiet] status [--cached] [--recursive] [--] [<path>...]
|
||||
'git submodule' [--quiet] init [--] [<path>...]
|
||||
'git submodule' [--quiet] update [--init] [-N|--no-fetch] [--rebase]
|
||||
[--reference <repository>] [--merge] [--recursive] [--] [<path>...]
|
||||
@ -100,6 +100,9 @@ status::
|
||||
initialized and `+` if the currently checked out submodule commit
|
||||
does not match the SHA-1 found in the index of the containing
|
||||
repository. This command is the default command for 'git-submodule'.
|
||||
+
|
||||
If '--recursive' is specified, this command will recurse into nested
|
||||
submodules, and show their status as well.
|
||||
|
||||
init::
|
||||
Initialize the submodules, i.e. register each submodule name
|
||||
@ -216,7 +219,7 @@ OPTIONS
|
||||
for linkgit:git-clone[1]'s --reference and --shared options carefully.
|
||||
|
||||
--recursive::
|
||||
This option is only valid for foreach and update commands.
|
||||
This option is only valid for foreach, update and status commands.
|
||||
Traverse submodules recursively. The operation is performed not
|
||||
only in the submodules of the current repo, but also
|
||||
in any nested submodules inside those submodules (and so on).
|
||||
|
@ -6,7 +6,7 @@
|
||||
|
||||
dashless=$(basename "$0" | sed -e 's/-/ /')
|
||||
USAGE="[--quiet] add [-b branch] [--reference <repository>] [--] <repository> <path>
|
||||
or: $dashless [--quiet] status [--cached] [--] [<path>...]
|
||||
or: $dashless [--quiet] status [--cached] [--recursive] [--] [<path>...]
|
||||
or: $dashless [--quiet] init [--] [<path>...]
|
||||
or: $dashless [--quiet] update [--init] [-N|--no-fetch] [--rebase] [--reference <repository>] [--merge] [--recursive] [--] [<path>...]
|
||||
or: $dashless [--quiet] summary [--cached] [--summary-limit <n>] [commit] [--] [<path>...]
|
||||
@ -690,6 +690,7 @@ cmd_summary() {
|
||||
cmd_status()
|
||||
{
|
||||
# parse $args after "submodule ... status".
|
||||
orig_args="$@"
|
||||
while test $# -ne 0
|
||||
do
|
||||
case "$1" in
|
||||
@ -699,6 +700,9 @@ cmd_status()
|
||||
--cached)
|
||||
cached=1
|
||||
;;
|
||||
--recursive)
|
||||
recursive=1
|
||||
;;
|
||||
--)
|
||||
shift
|
||||
break
|
||||
@ -718,22 +722,34 @@ cmd_status()
|
||||
do
|
||||
name=$(module_name "$path") || exit
|
||||
url=$(git config submodule."$name".url)
|
||||
displaypath="$prefix$path"
|
||||
if test -z "$url" || ! test -d "$path"/.git -o -f "$path"/.git
|
||||
then
|
||||
say "-$sha1 $path"
|
||||
say "-$sha1 $displaypath"
|
||||
continue;
|
||||
fi
|
||||
set_name_rev "$path" "$sha1"
|
||||
if git diff-files --quiet -- "$path"
|
||||
then
|
||||
say " $sha1 $path$revname"
|
||||
say " $sha1 $displaypath$revname"
|
||||
else
|
||||
if test -z "$cached"
|
||||
then
|
||||
sha1=$(unset GIT_DIR; cd "$path" && git rev-parse --verify HEAD)
|
||||
set_name_rev "$path" "$sha1"
|
||||
fi
|
||||
say "+$sha1 $path$revname"
|
||||
say "+$sha1 $displaypath$revname"
|
||||
fi
|
||||
|
||||
if test -n "$recursive"
|
||||
then
|
||||
(
|
||||
prefix="$displaypath/"
|
||||
unset GIT_DIR
|
||||
cd "$path" &&
|
||||
cmd_status $orig_args
|
||||
) ||
|
||||
die "Failed to recurse into submodule path '$path'"
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
@ -194,4 +194,30 @@ test_expect_success 'use "update --recursive" to checkout all submodules' '
|
||||
)
|
||||
'
|
||||
|
||||
nested1sha1=$(cd clone3/nested1 && git rev-parse HEAD)
|
||||
nested2sha1=$(cd clone3/nested1/nested2 && git rev-parse HEAD)
|
||||
nested3sha1=$(cd clone3/nested1/nested2/nested3 && git rev-parse HEAD)
|
||||
submodulesha1=$(cd clone3/nested1/nested2/nested3/submodule && git rev-parse HEAD)
|
||||
sub1sha1=$(cd clone3/sub1 && git rev-parse HEAD)
|
||||
sub2sha1=$(cd clone3/sub2 && git rev-parse HEAD)
|
||||
sub3sha1=$(cd clone3/sub3 && git rev-parse HEAD)
|
||||
|
||||
cat > expect <<EOF
|
||||
$nested1sha1 nested1 (heads/master)
|
||||
$nested2sha1 nested1/nested2 (heads/master)
|
||||
$nested3sha1 nested1/nested2/nested3 (heads/master)
|
||||
$submodulesha1 nested1/nested2/nested3/submodule (heads/master)
|
||||
$sub1sha1 sub1 (${sub1sha1:0:7})
|
||||
$sub2sha1 sub2 (${sub1sha1:0:7})
|
||||
$sub3sha1 sub3 (heads/master)
|
||||
EOF
|
||||
|
||||
test_expect_success 'test "status --recursive"' '
|
||||
(
|
||||
cd clone3 &&
|
||||
git submodule status --recursive > ../actual
|
||||
) &&
|
||||
test_cmp expect actual
|
||||
'
|
||||
|
||||
test_done
|
||||
|
Loading…
Reference in New Issue
Block a user