GitHubivarvong

ply

main
ply8 git calls172 ms25 KiB5 cachedprotocol v2
74 lines3.6 KiBRaw
1// Band-1 keepalives from real git (http.sideband-keepalive): git http-backend's receive-pack, with receive.keepAlive=1
2// and a pre-receive hook that sleeps 3 s without output, writes empty band-1 packets (`0005\x01`) while the hook runs,
3// then the report. ply's push reads past them to the report: landed, the ref moved, fsck --strict clean. The response
4// bytes are captured as the server wrote them, so the test also shows git sent keepalives at all (not only that ply
5// tolerates injected ones, test/push-report-bound.test.js).
6import { test, beforeAll as before, afterAll as after } from 'vitest';
7import assert from 'node:assert/strict';
8import { chmodSync, mkdirSync, writeFileSync } from 'node:fs';
9import { join } from 'node:path';
10import { git, gitBuf, tmpRoot, makeBareRepo, startGitServer, fsckProblems, initRepo } from './server.js';
11import { createTransport } from '../src/http.js';
12import { ZERO_OID } from '../src/push.js';
13import { pushPack } from '../src/receivecaps.js';
14import { unwrap } from './unwrap.js';
16const REF = 'refs/heads/main';
17const HOOK_S = 3;
18let root, cleanup, srv, source;
19before(async () => {
20 ({ root, cleanup } = tmpRoot());
21 srv = await startGitServer(root);
22 const work = join(root, 'source');
23 mkdirSync(work);
24 initRepo(work);
25 writeFileSync(join(work, 'a.txt'), 'keepalive\n');
26 git(work, ['add', '.']);
27 git(work, ['-c', 'user.name=a', '-c', 'user.email=a@x', 'commit', '-q', '-m', 'one']);
28 const oid = git(work, ['rev-parse', 'HEAD']).trim();
29 source = { oid, pack: new Uint8Array(gitBuf(work, ['pack-objects', '--revs', '--stdout', '-q'], `${oid}\n`)) };
30});
31after(async () => { await srv.close(); cleanup(); });
33// The bytes of every receive-pack answer, read whole here and handed to ply unchanged.
34const capture = () => {
35 const answers = [];
36 const fetchImpl = async (url, init) => {
37 const r = await fetch(url, init);
38 if (!String(url).endsWith('/git-receive-pack')) return r;
39 const bytes = new Uint8Array(await r.arrayBuffer());
40 answers.push(bytes);
41 return new Response(bytes, { status: r.status, headers: r.headers });
42 };
43 return { answers, fetchImpl };
44};
45// pkt-lines of a side-band-64k answer, framed from the protocol: four hex digits that count themselves, then the band.
46const bands = bytes => {
47 const out = [];
48 for (let o = 0; o + 4 <= bytes.length;) {
49 const n = parseInt(new TextDecoder().decode(bytes.subarray(o, o + 4)), 16);
50 if (!(n >= 4)) { o += 4; continue; }
51 out.push({ band: bytes[o + 4], length: n - 5 });
52 o += n;
53 }
54 return out;
55};
57test('real git keepalives while a pre-receive hook runs: band-1 empty packets, then the report; ply lands', async () => {
58 const bare = makeBareRepo(root, 'k');
59 git(bare, ['config', 'receive.keepAlive', '1']);
60 const hook = join(bare, 'hooks', 'pre-receive');
61 writeFileSync(hook, `#!/bin/sh\ncat >/dev/null\nsleep ${HOOK_S}\n`);
62 chmodSync(hook, 0o755);
63 const { answers, fetchImpl } = capture();
64 const t0 = performance.now();
65 const r = await pushPack(unwrap(createTransport(`${srv.url}/k.git`, { fetchImpl })), { ref: REF, oldOid: ZERO_OID, newOid: source.oid, pack: new ReadableStream({ start(c) { c.enqueue(source.pack); c.close(); } }), length: source.pack.length });
66 const ms = performance.now() - t0;
67 assert.equal(r.ok, true, JSON.stringify(r));
68 assert.ok(ms >= HOOK_S * 1000, `the hook ran (${Math.round(ms)} ms)`);
69 assert.equal(answers.length, 1);
70 const keepalives = bands(answers[0]).filter(p => p.band === 1 && p.length === 0).length;
71 assert.ok(keepalives >= 1, `git sent band-1 keepalives (${keepalives})`);
72 assert.equal(git(bare, ['rev-parse', REF]).trim(), source.oid);
73 assert.deepEqual(fsckProblems(bare), []);
74}, 30_000);
Diagnostics8 git calls · 172 ms
CallStatusSizeTime0172 ms
discover200191 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
git.response.bytes=191
git.server.agent=git/github-9922ec520325-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=191
git.pkt.payload.max=36
ls-refs20012 KiB · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=11990
git.response.cache=HIT
git.response.duration_ms=3
git.protocol.version=2
git.pkt.frames=152
git.pkt.data=151
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=11990
git.pkt.payload.max=122
git.ls_refs.count=151
git.ls_refs.head=refs/heads/main
fetchtree:0 · deepen 102004.2 KiB · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=73
git.response.bytes=4347
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=tree:0
git.fetch.wants=19912563f540228593df0c489082e5e2508e21e4
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=7
git.pkt.data=5
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=4347
git.pkt.payload.max=4247
git.sideband.band1.bytes=4247
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=10
git.pack.bytes=4247
git.pack.ofs_delta=0
git.pack.ref_delta=0
git.pack.chain.max=0
git.pack.trailer=a6caf8e129bea82c9bae4cbc7c130c9205add400
git.pack.full=10
Open pack map
fetchtree:0 · deepen 1200347 B · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=4
git.response.bytes=347
git.response.cache=HIT
git.response.duration_ms=4
git.fetch.filter=tree:0
git.fetch.wants=19912563f540228593df0c489082e5e2508e21e4
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=347
git.pkt.payload.max=247
git.sideband.band1.bytes=247
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=247
git.pack.trailer=4b72f39b5ea57c5ae3009f90b53e3a6a155093e7
Open pack map
fetchcombine:blob:none+tree:2 · deepen 1200—73 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.cache=BYPASS
git.fetch.filter=combine:blob:none+tree:2
git.fetch.wants=19912563f540228593df0c489082e5e2508e21e4
git.fetch.haves.count=0
git.fetch.deepen=1
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
error.type=remote_error
error=remote: filter 'combine' not supported
fetchtree:0200919 B · hit3 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=919
git.response.cache=HIT
git.response.duration_ms=3
git.fetch.filter=tree:0
git.fetch.wants=800d30ba8923860bfc460ca884b7f9ba22083588
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=919
git.pkt.payload.max=892
git.sideband.band1.bytes=892
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=892
git.pack.trailer=5323b9266eea5ded637285d1c5320699f12be76e
Open pack map
fetchtree:02005.6 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=91
git.response.bytes=5724
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=58fabb6768b3f737ee9cd8bac647bdc27405fb4d
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=5724
git.pkt.payload.max=5697
git.sideband.band1.bytes=5697
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=5697
git.pack.trailer=be7e0453974a5fe832f9065a33bb7e3434c10e9b
Open pack map
fetch2001.7 KiB91 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1759
git.response.cache=MISS
git.response.duration_ms=91
git.fetch.wants=847eb689272f83d0ca2098d214b5b8202e5409fc
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=1759
git.pkt.payload.max=1732
git.sideband.band1.bytes=1732
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://github.com/ivarvong/ply
Ref
refs/heads/main
Commit
19912563f540228593df0c489082e5e2508e21e4
cf-ray
a5e98eb19a57cf3e
Request
8f812555…
Protocol
v2 · sha1
Agent
git/github-9922ec520325-Linux
Filter
advertised
Fetch
shallow wait-for-done filter
Capabilities
agent ls-refs fetch server-option object-format