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