Function catFileWith

packages/computer/src/git/plumbing.ts:118–162

(opts: CatFileWithDeps)

}

export async function catFileWith(opts: CatFileWithDeps): Promise<CatFileResult> {
  const dir = opts.dir ?? "/";
  try {
    // readBlob is the right tool when we already know the oid
    // resolves to a blob; for tree / commit oids it errors out.
    // We try readBlob first (fast path); fall back to readObject
    // when the caller doesn't know the type up front.
    if (opts.filepath !== undefined) {
      const { oid, blob } = await opts.git.readBlob({
        fs: opts.fs,
        dir,
        oid: opts.oid,
        filepath: opts.filepath,
        cache: opts.cache,
      });
      return { oid, bytes: blob };
    }
    try {
      const { oid, blob } = await opts.git.readBlob({
        fs: opts.fs,
        dir,
        oid: opts.oid,
        cache: opts.cache,
      });
      return { oid, bytes: blob };
    } catch {
      // Not a blob; fall through to readObject's content form.
    }
    const obj = await opts.git.readObject({
      fs: opts.fs,
      dir,
      oid: opts.oid,
      format: "content",
      cache: opts.cache,
    });
    const bytes =
      obj.object instanceof Uint8Array ? obj.object : new TextEncoder().encode(String(obj.object));
    return { oid: obj.oid, bytes };
  } catch (cause) {
    if (isNotARepositoryCause(cause)) throw new NotARepositoryError(dir, { cause });
    throw new GitError("ECATFILEFAIL", `git cat-file failed: ${errorMessage(cause)}`, {
      cause,
    });
  }
}

// ---------------------------------------------------------------
// updateRef