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