Merge branch 'jp/get-ref-dir-unsorted'
[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 'setup - initial commit' '
15         >t &&
16         git add t &&
17         git commit -m "initial commit" &&
18         git branch initial
19 '
20
21 test_expect_success 'setup - repository in init subdirectory' '
22         mkdir init &&
23         (
24                 cd init &&
25                 git init &&
26                 echo a >a &&
27                 git add a &&
28                 git commit -m "submodule commit 1" &&
29                 git tag -a -m "rev-1" rev-1
30         )
31 '
32
33 test_expect_success 'setup - commit with gitlink' '
34         echo a >a &&
35         echo z >z &&
36         git add a init z &&
37         git commit -m "super commit 1"
38 '
39
40 test_expect_success 'setup - hide init subdirectory' '
41         mv init .subrepo
42 '
43
44 test_expect_success 'setup - repository to add submodules to' '
45         git init addtest &&
46         git init addtest-ignore
47 '
48
49 # The 'submodule add' tests need some repository to add as a submodule.
50 # The trash directory is a good one as any. We need to canonicalize
51 # the name, though, as some tests compare it to the absolute path git
52 # generates, which will expand symbolic links.
53 submodurl=$(pwd -P)
54
55 listbranches() {
56         git for-each-ref --format='%(refname)' 'refs/heads/*'
57 }
58
59 inspect() {
60         dir=$1 &&
61         dotdot="${2:-..}" &&
62
63         (
64                 cd "$dir" &&
65                 listbranches >"$dotdot/heads" &&
66                 { git symbolic-ref HEAD || :; } >"$dotdot/head" &&
67                 git rev-parse HEAD >"$dotdot/head-sha1" &&
68                 git update-index --refresh &&
69                 git diff-files --exit-code &&
70                 git clean -n -d -x >"$dotdot/untracked"
71         )
72 }
73
74 test_expect_success 'submodule add' '
75         echo "refs/heads/master" >expect &&
76         >empty &&
77
78         (
79                 cd addtest &&
80                 git submodule add -q "$submodurl" submod >actual &&
81                 test ! -s actual &&
82                 git submodule init
83         ) &&
84
85         rm -f heads head untracked &&
86         inspect addtest/submod ../.. &&
87         test_cmp expect heads &&
88         test_cmp expect head &&
89         test_cmp empty untracked
90 '
91
92 test_expect_success 'submodule add to .gitignored path fails' '
93         (
94                 cd addtest-ignore &&
95                 cat <<-\EOF >expect &&
96                 The following path is ignored by one of your .gitignore files:
97                 submod
98                 Use -f if you really want to add it.
99                 EOF
100                 # Does not use test_commit due to the ignore
101                 echo "*" > .gitignore &&
102                 git add --force .gitignore &&
103                 git commit -m"Ignore everything" &&
104                 ! git submodule add "$submodurl" submod >actual 2>&1 &&
105                 test_i18ncmp expect actual
106         )
107 '
108
109 test_expect_success 'submodule add to .gitignored path with --force' '
110         (
111                 cd addtest-ignore &&
112                 git submodule add --force "$submodurl" submod
113         )
114 '
115
116 test_expect_success 'submodule add --branch' '
117         echo "refs/heads/initial" >expect-head &&
118         cat <<-\EOF >expect-heads &&
119         refs/heads/initial
120         refs/heads/master
121         EOF
122         >empty &&
123
124         (
125                 cd addtest &&
126                 git submodule add -b initial "$submodurl" submod-branch &&
127                 git submodule init
128         ) &&
129
130         rm -f heads head untracked &&
131         inspect addtest/submod-branch ../.. &&
132         test_cmp expect-heads heads &&
133         test_cmp expect-head head &&
134         test_cmp empty untracked
135 '
136
137 test_expect_success 'submodule add with ./ in path' '
138         echo "refs/heads/master" >expect &&
139         >empty &&
140
141         (
142                 cd addtest &&
143                 git submodule add "$submodurl" ././dotsubmod/./frotz/./ &&
144                 git submodule init
145         ) &&
146
147         rm -f heads head untracked &&
148         inspect addtest/dotsubmod/frotz ../../.. &&
149         test_cmp expect heads &&
150         test_cmp expect head &&
151         test_cmp empty untracked
152 '
153
154 test_expect_success 'submodule add with // in path' '
155         echo "refs/heads/master" >expect &&
156         >empty &&
157
158         (
159                 cd addtest &&
160                 git submodule add "$submodurl" slashslashsubmod///frotz// &&
161                 git submodule init
162         ) &&
163
164         rm -f heads head untracked &&
165         inspect addtest/slashslashsubmod/frotz ../../.. &&
166         test_cmp expect heads &&
167         test_cmp expect head &&
168         test_cmp empty untracked
169 '
170
171 test_expect_success 'submodule add with /.. in path' '
172         echo "refs/heads/master" >expect &&
173         >empty &&
174
175         (
176                 cd addtest &&
177                 git submodule add "$submodurl" dotdotsubmod/../realsubmod/frotz/.. &&
178                 git submodule init
179         ) &&
180
181         rm -f heads head untracked &&
182         inspect addtest/realsubmod ../.. &&
183         test_cmp expect heads &&
184         test_cmp expect head &&
185         test_cmp empty untracked
186 '
187
188 test_expect_success 'submodule add with ./, /.. and // in path' '
189         echo "refs/heads/master" >expect &&
190         >empty &&
191
192         (
193                 cd addtest &&
194                 git submodule add "$submodurl" dot/dotslashsubmod/./../..////realsubmod2/a/b/c/d/../../../../frotz//.. &&
195                 git submodule init
196         ) &&
197
198         rm -f heads head untracked &&
199         inspect addtest/realsubmod2 ../.. &&
200         test_cmp expect heads &&
201         test_cmp expect head &&
202         test_cmp empty untracked
203 '
204
205 test_expect_success 'setup - add an example entry to .gitmodules' '
206         GIT_CONFIG=.gitmodules \
207         git config submodule.example.url git://example.com/init.git
208 '
209
210 test_expect_success 'status should fail for unmapped paths' '
211         test_must_fail git submodule status
212 '
213
214 test_expect_success 'setup - map path in .gitmodules' '
215         cat <<\EOF >expect &&
216 [submodule "example"]
217         url = git://example.com/init.git
218         path = init
219 EOF
220
221         GIT_CONFIG=.gitmodules git config submodule.example.path init &&
222
223         test_cmp expect .gitmodules
224 '
225
226 test_expect_success 'status should only print one line' '
227         git submodule status >lines &&
228         test $(wc -l <lines) = 1
229 '
230
231 test_expect_success 'setup - fetch commit name from submodule' '
232         rev1=$(cd .subrepo && git rev-parse HEAD) &&
233         printf "rev1: %s\n" "$rev1" &&
234         test -n "$rev1"
235 '
236
237 test_expect_success 'status should initially be "missing"' '
238         git submodule status >lines &&
239         grep "^-$rev1" lines
240 '
241
242 test_expect_success 'init should register submodule url in .git/config' '
243         echo git://example.com/init.git >expect &&
244
245         git submodule init &&
246         git config submodule.example.url >url &&
247         git config submodule.example.url ./.subrepo &&
248
249         test_cmp expect url
250 '
251
252 test_expect_success 'update should fail when path is used by a file' '
253         echo hello >expect &&
254
255         echo "hello" >init &&
256         test_must_fail git submodule update &&
257
258         test_cmp expect init
259 '
260
261 test_expect_success 'update should fail when path is used by a nonempty directory' '
262         echo hello >expect &&
263
264         rm -fr init &&
265         mkdir init &&
266         echo "hello" >init/a &&
267
268         test_must_fail git submodule update &&
269
270         test_cmp expect init/a
271 '
272
273 test_expect_success 'update should work when path is an empty dir' '
274         rm -fr init &&
275         rm -f head-sha1 &&
276         echo "$rev1" >expect &&
277
278         mkdir init &&
279         git submodule update -q >update.out &&
280         test ! -s update.out &&
281
282         inspect init &&
283         test_cmp expect head-sha1
284 '
285
286 test_expect_success 'status should be "up-to-date" after update' '
287         git submodule status >list &&
288         grep "^ $rev1" list
289 '
290
291 test_expect_success 'status should be "modified" after submodule commit' '
292         (
293                 cd init &&
294                 echo b >b &&
295                 git add b &&
296                 git commit -m "submodule commit 2"
297         ) &&
298
299         rev2=$(cd init && git rev-parse HEAD) &&
300         test -n "$rev2" &&
301         git submodule status >list &&
302
303         grep "^+$rev2" list
304 '
305
306 test_expect_success 'the --cached sha1 should be rev1' '
307         git submodule --cached status >list &&
308         grep "^+$rev1" list
309 '
310
311 test_expect_success 'git diff should report the SHA1 of the new submodule commit' '
312         git diff >diff &&
313         grep "^+Subproject commit $rev2" diff
314 '
315
316 test_expect_success 'update should checkout rev1' '
317         rm -f head-sha1 &&
318         echo "$rev1" >expect &&
319
320         git submodule update init &&
321         inspect init &&
322
323         test_cmp expect head-sha1
324 '
325
326 test_expect_success 'status should be "up-to-date" after update' '
327         git submodule status >list &&
328         grep "^ $rev1" list
329 '
330
331 test_expect_success 'checkout superproject with subproject already present' '
332         git checkout initial &&
333         git checkout master
334 '
335
336 test_expect_success 'apply submodule diff' '
337         >empty &&
338
339         git branch second &&
340         (
341                 cd init &&
342                 echo s >s &&
343                 git add s &&
344                 git commit -m "change subproject"
345         ) &&
346         git update-index --add init &&
347         git commit -m "change init" &&
348         git format-patch -1 --stdout >P.diff &&
349         git checkout second &&
350         git apply --index P.diff &&
351
352         git diff --cached master >staged &&
353         test_cmp empty staged
354 '
355
356 test_expect_success 'update --init' '
357         mv init init2 &&
358         git config -f .gitmodules submodule.example.url "$(pwd)/init2" &&
359         git config --remove-section submodule.example &&
360         test_must_fail git config submodule.example.url &&
361
362         git submodule update init > update.out &&
363         cat update.out &&
364         test_i18ngrep "not initialized" update.out &&
365         test_must_fail git rev-parse --resolve-git-dir init/.git &&
366
367         git submodule update --init init &&
368         git rev-parse --resolve-git-dir init/.git
369 '
370
371 test_expect_success 'do not add files from a submodule' '
372
373         git reset --hard &&
374         test_must_fail git add init/a
375
376 '
377
378 test_expect_success 'gracefully add submodule with a trailing slash' '
379
380         git reset --hard &&
381         git commit -m "commit subproject" init &&
382         (cd init &&
383          echo b > a) &&
384         git add init/ &&
385         git diff --exit-code --cached init &&
386         commit=$(cd init &&
387          git commit -m update a >/dev/null &&
388          git rev-parse HEAD) &&
389         git add init/ &&
390         test_must_fail git diff --exit-code --cached init &&
391         test $commit = $(git ls-files --stage |
392                 sed -n "s/^160000 \([^ ]*\).*/\1/p")
393
394 '
395
396 test_expect_success 'ls-files gracefully handles trailing slash' '
397
398         test "init" = "$(git ls-files init/)"
399
400 '
401
402 test_expect_success 'moving to a commit without submodule does not leave empty dir' '
403         rm -rf init &&
404         mkdir init &&
405         git reset --hard &&
406         git checkout initial &&
407         test ! -d init &&
408         git checkout second
409 '
410
411 test_expect_success 'submodule <invalid-path> warns' '
412
413         git submodule no-such-submodule 2> output.err &&
414         grep "^error: .*no-such-submodule" output.err
415
416 '
417
418 test_expect_success 'add submodules without specifying an explicit path' '
419         mkdir repo &&
420         (
421                 cd repo &&
422                 git init &&
423                 echo r >r &&
424                 git add r &&
425                 git commit -m "repo commit 1"
426         ) &&
427         git clone --bare repo/ bare.git &&
428         (
429                 cd addtest &&
430                 git submodule add "$submodurl/repo" &&
431                 git config -f .gitmodules submodule.repo.path repo &&
432                 git submodule add "$submodurl/bare.git" &&
433                 git config -f .gitmodules submodule.bare.path bare
434         )
435 '
436
437 test_expect_success 'add should fail when path is used by a file' '
438         (
439                 cd addtest &&
440                 touch file &&
441                 test_must_fail  git submodule add "$submodurl/repo" file
442         )
443 '
444
445 test_expect_success 'add should fail when path is used by an existing directory' '
446         (
447                 cd addtest &&
448                 mkdir empty-dir &&
449                 test_must_fail git submodule add "$submodurl/repo" empty-dir
450         )
451 '
452
453 test_expect_success 'use superproject as upstream when path is relative and no url is set there' '
454         (
455                 cd addtest &&
456                 git submodule add ../repo relative &&
457                 test "$(git config -f .gitmodules submodule.relative.url)" = ../repo &&
458                 git submodule sync relative &&
459                 test "$(git config submodule.relative.url)" = "$submodurl/repo"
460         )
461 '
462
463 test_expect_success 'set up for relative path tests' '
464         mkdir reltest &&
465         (
466                 cd reltest &&
467                 git init &&
468                 mkdir sub &&
469                 (
470                         cd sub &&
471                         git init &&
472                         test_commit foo
473                 ) &&
474                 git add sub &&
475                 git config -f .gitmodules submodule.sub.path sub &&
476                 git config -f .gitmodules submodule.sub.url ../subrepo &&
477                 cp .git/config pristine-.git-config
478         )
479 '
480
481 test_expect_success 'relative path works with URL' '
482         (
483                 cd reltest &&
484                 cp pristine-.git-config .git/config &&
485                 git config remote.origin.url ssh://hostname/repo &&
486                 git submodule init &&
487                 test "$(git config submodule.sub.url)" = ssh://hostname/subrepo
488         )
489 '
490
491 test_expect_success 'relative path works with user@host:path' '
492         (
493                 cd reltest &&
494                 cp pristine-.git-config .git/config &&
495                 git config remote.origin.url user@host:repo &&
496                 git submodule init &&
497                 test "$(git config submodule.sub.url)" = user@host:subrepo
498         )
499 '
500
501 test_done