main
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);
Diagnostics4 git calls · 389 ms
CallStatusSizeTime0389 ms
discover200152 B2 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=152 git.server.agent=gitty/1.0 git.server.object_format=sha1 git.server.caps=agent ls-refs fetch object-format git.server.fetch=shallow filter sideband-all git.protocol.version=2 git.pkt.frames=8 git.pkt.data=6 git.pkt.flush=2 git.pkt.delim=0 git.pkt.bytes=152 git.pkt.payload.max=34
ls-refs200145 B · 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=145 git.response.cache=HIT git.response.duration_ms=2 git.protocol.version=2 git.pkt.frames=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=145 git.pkt.payload.max=76 git.ls_refs.count=2 git.ls_refs.head=refs/heads/main
fetchblob:none · deepen 1020038 KiB · hit3 ms
git.upload-pack fetch http.response.status_code=200 git.upstream.cf_ray=- git.upstream.phase=fetch git.upstream.dur_ms=384 git.response.bytes=38434 git.response.cache=HIT git.response.duration_ms=3 git.fetch.filter=blob:none git.fetch.filter.requested=tree:0 git.fetch.filter.fallback=blob:none git.fetch.filter.learned=false 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=6 git.pkt.data=4 git.pkt.flush=1 git.pkt.delim=1 git.pkt.bytes=38434 git.pkt.payload.max=38339 git.sideband.band1.bytes=38338 git.sideband.band2.bytes=0 git.sideband.band3.bytes=0 git.pack.objects=63 git.pack.bytes=38338 git.pack.ofs_delta=0 git.pack.ref_delta=8 git.pack.chain.max=8 git.pack.trailer=0bc36ab7adf82d3109177f11f1ea93f1ce071f77 git.pack.full=55Open pack map
fetch2001.7 KiB384 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=1761 git.response.cache=MISS git.response.duration_ms=384 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=3 git.pkt.data=2 git.pkt.flush=1 git.pkt.delim=0 git.pkt.bytes=1761 git.pkt.payload.max=1740 git.sideband.band1.bytes=1739 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://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/ply.git
- Ref
- refs/heads/main
- Commit
- 19912563f540228593df0c489082e5e2508e21e4
- cf-ray
- a5e263e7db3f224d
- Request
- 77f0f5cc…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format