GitHubivarvong

ply

main
ply6 git calls27 ms20 KiB4 cachedprotocol v2
52 lines2.6 KiBRaw
1// Branded refname types. A `Refname` is any fully qualified ref starting with `refs/`.
2// Branch and tag names are stricter subsets. Parsing uses the validate.ts rules, which grant the Refname brand.
3import { ok, mapErr } from './result.js';
4import type { Result } from './result.js';
5import { fail, plyError } from './errors.js';
6import type { ErrorOf } from './errors.js';
7import { validateRef, validatePushRef } from './validate.js';
9declare const refBrand: unique symbol;
10declare const branchBrand: unique symbol;
11declare const tagBrand: unique symbol;
13export type Refname = string & { readonly [refBrand]: typeof refBrand };
14export type BranchName = string & { readonly [branchBrand]: typeof branchBrand };
15export type TagName = string & { readonly [tagBrand]: typeof tagBrand };
17function isBranchName(value: string): value is BranchName { return value.startsWith('refs/heads/'); }
18function isTagName(value: string): value is TagName { return value.startsWith('refs/tags/'); }
20type Bad = ErrorOf<'bad_request'>;
21// Each parser re-labels a validator's refusal for the thing parsed (`what`), with the validator's error as its cause.
23// @decoder parseRefname prefix=refname
24export function parseRefname(value: unknown): Result<Refname, Bad> {
25 return mapErr(validateRef(value), e => plyError('bad_request', e.message, { what: 'ref', cause: e }));
28// A pushable branch name (refs/heads/* with at least two levels after refs/).
29// @decoder parseBranchName prefix=refname
30export function parseBranchName(value: unknown): Result<BranchName, Bad> {
31 const ref = mapErr(validatePushRef(String(value), false), e => plyError('bad_request', e.message, { what: 'branch', cause: e }));
32 if (!ref.ok) return ref;
33 if (!isBranchName(ref.value)) return fail('bad_request', 'must start with refs/heads/', { what: 'branch' });
34 return ok(ref.value);
37// A refname the source spells, checked once when the module loads. A bad literal is a programmer error.
38function constantRefname(value: string): Refname {
39 const r = parseRefname(value);
40 if (!r.ok) throw plyError('internal', `${value} is not a refname`);
41 return r.value;
43// The branch an edit targets when the caller names none.
44export const DEFAULT_REF: Refname = constantRefname('refs/heads/main');
46// @decoder parseTagName prefix=refname
47export function parseTagName(value: unknown): Result<TagName, Bad> {
48 const ref = mapErr(validateRef(value), e => plyError('bad_request', e.message, { what: 'tag', cause: e }));
49 if (!ref.ok) return ref;
50 if (!isTagName(ref.value)) return fail('bad_request', 'must start with refs/tags/', { what: 'tag' });
51 return ok(ref.value);
Diagnostics6 git calls · 27 ms
CallStatusSizeTime027 ms
discover200191 B2 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=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 KiB2 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=11990
git.response.cache=UPDATING
git.response.duration_ms=2
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 · 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=4347
git.response.cache=HIT
git.response.duration_ms=2
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: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:02002.4 KiB · hit2 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=2507
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=tree:0
git.fetch.wants=8f720d29ff85ce682ffdad9c393b04a3834c3203
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=2507
git.pkt.payload.max=2480
git.sideband.band1.bytes=2480
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=1
git.pack.bytes=2480
git.pack.trailer=723b6bf1d4d6021fe5eb940c622b9ff00ee4a381
Open pack map
fetch200991 B · hit18 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=991
git.response.cache=HIT
git.response.duration_ms=18
git.fetch.wants=41bafdfa158fe8cc48b568216e70a3831705cc48
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=991
git.pkt.payload.max=964
git.sideband.band1.bytes=964
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
a5e0fd935f73332c
Request
95a44f76…
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