Function runCheckout

packages/computer/src/git/cli.ts:1232–1281

(
  client: GitClient,
  args: string[],
  input: GitCliInput,
)

// ---------------------------------------------------------------

async function runCheckout(
  client: GitClient,
  args: string[],
  input: GitCliInput,
): Promise<GitCliResult> {
  // `git checkout [-b <new>] <ref> [-- <paths>...]`. `-b` creates
  // a branch (optionally at a start point) and switches to it.
  const parsed = parseFlags(args, {
    force: { kind: "bool", alias: ["f"] },
    b: { kind: "bool" },
  });
  if ("error" in parsed) {
    return { stdout: "", stderr: `git checkout: ${parsed.error}\n`, exitCode: 129 };
  }
  const sep = args.indexOf("--");
  const refArgs =
    sep === -1 ? parsed.positional : args.slice(0, sep).filter((a) => !a.startsWith("-"));
  const pathArgs = sep === -1 ? [] : args.slice(sep + 1);
  const dir = resolveDir(undefined, input.cwd);

  if (parsed.flags.b === true) {
    // Create-and-switch. `refArgs` is `<new-branch> [<start>]`.
    if (refArgs.length === 0) {
      return { stdout: "", stderr: "git checkout: -b requires a branch name\n", exitCode: 129 };
    }
    return createAndSwitch(client, dir, refArgs[0], refArgs[1], "checkout");
  }

  if (refArgs.length === 0) {
    return { stdout: "", stderr: "git checkout: missing <ref>\n", exitCode: 129 };
  }
  if (refArgs.length > 1) {
    return {
      stdout: "",
      stderr: `git checkout: unexpected argument '${refArgs[1]}'\n`,
      exitCode: 129,
    };
  }
  try {
    await client.checkout({
      dir,
      ref: refArgs[0],
      paths: pathArgs.length > 0 ? pathArgs : undefined,
      force: parsed.flags.force === true,
    });
    return { stdout: "", stderr: "", exitCode: 0 };
  } catch (cause) {
    return mapGitError("checkout", cause);
  }
}

// ---------------------------------------------------------------
// switch