main
1// parseTree as it was before #207 (src/objects.ts at c91c9cf: the mode decoded and matched by a regex, take() for the
2// id, a concatenated key per directory, Object.assign entries on a per-tree prototype), its name checks from
3// test/oracle/dotnames-ref.ts: kept in test/ as the oracle test/parsetree.test.js holds src/objects.ts parseTree to,
4// entry by entry (mode, name, oid, offsets) and refusal by refusal (code and message).
5import { fail } from '../../src/errors.js';
6import type { ErrorOf } from '../../src/errors.js';
7import type { Err, Result } from '../../src/result.js';
8import { ok, err } from '../../src/result.js';
9import { toOid } from '../../src/sha1.js';
10import { td, concat, take, decodeBytes } from '../../src/bytes.js';
11import { DEFAULT_LIMITS, limitError, parseLimits } from '../../src/limits.js';
12import type { LimitsInput } from '../../src/limits.js';
13import {
14 OID_BYTES, TREE_MODE_SEP, TREE_NUL, MODE_TREE, MODE_BLOB, MODE_EXEC, MODE_LINK, MODE_COMMIT, MODE_S_IFREG, MODE_S_IFLNK,
15 MODE_OWNER_EXEC, TREE_MAX_NAME_BYTES, MODE_S_IFMT, MODE_S_IFDIR, MODE_BITS, MODE_LOW_DIGITS, TREE_SORT_SLASH, TREE_ENTRY_MIN,
16} from '../../src/format.js';
17import { isDotGitNameRef, isDotFileNameRef } from './dotnames-ref.ts';
19type Mode = typeof MODE_BLOB | typeof MODE_EXEC | typeof MODE_LINK | typeof MODE_TREE | typeof MODE_COMMIT;
20export type RefEntry = { readonly mode: Mode; readonly name: string; readonly oid: string; readonly oidOffset: number; readonly entryOffset: number };
21type RefError = ErrorOf<'pack_corrupt'> | ErrorOf<'limit_exceeded'> | ErrorOf<'bad_request'>;
23const cmpBytes = (a: Uint8Array, b: Uint8Array): number => {
24 const n = Math.min(a.length, b.length);
25 for (let i = 0; i < n; i++) if (a[i] !== b[i]) return (a[i] as number) - (b[i] as number);
26 return a.length - b.length;
27};
28const lowBits = (mode: string): number => Number.parseInt(mode.slice(-MODE_LOW_DIGITS), 8) & MODE_BITS;
29const isDirMode = (mode: string): boolean => (lowBits(mode) & MODE_S_IFMT) === MODE_S_IFDIR;
30function canonMode(mode: string): Mode {
31 const m = lowBits(mode), type = m & MODE_S_IFMT;
32 if (type === MODE_S_IFREG) return m & MODE_OWNER_EXEC ? MODE_EXEC : MODE_BLOB;
33 if (type === MODE_S_IFLNK) return MODE_LINK;
34 if (type === MODE_S_IFDIR) return MODE_TREE;
35 return MODE_COMMIT;
36}
37const SLASH = Uint8Array.of(TREE_SORT_SLASH);
38const badTree = (why: string): Err<ErrorOf<'pack_corrupt'>> => fail('pack_corrupt', `tree: ${why}`);
39const completeTreeFrames = (data: Uint8Array, maxEntries: number): number => {
40 const stop = maxEntries + 1;
41 let p = 0;
42 let n = 0;
43 while (p < data.length && n < stop) {
44 const sp = data.indexOf(TREE_MODE_SEP, p);
45 if (sp < p) return n;
46 const nul = data.indexOf(TREE_NUL, sp + 1);
47 if (nul < sp + 1 || data.length - (nul + 1) < OID_BYTES) return n;
48 n += 1;
49 p = nul + 1 + OID_BYTES;
50 }
51 return n;
52};
54export function parseTreeRef(data: Uint8Array, limits: LimitsInput = DEFAULT_LIMITS): Result<RefEntry[], RefError> {
55 const checked = parseLimits(limits);
56 if (!checked.ok) return checked;
57 const maxEntries = checked.value.maxTreeEntries;
58 const wide = data.length > maxEntries * TREE_ENTRY_MIN;
59 const over = wide && completeTreeFrames(data, maxEntries) > maxEntries;
60 const entries: RefEntry[] = [];
61 const seen = new Set<string>();
62 let p = 0;
63 let count = 0;
64 let prevKey: Uint8Array | null = null;
65 while (p < data.length) {
66 if (count >= maxEntries) return err(limitError('tree entries', count + 1, maxEntries));
67 const sp = data.indexOf(TREE_MODE_SEP, p);
68 if (sp < p) return badTree('malformed entry');
69 const nul = data.indexOf(TREE_NUL, sp + 1);
70 if (nul < sp + 1) return badTree('malformed entry');
71 const raw: string = td.decode(data.subarray(p, sp));
72 const nameBytes: Uint8Array = data.subarray(sp + 1, nul);
73 const name: string = decodeBytes(nameBytes);
74 const oid = take(data, nul + 1, OID_BYTES);
75 if (!oid.ok) return oid;
76 const oidBytes: Uint8Array = oid.value;
77 if (raw.length === 0) return badTree('empty mode');
78 if (!/^[0-7]+$/u.test(raw)) return badTree('malformed mode');
79 if (name.length === 0) return badTree('empty name');
80 if (raw[0] === '0') return badTree('zero-padded mode');
81 const mode = canonMode(raw);
82 if (name.includes('/')) return badTree('full pathname');
83 if (name === '.' || name === '..' || isDotGitNameRef(nameBytes)) return badTree('bad name');
84 if (nameBytes.length > TREE_MAX_NAME_BYTES) return badTree('large pathname');
85 if (oidBytes.every(b => b === 0)) return badTree('null sha1');
86 if (isDotFileNameRef(nameBytes, 'gitmodules')) {
87 if (mode === MODE_LINK) return badTree('.gitmodules is a symbolic link');
88 if (mode === MODE_TREE || mode === MODE_COMMIT) return badTree('.gitmodules is not a blob');
89 }
90 if ((mode === MODE_TREE || mode === MODE_COMMIT) && isDotFileNameRef(nameBytes, 'gitattributes')) return badTree('.gitattributes is not a blob');
91 if (seen.has(name)) return badTree(`duplicate entry ${JSON.stringify(name)}`);
92 seen.add(name);
93 const key: Uint8Array = isDirMode(raw) ? concat([nameBytes, SLASH]) : nameBytes;
94 if (prevKey !== null && cmpBytes(prevKey, key) >= 0) return badTree('not strictly sorted');
95 prevKey = key;
96 if (!over) entries.push({ mode, name, oid: toOid(oidBytes), oidOffset: nul + 1, entryOffset: p });
97 count += 1;
98 p = nul + 1 + OID_BYTES;
99 }
100 return ok(entries);
101}
Diagnostics4 git calls · 24 ms
CallStatusSizeTime024 ms
discover200152 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=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=18 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.9 KiB · hit18 ms
git.upload-pack fetch http.response.status_code=200 git.response.bytes=1989 git.response.cache=HIT git.response.duration_ms=18 git.fetch.wants=2c68594cca9faf7756f03e561cbf09a16b90729e 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=1989 git.pkt.payload.max=1968 git.sideband.band1.bytes=1967 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
- a5e33e82d809dafe
- Request
- 496d7401…
- Protocol
- v2 · sha1
- Agent
- gitty/1.0
- Filter
- advertised
- Fetch
- shallow filter sideband-all
- Capabilities
- agent ls-refs fetch object-format