argsbarg 4.0.4 → 4.1.1

package/src/install/binary.ts

@@ -1,94 +0,0 @@
-import {
-  copyFileSync,
-  existsSync,
-  mkdirSync,
-  readFileSync,
-  unlinkSync,
-  writeFileSync,
-} from "node:fs";
-import { dirname, join } from "node:path";
-import type { CliProgram } from "../types.ts";
-import type { InstallPaths } from "./paths.ts";
-import {
-  buildPathRcBlock,
-  buildZshFpathRcBlock,
-  detectShells,
-  hasRcBlock,
-  removeRcBlock,
-} from "./shell.ts";
-
-export interface BinaryInstallResult {
-  changedFiles: string[];
-  patchedBashRc: boolean;
-  patchedZshRc: boolean;
-}
-
-/** Copies a binary to the install path and patches rc files when shells are detected. */
-export function installBinary(
-  root: CliProgram,
-  paths: InstallPaths,
-  dry: boolean,
-  sourcePath: string = process.execPath,
-): BinaryInstallResult {
-  const changed: string[] = [];
-  const shells = detectShells();
-  let patchedBashRc = false;
-  let patchedZshRc = false;
-
-  if (!dry) {
-    mkdirSync(paths.bindir, { recursive: true });
-    copyFileSync(sourcePath, paths.binaryPath);
-  }
-  changed.push(paths.binaryPath);
-
-  if (shells.bash && existsSync(dirname(paths.bashRc))) {
-    const block = buildPathRcBlock(root.key, paths.bindir);
-    let content = existsSync(paths.bashRc) ? readFileSync(paths.bashRc, "utf8") : "";
-    if (!hasRcBlock(content, root.key, "path")) {
-      if (!content.endsWith("\n") && content.length > 0) content += "\n";
-      content += `${block}\n`;
-      if (!dry) writeFileSync(paths.bashRc, content, "utf8");
-      changed.push(paths.bashRc);
-      patchedBashRc = true;
-    }
-  }
-
-  if (shells.zsh) {
-    const completionsDir = join(dirname(paths.zshCompletion));
-    const block = buildZshFpathRcBlock(root.key, completionsDir);
-    let content = existsSync(paths.zshRc) ? readFileSync(paths.zshRc, "utf8") : "";
-    if (!hasRcBlock(content, root.key, "fpath")) {
-      if (!content.endsWith("\n") && content.length > 0) content += "\n";
-      content += `${block}\n`;
-      if (!dry) writeFileSync(paths.zshRc, content, "utf8");
-      changed.push(paths.zshRc);
-      patchedZshRc = true;
-    }
-  }
-
-  return { changedFiles: changed, patchedBashRc, patchedZshRc };
-}
-
-/** Removes binary and rc marker blocks. */
-export function uninstallBinary(root: CliProgram, paths: InstallPaths, dry: boolean): string[] {
-  const changed: string[] = [];
-  if (existsSync(paths.binaryPath)) {
-    if (!dry) unlinkSync(paths.binaryPath);
-    changed.push(paths.binaryPath);
-  }
-
-  for (const [rcPath, tag] of [
-    [paths.bashRc, "path"],
-    [paths.zshRc, "fpath"],
-  ] as const) {
-    if (!existsSync(rcPath)) continue;
-    const content = readFileSync(rcPath, "utf8");
-    if (hasRcBlock(content, root.key, tag)) {
-      const next = removeRcBlock(content, root.key, tag);
-      if (!dry) writeFileSync(rcPath, next, "utf8");
-      changed.push(rcPath);
-    }
-  }
-
-  return changed;
-}

package/src/install/completions.ts

@@ -1,56 +0,0 @@
-import { existsSync, mkdirSync, unlinkSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
-import {
-  completionBashScript,
-  completionFishScript,
-  completionZshScript,
-} from "../builtins/index.ts";
-import { cliPresentationRoot } from "../builtins/presentation.ts";
-import type { CliProgram } from "../types.ts";
-import type { InstallPaths } from "./paths.ts";
-import { detectShells } from "./shell.ts";
-
-/** Writes shell completion scripts for detected shells. */
-export function installCompletions(root: CliProgram, paths: InstallPaths, dry: boolean): string[] {
-  const changed: string[] = [];
-  const shells = detectShells();
-  const schema = cliPresentationRoot(root);
-
-  if (shells.bash) {
-    if (!dry) {
-      mkdirSync(dirname(paths.bashCompletion), { recursive: true });
-      writeFileSync(paths.bashCompletion, completionBashScript(schema), "utf8");
-    }
-    changed.push(paths.bashCompletion);
-  }
-
-  if (shells.zsh) {
-    if (!dry) {
-      mkdirSync(dirname(paths.zshCompletion), { recursive: true });
-      writeFileSync(paths.zshCompletion, completionZshScript(schema), "utf8");
-    }
-    changed.push(paths.zshCompletion);
-  }
-
-  if (shells.fish) {
-    if (!dry) {
-      mkdirSync(dirname(paths.fishCompletion), { recursive: true });
-      writeFileSync(paths.fishCompletion, completionFishScript(schema), "utf8");
-    }
-    changed.push(paths.fishCompletion);
-  }
-
-  return changed;
-}
-
-/** Removes shell completion files. */
-export function uninstallCompletions(paths: InstallPaths, dry: boolean): string[] {
-  const changed: string[] = [];
-  for (const p of [paths.bashCompletion, paths.zshCompletion, paths.fishCompletion]) {
-    if (existsSync(p)) {
-      if (!dry) unlinkSync(p);
-      changed.push(p);
-    }
-  }
-  return changed;
-}

package/src/install/update.test.ts

@@ -1,108 +0,0 @@
-import { afterEach, beforeEach, expect, test } from "bun:test";
-import { chmodSync, existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import { cliPresentationRoot } from "../builtins/presentation.ts";
-import { Cli } from "../index.ts";
-import type { CliProgram, CliUpdateArtifact } from "../types.ts";
-import { cliValidateProgram } from "../validate.ts";
-import { parseInstallOpts, runInstallMutation } from "./index.ts";
-
-let home: string;
-let prevHome: string | undefined;
-let prevExecPath: string;
-
-beforeEach(() => {
-  home = mkdtempSync(join(tmpdir(), "argsbarg-update-"));
-  prevHome = process.env.HOME;
-  process.env.HOME = home;
-  prevExecPath = process.execPath;
-});
-
-afterEach(() => {
-  if (prevHome === undefined) delete process.env.HOME;
-  else process.env.HOME = prevHome;
-  process.execPath = prevExecPath;
-  rmSync(home, { recursive: true, force: true });
-});
-
-function fixtureWithUpdate(hook: () => Promise<CliUpdateArtifact>): CliProgram {
-  return {
-    key: "testapp",
-    version: "1.0.0",
-    description: "Test",
-    install: { updateGetLatest: hook },
-    commands: [{ key: "run", description: "Run", handler: () => {} }],
-  };
-}
-
-test("user update command is allowed when updateGetLatest is set", () => {
-  const root: CliProgram = {
-    ...fixtureWithUpdate(async () => ({ path: process.execPath })),
-    commands: [{ key: "update", description: "Custom update", handler: () => {} }],
-  };
-  expect(() => cliValidateProgram(root)).not.toThrow();
-});
-
-test("presentation exposes install --update when hook is set", () => {
-  const root = fixtureWithUpdate(async () => ({ path: process.execPath }));
-  const presentation = cliPresentationRoot(root);
-  const install = presentation.commands.find((c) => c.key === "install");
-  expect(install?.options?.some((o) => o.name === "update")).toBe(true);
-  expect(presentation.commands.some((c) => c.key === "update")).toBe(false);
-});
-
-test("parseInstallOpts treats --update separately from --reinstall", () => {
-  expect(parseInstallOpts({ update: "1" }).update).toBe(true);
-  expect(parseInstallOpts({ update: "1" }).reinstall).toBe(false);
-});
-
-test("runInstallMutation honors --from for binary copy", async () => {
-  const root: CliProgram = {
-    key: "testapp",
-    version: "1.0.0",
-    description: "Test",
-    handler: () => {},
-  };
-  const source = join(home, "new-binary");
-  writeFileSync(source, "#!/bin/sh\necho hi\n", "utf8");
-  chmodSync(source, 0o755);
-
-  const { changed } = await runInstallMutation(root, {
-    reinstall: "1",
-    yes: "1",
-    quiet: "1",
-    from: source,
-  });
-
-  const dest = join(home, ".local", "bin", "testapp");
-  expect(changed).toContain(dest);
-  expect(readFileSync(dest, "utf8")).toContain("echo hi");
-});
-
-test("Cli.invoke install --update uses hook and reinstalls", async () => {
-  const source = join(home, "new-binary");
-  writeFileSync(source, "#!/bin/sh\necho hi\n", "utf8");
-  chmodSync(source, 0o755);
-
-  const root = fixtureWithUpdate(async () => ({
-    path: source,
-    version: "2.0.0",
-  }));
-
-  const result = await new Cli(root).invoke(["install", "--update"]);
-  expect(result.exitCode).toBe(0);
-  expect(result.stdout).toContain("Updated testapp 1.0.0 → 2.0.0");
-  expect(existsSync(join(home, ".local", "bin", "testapp"))).toBe(true);
-});
-
-test("Cli.invoke install --update reports already current", async () => {
-  const root = fixtureWithUpdate(async () => ({
-    path: process.execPath,
-    version: "1.0.0",
-  }));
-
-  const result = await new Cli(root).invoke(["install", "--update"]);
-  expect(result.exitCode).toBe(0);
-  expect(result.stdout).toContain("Already at v1.0.0");
-});

package/src/install/update.ts

@@ -1,57 +0,0 @@
-import { existsSync } from "node:fs";
-import type { CliProgram } from "../types.ts";
-import { runInstallMutation } from "./index.ts";
-import { installErr } from "./status.ts";
-
-/** Downloads the latest release and reinstalls installed artifacts (`myapp install --update`). */
-export async function cliUpdate(root: CliProgram): Promise<never> {
-  const hook = root.install?.updateGetLatest;
-  if (!hook) {
-    installErr(
-      "install --update is not configured. Set install.updateGetLatest on the program root.",
-    );
-    process.exit(1);
-  }
-
-  let artifact: Awaited<ReturnType<typeof hook>>;
-  try {
-    artifact = await hook({ version: root.version });
-  } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    installErr(message);
-    process.exit(1);
-  }
-
-  if (!artifact.path || !existsSync(artifact.path)) {
-    installErr(`updateGetLatest returned missing binary: ${JSON.stringify(artifact.path)}`);
-    process.exit(1);
-  }
-
-  if (artifact.version !== undefined && artifact.version === root.version) {
-    process.stdout.write(`Already at v${root.version}\n`);
-    await artifact.cleanup?.();
-    process.exit(0);
-  }
-
-  const currentVersion = root.version;
-  try {
-    await runInstallMutation(root, {
-      reinstall: "1",
-      yes: "1",
-      quiet: "1",
-      from: artifact.path,
-    });
-  } catch (err) {
-    await artifact.cleanup?.();
-    installErr(err instanceof Error ? err.message : String(err));
-    process.exit(1);
-  }
-
-  await artifact.cleanup?.();
-
-  if (artifact.version !== undefined && artifact.version !== currentVersion) {
-    process.stdout.write(`Updated ${root.key} ${currentVersion} → ${artifact.version}\n`);
-  }
-
-  process.exit(0);
-}