3 # Copyright (c) 2009 Red Hat, Inc.
6 test_description='Test updating submodules
8 This test verifies that "git submodule update" detaches the HEAD of the
9 submodule and "git submodule update --rebase/--merge" does not detach the HEAD.
17 sha_master=$(git rev-list --max-count=1 master)
18 sha_head=$(git rev-list --max-count=1 HEAD)
20 test "$sha_master" = "$sha_head"
24 test_expect_success 'setup a submodule tree' '
28 git commit -m upstream &&
30 git clone super submodule &&
31 git clone super rebasing &&
32 git clone super merging &&
33 git clone super none &&
35 git submodule add ../submodule submodule &&
37 git commit -m "submodule" &&
38 git submodule init submodule
41 echo "line2" > file &&
43 git commit -m "Commit 2"
47 git pull --rebase origin
50 git commit -m "submodule update"
53 git submodule add ../rebasing rebasing &&
55 git commit -m "rebasing"
58 git submodule add ../merging merging &&
60 git commit -m "rebasing"
63 git submodule add ../none none &&
67 git clone . recursivesuper &&
68 ( cd recursivesuper &&
69 git submodule add ../super super
73 test_expect_success 'submodule update detaching the HEAD ' '
74 (cd super/submodule &&
75 git reset --hard HEAD~1
81 git submodule update submodule &&
87 test_expect_success 'submodule update from subdirectory' '
88 (cd super/submodule &&
89 git reset --hard HEAD~1
96 git submodule update ../submodule &&
102 supersha1=$(git -C super rev-parse HEAD)
103 mergingsha1=$(git -C super/merging rev-parse HEAD)
104 nonesha1=$(git -C super/none rev-parse HEAD)
105 rebasingsha1=$(git -C super/rebasing rev-parse HEAD)
106 submodulesha1=$(git -C super/submodule rev-parse HEAD)
110 Submodule path '../super': checked out '$supersha1'
111 Submodule path '../super/merging': checked out '$mergingsha1'
112 Submodule path '../super/none': checked out '$nonesha1'
113 Submodule path '../super/rebasing': checked out '$rebasingsha1'
114 Submodule path '../super/submodule': checked out '$submodulesha1'
118 Cloning into '$pwd/recursivesuper/super/merging'...
119 Cloning into '$pwd/recursivesuper/super/none'...
120 Cloning into '$pwd/recursivesuper/super/rebasing'...
121 Cloning into '$pwd/recursivesuper/super/submodule'...
122 Submodule 'merging' ($pwd/merging) registered for path '../super/merging'
123 Submodule 'none' ($pwd/none) registered for path '../super/none'
124 Submodule 'rebasing' ($pwd/rebasing) registered for path '../super/rebasing'
125 Submodule 'submodule' ($pwd/submodule) registered for path '../super/submodule'
132 test_expect_success 'submodule update --init --recursive from subdirectory' '
133 git -C recursivesuper/super reset --hard HEAD^ &&
134 (cd recursivesuper &&
137 git submodule update --init --recursive ../super >../../actual 2>../../actual2
139 test_i18ncmp expect actual &&
140 sort actual2 >actual2.sorted &&
141 test_i18ncmp expect2 actual2.sorted
145 Submodule 'foo/sub' ($pwd/withsubs/../rebasing) registered for path 'sub'
148 test_expect_success 'submodule update --init from and of subdirectory' '
152 git submodule add "$(pwd)/../rebasing" foo/sub &&
154 git submodule deinit -f sub &&
155 git submodule update --init sub 2>../../actual2
158 test_i18ncmp expect2 actual2
161 test_expect_success 'submodule update does not fetch already present commits' '
163 echo line3 >> file &&
166 git commit -m "upstream line3"
168 (cd super/submodule &&
169 head=$(git rev-parse --verify HEAD) &&
170 echo "Submodule path ${SQ}submodule$SQ: checked out $SQ$head$SQ" > ../../expected &&
171 git reset --hard HEAD~1
174 git submodule update > ../actual 2> ../actual.err
176 test_i18ncmp expected actual &&
177 test_must_be_empty actual.err
180 test_expect_success 'submodule update should fail due to local changes' '
181 (cd super/submodule &&
182 git reset --hard HEAD~1 &&
183 echo "local change" > file
189 test_must_fail git submodule update submodule
192 test_expect_success 'submodule update should throw away changes with --force ' '
197 git submodule update --force submodule &&
203 test_expect_success 'submodule update --force forcibly checks out submodules' '
208 git submodule update --force submodule &&
210 test "$(git status -s file)" = ""
215 test_expect_success 'submodule update --remote should fetch upstream changes' '
217 echo line4 >> file &&
220 git commit -m "upstream line4"
223 git submodule update --remote --force submodule &&
225 test "$(git log -1 --oneline)" = "$(GIT_DIR=../../submodule/.git git log -1 --oneline)"
229 test_expect_success 'submodule update --remote should fetch upstream changes with .' '
232 git config -f .gitmodules submodule."submodule".branch "." &&
233 git add .gitmodules &&
234 git commit -m "submodules: update from the respective superproject branch"
238 echo line4a >> file &&
241 git commit -m "upstream line4a" &&
242 git checkout -b test-branch &&
243 test_commit on-test-branch
247 git submodule update --remote --force submodule &&
248 git -C submodule log -1 --oneline >actual &&
249 git -C ../submodule log -1 --oneline master >expect &&
250 test_cmp expect actual &&
251 git checkout -b test-branch &&
252 git submodule update --remote --force submodule &&
253 git -C submodule log -1 --oneline >actual &&
254 git -C ../submodule log -1 --oneline test-branch >expect &&
255 test_cmp expect actual &&
256 git checkout master &&
257 git branch -d test-branch &&
258 git reset --hard HEAD^
262 test_expect_success 'local config should override .gitmodules branch' '
264 git checkout test-branch &&
265 echo line5 >> file &&
268 git commit -m "upstream line5" &&
272 git config submodule.submodule.branch test-branch &&
273 git submodule update --remote --force submodule &&
275 test "$(git log -1 --oneline)" = "$(GIT_DIR=../../submodule/.git git log -1 --oneline test-branch)"
279 test_expect_success 'submodule update --rebase staying on master' '
280 (cd super/submodule &&
287 git submodule update --rebase submodule &&
293 test_expect_success 'submodule update --merge staying on master' '
294 (cd super/submodule &&
295 git reset --hard HEAD~1
301 git submodule update --merge submodule &&
307 test_expect_success 'submodule update - rebase in .git/config' '
309 git config submodule.submodule.update rebase
311 (cd super/submodule &&
312 git reset --hard HEAD~1
318 git submodule update submodule &&
324 test_expect_success 'submodule update - checkout in .git/config but --rebase given' '
326 git config submodule.submodule.update checkout
328 (cd super/submodule &&
329 git reset --hard HEAD~1
335 git submodule update --rebase submodule &&
341 test_expect_success 'submodule update - merge in .git/config' '
343 git config submodule.submodule.update merge
345 (cd super/submodule &&
346 git reset --hard HEAD~1
352 git submodule update submodule &&
358 test_expect_success 'submodule update - checkout in .git/config but --merge given' '
360 git config submodule.submodule.update checkout
362 (cd super/submodule &&
363 git reset --hard HEAD~1
369 git submodule update --merge submodule &&
375 test_expect_success 'submodule update - checkout in .git/config' '
377 git config submodule.submodule.update checkout
379 (cd super/submodule &&
380 git reset --hard HEAD^
386 git submodule update submodule &&
392 test_expect_success 'submodule update - command in .git/config' '
394 git config submodule.submodule.update "!git checkout"
396 (cd super/submodule &&
397 git reset --hard HEAD^
403 git submodule update submodule &&
409 test_expect_success 'submodule update - command in .gitmodules is ignored' '
410 test_when_finished "git -C super reset --hard HEAD^" &&
411 git -C super config -f .gitmodules submodule.submodule.update "!false" &&
412 git -C super commit -a -m "add command to .gitmodules file" &&
413 git -C super/submodule reset --hard $submodulesha1^ &&
414 git -C super submodule update submodule
418 Execution of 'false $submodulesha1' failed in submodule path 'submodule'
421 test_expect_success 'submodule update - command in .git/config catches failure' '
423 git config submodule.submodule.update "!false"
425 (cd super/submodule &&
426 git reset --hard $submodulesha1^
429 test_must_fail git submodule update submodule 2>../actual
431 test_i18ncmp actual expect
435 Execution of 'false $submodulesha1' failed in submodule path '../submodule'
438 test_expect_success 'submodule update - command in .git/config catches failure -- subdirectory' '
440 git config submodule.submodule.update "!false"
442 (cd super/submodule &&
443 git reset --hard $submodulesha1^
446 mkdir tmp && cd tmp &&
447 test_must_fail git submodule update ../submodule 2>../../actual
449 test_i18ncmp actual expect
452 test_expect_success 'submodule update - command run for initial population of submodule' '
453 cat >expect <<-EOF &&
454 Execution of '\''false $submodulesha1'\'' failed in submodule path '\''submodule'\''
456 rm -rf super/submodule &&
457 test_must_fail git -C super submodule update 2>actual &&
458 test_i18ncmp expect actual &&
459 git -C super submodule update --checkout
463 Execution of 'false $submodulesha1' failed in submodule path '../super/submodule'
464 Failed to recurse into submodule path '../super'
467 test_expect_success 'recursive submodule update - command in .git/config catches failure -- subdirectory' '
468 (cd recursivesuper &&
469 git submodule update --remote super &&
471 git commit -m "update to latest to have more than one commit in submodules"
473 git -C recursivesuper/super config submodule.submodule.update "!false" &&
474 git -C recursivesuper/super/submodule reset --hard $submodulesha1^ &&
475 (cd recursivesuper &&
476 mkdir -p tmp && cd tmp &&
477 test_must_fail git submodule update --recursive ../super 2>../../actual
479 test_i18ncmp actual expect
482 test_expect_success 'submodule init does not copy command into .git/config' '
484 git ls-files -s submodule >out &&
485 H=$(cut -d" " -f2 out) &&
487 git update-index --add --cacheinfo 160000 $H submodule1 &&
488 git config -f .gitmodules submodule.submodule1.path submodule1 &&
489 git config -f .gitmodules submodule.submodule1.url ../submodule &&
490 git config -f .gitmodules submodule.submodule1.update !false &&
491 git submodule init submodule1 &&
492 echo "none" >expect &&
493 git config submodule.submodule1.update >actual &&
494 test_cmp expect actual
498 test_expect_success 'submodule init picks up rebase' '
500 git config -f .gitmodules submodule.rebasing.update rebase &&
501 git submodule init rebasing &&
502 test "rebase" = "$(git config submodule.rebasing.update)"
506 test_expect_success 'submodule init picks up merge' '
508 git config -f .gitmodules submodule.merging.update merge &&
509 git submodule init merging &&
510 test "merge" = "$(git config submodule.merging.update)"
514 test_expect_success 'submodule update --merge - ignores --merge for new submodules' '
515 test_config -C super submodule.submodule.update checkout &&
518 git submodule update submodule &&
519 git status -s submodule >expect &&
521 git submodule update --merge submodule &&
522 git status -s submodule >actual &&
523 test_cmp expect actual
527 test_expect_success 'submodule update --rebase - ignores --rebase for new submodules' '
528 test_config -C super submodule.submodule.update checkout &&
531 git submodule update submodule &&
532 git status -s submodule >expect &&
534 git submodule update --rebase submodule &&
535 git status -s submodule >actual &&
536 test_cmp expect actual
540 test_expect_success 'submodule update ignores update=merge config for new submodules' '
543 git submodule update submodule &&
544 git status -s submodule >expect &&
546 git config submodule.submodule.update merge &&
547 git submodule update submodule &&
548 git status -s submodule >actual &&
549 git config --unset submodule.submodule.update &&
550 test_cmp expect actual
554 test_expect_success 'submodule update ignores update=rebase config for new submodules' '
557 git submodule update submodule &&
558 git status -s submodule >expect &&
560 git config submodule.submodule.update rebase &&
561 git submodule update submodule &&
562 git status -s submodule >actual &&
563 git config --unset submodule.submodule.update &&
564 test_cmp expect actual
568 test_expect_success 'submodule init picks up update=none' '
570 git config -f .gitmodules submodule.none.update none &&
571 git submodule init none &&
572 test "none" = "$(git config submodule.none.update)"
576 test_expect_success 'submodule update - update=none in .git/config' '
578 git config submodule.submodule.update none &&
580 git checkout master &&
583 git diff --name-only >out &&
584 grep ^submodule$ out &&
585 git submodule update &&
586 git diff --name-only >out &&
587 grep ^submodule$ out &&
591 git config --unset submodule.submodule.update &&
592 git submodule update submodule
596 test_expect_success 'submodule update - update=none in .git/config but --checkout given' '
598 git config submodule.submodule.update none &&
600 git checkout master &&
603 git diff --name-only >out &&
604 grep ^submodule$ out &&
605 git submodule update --checkout &&
606 git diff --name-only >out &&
607 ! grep ^submodule$ out &&
611 git config --unset submodule.submodule.update
615 test_expect_success 'submodule update --init skips submodule with update=none' '
617 git add .gitmodules &&
618 git commit -m ".gitmodules"
620 git clone super cloned &&
622 git submodule update --init &&
623 test_path_exists submodule/.git &&
624 test_path_is_missing none/.git
628 test_expect_success 'submodule update continues after checkout error' '
630 git reset --hard HEAD &&
631 git submodule add ../submodule submodule2 &&
632 git submodule init &&
633 git commit -am "new_submodule" &&
635 git rev-parse --verify HEAD >../expect
638 test_commit "update_submodule" file
641 test_commit "update_submodule2" file
644 git add submodule2 &&
645 git commit -m "two_new_submodule_commits" &&
649 git checkout HEAD^ &&
650 test_must_fail git submodule update &&
652 git rev-parse --verify HEAD >../actual
654 test_cmp expect actual
657 test_expect_success 'submodule update continues after recursive checkout error' '
659 git reset --hard HEAD &&
660 git checkout master &&
661 git submodule update &&
663 git submodule add ../submodule subsubmodule &&
664 git submodule init &&
665 git commit -m "new_subsubmodule"
668 git commit -m "update_submodule" &&
671 test_commit "update_subsubmodule" file
673 git add subsubmodule &&
674 test_commit "update_submodule_again" file &&
676 test_commit "update_subsubmodule_again" file
678 test_commit "update_submodule_again_again" file
681 git rev-parse --verify HEAD >../expect &&
682 test_commit "update_submodule2_again" file
685 git add submodule2 &&
686 git commit -m "new_commits" &&
687 git checkout HEAD^ &&
689 git checkout HEAD^ &&
694 test_must_fail git submodule update --recursive &&
696 git rev-parse --verify HEAD >../actual
698 test_cmp expect actual
702 test_expect_success 'submodule update exit immediately in case of merge conflict' '
704 git checkout master &&
705 git reset --hard HEAD &&
708 git reset --hard HEAD
711 git submodule update --recursive &&
713 test_commit "update_submodule_2" file
716 test_commit "update_submodule2_2" file
719 git add submodule2 &&
720 git commit -m "two_new_submodule_commits" &&
722 git checkout master &&
723 test_commit "conflict" file &&
724 echo "conflict" > file
726 git checkout HEAD^ &&
728 git rev-parse --verify HEAD >../expect
730 git config submodule.submodule.update merge &&
731 test_must_fail git submodule update &&
733 git rev-parse --verify HEAD >../actual
735 test_cmp expect actual
739 test_expect_success 'submodule update exit immediately after recursive rebase error' '
741 git checkout master &&
742 git reset --hard HEAD &&
744 git reset --hard HEAD &&
745 git submodule update --recursive
748 test_commit "update_submodule_3" file
751 test_commit "update_submodule2_3" file
754 git add submodule2 &&
755 git commit -m "two_new_submodule_commits" &&
757 git checkout master &&
758 test_commit "conflict2" file &&
759 echo "conflict" > file
761 git checkout HEAD^ &&
763 git rev-parse --verify HEAD >../expect
765 git config submodule.submodule.update rebase &&
766 test_must_fail git submodule update &&
768 git rev-parse --verify HEAD >../actual
770 test_cmp expect actual
774 test_expect_success 'add different submodules to the same path' '
776 git submodule add ../submodule s1 &&
777 test_must_fail git submodule add ../merging s1
781 test_expect_success 'submodule add places git-dir in superprojects git-dir' '
784 git submodule add ../submodule deeper/submodule &&
785 (cd deeper/submodule &&
786 git log > ../../expected
788 (cd .git/modules/deeper/submodule &&
789 git log > ../../../../actual
791 test_cmp expected actual
795 test_expect_success 'submodule update places git-dir in superprojects git-dir' '
797 git commit -m "added submodule"
799 git clone super super2 &&
801 git submodule init deeper/submodule &&
802 git submodule update &&
803 (cd deeper/submodule &&
804 git log > ../../expected
806 (cd .git/modules/deeper/submodule &&
807 git log > ../../../../actual
809 test_cmp expected actual
813 test_expect_success 'submodule add places git-dir in superprojects git-dir recursive' '
815 (cd deeper/submodule &&
816 git submodule add ../submodule subsubmodule &&
818 git log > ../../../expected
820 git commit -m "added subsubmodule" &&
823 (cd .git/modules/deeper/submodule/modules/subsubmodule &&
824 git log > ../../../../../actual
826 git add deeper/submodule &&
827 git commit -m "update submodule" &&
829 test_cmp expected actual
833 test_expect_success 'submodule update places git-dir in superprojects git-dir recursive' '
834 mkdir super_update_r &&
835 (cd super_update_r &&
838 mkdir subsuper_update_r &&
839 (cd subsuper_update_r &&
842 mkdir subsubsuper_update_r &&
843 (cd subsubsuper_update_r &&
846 git clone subsubsuper_update_r subsubsuper_update_r2 &&
847 (cd subsubsuper_update_r2 &&
848 test_commit "update_subsubsuper" file &&
849 git push origin master
851 git clone subsuper_update_r subsuper_update_r2 &&
852 (cd subsuper_update_r2 &&
853 test_commit "update_subsuper" file &&
854 git submodule add ../subsubsuper_update_r subsubmodule &&
855 git commit -am "subsubmodule" &&
856 git push origin master
858 git clone super_update_r super_update_r2 &&
859 (cd super_update_r2 &&
860 test_commit "update_super" file &&
861 git submodule add ../subsuper_update_r submodule &&
862 git commit -am "submodule" &&
863 git push origin master
865 rm -rf super_update_r2 &&
866 git clone super_update_r super_update_r2 &&
867 (cd super_update_r2 &&
868 git submodule update --init --recursive >actual &&
869 test_i18ngrep "Submodule path .submodule/subsubmodule.: checked out" actual &&
870 (cd submodule/subsubmodule &&
871 git log > ../../expected
873 (cd .git/modules/submodule/modules/subsubmodule &&
874 git log > ../../../../../actual
876 test_cmp expected actual
880 test_expect_success 'submodule add properly re-creates deeper level submodules' '
882 git reset --hard master &&
884 git submodule add --force ../submodule deeper/submodule
888 test_expect_success 'submodule update properly revives a moved submodule' '
890 H=$(git rev-parse --short HEAD) &&
891 git commit -am "pre move" &&
892 H2=$(git rev-parse --short HEAD) &&
894 sed "s/$H/XXX/" out >expect &&
895 H=$(cd submodule2 && git rev-parse HEAD) &&
896 git rm --cached submodule2 &&
898 mkdir -p "moved/sub module" &&
899 git update-index --add --cacheinfo 160000 $H "moved/sub module" &&
900 git config -f .gitmodules submodule.submodule2.path "moved/sub module" &&
901 git commit -am "post move" &&
902 git submodule update &&
904 sed "s/$H2/XXX/" out >actual &&
905 test_cmp expect actual
909 test_expect_success SYMLINKS 'submodule update can handle symbolic links in pwd' '
910 mkdir -p linked/dir &&
911 ln -s linked/dir linkto &&
913 git clone "$TRASH_DIRECTORY"/super_update_r2 super &&
915 git submodule update --init --recursive
920 test_expect_success 'submodule update clone shallow submodule' '
921 test_when_finished "rm -rf super3" &&
922 first=$(git -C cloned rev-parse HEAD:submodule) &&
923 second=$(git -C submodule rev-parse HEAD) &&
924 commit_count=$(git -C submodule rev-list --count $first^..$second) &&
925 git clone cloned super3 &&
929 sed -e "s#url = ../#url = file://$pwd/#" <.gitmodules >.gitmodules.tmp &&
930 mv -f .gitmodules.tmp .gitmodules &&
931 git submodule update --init --depth=$commit_count &&
932 git -C submodule log --oneline >out &&
933 test_line_count = 1 out
937 test_expect_success 'submodule update clone shallow submodule outside of depth' '
938 test_when_finished "rm -rf super3" &&
939 git clone cloned super3 &&
943 sed -e "s#url = ../#url = file://$pwd/#" <.gitmodules >.gitmodules.tmp &&
944 mv -f .gitmodules.tmp .gitmodules &&
945 # Some protocol versions (e.g. 2) support fetching
946 # unadvertised objects, so restrict this test to v0.
947 test_must_fail env GIT_TEST_PROTOCOL_VERSION= \
948 git submodule update --init --depth=1 2>actual &&
949 test_i18ngrep "Direct fetching of that commit failed." actual &&
950 git -C ../submodule config uploadpack.allowReachableSHA1InWant true &&
951 git submodule update --init --depth=1 >actual &&
952 git -C submodule log --oneline >out &&
953 test_line_count = 1 out
957 test_expect_success 'submodule update --recursive drops module name before recursing' '
959 (cd deeper/submodule/subsubmodule &&
962 git submodule update --recursive deeper/submodule >actual &&
963 test_i18ngrep "Submodule path .deeper/submodule/subsubmodule.: checked out" actual
967 test_expect_success 'submodule update can be run in parallel' '
969 GIT_TRACE=$(pwd)/trace.out git submodule update --jobs 7 &&
970 grep "7 tasks" trace.out &&
971 git config submodule.fetchJobs 8 &&
972 GIT_TRACE=$(pwd)/trace.out git submodule update &&
973 grep "8 tasks" trace.out &&
974 GIT_TRACE=$(pwd)/trace.out git submodule update --jobs 9 &&
975 grep "9 tasks" trace.out
979 test_expect_success 'git clone passes the parallel jobs config on to submodules' '
980 test_when_finished "rm -rf super4" &&
981 GIT_TRACE=$(pwd)/trace.out git clone --recurse-submodules --jobs 7 . super4 &&
982 grep "7 tasks" trace.out &&
984 git config --global submodule.fetchJobs 8 &&
985 GIT_TRACE=$(pwd)/trace.out git clone --recurse-submodules . super4 &&
986 grep "8 tasks" trace.out &&
988 GIT_TRACE=$(pwd)/trace.out git clone --recurse-submodules --jobs 9 . super4 &&
989 grep "9 tasks" trace.out &&