Merge branch 'ma/filter-branch-doc-caret'
[git] / t / t7400-submodule-basic.sh
1 #!/bin/sh
2 #
3 # Copyright (c) 2007 Lars Hjemli
4 #
5
6 test_description='Basic porcelain support for submodules
7
8 This test tries to verify basic sanity of the init, update and status
9 subcommands of git submodule.
10 '
11
12 . ./test-lib.sh
13
14 test_expect_success 'submodule deinit works on empty repository' '
15         git submodule deinit --all
16 '
17
18 test_expect_success 'setup - initial commit' '
19         >t &&
20         git add t &&
21         git commit -m "initial commit" &&
22         git branch initial
23 '
24
25 test_expect_success 'submodule init aborts on missing .gitmodules file' '
26         test_when_finished "git update-index --remove sub" &&
27         git update-index --add --cacheinfo 160000,$(git rev-parse HEAD),sub &&
28         # missing the .gitmodules file here
29         test_must_fail git submodule init 2>actual &&
30         test_i18ngrep "No url found for submodule path" actual
31 '
32
33 test_expect_success 'submodule update aborts on missing .gitmodules file' '
34         test_when_finished "git update-index --remove sub" &&
35         git update-index --add --cacheinfo 160000,$(git rev-parse HEAD),sub &&
36         # missing the .gitmodules file here
37         git submodule update sub 2>actual &&
38         test_i18ngrep "Submodule path .sub. not initialized" actual
39 '
40
41 test_expect_success 'submodule update aborts on missing gitmodules url' '
42         test_when_finished "git update-index --remove sub" &&
43         git update-index --add --cacheinfo 160000,$(git rev-parse HEAD),sub &&
44         test_when_finished "rm -f .gitmodules" &&
45         git config -f .gitmodules submodule.s.path sub &&
46         test_must_fail git submodule init
47 '
48
49 test_expect_success 'add aborts on repository with no commits' '
50         cat >expect <<-\EOF &&
51         '"'repo-no-commits'"' does not have a commit checked out
52         EOF
53         git init repo-no-commits &&
54         test_must_fail git submodule add ../a ./repo-no-commits 2>actual &&
55         test_i18ncmp expect actual
56 '
57
58 test_expect_success 'setup - repository in init subdirectory' '
59         mkdir init &&
60         (
61                 cd init &&
62                 git init &&
63                 echo a >a &&
64                 git add a &&
65                 git commit -m "submodule commit 1" &&
66                 git tag -a -m "rev-1" rev-1
67         )
68 '
69
70 test_expect_success 'setup - commit with gitlink' '
71         echo a >a &&
72         echo z >z &&
73         git add a init z &&
74         git commit -m "super commit 1"
75 '
76
77 test_expect_success 'setup - hide init subdirectory' '
78         mv init .subrepo
79 '
80
81 test_expect_success 'setup - repository to add submodules to' '
82         git init addtest &&
83         git init addtest-ignore
84 '
85
86 # The 'submodule add' tests need some repository to add as a submodule.
87 # The trash directory is a good one as any. We need to canonicalize
88 # the name, though, as some tests compare it to the absolute path git
89 # generates, which will expand symbolic links.
90 submodurl=$(pwd -P)
91
92 listbranches() {
93         git for-each-ref --format='%(refname)' 'refs/heads/*'
94 }
95
96 inspect() {
97         dir=$1 &&
98         dotdot="${2:-..}" &&
99
100         (
101                 cd "$dir" &&
102                 listbranches >"$dotdot/heads" &&
103                 { git symbolic-ref HEAD || :; } >"$dotdot/head" &&
104                 git rev-parse HEAD >"$dotdot/head-sha1" &&
105                 git update-index --refresh &&
106                 git diff-files --exit-code &&
107                 git clean -n -d -x >"$dotdot/untracked"
108         )
109 }
110
111 test_expect_success 'submodule add' '
112         echo "refs/heads/master" >expect &&
113
114         (
115                 cd addtest &&
116                 git submodule add -q "$submodurl" submod >actual &&
117                 test_must_be_empty actual &&
118                 echo "gitdir: ../.git/modules/submod" >expect &&
119                 test_cmp expect submod/.git &&
120                 (
121                         cd submod &&
122                         git config core.worktree >actual &&
123                         echo "../../../submod" >expect &&
124                         test_cmp expect actual &&
125                         rm -f actual expect
126                 ) &&
127                 git submodule init
128         ) &&
129
130         rm -f heads head untracked &&
131         inspect addtest/submod ../.. &&
132         test_cmp expect heads &&
133         test_cmp expect head &&
134         test_must_be_empty untracked
135 '
136
137 test_expect_success 'setup parent and one repository' '
138         test_create_repo parent &&
139         test_commit -C parent one
140 '
141
142 test_expect_success 'redirected submodule add does not show progress' '
143         git -C addtest submodule add "file://$submodurl/parent" submod-redirected \
144                 2>err &&
145         ! grep % err &&
146         test_i18ngrep ! "Checking connectivity" err
147 '
148
149 test_expect_success 'redirected submodule add --progress does show progress' '
150         git -C addtest submodule add --progress "file://$submodurl/parent" \
151                 submod-redirected-progress 2>err && \
152         grep % err
153 '
154
155 test_expect_success 'submodule add to .gitignored path fails' '
156         (
157                 cd addtest-ignore &&
158                 cat <<-\EOF >expect &&
159                 The following paths are ignored by one of your .gitignore files:
160                 submod
161                 Use -f if you really want to add them.
162                 EOF
163                 # Does not use test_commit due to the ignore
164                 echo "*" > .gitignore &&
165                 git add --force .gitignore &&
166                 git commit -m"Ignore everything" &&
167                 ! git submodule add "$submodurl" submod >actual 2>&1 &&
168                 test_i18ncmp expect actual
169         )
170 '
171
172 test_expect_success 'submodule add to .gitignored path with --force' '
173         (
174                 cd addtest-ignore &&
175                 git submodule add --force "$submodurl" submod
176         )
177 '
178
179 test_expect_success 'submodule add to reconfigure existing submodule with --force' '
180         (
181                 cd addtest-ignore &&
182                 bogus_url="$(pwd)/bogus-url" &&
183                 git submodule add --force "$bogus_url" submod &&
184                 git submodule add --force -b initial "$submodurl" submod-branch &&
185                 test "$bogus_url" = "$(git config -f .gitmodules submodule.submod.url)" &&
186                 test "$bogus_url" = "$(git config submodule.submod.url)" &&
187                 # Restore the url
188                 git submodule add --force "$submodurl" submod &&
189                 test "$submodurl" = "$(git config -f .gitmodules submodule.submod.url)" &&
190                 test "$submodurl" = "$(git config submodule.submod.url)"
191         )
192 '
193
194 test_expect_success 'submodule add relays add --dry-run stderr' '
195         test_when_finished "rm -rf addtest/.git/index.lock" &&
196         (
197                 cd addtest &&
198                 : >.git/index.lock &&
199                 ! git submodule add "$submodurl" sub-while-locked 2>output.err &&
200                 test_i18ngrep "^fatal: .*index\.lock" output.err &&
201                 test_path_is_missing sub-while-locked
202         )
203 '
204
205 test_expect_success 'submodule add --branch' '
206         echo "refs/heads/initial" >expect-head &&
207         cat <<-\EOF >expect-heads &&
208         refs/heads/initial
209         refs/heads/master
210         EOF
211
212         (
213                 cd addtest &&
214                 git submodule add -b initial "$submodurl" submod-branch &&
215                 test "initial" = "$(git config -f .gitmodules submodule.submod-branch.branch)" &&
216                 git submodule init
217         ) &&
218
219         rm -f heads head untracked &&
220         inspect addtest/submod-branch ../.. &&
221         test_cmp expect-heads heads &&
222         test_cmp expect-head head &&
223         test_must_be_empty untracked
224 '
225
226 test_expect_success 'submodule add with ./ in path' '
227         echo "refs/heads/master" >expect &&
228
229         (
230                 cd addtest &&
231                 git submodule add "$submodurl" ././dotsubmod/./frotz/./ &&
232                 git submodule init
233         ) &&
234
235         rm -f heads head untracked &&
236         inspect addtest/dotsubmod/frotz ../../.. &&
237         test_cmp expect heads &&
238         test_cmp expect head &&
239         test_must_be_empty untracked
240 '
241
242 test_expect_success 'submodule add with /././ in path' '
243         echo "refs/heads/master" >expect &&
244
245         (
246                 cd addtest &&
247                 git submodule add "$submodurl" dotslashdotsubmod/././frotz/./ &&
248                 git submodule init
249         ) &&
250
251         rm -f heads head untracked &&
252         inspect addtest/dotslashdotsubmod/frotz ../../.. &&
253         test_cmp expect heads &&
254         test_cmp expect head &&
255         test_must_be_empty untracked
256 '
257
258 test_expect_success 'submodule add with // in path' '
259         echo "refs/heads/master" >expect &&
260
261         (
262                 cd addtest &&
263                 git submodule add "$submodurl" slashslashsubmod///frotz// &&
264                 git submodule init
265         ) &&
266
267         rm -f heads head untracked &&
268         inspect addtest/slashslashsubmod/frotz ../../.. &&
269         test_cmp expect heads &&
270         test_cmp expect head &&
271         test_must_be_empty untracked
272 '
273
274 test_expect_success 'submodule add with /.. in path' '
275         echo "refs/heads/master" >expect &&
276
277         (
278                 cd addtest &&
279                 git submodule add "$submodurl" dotdotsubmod/../realsubmod/frotz/.. &&
280                 git submodule init
281         ) &&
282
283         rm -f heads head untracked &&
284         inspect addtest/realsubmod ../.. &&
285         test_cmp expect heads &&
286         test_cmp expect head &&
287         test_must_be_empty untracked
288 '
289
290 test_expect_success 'submodule add with ./, /.. and // in path' '
291         echo "refs/heads/master" >expect &&
292
293         (
294                 cd addtest &&
295                 git submodule add "$submodurl" dot/dotslashsubmod/./../..////realsubmod2/a/b/c/d/../../../../frotz//.. &&
296                 git submodule init
297         ) &&
298
299         rm -f heads head untracked &&
300         inspect addtest/realsubmod2 ../.. &&
301         test_cmp expect heads &&
302         test_cmp expect head &&
303         test_must_be_empty untracked
304 '
305
306 test_expect_success !CYGWIN 'submodule add with \\ in path' '
307         test_when_finished "rm -rf parent sub\\with\\backslash" &&
308
309         # Initialize a repo with a backslash in its name
310         git init sub\\with\\backslash &&
311         touch sub\\with\\backslash/empty.file &&
312         git -C sub\\with\\backslash add empty.file &&
313         git -C sub\\with\\backslash commit -m "Added empty.file" &&
314
315         # Add that repository as a submodule
316         git init parent &&
317         git -C parent submodule add ../sub\\with\\backslash
318 '
319
320 test_expect_success 'submodule add in subdirectory' '
321         echo "refs/heads/master" >expect &&
322
323         mkdir addtest/sub &&
324         (
325                 cd addtest/sub &&
326                 git submodule add "$submodurl" ../realsubmod3 &&
327                 git submodule init
328         ) &&
329
330         rm -f heads head untracked &&
331         inspect addtest/realsubmod3 ../.. &&
332         test_cmp expect heads &&
333         test_cmp expect head &&
334         test_must_be_empty untracked
335 '
336
337 test_expect_success 'submodule add in subdirectory with relative path should fail' '
338         (
339                 cd addtest/sub &&
340                 test_must_fail git submodule add ../../ submod3 2>../../output.err
341         ) &&
342         test_i18ngrep toplevel output.err
343 '
344
345 test_expect_success 'setup - add an example entry to .gitmodules' '
346         git config --file=.gitmodules submodule.example.url git://example.com/init.git
347 '
348
349 test_expect_success 'status should fail for unmapped paths' '
350         test_must_fail git submodule status
351 '
352
353 test_expect_success 'setup - map path in .gitmodules' '
354         cat <<\EOF >expect &&
355 [submodule "example"]
356         url = git://example.com/init.git
357         path = init
358 EOF
359
360         git config --file=.gitmodules submodule.example.path init &&
361
362         test_cmp expect .gitmodules
363 '
364
365 test_expect_success 'status should only print one line' '
366         git submodule status >lines &&
367         test_line_count = 1 lines
368 '
369
370 test_expect_success 'status from subdirectory should have the same SHA1' '
371         test_when_finished "rmdir addtest/subdir" &&
372         (
373                 cd addtest &&
374                 mkdir subdir &&
375                 git submodule status >output &&
376                 awk "{print \$1}" <output >expect &&
377                 cd subdir &&
378                 git submodule status >../output &&
379                 awk "{print \$1}" <../output >../actual &&
380                 test_cmp ../expect ../actual &&
381                 git -C ../submod checkout HEAD^ &&
382                 git submodule status >../output &&
383                 awk "{print \$1}" <../output >../actual2 &&
384                 cd .. &&
385                 git submodule status >output &&
386                 awk "{print \$1}" <output >expect2 &&
387                 test_cmp expect2 actual2 &&
388                 ! test_cmp actual actual2
389         )
390 '
391
392 test_expect_success 'setup - fetch commit name from submodule' '
393         rev1=$(cd .subrepo && git rev-parse HEAD) &&
394         printf "rev1: %s\n" "$rev1" &&
395         test -n "$rev1"
396 '
397
398 test_expect_success 'status should initially be "missing"' '
399         git submodule status >lines &&
400         grep "^-$rev1" lines
401 '
402
403 test_expect_success 'init should register submodule url in .git/config' '
404         echo git://example.com/init.git >expect &&
405
406         git submodule init &&
407         git config submodule.example.url >url &&
408         git config submodule.example.url ./.subrepo &&
409
410         test_cmp expect url
411 '
412
413 test_failure_with_unknown_submodule () {
414         test_must_fail git submodule $1 no-such-submodule 2>output.err &&
415         test_i18ngrep "^error: .*no-such-submodule" output.err
416 }
417
418 test_expect_success 'init should fail with unknown submodule' '
419         test_failure_with_unknown_submodule init
420 '
421
422 test_expect_success 'update should fail with unknown submodule' '
423         test_failure_with_unknown_submodule update
424 '
425
426 test_expect_success 'status should fail with unknown submodule' '
427         test_failure_with_unknown_submodule status
428 '
429
430 test_expect_success 'sync should fail with unknown submodule' '
431         test_failure_with_unknown_submodule sync
432 '
433
434 test_expect_success 'update should fail when path is used by a file' '
435         echo hello >expect &&
436
437         echo "hello" >init &&
438         test_must_fail git submodule update &&
439
440         test_cmp expect init
441 '
442
443 test_expect_success 'update should fail when path is used by a nonempty directory' '
444         echo hello >expect &&
445
446         rm -fr init &&
447         mkdir init &&
448         echo "hello" >init/a &&
449
450         test_must_fail git submodule update &&
451
452         test_cmp expect init/a
453 '
454
455 test_expect_success 'update should work when path is an empty dir' '
456         rm -fr init &&
457         rm -f head-sha1 &&
458         echo "$rev1" >expect &&
459
460         mkdir init &&
461         git submodule update -q >update.out &&
462         test_must_be_empty update.out &&
463
464         inspect init &&
465         test_cmp expect head-sha1
466 '
467
468 test_expect_success 'status should be "up-to-date" after update' '
469         git submodule status >list &&
470         grep "^ $rev1" list
471 '
472
473 test_expect_success 'status "up-to-date" from subdirectory' '
474         mkdir -p sub &&
475         (
476                 cd sub &&
477                 git submodule status >../list
478         ) &&
479         grep "^ $rev1" list &&
480         grep "\\.\\./init" list
481 '
482
483 test_expect_success 'status "up-to-date" from subdirectory with path' '
484         mkdir -p sub &&
485         (
486                 cd sub &&
487                 git submodule status ../init >../list
488         ) &&
489         grep "^ $rev1" list &&
490         grep "\\.\\./init" list
491 '
492
493 test_expect_success 'status should be "modified" after submodule commit' '
494         (
495                 cd init &&
496                 echo b >b &&
497                 git add b &&
498                 git commit -m "submodule commit 2"
499         ) &&
500
501         rev2=$(cd init && git rev-parse HEAD) &&
502         test -n "$rev2" &&
503         git submodule status >list &&
504
505         grep "^+$rev2" list
506 '
507
508 test_expect_success 'the --cached sha1 should be rev1' '
509         git submodule --cached status >list &&
510         grep "^+$rev1" list
511 '
512
513 test_expect_success 'git diff should report the SHA1 of the new submodule commit' '
514         git diff >diff &&
515         grep "^+Subproject commit $rev2" diff
516 '
517
518 test_expect_success 'update should checkout rev1' '
519         rm -f head-sha1 &&
520         echo "$rev1" >expect &&
521
522         git submodule update init &&
523         inspect init &&
524
525         test_cmp expect head-sha1
526 '
527
528 test_expect_success 'status should be "up-to-date" after update' '
529         git submodule status >list &&
530         grep "^ $rev1" list
531 '
532
533 test_expect_success 'checkout superproject with subproject already present' '
534         git checkout initial &&
535         git checkout master
536 '
537
538 test_expect_success 'apply submodule diff' '
539         git branch second &&
540         (
541                 cd init &&
542                 echo s >s &&
543                 git add s &&
544                 git commit -m "change subproject"
545         ) &&
546         git update-index --add init &&
547         git commit -m "change init" &&
548         git format-patch -1 --stdout >P.diff &&
549         git checkout second &&
550         git apply --index P.diff &&
551
552         git diff --cached master >staged &&
553         test_must_be_empty staged
554 '
555
556 test_expect_success 'update --init' '
557         mv init init2 &&
558         git config -f .gitmodules submodule.example.url "$(pwd)/init2" &&
559         git config --remove-section submodule.example &&
560         test_must_fail git config submodule.example.url &&
561
562         git submodule update init 2> update.out &&
563         test_i18ngrep "not initialized" update.out &&
564         test_must_fail git rev-parse --resolve-git-dir init/.git &&
565
566         git submodule update --init init &&
567         git rev-parse --resolve-git-dir init/.git
568 '
569
570 test_expect_success 'update --init from subdirectory' '
571         mv init init2 &&
572         git config -f .gitmodules submodule.example.url "$(pwd)/init2" &&
573         git config --remove-section submodule.example &&
574         test_must_fail git config submodule.example.url &&
575
576         mkdir -p sub &&
577         (
578                 cd sub &&
579                 git submodule update ../init 2>update.out &&
580                 test_i18ngrep "not initialized" update.out &&
581                 test_must_fail git rev-parse --resolve-git-dir ../init/.git &&
582
583                 git submodule update --init ../init
584         ) &&
585         git rev-parse --resolve-git-dir init/.git
586 '
587
588 test_expect_success 'do not add files from a submodule' '
589
590         git reset --hard &&
591         test_must_fail git add init/a
592
593 '
594
595 test_expect_success 'gracefully add/reset submodule with a trailing slash' '
596
597         git reset --hard &&
598         git commit -m "commit subproject" init &&
599         (cd init &&
600          echo b > a) &&
601         git add init/ &&
602         git diff --exit-code --cached init &&
603         commit=$(cd init &&
604          git commit -m update a >/dev/null &&
605          git rev-parse HEAD) &&
606         git add init/ &&
607         test_must_fail git diff --exit-code --cached init &&
608         test $commit = $(git ls-files --stage |
609                 sed -n "s/^160000 \([^ ]*\).*/\1/p") &&
610         git reset init/ &&
611         git diff --exit-code --cached init
612
613 '
614
615 test_expect_success 'ls-files gracefully handles trailing slash' '
616
617         test "init" = "$(git ls-files init/)"
618
619 '
620
621 test_expect_success 'moving to a commit without submodule does not leave empty dir' '
622         rm -rf init &&
623         mkdir init &&
624         git reset --hard &&
625         git checkout initial &&
626         test ! -d init &&
627         git checkout second
628 '
629
630 test_expect_success 'submodule <invalid-subcommand> fails' '
631         test_must_fail git submodule no-such-subcommand
632 '
633
634 test_expect_success 'add submodules without specifying an explicit path' '
635         mkdir repo &&
636         (
637                 cd repo &&
638                 git init &&
639                 echo r >r &&
640                 git add r &&
641                 git commit -m "repo commit 1"
642         ) &&
643         git clone --bare repo/ bare.git &&
644         (
645                 cd addtest &&
646                 git submodule add "$submodurl/repo" &&
647                 git config -f .gitmodules submodule.repo.path repo &&
648                 git submodule add "$submodurl/bare.git" &&
649                 git config -f .gitmodules submodule.bare.path bare
650         )
651 '
652
653 test_expect_success 'add should fail when path is used by a file' '
654         (
655                 cd addtest &&
656                 touch file &&
657                 test_must_fail  git submodule add "$submodurl/repo" file
658         )
659 '
660
661 test_expect_success 'add should fail when path is used by an existing directory' '
662         (
663                 cd addtest &&
664                 mkdir empty-dir &&
665                 test_must_fail git submodule add "$submodurl/repo" empty-dir
666         )
667 '
668
669 test_expect_success 'use superproject as upstream when path is relative and no url is set there' '
670         (
671                 cd addtest &&
672                 git submodule add ../repo relative &&
673                 test "$(git config -f .gitmodules submodule.relative.url)" = ../repo &&
674                 git submodule sync relative &&
675                 test "$(git config submodule.relative.url)" = "$submodurl/repo"
676         )
677 '
678
679 test_expect_success 'set up for relative path tests' '
680         mkdir reltest &&
681         (
682                 cd reltest &&
683                 git init &&
684                 mkdir sub &&
685                 (
686                         cd sub &&
687                         git init &&
688                         test_commit foo
689                 ) &&
690                 git add sub &&
691                 git config -f .gitmodules submodule.sub.path sub &&
692                 git config -f .gitmodules submodule.sub.url ../subrepo &&
693                 cp .git/config pristine-.git-config &&
694                 cp .gitmodules pristine-.gitmodules
695         )
696 '
697
698 test_expect_success '../subrepo works with URL - ssh://hostname/repo' '
699         (
700                 cd reltest &&
701                 cp pristine-.git-config .git/config &&
702                 cp pristine-.gitmodules .gitmodules &&
703                 git config remote.origin.url ssh://hostname/repo &&
704                 git submodule init &&
705                 test "$(git config submodule.sub.url)" = ssh://hostname/subrepo
706         )
707 '
708
709 test_expect_success '../subrepo works with port-qualified URL - ssh://hostname:22/repo' '
710         (
711                 cd reltest &&
712                 cp pristine-.git-config .git/config &&
713                 cp pristine-.gitmodules .gitmodules &&
714                 git config remote.origin.url ssh://hostname:22/repo &&
715                 git submodule init &&
716                 test "$(git config submodule.sub.url)" = ssh://hostname:22/subrepo
717         )
718 '
719
720 # About the choice of the path in the next test:
721 # - double-slash side-steps path mangling issues on Windows
722 # - it is still an absolute local path
723 # - there cannot be a server with a blank in its name just in case the
724 #   path is used erroneously to access a //server/share style path
725 test_expect_success '../subrepo path works with local path - //somewhere else/repo' '
726         (
727                 cd reltest &&
728                 cp pristine-.git-config .git/config &&
729                 cp pristine-.gitmodules .gitmodules &&
730                 git config remote.origin.url "//somewhere else/repo" &&
731                 git submodule init &&
732                 test "$(git config submodule.sub.url)" = "//somewhere else/subrepo"
733         )
734 '
735
736 test_expect_success '../subrepo works with file URL - file:///tmp/repo' '
737         (
738                 cd reltest &&
739                 cp pristine-.git-config .git/config &&
740                 cp pristine-.gitmodules .gitmodules &&
741                 git config remote.origin.url file:///tmp/repo &&
742                 git submodule init &&
743                 test "$(git config submodule.sub.url)" = file:///tmp/subrepo
744         )
745 '
746
747 test_expect_success '../subrepo works with helper URL- helper:://hostname/repo' '
748         (
749                 cd reltest &&
750                 cp pristine-.git-config .git/config &&
751                 cp pristine-.gitmodules .gitmodules &&
752                 git config remote.origin.url helper:://hostname/repo &&
753                 git submodule init &&
754                 test "$(git config submodule.sub.url)" = helper:://hostname/subrepo
755         )
756 '
757
758 test_expect_success '../subrepo works with scp-style URL - user@host:repo' '
759         (
760                 cd reltest &&
761                 cp pristine-.git-config .git/config &&
762                 git config remote.origin.url user@host:repo &&
763                 git submodule init &&
764                 test "$(git config submodule.sub.url)" = user@host:subrepo
765         )
766 '
767
768 test_expect_success '../subrepo works with scp-style URL - user@host:path/to/repo' '
769         (
770                 cd reltest &&
771                 cp pristine-.git-config .git/config &&
772                 cp pristine-.gitmodules .gitmodules &&
773                 git config remote.origin.url user@host:path/to/repo &&
774                 git submodule init &&
775                 test "$(git config submodule.sub.url)" = user@host:path/to/subrepo
776         )
777 '
778
779 test_expect_success '../subrepo works with relative local path - foo' '
780         (
781                 cd reltest &&
782                 cp pristine-.git-config .git/config &&
783                 cp pristine-.gitmodules .gitmodules &&
784                 git config remote.origin.url foo &&
785                 # actual: fails with an error
786                 git submodule init &&
787                 test "$(git config submodule.sub.url)" = subrepo
788         )
789 '
790
791 test_expect_success '../subrepo works with relative local path - foo/bar' '
792         (
793                 cd reltest &&
794                 cp pristine-.git-config .git/config &&
795                 cp pristine-.gitmodules .gitmodules &&
796                 git config remote.origin.url foo/bar &&
797                 git submodule init &&
798                 test "$(git config submodule.sub.url)" = foo/subrepo
799         )
800 '
801
802 test_expect_success '../subrepo works with relative local path - ./foo' '
803         (
804                 cd reltest &&
805                 cp pristine-.git-config .git/config &&
806                 cp pristine-.gitmodules .gitmodules &&
807                 git config remote.origin.url ./foo &&
808                 git submodule init &&
809                 test "$(git config submodule.sub.url)" = subrepo
810         )
811 '
812
813 test_expect_success '../subrepo works with relative local path - ./foo/bar' '
814         (
815                 cd reltest &&
816                 cp pristine-.git-config .git/config &&
817                 cp pristine-.gitmodules .gitmodules &&
818                 git config remote.origin.url ./foo/bar &&
819                 git submodule init &&
820                 test "$(git config submodule.sub.url)" = foo/subrepo
821         )
822 '
823
824 test_expect_success '../subrepo works with relative local path - ../foo' '
825         (
826                 cd reltest &&
827                 cp pristine-.git-config .git/config &&
828                 cp pristine-.gitmodules .gitmodules &&
829                 git config remote.origin.url ../foo &&
830                 git submodule init &&
831                 test "$(git config submodule.sub.url)" = ../subrepo
832         )
833 '
834
835 test_expect_success '../subrepo works with relative local path - ../foo/bar' '
836         (
837                 cd reltest &&
838                 cp pristine-.git-config .git/config &&
839                 cp pristine-.gitmodules .gitmodules &&
840                 git config remote.origin.url ../foo/bar &&
841                 git submodule init &&
842                 test "$(git config submodule.sub.url)" = ../foo/subrepo
843         )
844 '
845
846 test_expect_success '../bar/a/b/c works with relative local path - ../foo/bar.git' '
847         (
848                 cd reltest &&
849                 cp pristine-.git-config .git/config &&
850                 cp pristine-.gitmodules .gitmodules &&
851                 mkdir -p a/b/c &&
852                 (cd a/b/c && git init && test_commit msg) &&
853                 git config remote.origin.url ../foo/bar.git &&
854                 git submodule add ../bar/a/b/c ./a/b/c &&
855                 git submodule init &&
856                 test "$(git config submodule.a/b/c.url)" = ../foo/bar/a/b/c
857         )
858 '
859
860 test_expect_success 'moving the superproject does not break submodules' '
861         (
862                 cd addtest &&
863                 git submodule status >expect
864         ) &&
865         mv addtest addtest2 &&
866         (
867                 cd addtest2 &&
868                 git submodule status >actual &&
869                 test_cmp expect actual
870         )
871 '
872
873 test_expect_success 'moving the submodule does not break the superproject' '
874         (
875                 cd addtest2 &&
876                 git submodule status
877         ) >actual &&
878         sed -e "s/^ \([^ ]* repo\) .*/-\1/" <actual >expect &&
879         mv addtest2/repo addtest2/repo.bak &&
880         test_when_finished "mv addtest2/repo.bak addtest2/repo" &&
881         (
882                 cd addtest2 &&
883                 git submodule status
884         ) >actual &&
885         test_cmp expect actual
886 '
887
888 test_expect_success 'submodule add --name allows to replace a submodule with another at the same path' '
889         (
890                 cd addtest2 &&
891                 (
892                         cd repo &&
893                         echo "$submodurl/repo" >expect &&
894                         git config remote.origin.url >actual &&
895                         test_cmp expect actual &&
896                         echo "gitdir: ../.git/modules/repo" >expect &&
897                         test_cmp expect .git
898                 ) &&
899                 rm -rf repo &&
900                 git rm repo &&
901                 git submodule add -q --name repo_new "$submodurl/bare.git" repo >actual &&
902                 test_must_be_empty actual &&
903                 echo "gitdir: ../.git/modules/submod" >expect &&
904                 test_cmp expect submod/.git &&
905                 (
906                         cd repo &&
907                         echo "$submodurl/bare.git" >expect &&
908                         git config remote.origin.url >actual &&
909                         test_cmp expect actual &&
910                         echo "gitdir: ../.git/modules/repo_new" >expect &&
911                         test_cmp expect .git
912                 ) &&
913                 echo "repo" >expect &&
914                 test_must_fail git config -f .gitmodules submodule.repo.path &&
915                 git config -f .gitmodules submodule.repo_new.path >actual &&
916                 test_cmp expect actual&&
917                 echo "$submodurl/repo" >expect &&
918                 test_must_fail git config -f .gitmodules submodule.repo.url &&
919                 echo "$submodurl/bare.git" >expect &&
920                 git config -f .gitmodules submodule.repo_new.url >actual &&
921                 test_cmp expect actual &&
922                 echo "$submodurl/repo" >expect &&
923                 git config submodule.repo.url >actual &&
924                 test_cmp expect actual &&
925                 echo "$submodurl/bare.git" >expect &&
926                 git config submodule.repo_new.url >actual &&
927                 test_cmp expect actual
928         )
929 '
930
931 test_expect_success 'recursive relative submodules stay relative' '
932         test_when_finished "rm -rf super clone2 subsub sub3" &&
933         mkdir subsub &&
934         (
935                 cd subsub &&
936                 git init &&
937                 >t &&
938                 git add t &&
939                 git commit -m "initial commit"
940         ) &&
941         mkdir sub3 &&
942         (
943                 cd sub3 &&
944                 git init &&
945                 >t &&
946                 git add t &&
947                 git commit -m "initial commit" &&
948                 git submodule add ../subsub dirdir/subsub &&
949                 git commit -m "add submodule subsub"
950         ) &&
951         mkdir super &&
952         (
953                 cd super &&
954                 git init &&
955                 >t &&
956                 git add t &&
957                 git commit -m "initial commit" &&
958                 git submodule add ../sub3 &&
959                 git commit -m "add submodule sub"
960         ) &&
961         git clone super clone2 &&
962         (
963                 cd clone2 &&
964                 git submodule update --init --recursive &&
965                 echo "gitdir: ../.git/modules/sub3" >./sub3/.git_expect &&
966                 echo "gitdir: ../../../.git/modules/sub3/modules/dirdir/subsub" >./sub3/dirdir/subsub/.git_expect
967         ) &&
968         test_cmp clone2/sub3/.git_expect clone2/sub3/.git &&
969         test_cmp clone2/sub3/dirdir/subsub/.git_expect clone2/sub3/dirdir/subsub/.git
970 '
971
972 test_expect_success 'submodule add with an existing name fails unless forced' '
973         (
974                 cd addtest2 &&
975                 rm -rf repo &&
976                 git rm repo &&
977                 test_must_fail git submodule add -q --name repo_new "$submodurl/repo.git" repo &&
978                 test ! -d repo &&
979                 test_must_fail git config -f .gitmodules submodule.repo_new.path &&
980                 test_must_fail git config -f .gitmodules submodule.repo_new.url &&
981                 echo "$submodurl/bare.git" >expect &&
982                 git config submodule.repo_new.url >actual &&
983                 test_cmp expect actual &&
984                 git submodule add -f -q --name repo_new "$submodurl/repo.git" repo &&
985                 test -d repo &&
986                 echo "repo" >expect &&
987                 git config -f .gitmodules submodule.repo_new.path >actual &&
988                 test_cmp expect actual&&
989                 echo "$submodurl/repo.git" >expect &&
990                 git config -f .gitmodules submodule.repo_new.url >actual &&
991                 test_cmp expect actual &&
992                 echo "$submodurl/repo.git" >expect &&
993                 git config submodule.repo_new.url >actual &&
994                 test_cmp expect actual
995         )
996 '
997
998 test_expect_success 'set up a second submodule' '
999         git submodule add ./init2 example2 &&
1000         git commit -m "submodule example2 added"
1001 '
1002
1003 test_expect_success 'submodule deinit works on repository without submodules' '
1004         test_when_finished "rm -rf newdirectory" &&
1005         mkdir newdirectory &&
1006         (
1007                 cd newdirectory &&
1008                 git init &&
1009                 >file &&
1010                 git add file &&
1011                 git commit -m "repo should not be empty" &&
1012                 git submodule deinit . &&
1013                 git submodule deinit --all
1014         )
1015 '
1016
1017 test_expect_success 'submodule deinit should remove the whole submodule section from .git/config' '
1018         git config submodule.example.foo bar &&
1019         git config submodule.example2.frotz nitfol &&
1020         git submodule deinit init &&
1021         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1022         test -n "$(git config --get-regexp "submodule\.example2\.")" &&
1023         test -f example2/.git &&
1024         rmdir init
1025 '
1026
1027 test_expect_success 'submodule deinit should unset core.worktree' '
1028         test_path_is_file .git/modules/example/config &&
1029         test_must_fail git config -f .git/modules/example/config core.worktree
1030 '
1031
1032 test_expect_success 'submodule deinit from subdirectory' '
1033         git submodule update --init &&
1034         git config submodule.example.foo bar &&
1035         mkdir -p sub &&
1036         (
1037                 cd sub &&
1038                 git submodule deinit ../init >../output
1039         ) &&
1040         test_i18ngrep "\\.\\./init" output &&
1041         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1042         test -n "$(git config --get-regexp "submodule\.example2\.")" &&
1043         test -f example2/.git &&
1044         rmdir init
1045 '
1046
1047 test_expect_success 'submodule deinit . deinits all initialized submodules' '
1048         git submodule update --init &&
1049         git config submodule.example.foo bar &&
1050         git config submodule.example2.frotz nitfol &&
1051         test_must_fail git submodule deinit &&
1052         git submodule deinit . >actual &&
1053         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1054         test -z "$(git config --get-regexp "submodule\.example2\.")" &&
1055         test_i18ngrep "Cleared directory .init" actual &&
1056         test_i18ngrep "Cleared directory .example2" actual &&
1057         rmdir init example2
1058 '
1059
1060 test_expect_success 'submodule deinit --all deinits all initialized submodules' '
1061         git submodule update --init &&
1062         git config submodule.example.foo bar &&
1063         git config submodule.example2.frotz nitfol &&
1064         test_must_fail git submodule deinit &&
1065         git submodule deinit --all >actual &&
1066         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1067         test -z "$(git config --get-regexp "submodule\.example2\.")" &&
1068         test_i18ngrep "Cleared directory .init" actual &&
1069         test_i18ngrep "Cleared directory .example2" actual &&
1070         rmdir init example2
1071 '
1072
1073 test_expect_success 'submodule deinit deinits a submodule when its work tree is missing or empty' '
1074         git submodule update --init &&
1075         rm -rf init example2/* example2/.git &&
1076         git submodule deinit init example2 >actual &&
1077         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1078         test -z "$(git config --get-regexp "submodule\.example2\.")" &&
1079         test_i18ngrep ! "Cleared directory .init" actual &&
1080         test_i18ngrep "Cleared directory .example2" actual &&
1081         rmdir init
1082 '
1083
1084 test_expect_success 'submodule deinit fails when the submodule contains modifications unless forced' '
1085         git submodule update --init &&
1086         echo X >>init/s &&
1087         test_must_fail git submodule deinit init &&
1088         test -n "$(git config --get-regexp "submodule\.example\.")" &&
1089         test -f example2/.git &&
1090         git submodule deinit -f init >actual &&
1091         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1092         test_i18ngrep "Cleared directory .init" actual &&
1093         rmdir init
1094 '
1095
1096 test_expect_success 'submodule deinit fails when the submodule contains untracked files unless forced' '
1097         git submodule update --init &&
1098         echo X >>init/untracked &&
1099         test_must_fail git submodule deinit init &&
1100         test -n "$(git config --get-regexp "submodule\.example\.")" &&
1101         test -f example2/.git &&
1102         git submodule deinit -f init >actual &&
1103         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1104         test_i18ngrep "Cleared directory .init" actual &&
1105         rmdir init
1106 '
1107
1108 test_expect_success 'submodule deinit fails when the submodule HEAD does not match unless forced' '
1109         git submodule update --init &&
1110         (
1111                 cd init &&
1112                 git checkout HEAD^
1113         ) &&
1114         test_must_fail git submodule deinit init &&
1115         test -n "$(git config --get-regexp "submodule\.example\.")" &&
1116         test -f example2/.git &&
1117         git submodule deinit -f init >actual &&
1118         test -z "$(git config --get-regexp "submodule\.example\.")" &&
1119         test_i18ngrep "Cleared directory .init" actual &&
1120         rmdir init
1121 '
1122
1123 test_expect_success 'submodule deinit is silent when used on an uninitialized submodule' '
1124         git submodule update --init &&
1125         git submodule deinit init >actual &&
1126         test_i18ngrep "Submodule .example. (.*) unregistered for path .init" actual &&
1127         test_i18ngrep "Cleared directory .init" actual &&
1128         git submodule deinit init >actual &&
1129         test_i18ngrep ! "Submodule .example. (.*) unregistered for path .init" actual &&
1130         test_i18ngrep "Cleared directory .init" actual &&
1131         git submodule deinit . >actual &&
1132         test_i18ngrep ! "Submodule .example. (.*) unregistered for path .init" actual &&
1133         test_i18ngrep "Submodule .example2. (.*) unregistered for path .example2" actual &&
1134         test_i18ngrep "Cleared directory .init" actual &&
1135         git submodule deinit . >actual &&
1136         test_i18ngrep ! "Submodule .example. (.*) unregistered for path .init" actual &&
1137         test_i18ngrep ! "Submodule .example2. (.*) unregistered for path .example2" actual &&
1138         test_i18ngrep "Cleared directory .init" actual &&
1139         git submodule deinit --all >actual &&
1140         test_i18ngrep ! "Submodule .example. (.*) unregistered for path .init" actual &&
1141         test_i18ngrep ! "Submodule .example2. (.*) unregistered for path .example2" actual &&
1142         test_i18ngrep "Cleared directory .init" actual &&
1143         rmdir init example2
1144 '
1145
1146 test_expect_success 'submodule deinit fails when submodule has a .git directory even when forced' '
1147         git submodule update --init &&
1148         (
1149                 cd init &&
1150                 rm .git &&
1151                 cp -R ../.git/modules/example .git &&
1152                 GIT_WORK_TREE=. git config --unset core.worktree
1153         ) &&
1154         test_must_fail git submodule deinit init &&
1155         test_must_fail git submodule deinit -f init &&
1156         test -d init/.git &&
1157         test -n "$(git config --get-regexp "submodule\.example\.")"
1158 '
1159
1160 test_expect_success 'submodule with UTF-8 name' '
1161         svname=$(printf "\303\245 \303\244\303\266") &&
1162         mkdir "$svname" &&
1163         (
1164                 cd "$svname" &&
1165                 git init &&
1166                 >sub &&
1167                 git add sub &&
1168                 git commit -m "init sub"
1169         ) &&
1170         git submodule add ./"$svname" &&
1171         git submodule >&2 &&
1172         test -n "$(git submodule | grep "$svname")"
1173 '
1174
1175 test_expect_success 'submodule add clone shallow submodule' '
1176         mkdir super &&
1177         pwd=$(pwd) &&
1178         (
1179                 cd super &&
1180                 git init &&
1181                 git submodule add --depth=1 file://"$pwd"/example2 submodule &&
1182                 (
1183                         cd submodule &&
1184                         test 1 = $(git log --oneline | wc -l)
1185                 )
1186         )
1187 '
1188
1189 test_expect_success 'submodule helper list is not confused by common prefixes' '
1190         mkdir -p dir1/b &&
1191         (
1192                 cd dir1/b &&
1193                 git init &&
1194                 echo hi >testfile2 &&
1195                 git add . &&
1196                 git commit -m "test1"
1197         ) &&
1198         mkdir -p dir2/b &&
1199         (
1200                 cd dir2/b &&
1201                 git init &&
1202                 echo hello >testfile1 &&
1203                 git add .  &&
1204                 git commit -m "test2"
1205         ) &&
1206         git submodule add /dir1/b dir1/b &&
1207         git submodule add /dir2/b dir2/b &&
1208         git commit -m "first submodule commit" &&
1209         git submodule--helper list dir1/b |cut -c51- >actual &&
1210         echo "dir1/b" >expect &&
1211         test_cmp expect actual
1212 '
1213
1214 test_expect_success 'setup superproject with submodules' '
1215         git init sub1 &&
1216         test_commit -C sub1 test &&
1217         test_commit -C sub1 test2 &&
1218         git init multisuper &&
1219         git -C multisuper submodule add ../sub1 sub0 &&
1220         git -C multisuper submodule add ../sub1 sub1 &&
1221         git -C multisuper submodule add ../sub1 sub2 &&
1222         git -C multisuper submodule add ../sub1 sub3 &&
1223         git -C multisuper commit -m "add some submodules"
1224 '
1225
1226 cat >expect <<-EOF
1227 -sub0
1228  sub1 (test2)
1229  sub2 (test2)
1230  sub3 (test2)
1231 EOF
1232
1233 test_expect_success 'submodule update --init with a specification' '
1234         test_when_finished "rm -rf multisuper_clone" &&
1235         pwd=$(pwd) &&
1236         git clone file://"$pwd"/multisuper multisuper_clone &&
1237         git -C multisuper_clone submodule update --init . ":(exclude)sub0" &&
1238         git -C multisuper_clone submodule status |cut -c 1,43- >actual &&
1239         test_cmp expect actual
1240 '
1241
1242 test_expect_success 'submodule update --init with submodule.active set' '
1243         test_when_finished "rm -rf multisuper_clone" &&
1244         pwd=$(pwd) &&
1245         git clone file://"$pwd"/multisuper multisuper_clone &&
1246         git -C multisuper_clone config submodule.active "." &&
1247         git -C multisuper_clone config --add submodule.active ":(exclude)sub0" &&
1248         git -C multisuper_clone submodule update --init &&
1249         git -C multisuper_clone submodule status |cut -c 1,43- >actual &&
1250         test_cmp expect actual
1251 '
1252
1253 test_expect_success 'submodule update and setting submodule.<name>.active' '
1254         test_when_finished "rm -rf multisuper_clone" &&
1255         pwd=$(pwd) &&
1256         git clone file://"$pwd"/multisuper multisuper_clone &&
1257         git -C multisuper_clone config --bool submodule.sub0.active "true" &&
1258         git -C multisuper_clone config --bool submodule.sub1.active "false" &&
1259         git -C multisuper_clone config --bool submodule.sub2.active "true" &&
1260
1261         cat >expect <<-\EOF &&
1262          sub0 (test2)
1263         -sub1
1264          sub2 (test2)
1265         -sub3
1266         EOF
1267         git -C multisuper_clone submodule update &&
1268         git -C multisuper_clone submodule status |cut -c 1,43- >actual &&
1269         test_cmp expect actual
1270 '
1271
1272 test_expect_success 'clone active submodule without submodule url set' '
1273         test_when_finished "rm -rf test/test" &&
1274         mkdir test &&
1275         # another dir breaks accidental relative paths still being correct
1276         git clone file://"$pwd"/multisuper test/test &&
1277         (
1278                 cd test/test &&
1279                 git config submodule.active "." &&
1280
1281                 # do not pass --init flag, as the submodule is already active:
1282                 git submodule update &&
1283                 git submodule status >actual_raw &&
1284
1285                 cut -c 1,43- actual_raw >actual &&
1286                 cat >expect <<-\EOF &&
1287                  sub0 (test2)
1288                  sub1 (test2)
1289                  sub2 (test2)
1290                  sub3 (test2)
1291                 EOF
1292                 test_cmp expect actual
1293         )
1294 '
1295
1296 test_expect_success 'clone --recurse-submodules with a pathspec works' '
1297         test_when_finished "rm -rf multisuper_clone" &&
1298         cat >expected <<-\EOF &&
1299          sub0 (test2)
1300         -sub1
1301         -sub2
1302         -sub3
1303         EOF
1304
1305         git clone --recurse-submodules="sub0" multisuper multisuper_clone &&
1306         git -C multisuper_clone submodule status |cut -c1,43- >actual &&
1307         test_cmp expected actual
1308 '
1309
1310 test_expect_success 'clone with multiple --recurse-submodules options' '
1311         test_when_finished "rm -rf multisuper_clone" &&
1312         cat >expect <<-\EOF &&
1313         -sub0
1314          sub1 (test2)
1315         -sub2
1316          sub3 (test2)
1317         EOF
1318
1319         git clone --recurse-submodules="." \
1320                   --recurse-submodules=":(exclude)sub0" \
1321                   --recurse-submodules=":(exclude)sub2" \
1322                   multisuper multisuper_clone &&
1323         git -C multisuper_clone submodule status |cut -c1,43- >actual &&
1324         test_cmp expect actual
1325 '
1326
1327 test_expect_success 'clone and subsequent updates correctly auto-initialize submodules' '
1328         test_when_finished "rm -rf multisuper_clone" &&
1329         cat <<-\EOF >expect &&
1330         -sub0
1331          sub1 (test2)
1332         -sub2
1333          sub3 (test2)
1334         EOF
1335
1336         cat <<-\EOF >expect2 &&
1337         -sub0
1338          sub1 (test2)
1339         -sub2
1340          sub3 (test2)
1341         -sub4
1342          sub5 (test2)
1343         EOF
1344
1345         git clone --recurse-submodules="." \
1346                   --recurse-submodules=":(exclude)sub0" \
1347                   --recurse-submodules=":(exclude)sub2" \
1348                   --recurse-submodules=":(exclude)sub4" \
1349                   multisuper multisuper_clone &&
1350
1351         git -C multisuper_clone submodule status |cut -c1,43- >actual &&
1352         test_cmp expect actual &&
1353
1354         git -C multisuper submodule add ../sub1 sub4 &&
1355         git -C multisuper submodule add ../sub1 sub5 &&
1356         git -C multisuper commit -m "add more submodules" &&
1357         # obtain the new superproject
1358         git -C multisuper_clone pull &&
1359         git -C multisuper_clone submodule update --init &&
1360         git -C multisuper_clone submodule status |cut -c1,43- >actual &&
1361         test_cmp expect2 actual
1362 '
1363
1364 test_expect_success 'init properly sets the config' '
1365         test_when_finished "rm -rf multisuper_clone" &&
1366         git clone --recurse-submodules="." \
1367                   --recurse-submodules=":(exclude)sub0" \
1368                   multisuper multisuper_clone &&
1369
1370         git -C multisuper_clone submodule init -- sub0 sub1 &&
1371         git -C multisuper_clone config --get submodule.sub0.active &&
1372         test_must_fail git -C multisuper_clone config --get submodule.sub1.active
1373 '
1374
1375 test_expect_success 'recursive clone respects -q' '
1376         test_when_finished "rm -rf multisuper_clone" &&
1377         git clone -q --recurse-submodules multisuper multisuper_clone >actual &&
1378         test_must_be_empty actual
1379 '
1380
1381 test_done