Function checkoutWith

packages/computer/src/git/refs.ts:225–248

(opts: CheckoutWithDeps)

}

export async function checkoutWith(opts: CheckoutWithDeps): Promise<void> {
  const dir = opts.dir ?? "/";
  // git checkout <ref> -- <paths>: update the working tree but
  // leave HEAD where it was. isomorphic-git's `noUpdateHead`
  // achieves this; without it a path-restricted checkout would
  // detach HEAD onto the source commit.
  const pathScoped = opts.paths !== undefined && opts.paths.length > 0;
  try {
    await opts.git.checkout({
      fs: opts.fs,
      dir,
      ref: opts.ref,
      filepaths: pathScoped ? opts.paths : undefined,
      force: opts.force,
      noUpdateHead: pathScoped,
      cache: opts.cache,
    });
  } catch (cause) {
    if (isNotARepositoryCause(cause)) throw new NotARepositoryError(dir, { cause });
    throw new GitError("ECHECKOUTFAIL", `git checkout failed: ${errorMessage(cause)}`, {
      cause,
    });
  }
}

function errorMessage(cause: unknown): string {
  if (cause instanceof Error) return cause.message;