kubepile 0.0.1 → 0.0.3

package/README.md

@@ -46,6 +46,13 @@ This reads `~/.config/kubepile/*.yaml`, then writes `~/.kube/config`. If
 `~/.kube/config` already exists, `kubepile compile` prompts before copying it to
 `~/.kube/config.bak`.
 
+Kubepile skips that backup prompt for safe rebuilds. A rebuild is safe when the
+existing generated kubeconfig can be reproduced from a subset of the current
+`*.yaml` files. In practice, this means no-op rebuilds and adding a new
+provider file do not ask for a backup. If the existing generated kubeconfig was
+manually edited, was not generated by kubepile, or can no longer be reproduced
+from the current inputs, kubepile asks before replacing it.
+
 Explicit command and options:
 
 ```sh

package/dist/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kubepile",
-    "version": "0.0.1",
+    "version": "0.0.3",
     "description": "Compile and split kubeconfig files from ~/.config/kubepile.",
     "type": "module",
     "main": "./dist/src/kubepile.js",
@@ -22,7 +22,7 @@
     ],
     "scripts": {
         "clean": "rm -rf dist",
-        "build": "npm run clean && tsc",
+        "build": "npm run clean && tsc && chmod +x dist/src/cli.js",
         "typecheck": "tsc --noEmit",
         "test": "vitest run --dir test",
         "prepublishOnly": "npm run typecheck && npm run build && npm test"

package/dist/src/cli.d.ts

@@ -1,2 +1,2 @@
 #!/usr/bin/env node
-export declare function runCli(argv: string[]): Promise<void>;
+export {};

package/dist/src/cli.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 import process from "node:process";
 import { createInterface } from "node:readline/promises";
-import { pathToFileURL } from "node:url";
 import { Command } from "@commander-js/extra-typings";
 import packageJson from "../package.json" with { type: "json" };
 import { compileToKubeConfig, defaultKubeConfigPath, defaultKubepileDir, splitKubeConfigFile, } from "./kubepile.js";
-export async function runCli(argv) {
-    const program = createProgram();
-    if (argv.length === 0) {
-        program.outputHelp();
-        return;
-    }
-    await program.parseAsync(argv, { from: "user" });
+const program = createProgram();
+if (process.argv.slice(2).length === 0) {
+    program.outputHelp();
+}
+else {
+    program.parseAsync(process.argv.slice(2), { from: "user" }).catch((error) => {
+        const message = error instanceof Error ? error.message : String(error);
+        process.stderr.write(`kubepile: ${message}\n`);
+        process.exitCode = 1;
+    });
 }
 async function askBackup(existingPath, backupPath) {
     const rl = createInterface({
@@ -73,11 +75,3 @@ Defaults:
     });
     return program;
 }
-const entryPoint = process.argv[1] ? pathToFileURL(process.argv[1]).href : undefined;
-if (import.meta.url === entryPoint) {
-    runCli(process.argv.slice(2)).catch((error) => {
-        const message = error instanceof Error ? error.message : String(error);
-        process.stderr.write(`kubepile: ${message}\n`);
-        process.exitCode = 1;
-    });
-}

package/dist/src/kubepile.js

@@ -11,6 +11,9 @@ export function defaultKubeConfigPath() {
 export async function buildMergedConfig(options = {}) {
     const inputDir = options.inputDir ?? defaultKubepileDir();
     const inputFiles = await listKubeConfigFiles(inputDir);
+    return buildMergedConfigFromFiles(inputFiles);
+}
+async function buildMergedConfigFromFiles(inputFiles) {
     const configs = await Promise.all(inputFiles.map(async (filePath) => ({
         filePath,
         config: await readKubeConfigFile(filePath),
@@ -41,7 +44,7 @@ export async function compileToKubeConfig(options = {}) {
     const { config, inputFiles } = await buildMergedConfig({ ...options, inputDir });
     let backedUpTo;
     if (await pathExists(outputPath)) {
-        const shouldBackup = await options.shouldBackup?.(outputPath, backupPath);
+        const shouldBackup = await shouldBackUpExistingKubeConfig(outputPath, inputDir, inputFiles, options);
         if (shouldBackup) {
             await mkdir(path.dirname(backupPath), { recursive: true });
             await copyFile(outputPath, backupPath);
@@ -52,6 +55,52 @@ export async function compileToKubeConfig(options = {}) {
     await writeFile(outputPath, serializeGeneratedKubeConfig(config, inputDir), "utf8");
     return { config, inputFiles, outputPath, backedUpTo };
 }
+async function shouldBackUpExistingKubeConfig(outputPath, inputDir, currentInputFiles, options) {
+    if (await canSafelyRegenerate(outputPath, inputDir, currentInputFiles)) {
+        return false;
+    }
+    return Boolean(await options.shouldBackup?.(outputPath, `${outputPath}.bak`));
+}
+async function canSafelyRegenerate(outputPath, inputDir, currentInputFiles) {
+    const existingSource = await readFile(outputPath, "utf8");
+    if (!existingSource.startsWith(generatedKubeConfigHeader(inputDir))) {
+        return false;
+    }
+    try {
+        const existingConfig = parseKubeConfig(existingSource, outputPath);
+        const previousInputFiles = await findInputFilesRepresentedInConfig(currentInputFiles, existingConfig);
+        if (previousInputFiles.length === 0) {
+            return false;
+        }
+        const { config } = await buildMergedConfigFromFiles(previousInputFiles);
+        return existingSource === serializeGeneratedKubeConfig(config, inputDir);
+    }
+    catch {
+        return false;
+    }
+}
+async function findInputFilesRepresentedInConfig(inputFiles, config) {
+    const representedInputFiles = [];
+    for (const inputFile of inputFiles) {
+        const inputConfig = await readKubeConfigFile(inputFile);
+        if (configContainsAllNamedEntries(config, inputConfig, inputFile)) {
+            representedInputFiles.push(inputFile);
+        }
+    }
+    return representedInputFiles;
+}
+function configContainsAllNamedEntries(haystack, needle, sourceLabel) {
+    return hasAllNamedEntries(getNamedClusters(haystack, sourceLabel), getNamedClusters(needle, sourceLabel))
+        && hasAllNamedEntries(getNamedUsers(haystack, sourceLabel), getNamedUsers(needle, sourceLabel))
+        && hasAllNamedEntries(getNamedContexts(haystack, sourceLabel), getNamedContexts(needle, sourceLabel));
+}
+function hasAllNamedEntries(haystack, needles) {
+    const entriesByName = new Map(haystack.map((entry) => [entry.name, entry]));
+    return needles.every((needle) => deepEqual(entriesByName.get(needle.name), needle));
+}
+function deepEqual(left, right) {
+    return JSON.stringify(left) === JSON.stringify(right);
+}
 async function pathExists(filePath) {
     try {
         await stat(filePath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kubepile",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "description": "Compile and split kubeconfig files from ~/.config/kubepile.",
   "type": "module",
   "main": "./dist/src/kubepile.js",
@@ -22,7 +22,7 @@
   ],
   "scripts": {
     "clean": "rm -rf dist",
-    "build": "npm run clean && tsc",
+    "build": "npm run clean && tsc && chmod +x dist/src/cli.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run --dir test",
     "prepublishOnly": "npm run typecheck && npm run build && npm test"