t/t5512-ls-remote.sh

   1 #!/bin/sh
   2
   3 test_description='git ls-remote'
   4
   5 GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME=main
   6 export GIT_TEST_DEFAULT_INITIAL_BRANCH_NAME
   7
   8 . ./test-lib.sh
   9
  10 generate_references () {
  11         for ref
  12         do
  13                 oid=$(git rev-parse "$ref") &&
  14                 printf '%s\t%s\n' "$oid" "$ref" || return 1
  15         done
  16 }
  17
  18 test_expect_success 'set up fake upload-pack' '
  19         # This can be used to simulate an upload-pack that just shows the
  20         # contents of the "input" file (prepared with the test-tool pkt-line
  21         # helper), and does not do any negotiation (since ls-remote does not
  22         # need it).
  23         write_script cat-input <<-\EOF
  24         # send our initial advertisement/response
  25         cat input
  26         # soak up the flush packet from the client
  27         cat
  28         EOF
  29 '
  30
  31 test_expect_success 'dies when no remote found' '
  32         test_must_fail git ls-remote
  33 '
  34
  35 test_expect_success setup '
  36         >file &&
  37         git add file &&
  38         test_tick &&
  39         git commit -m initial &&
  40         git tag mark &&
  41         git tag mark1.1 &&
  42         git tag mark1.2 &&
  43         git tag mark1.10 &&
  44         git show-ref --tags -d >expected.tag.raw &&
  45         sed -e "s/ /    /" expected.tag.raw >expected.tag &&
  46         generate_references HEAD >expected.all &&
  47         git show-ref -d >refs &&
  48         sed -e "s/ /    /" refs >>expected.all &&
  49
  50         git remote add self "$(pwd)/.git" &&
  51         git remote add self2 "."
  52 '
  53
  54 test_expect_success 'ls-remote --tags .git' '
  55         git ls-remote --tags .git >actual &&
  56         test_cmp expected.tag actual
  57 '
  58
  59 test_expect_success 'ls-remote .git' '
  60         git ls-remote .git >actual &&
  61         test_cmp expected.all actual
  62 '
  63
  64 test_expect_success 'ls-remote --tags self' '
  65         git ls-remote --tags self >actual &&
  66         test_cmp expected.tag actual
  67 '
  68
  69 test_expect_success 'ls-remote self' '
  70         git ls-remote self >actual &&
  71         test_cmp expected.all actual
  72 '
  73
  74 test_expect_success 'ls-remote --sort="version:refname" --tags self' '
  75         generate_references \
  76                 refs/tags/mark \
  77                 refs/tags/mark1.1 \
  78                 refs/tags/mark1.2 \
  79                 refs/tags/mark1.10 >expect &&
  80         git ls-remote --sort="version:refname" --tags self >actual &&
  81         test_cmp expect actual
  82 '
  83
  84 test_expect_success 'ls-remote --sort="-version:refname" --tags self' '
  85         generate_references \
  86                 refs/tags/mark1.10 \
  87                 refs/tags/mark1.2 \
  88                 refs/tags/mark1.1 \
  89                 refs/tags/mark >expect &&
  90         git ls-remote --sort="-version:refname" --tags self >actual &&
  91         test_cmp expect actual
  92 '
  93
  94 test_expect_success 'ls-remote --sort="-refname" --tags self' '
  95         generate_references \
  96                 refs/tags/mark1.2 \
  97                 refs/tags/mark1.10 \
  98                 refs/tags/mark1.1 \
  99                 refs/tags/mark >expect &&
 100         git ls-remote --sort="-refname" --tags self >actual &&
 101         test_cmp expect actual
 102 '
 103
 104 test_expect_success 'dies when no remote specified, multiple remotes found, and no default specified' '
 105         test_must_fail git ls-remote
 106 '
 107
 108 test_expect_success 'succeeds when no remote specified but only one found' '
 109         test_when_finished git remote add self2 "." &&
 110         git remote remove self2 &&
 111         git ls-remote
 112 '
 113
 114 test_expect_success 'use "origin" when no remote specified and multiple found' '
 115         URL="$(pwd)/.git" &&
 116         echo "From $URL" >exp_err &&
 117
 118         git remote add origin "$URL" &&
 119         git ls-remote 2>actual_err >actual &&
 120
 121         test_cmp exp_err actual_err &&
 122         test_cmp expected.all actual
 123 '
 124
 125 test_expect_success 'suppress "From <url>" with -q' '
 126         git ls-remote -q 2>actual_err &&
 127         ! test_cmp exp_err actual_err
 128 '
 129
 130 test_expect_success 'use branch.<name>.remote if possible' '
 131         #
 132         # Test that we are indeed using branch.<name>.remote, not "origin", even
 133         # though the "origin" remote has been set.
 134         #
 135
 136         # setup a new remote to differentiate from "origin"
 137         git clone . other.git &&
 138         (
 139                 cd other.git &&
 140                 echo "$(git rev-parse HEAD)     HEAD" &&
 141                 git show-ref    | sed -e "s/ /  /"
 142         ) >exp &&
 143
 144         URL="other.git" &&
 145         echo "From $URL" >exp_err &&
 146
 147         git remote add other $URL &&
 148         git config branch.main.remote other &&
 149
 150         git ls-remote 2>actual_err >actual &&
 151         test_cmp exp_err actual_err &&
 152         test_cmp exp actual
 153 '
 154
 155 test_expect_success 'confuses pattern as remote when no remote specified' '
 156         if test_have_prereq MINGW
 157         then
 158                 # Windows does not like asterisks in pathname
 159                 does_not_exist=main
 160         else
 161                 does_not_exist="refs*main"
 162         fi &&
 163         cat >exp <<-EOF &&
 164         fatal: '\''$does_not_exist'\'' does not appear to be a git repository
 165         fatal: Could not read from remote repository.
 166
 167         Please make sure you have the correct access rights
 168         and the repository exists.
 169         EOF
 170         #
 171         # Do not expect "git ls-remote <pattern>" to work; ls-remote needs
 172         # <remote> if you want to feed <pattern>, just like you cannot say
 173         # fetch <branch>.
 174         # We could just as easily have used "main"; the "*" emphasizes its
 175         # role as a pattern.
 176         test_must_fail git ls-remote "$does_not_exist" >actual 2>&1 &&
 177         test_cmp exp actual
 178 '
 179
 180 test_expect_success 'die with non-2 for wrong repository even with --exit-code' '
 181         {
 182                 git ls-remote --exit-code ./no-such-repository
 183                 status=$?
 184         } &&
 185         test $status != 2 && test $status != 0
 186 '
 187
 188 test_expect_success 'Report success even when nothing matches' '
 189         git ls-remote other.git "refs/nsn/*" >actual &&
 190         test_must_be_empty actual
 191 '
 192
 193 test_expect_success 'Report no-match with --exit-code' '
 194         test_expect_code 2 git ls-remote --exit-code other.git "refs/nsn/*" >actual &&
 195         test_must_be_empty actual
 196 '
 197
 198 test_expect_success 'Report match with --exit-code' '
 199         git ls-remote --exit-code other.git "refs/tags/*" >actual &&
 200         git ls-remote . tags/mark* >expect &&
 201         test_cmp expect actual
 202 '
 203
 204 test_expect_success 'set up some extra tags for ref hiding' '
 205         git tag magic/one &&
 206         git tag magic/two
 207 '
 208
 209 for configsection in transfer uploadpack
 210 do
 211         test_expect_success "Hide some refs with $configsection.hiderefs" '
 212                 test_config $configsection.hiderefs refs/tags &&
 213                 git ls-remote . >actual &&
 214                 test_unconfig $configsection.hiderefs &&
 215                 git ls-remote . >expect.raw &&
 216                 sed -e "/       refs\/tags\//d" expect.raw >expect &&
 217                 test_cmp expect actual
 218         '
 219
 220         test_expect_success "Override hiding of $configsection.hiderefs" '
 221                 test_when_finished "test_unconfig $configsection.hiderefs" &&
 222                 git config --add $configsection.hiderefs refs/tags &&
 223                 git config --add $configsection.hiderefs "!refs/tags/magic" &&
 224                 git config --add $configsection.hiderefs refs/tags/magic/one &&
 225                 git ls-remote . >actual &&
 226                 grep refs/tags/magic/two actual &&
 227                 ! grep refs/tags/magic/one actual
 228         '
 229
 230 done
 231
 232 test_expect_success 'overrides work between mixed transfer/upload-pack hideRefs' '
 233         test_config uploadpack.hiderefs refs/tags &&
 234         test_config transfer.hiderefs "!refs/tags/magic" &&
 235         git ls-remote . >actual &&
 236         grep refs/tags/magic actual
 237 '
 238
 239 test_expect_success 'protocol v2 supports hiderefs' '
 240         test_config uploadpack.hiderefs refs/tags &&
 241         git -c protocol.version=2 ls-remote . >actual &&
 242         ! grep refs/tags actual
 243 '
 244
 245 test_expect_success 'ls-remote --symref' '
 246         git fetch origin &&
 247         echo "ref: refs/heads/main      HEAD" >expect &&
 248         generate_references \
 249                 HEAD \
 250                 refs/heads/main >>expect &&
 251         oid=$(git rev-parse HEAD) &&
 252         echo "$oid      refs/remotes/origin/HEAD" >>expect &&
 253         generate_references \
 254                 refs/remotes/origin/main \
 255                 refs/tags/mark \
 256                 refs/tags/mark1.1 \
 257                 refs/tags/mark1.10 \
 258                 refs/tags/mark1.2 >>expect &&
 259         # Protocol v2 supports sending symrefs for refs other than HEAD, so use
 260         # protocol v0 here.
 261         GIT_TEST_PROTOCOL_VERSION=0 git ls-remote --symref >actual &&
 262         test_cmp expect actual
 263 '
 264
 265 test_expect_success 'ls-remote with filtered symref (refname)' '
 266         rev=$(git rev-parse HEAD) &&
 267         cat >expect <<-EOF &&
 268         ref: refs/heads/main    HEAD
 269         $rev    HEAD
 270         EOF
 271         # Protocol v2 supports sending symrefs for refs other than HEAD, so use
 272         # protocol v0 here.
 273         GIT_TEST_PROTOCOL_VERSION=0 git ls-remote --symref . HEAD >actual &&
 274         test_cmp expect actual
 275 '
 276
 277 test_expect_failure 'ls-remote with filtered symref (--heads)' '
 278         git symbolic-ref refs/heads/foo refs/tags/mark &&
 279         cat >expect <<-EOF &&
 280         ref: refs/tags/mark     refs/heads/foo
 281         $rev    refs/heads/foo
 282         $rev    refs/heads/main
 283         EOF
 284         # Protocol v2 supports sending symrefs for refs other than HEAD, so use
 285         # protocol v0 here.
 286         GIT_TEST_PROTOCOL_VERSION=0 git ls-remote --symref --heads . >actual &&
 287         test_cmp expect actual
 288 '
 289
 290 test_expect_success 'ls-remote --symref omits filtered-out matches' '
 291         cat >expect <<-EOF &&
 292         $rev    refs/heads/foo
 293         $rev    refs/heads/main
 294         EOF
 295         # Protocol v2 supports sending symrefs for refs other than HEAD, so use
 296         # protocol v0 here.
 297         GIT_TEST_PROTOCOL_VERSION=0 git ls-remote --symref --heads . >actual &&
 298         test_cmp expect actual &&
 299         GIT_TEST_PROTOCOL_VERSION=0 git ls-remote --symref . "refs/heads/*" >actual &&
 300         test_cmp expect actual
 301 '
 302
 303 test_expect_success 'indicate no refs in v0 standards-compliant empty remote' '
 304         # Git does not produce an output like this, but it does match the
 305         # standard and is produced by other implementations like JGit. So
 306         # hard-code the case we care about.
 307         #
 308         # The actual capabilities do not matter; there are none that would
 309         # change how ls-remote behaves.
 310         oid=0000000000000000000000000000000000000000 &&
 311         test-tool pkt-line pack >input.q <<-EOF &&
 312         $oid capabilities^{}Qcaps-go-here
 313         0000
 314         EOF
 315         q_to_nul <input.q >input &&
 316
 317         # --exit-code asks the command to exit with 2 when no
 318         # matching refs are found.
 319         test_expect_code 2 git ls-remote --exit-code --upload-pack=./cat-input .
 320 '
 321
 322 test_expect_success 'ls-remote works outside repository' '
 323         # It is important for this repo to be inside the nongit
 324         # area, as we want a repo name that does not include
 325         # slashes (because those inhibit some of our configuration
 326         # lookups).
 327         nongit git init --bare dst.git &&
 328         nongit git ls-remote dst.git
 329 '
 330
 331 test_expect_success 'ls-remote --sort fails gracefully outside repository' '
 332         # Use a sort key that requires access to the referenced objects.
 333         nongit test_must_fail git ls-remote --sort=authordate "$TRASH_DIRECTORY" 2>err &&
 334         test_i18ngrep "^fatal: not a git repository, but the field '\''authordate'\'' requires access to object data" err
 335 '
 336
 337 test_expect_success 'ls-remote patterns work with all protocol versions' '
 338         git for-each-ref --format="%(objectname)        %(refname)" \
 339                 refs/heads/main refs/remotes/origin/main >expect &&
 340         git -c protocol.version=0 ls-remote . main >actual.v0 &&
 341         test_cmp expect actual.v0 &&
 342         git -c protocol.version=2 ls-remote . main >actual.v2 &&
 343         test_cmp expect actual.v2
 344 '
 345
 346 test_expect_success 'ls-remote prefixes work with all protocol versions' '
 347         git for-each-ref --format="%(objectname)        %(refname)" \
 348                 refs/heads/ refs/tags/ >expect &&
 349         git -c protocol.version=0 ls-remote --heads --tags . >actual.v0 &&
 350         test_cmp expect actual.v0 &&
 351         git -c protocol.version=2 ls-remote --heads --tags . >actual.v2 &&
 352         test_cmp expect actual.v2
 353 '
 354
 355 test_expect_success 'v0 clients can handle multiple symrefs' '
 356         # Modern versions of Git will not return multiple symref capabilities
 357         # for v0, so we have to hard-code the response. Note that we will
 358         # always use both v0 and object-format=sha1 here, as the hard-coded
 359         # response reflects a server that only supports those.
 360         oid=1234567890123456789012345678901234567890 &&
 361         symrefs="symref=refs/remotes/origin/HEAD:refs/remotes/origin/main" &&
 362         symrefs="$symrefs symref=HEAD:refs/heads/main" &&
 363
 364         # Likewise we want to make sure our parser is not fooled by the string
 365         # "symref" appearing as part of an earlier cap. But there is no way to
 366         # do that via upload-pack, as arbitrary strings can appear only in a
 367         # "symref" value itself (where we skip past the values as a whole)
 368         # and "agent" (which always appears after "symref", so putting our
 369         # parser in a confused state is less interesting).
 370         caps="some other caps including a-fake-symref-cap" &&
 371
 372         test-tool pkt-line pack >input.q <<-EOF &&
 373         $oid HEADQ$caps $symrefs
 374         $oid refs/heads/main
 375         $oid refs/remotes/origin/HEAD
 376         $oid refs/remotes/origin/main
 377         0000
 378         EOF
 379         q_to_nul <input.q >input &&
 380
 381         cat >expect <<-EOF &&
 382         ref: refs/heads/main    HEAD
 383         $oid    HEAD
 384         $oid    refs/heads/main
 385         ref: refs/remotes/origin/main   refs/remotes/origin/HEAD
 386         $oid    refs/remotes/origin/HEAD
 387         $oid    refs/remotes/origin/main
 388         EOF
 389
 390         git ls-remote --symref --upload-pack=./cat-input . >actual &&
 391         test_cmp expect actual
 392 '
 393
 394 test_done