GitLabgitlab-org
cli
main
1//go:build !integration
3package download
5import (
6 "fmt"
7 "os"
8 "path/filepath"
9 "testing"
11 "github.com/stretchr/testify/assert"
12 "github.com/stretchr/testify/require"
13 "go.uber.org/mock/gomock"
15 gitlab "gitlab.com/gitlab-org/api/client-go/v3"
16 gitlabtesting "gitlab.com/gitlab-org/api/client-go/v3/testing"
18 "gitlab.com/gitlab-org/cli/internal/testing/cmdtest"
19)
21const (
22 fileContents = "Hello"
23 fileContentsChecksum = "185f8db32271fe25f561a6fc938b2e264306ec304eda518007d1764826381969"
24 repoName = "OWNER/REPO"
25)
27func mockChecksumLookup(tc *gitlabtesting.TestClient, checksum string) {
28 mockChecksumLookupFiles(tc, []*gitlab.PackageFile{{ID: 1, FileName: "app.zip", FileSHA256: checksum}})
29}
31func mockChecksumLookupFiles(tc *gitlabtesting.TestClient, files []*gitlab.PackageFile) {
32 tc.MockPackages.EXPECT().
33 ListProjectPackages(repoName, gomock.Any(), gomock.Any(), gomock.Any()).
34 Return([]*gitlab.Package{{ID: 7, Name: "my-package", Version: "1.0.0", PackageType: "generic"}}, &gitlab.Response{}, nil)
35 tc.MockPackages.EXPECT().
36 ListPackageFiles(repoName, int64(7), gomock.Any(), gomock.Any(), gomock.Any()).
37 Return(files, &gitlab.Response{}, nil)
38}
40func Test_PackagesDownload(t *testing.T) {
41 testCases := []struct {
42 name string
43 cli string
44 expectedMsg []string
45 expectedFileName string
46 wantErr bool
47 wantStderr string
48 setup func(t *testing.T)
49 setupMocks func(*gitlabtesting.TestClient)
50 }{
51 {
52 name: "Download with checksum verification",
53 cli: "--name my-package --version 1.0.0 --filename app.zip",
54 expectedMsg: []string{"Downloaded package file to 'app.zip' (Package: my-package, Version: 1.0.0)\n"},
55 expectedFileName: "app.zip",
56 setupMocks: func(tc *gitlabtesting.TestClient) {
57 tc.MockGenericPackages.EXPECT().
58 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
59 Return([]byte(fileContents), nil, nil)
60 mockChecksumLookup(tc, fileContentsChecksum)
61 },
62 },
63 {
64 name: "Republished file verifies against the most recent upload",
65 cli: "--name my-package --version 1.0.0 --filename app.zip",
66 expectedMsg: []string{"Downloaded package file to 'app.zip' (Package: my-package, Version: 1.0.0)\n"},
67 expectedFileName: "app.zip",
68 setupMocks: func(tc *gitlabtesting.TestClient) {
69 // The download endpoint serves the newest file with a given name,
70 // while the package files list is ordered by ID ascending.
71 tc.MockGenericPackages.EXPECT().
72 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
73 Return([]byte(fileContents), nil, nil)
74 mockChecksumLookupFiles(tc, []*gitlab.PackageFile{
75 {ID: 1, FileName: "app.zip", FileSHA256: "checksum_of_the_old_upload"},
76 {ID: 2, FileName: "app.zip", FileSHA256: fileContentsChecksum},
77 {ID: 3, FileName: "other.zip", FileSHA256: "checksum_of_another_file"},
78 })
79 },
80 },
81 {
82 name: "Republished file verifies against the highest ID in any list order",
83 cli: "--name my-package --version 1.0.0 --filename app.zip",
84 expectedMsg: []string{"Downloaded package file to 'app.zip' (Package: my-package, Version: 1.0.0)\n"},
85 expectedFileName: "app.zip",
86 setupMocks: func(tc *gitlabtesting.TestClient) {
87 tc.MockGenericPackages.EXPECT().
88 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
89 Return([]byte(fileContents), nil, nil)
90 mockChecksumLookupFiles(tc, []*gitlab.PackageFile{
91 {ID: 9, FileName: "app.zip", FileSHA256: fileContentsChecksum},
92 {ID: 4, FileName: "app.zip", FileSHA256: "checksum_of_the_old_upload"},
93 })
94 },
95 },
96 {
97 name: "Download to a custom path",
98 cli: "--name my-package --version 1.0.0 --filename app.zip --path newdir/new.zip",
99 expectedMsg: []string{"Downloaded package file to 'newdir/new.zip' (Package: my-package, Version: 1.0.0)\n"},
100 expectedFileName: "newdir/new.zip",
101 setupMocks: func(tc *gitlabtesting.TestClient) {
102 tc.MockGenericPackages.EXPECT().
103 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
104 Return([]byte(fileContents), nil, nil)
105 mockChecksumLookup(tc, fileContentsChecksum)
106 },
107 },
108 {
109 name: "Download without checksum verification",
110 cli: "--name my-package --version 1.0.0 --filename app.zip --no-verify",
111 expectedMsg: []string{"Downloaded package file to 'app.zip' (Package: my-package, Version: 1.0.0)\n"},
112 expectedFileName: "app.zip",
113 setupMocks: func(tc *gitlabtesting.TestClient) {
114 tc.MockGenericPackages.EXPECT().
115 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
116 Return([]byte(fileContents), nil, nil)
117 },
118 },
119 {
120 name: "Download with invalid checksum",
121 cli: "--name my-package --version 1.0.0 --filename app.zip",
122 wantErr: true,
123 wantStderr: "checksum verification failed for app.zip: expected invalid_checksum, got " + fileContentsChecksum,
124 setupMocks: func(tc *gitlabtesting.TestClient) {
125 tc.MockGenericPackages.EXPECT().
126 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
127 Return([]byte(fileContents), nil, nil)
128 mockChecksumLookup(tc, "invalid_checksum")
129 },
130 },
131 {
132 name: "Download into a directory keeps the original name",
133 cli: "--name my-package --version 1.0.0 --filename app.zip --path subdir/",
134 expectedMsg: []string{"Downloaded package file to 'subdir/app.zip' (Package: my-package, Version: 1.0.0)\n"},
135 expectedFileName: "subdir/app.zip",
136 setupMocks: func(tc *gitlabtesting.TestClient) {
137 tc.MockGenericPackages.EXPECT().
138 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
139 Return([]byte(fileContents), nil, nil)
140 mockChecksumLookup(tc, fileContentsChecksum)
141 },
142 },
143 {
144 name: "Download into an existing directory keeps the original name",
145 cli: "--name my-package --version 1.0.0 --filename app.zip --path existing",
146 expectedMsg: []string{"Downloaded package file to 'existing/app.zip' (Package: my-package, Version: 1.0.0)\n"},
147 expectedFileName: "existing/app.zip",
148 setup: func(t *testing.T) {
149 t.Helper()
150 require.NoError(t, os.Mkdir("existing", 0o755))
151 },
152 setupMocks: func(tc *gitlabtesting.TestClient) {
153 tc.MockGenericPackages.EXPECT().
154 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
155 Return([]byte(fileContents), nil, nil)
156 mockChecksumLookup(tc, fileContentsChecksum)
157 },
158 },
159 {
160 name: "Force overwrites an existing file",
161 cli: "--name my-package --version 1.0.0 --filename app.zip --force",
162 expectedMsg: []string{"Downloaded package file to 'app.zip' (Package: my-package, Version: 1.0.0)\n"},
163 expectedFileName: "app.zip",
164 setup: func(t *testing.T) {
165 t.Helper()
166 require.NoError(t, os.WriteFile("app.zip", []byte("stale"), 0o644))
167 },
168 setupMocks: func(tc *gitlabtesting.TestClient) {
169 tc.MockGenericPackages.EXPECT().
170 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
171 Return([]byte(fileContents), nil, nil)
172 mockChecksumLookup(tc, fileContentsChecksum)
173 },
174 },
175 {
176 name: "Existing file without force errors",
177 cli: "--name my-package --version 1.0.0 --filename app.zip",
178 wantErr: true,
179 wantStderr: "file app.zip already exists; use --force to overwrite current file",
180 setup: func(t *testing.T) {
181 t.Helper()
182 require.NoError(t, os.WriteFile("app.zip", []byte("stale"), 0o644))
183 },
184 setupMocks: func(tc *gitlabtesting.TestClient) {},
185 },
186 {
187 name: "Download but API errors",
188 cli: "--name my-package --version 1.0.0 --filename app.zip --no-verify",
189 wantErr: true,
190 wantStderr: "failed to download package file: GET https://gitlab.com/api/v4/projects/OWNER%2FREPO/packages/generic: 404",
191 setupMocks: func(tc *gitlabtesting.TestClient) {
192 tc.MockGenericPackages.EXPECT().
193 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
194 Return(nil, nil, fmt.Errorf("GET https://gitlab.com/api/v4/projects/OWNER%%2FREPO/packages/generic: 404"))
195 },
196 },
197 {
198 name: "Download but package not found",
199 cli: "--name my-package --version 1.0.0 --filename app.zip",
200 wantErr: true,
201 wantStderr: "failed to look up package: couldn't locate package \"my-package\" with package-type \"generic\" and version \"1.0.0\"",
202 setupMocks: func(tc *gitlabtesting.TestClient) {
203 tc.MockGenericPackages.EXPECT().
204 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
205 Return([]byte(fileContents), nil, nil)
206 tc.MockPackages.EXPECT().
207 ListProjectPackages(repoName, gomock.Any(), gomock.Any(), gomock.Any()).
208 Return(nil, &gitlab.Response{}, nil)
209 },
210 },
211 {
212 name: "Download but several packages match",
213 cli: "--name my-package --version 1.0.0 --filename app.zip",
214 wantErr: true,
215 wantStderr: "failed to look up package: found 2 packages named \"my-package\" with package-type \"generic\" and version \"1.0.0\" (IDs: 7, 8)",
216 setupMocks: func(tc *gitlabtesting.TestClient) {
217 tc.MockGenericPackages.EXPECT().
218 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
219 Return([]byte(fileContents), nil, nil)
220 tc.MockPackages.EXPECT().
221 ListProjectPackages(repoName, gomock.Any(), gomock.Any(), gomock.Any()).
222 Return([]*gitlab.Package{
223 {ID: 7, Name: "my-package", Version: "1.0.0", PackageType: "generic"},
224 {ID: 8, Name: "my-package", Version: "1.0.0", PackageType: "generic"},
225 }, &gitlab.Response{}, nil)
226 },
227 },
228 {
229 name: "Download missing file in package",
230 cli: "--name my-package --version 1.0.0 --filename missing.zip",
231 wantErr: true,
232 wantStderr: "couldn't locate file missing.zip in package my-package version 1.0.0",
233 setupMocks: func(tc *gitlabtesting.TestClient) {
234 tc.MockGenericPackages.EXPECT().
235 DownloadPackageFile(repoName, "my-package", "1.0.0", "missing.zip", gomock.Any()).
236 Return([]byte(fileContents), nil, nil)
237 mockChecksumLookup(tc, fileContentsChecksum)
238 },
239 },
240 }
242 for _, tc := range testCases {
243 t.Run(tc.name, func(t *testing.T) {
244 tempDir := t.TempDir()
245 t.Chdir(tempDir)
247 if tc.setup != nil {
248 tc.setup(t)
249 }
251 testClient := gitlabtesting.NewTestClient(t)
252 tc.setupMocks(testClient)
254 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
255 cmdtest.WithGitLabClient(testClient.Client),
256 )
257 out, err := exec(tc.cli)
259 if tc.wantErr {
260 require.Error(t, err)
261 assert.Equal(t, tc.wantStderr, err.Error())
262 return
263 }
264 require.NoError(t, err)
266 for _, msg := range tc.expectedMsg {
267 require.Contains(t, out.String(), msg)
268 }
270 actualContent, err := os.ReadFile(tc.expectedFileName)
271 require.NoError(t, err, "Failed to read downloaded test file")
272 assert.Equal(t, fileContents, string(actualContent), "File content should match")
273 })
274 }
275}
277// The table above can only carry static CLI strings, so the absolute-path
278// cases live here where a t.TempDir() can be interpolated.
279func Test_PackagesDownload_AbsoluteDestination(t *testing.T) {
280 mockDownload := func(t *testing.T, checksum string) *gitlabtesting.TestClient {
281 t.Helper()
282 tc := gitlabtesting.NewTestClient(t)
283 tc.MockGenericPackages.EXPECT().
284 DownloadPackageFile(repoName, "my-package", "1.0.0", "app.zip", gomock.Any()).
285 Return([]byte(fileContents), nil, nil)
286 mockChecksumLookup(tc, checksum)
287 return tc
288 }
290 const cli = "--name my-package --version 1.0.0 --filename app.zip --path "
292 t.Run("absolute path creates missing parents and writes the file", func(t *testing.T) {
293 t.Chdir(t.TempDir())
294 dest := filepath.Join(t.TempDir(), "nested", "deeper", "out.zip")
296 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
297 cmdtest.WithGitLabClient(mockDownload(t, fileContentsChecksum).Client))
298 out, err := exec(cli + dest)
300 require.NoError(t, err)
301 assert.Contains(t, out.String(), "Downloaded package file to '"+dest+"'")
303 got, err := os.ReadFile(dest)
304 require.NoError(t, err)
305 assert.Equal(t, fileContents, string(got))
306 })
308 t.Run("absolute path naming an existing directory appends the filename", func(t *testing.T) {
309 t.Chdir(t.TempDir())
310 destDir := t.TempDir()
312 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
313 cmdtest.WithGitLabClient(mockDownload(t, fileContentsChecksum).Client))
314 _, err := exec(cli + destDir)
316 require.NoError(t, err)
317 got, err := os.ReadFile(filepath.Join(destDir, "app.zip"))
318 require.NoError(t, err)
319 assert.Equal(t, fileContents, string(got))
320 })
322 // The existing-file guard reads through the same root, so it has to keep
323 // working once that root is anchored at an absolute destination.
324 t.Run("absolute path refuses to overwrite without --force", func(t *testing.T) {
325 t.Chdir(t.TempDir())
326 dest := filepath.Join(t.TempDir(), "out.zip")
327 require.NoError(t, os.WriteFile(dest, []byte("existing"), 0o600))
329 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
330 cmdtest.WithGitLabClient(gitlabtesting.NewTestClient(t).Client))
331 _, err := exec(cli + dest)
333 require.Error(t, err)
334 assert.Equal(t, fmt.Sprintf("file %s already exists; use --force to overwrite current file", dest), err.Error())
336 got, err := os.ReadFile(dest)
337 require.NoError(t, err)
338 assert.Equal(t, "existing", string(got), "the existing file must be left untouched")
339 })
341 t.Run("absolute path overwrites with --force", func(t *testing.T) {
342 t.Chdir(t.TempDir())
343 dest := filepath.Join(t.TempDir(), "out.zip")
344 require.NoError(t, os.WriteFile(dest, []byte("existing"), 0o600))
346 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
347 cmdtest.WithGitLabClient(mockDownload(t, fileContentsChecksum).Client))
348 _, err := exec(cli + dest + " --force")
350 require.NoError(t, err)
351 got, err := os.ReadFile(dest)
352 require.NoError(t, err)
353 assert.Equal(t, fileContents, string(got))
354 })
356 t.Run("failed checksum leaves no temporary file behind", func(t *testing.T) {
357 t.Chdir(t.TempDir())
358 destDir := t.TempDir()
359 dest := filepath.Join(destDir, "out.zip")
361 exec := cmdtest.SetupCmdForTest(t, NewCmd, false,
362 cmdtest.WithGitLabClient(mockDownload(t, "invalid_checksum").Client))
363 _, err := exec(cli + dest)
365 require.Error(t, err)
366 entries, readErr := os.ReadDir(destDir)
367 require.NoError(t, readErr)
368 assert.Empty(t, entries, "destination directory should hold no temporary leftovers")
369 })
370}
Diagnostics8 git calls · 232 ms
CallStatusSizeTime0232 ms
discover200185 B3 ms
git.upload-pack discover http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=2 git.response.bytes=185 git.server.agent=git/2.56.g1891de4-Linux git.server.object_format=sha1 git.server.caps=agent ls-refs fetch server-option object-format git.server.fetch=shallow wait-for-done filter git.protocol.version=2 git.pkt.frames=9 git.pkt.data=7 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=185 git.pkt.payload.max=35
ls-refs20058 KiB · hit2 ms
git.upload-pack ls-refs http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=ls-refs git.upstream.dur_ms=2 git.response.bytes=59849 git.response.cache=HIT git.response.duration_ms=2 git.protocol.version=2 git.pkt.frames=731 git.pkt.data=730 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=59849 git.pkt.payload.max=143 git.ls_refs.count=730 git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 1020032 KiB · hit2 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=32926 git.response.cache=HIT git.response.duration_ms=2 git.fetch.filter=tree:0 git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9 git.fetch.haves.count=0 git.fetch.deepen=10 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=22 git.pkt.data=20 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=32926 git.pkt.payload.max=32046 git.sideband.band1.bytes=32046 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=80 git.pack.bytes=32046 git.pack.ofs_delta=36 git.pack.ref_delta=0 git.pack.chain.max=2 git.pack.trailer=cb0bad5d7ffc514895d8b21c4dd470327f90bc91 git.pack.full=44Open pack map
fetchcombine:blob:none+tree:2 · deepen 12004.2 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=4273 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=combine:blob:none+tree:2 git.fetch.wants=0dd7574dce9e385c5c30540e6c15657adc6bdce9 git.fetch.haves.count=0 git.fetch.deepen=1 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=7 git.pkt.data=5 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=4273 git.pkt.payload.max=4173 git.sideband.band1.bytes=4173 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=11 git.pack.bytes=4173 git.fetch.wide.objects=11 git.fetch.wide.extra_bytes=3930 git.fetch.wide.blobs=0
fetchtree:02001.8 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=1857 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=tree:0 git.fetch.wants=dce174ff8c632a19d17eea99c8a9b7c37fb2b592 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1857 git.pkt.payload.max=1830 git.sideband.band1.bytes=1830 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=1830 git.pack.trailer=fb03183b7909876778f740d196d7516811003517Open pack map
fetchtree:0200263 B · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=3 git.response.bytes=263 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=tree:0 git.fetch.wants=4445ce4c6a6710742ed094287b245091ae79204f git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=263 git.pkt.payload.max=236 git.sideband.band1.bytes=236 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=236 git.pack.trailer=4126ef8ff4c560b52ccdd91c9d0a185a77d21c2dOpen pack map
fetchtree:0200139 B · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=217 git.response.bytes=139 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=tree:0 git.fetch.wants=9ef2aa8df7c241d48da8b281656b7e14f70eaba3 git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=139 git.pkt.payload.max=112 git.sideband.band1.bytes=112 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=1 git.pack.bytes=112 git.pack.trailer=ac014dd502574dc71152e3d20bfead22fb64a2ceOpen pack map
fetch2002.6 KiB217 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=2697 git.response.cache=MISS git.response.duration_ms=217 git.fetch.wants=e851bc46ff05752161510ab028a36707443fa31e git.fetch.haves.count=0 git.fetch.deepen=0 git.fetch.thin_pack=false git.fetch.ofs_delta=true git.protocol.version=2 git.pkt.frames=4 git.pkt.data=3 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=2697 git.pkt.payload.max=2670 git.sideband.band1.bytes=2670 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0
Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.
- Remote
- https://gitlab.com/gitlab-org/cli
- Ref
- refs/heads/main
- Commit
- 0dd7574dce9e385c5c30540e6c15657adc6bdce9
- cf-ray
- a5e32720e9d74628
- Request
- 64437c7b…
- Protocol
- v2 · sha1
- Agent
- git/2.56.g1891de4-Linux
- Filter
- advertised
- Fetch
- shallow wait-for-done filter
- Capabilities
- agent ls-refs fetch server-option object-format