@cmdwuzntfnd/bitecli 0.1.20

package/dist/create-app.js

@@ -0,0 +1,217 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { execSync } from "node:child_process";
+import { createInterface } from "node:readline/promises";
+const red = (text) => `\x1b[31m${text}\x1b[0m`;
+const blue = (text) => `\x1b[34m${text}\x1b[0m`;
+const dim = (text) => `\x1b[2m${text}\x1b[0m`;
+async function askQuestions(questions) {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answers = {};
+    try {
+        for (const question of questions) {
+            let answer;
+            let valid = false;
+            while (!valid) {
+                const defaultHint = question.initial
+                    ? dim(` (${question.initial})`)
+                    : "";
+                const promptText = `${question.message}${defaultHint}: `;
+                const rawAnswer = await rl.question(promptText);
+                answer = rawAnswer.trim() || question.initial;
+                if (answer === undefined) {
+                    console.log(red("  > An answer is required."));
+                    continue;
+                }
+                if (question.validate) {
+                    const validationResult = question.validate(answer);
+                    if (validationResult === true) {
+                        valid = true;
+                    }
+                    else {
+                        console.log(red(`  > ${validationResult}`));
+                    }
+                }
+                else {
+                    valid = true;
+                }
+            }
+            answers[question.name] = answer;
+        }
+    }
+    finally {
+        rl.close();
+    }
+    return answers;
+}
+const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+function replaceInDirectory(dir, find, replace) {
+    const items = fs.readdirSync(dir, { withFileTypes: true });
+    for (const item of items) {
+        const itemPath = path.join(dir, item.name);
+        if (item.isDirectory()) {
+            replaceInDirectory(itemPath, find, replace);
+        }
+        else if (item.isFile()) {
+            try {
+                const content = fs.readFileSync(itemPath, "utf-8");
+                if (content.includes(find)) {
+                    const newContent = content.replaceAll(find, replace);
+                    fs.writeFileSync(itemPath, newContent, "utf-8");
+                }
+            }
+            catch (error) {
+                console.warn(dim(`Could not process binary or unreadable file: ${itemPath}`));
+            }
+        }
+    }
+}
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const templateDir = path.resolve(__dirname, "..", "template");
+async function main() {
+    console.log(blue("Welcome! Let's create your new CLI app."));
+    const initialProjectName = process.argv[2] || "my-new-cli";
+    const projectResponse = await askQuestions([
+        {
+            name: "projectName",
+            message: "Project name",
+            initial: initialProjectName.replace(/[^\w-]/g, ""),
+            validate: (name) => /^[a-z0-9-_]+$/.test(name)
+                ? true
+                : "Project name requires lowercase letters, numbers, hyphens.",
+        },
+        {
+            name: "description",
+            message: "Short description",
+            initial: "A new CLI app.",
+        },
+        { name: "author", message: "Author" },
+    ]);
+    if (!projectResponse.projectName) {
+        console.log("\nProject creation cancelled.");
+        return;
+    }
+    console.log(blue("\nGreat! Now let's configure your first command."));
+    const commandResponse = await askQuestions([
+        {
+            name: "commandName",
+            message: "Command name (e.g., greet, create)",
+            initial: "greet",
+            validate: (name) => /^[a-z]+$/.test(name)
+                ? true
+                : "Command name requires lowercase letters.",
+        },
+        {
+            name: "commandDesc",
+            message: "Short description for this command",
+            initial: "A simple example command.",
+        },
+        {
+            name: "optionName",
+            message: "Primary option (e.g. name, target)",
+            initial: "name",
+            validate: (name) => /^[a-z]+$/.test(name)
+                ? true
+                : "Option name requires lowercase letters.",
+        },
+        {
+            name: "optionDesc",
+            message: "Description for the option",
+            initial: "The value to use for the command.",
+        },
+    ]);
+    const { projectName, description, author } = projectResponse;
+    const { commandName, commandDesc, optionName, optionDesc } = commandResponse;
+    const targetDir = path.resolve(process.cwd(), projectName);
+    try {
+        fs.statSync(targetDir);
+        console.error(`\nError: Directory "${projectName}" already exists.`);
+        process.exit(1);
+    }
+    catch (err) {
+        const error = err;
+        if (error?.code !== "ENOENT") {
+            throw error;
+        }
+    }
+    const SRC = path.join(targetDir, "src");
+    const DATA = path.join(targetDir, "data");
+    const I18N = path.join(DATA, "i18n");
+    const ENUS = path.join(I18N, "en-US.json");
+    const COMMANDS = path.join(SRC, "commands");
+    const CO_PATH = path.join(COMMANDS, "cocommand.ts");
+    const NEW_COMMAND = path.join(COMMANDS, `${commandName}command.ts`);
+    const LIBS = path.join(SRC, "libs");
+    const META_PATH = path.join(LIBS, "meta.ts");
+    const PKG = path.join(targetDir, "package.json");
+    const NPMIGNORE = path.join(targetDir, ".npmignore");
+    const npmignoreContent = `*.ts\n*.map\ntsconfig.json`;
+    console.log(`\nCreating project in ${targetDir}...`);
+    fs.cpSync(templateDir, targetDir, { recursive: true });
+    console.log("Customizing project files...");
+    replaceInDirectory(targetDir, "bitecli", projectName);
+    fs.renameSync(path.join(SRC, "bitecli.ts"), path.join(SRC, `${projectName}.ts`));
+    const pkgJson = JSON.parse(fs.readFileSync(PKG, "utf-8"));
+    pkgJson.name = projectName;
+    pkgJson.description = description;
+    pkgJson.author = author;
+    if (pkgJson.bin.bitecli) {
+        pkgJson.bin[projectName] = pkgJson.bin.bitecli;
+        delete pkgJson.bin.bitecli;
+    }
+    fs.writeFileSync(PKG, JSON.stringify(pkgJson, null, 2) + "\n");
+    console.log(`Configuring '${commandName}' command...`);
+    fs.renameSync(path.join(COMMANDS, "hellocommand.ts"), path.join(COMMANDS, `${commandName}command.ts`));
+    let metaContent = fs.readFileSync(META_PATH, "utf-8");
+    metaContent = metaContent.replace('hello: "hellocommand"', `${commandName}: "${commandName}command"`);
+    fs.writeFileSync(META_PATH, metaContent);
+    let coContent = fs.readFileSync(CO_PATH, "utf-8");
+    coContent = coContent.replace("hello: { Greeting: GREETING }", `${commandName}: { Greeting: GREETING }`);
+    fs.writeFileSync(CO_PATH, coContent);
+    let newCommandContent = fs.readFileSync(NEW_COMMAND, "utf-8");
+    const capOptionName = capitalize(optionName);
+    const newClassName = `${capitalize(commandName)}Command`;
+    newCommandContent = newCommandContent
+        .replaceAll("HelloCommand", newClassName)
+        .replaceAll('name: { type: "string", short: "n" }', `${optionName}: { type: "string", short: "${optionName[0]}" }`)
+        .replaceAll("argValues.name", `argValues.${optionName}`)
+        .replaceAll("s.help.commands.hello", `s.help.commands.${commandName}`)
+        .replaceAll(".Name", `.${capOptionName}`);
+    fs.writeFileSync(NEW_COMMAND, newCommandContent);
+    const i18nJson = JSON.parse(fs.readFileSync(ENUS, "utf-8"));
+    i18nJson.help.generic.header = `${projectName}: ${description}`;
+    delete i18nJson.help.generic.commandDescriptions.hello;
+    i18nJson.help.generic.commandDescriptions[commandName] = commandDesc;
+    const helloCommandHelp = i18nJson.help.commands.hello;
+    if (helloCommandHelp) {
+        i18nJson.help.commands[commandName] = helloCommandHelp;
+        delete i18nJson.help.commands.hello;
+        const newCommandHelp = i18nJson.help.commands[commandName];
+        newCommandHelp.usage = newCommandHelp.usage.replace("hello", commandName);
+        newCommandHelp.description = commandDesc;
+        newCommandHelp.flags[optionName] = optionDesc;
+        delete newCommandHelp.flags.name;
+    }
+    fs.writeFileSync(ENUS, JSON.stringify(i18nJson, null, 2) + "\n");
+    console.log("Creating .npmignore file...");
+    fs.writeFileSync(NPMIGNORE, npmignoreContent);
+    console.log("Installing dependencies...");
+    execSync("npm install", { cwd: targetDir, stdio: "inherit" });
+    console.log(`\n✅ Success! Your new CLI app "${projectName}" is ready.`);
+    console.log("\nNext steps:");
+    console.log(`  cd ${projectName}`);
+    console.log("  npm run build");
+    console.log(`  npm link          (to make the command available globally for testing)`);
+    console.log(`  ${projectName} ${commandName} --help`);
+}
+await main().catch((err) => {
+    const error = err;
+    if (error?.code === "ABORT_ERR") {
+        console.log("\n\nProject creation cancelled.");
+        process.exit(0);
+    }
+    console.error(red("\nAn unexpected error occurred:"), err);
+    process.exit(1);
+});

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@cmdwuzntfnd/bitecli",
+  "author": "cmdntfnd",
+  "version": "0.1.20",
+  "description": "Creates a new CLI app from the bitecli template.",
+  "files": [
+    "dist/",
+    "template/"
+  ],
+  "bin": {
+    "bitecli": "dist/create-app.js"
+  },
+  "scripts": {
+    "clean": "del-cli \"dist\"",
+    "prebuild": "npm run clean",
+    "prepack": "npm i && npm run build && del-cli \"dist/**/*.map\"",
+    "build": "tsc",
+    "start": "node ./dist/create-app.js",
+    "format": "npx prettier . --write"
+  },
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmdntfnd/bitecli.git"
+  },
+  "keywords": [
+    "cli",
+    "framework",
+    "scaffolding",
+    "bitecli"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "24.3.1",
+    "cross-env": "10.0.0",
+    "del-cli": "6.0.0",
+    "prettier": "3.6.2",
+    "typescript": "5.9.2"
+  }
+}

package/readme.md

@@ -0,0 +1,8 @@
+Initial extraction of a scaffolding from batchbite for a very basic but dependency free quick copy and paste for making throw away scripted cli tools.  
+Not a framework, nor a real library. Copy, paste and quickly get something okay looking for personal use.  
+Requires Node.JS (v24) and TypeScript. Only really needs v24 because I like RegExp.escape(), deal with it.  
+Run:
+
+```bash
+npx @cmdwuzntfnd/bitecli@latest
+```

package/template/.editorconfig

@@ -0,0 +1,7 @@
+[*]
+charset = utf-8
+insert_final_newline = true
+end_of_line = lf
+indent_style = space
+indent_size = 2
+max_line_length = 80

package/template/.gitattributes

@@ -0,0 +1,2 @@
+* text=auto eol=lf
+data/** -diff

package/template/.github/workflows/ci.yml

@@ -0,0 +1,28 @@
+name: Node.js CI
+
+on:
+  push:
+    branches: ["main"]
+
+jobs:
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Use Node.js 24.x
+        uses: actions/setup-node@v4
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Run tests
+        run: npm test

package/template/.prettierrc

@@ -0,0 +1 @@
+{}

package/template/.rgignore

@@ -0,0 +1 @@
+data/

package/template/data/i18n/en-US.json

@@ -0,0 +1,59 @@
+{
+  "errors": {
+    "unknownErrorOccurred": "An unknown error occurred.",
+    "commandNotImplemented": "Error: This command is not implemented.",
+    "cfgCouldNotBeLoaded": "Error: The configuration file could not be loaded from '{{ .UserConfigPath }}'.",
+    "sourceRequired": "Error: A source file or directory is required.",
+    "editorNotFound": "Warning: $EDITOR environment variable not set. Cannot open configuration file automatically.",
+    "editorLaunchFailed": "Error: Failed to launch editor: {{ .ErrorMessage }}",
+    "failedToWriteLocale": "Error: Failed to write locale settings: {{ .ErrorMessage }}",
+    "coError": "Warning: Could not generate completions for command '{{ .Command }}'."
+  },
+  "messages": {
+    "userConfigNotFound": "User configuration not found at '{{ .UserConfigPath }}'.",
+    "cfgCreatedSuccessfully": "A new configuration file has been created successfully.",
+    "deletionConfirm": "Are you sure you want to delete these files? This action cannot be undone. (y/N): ",
+    "yN": "y",
+    "deletionAborted": "Deletion aborted.",
+    "cfgDeletedSuccessfully": "Configuration file(s) deleted successfully.",
+    "localeSuccessfullyChanged": "Application language changed to {{ .Locale }}."
+  },
+  "help": {
+    "generic": {
+      "header": "bitecli: A tool for fun things.",
+      "usage": "Usage: bitecli <command> [options]",
+      "commandHeader": "Commands:",
+      "commandDescriptions": {
+        "hello": "A simple example command that prints a greeting.",
+        "cfg": "Manage application configuration.",
+        "co": "Generate bash completion script."
+      },
+      "footer": "For more information on any command, use `bitecli <command> --help`.",
+      "globalOptionsHeader": "Global Options:",
+      "flags": {
+        "version": "Show application version."
+      }
+    },
+    "commands": {
+      "cfg": {
+        "usage": "Usage: bitecli cfg [options]",
+        "description": "Manages the application configuration.",
+        "flags": {
+          "help": "Show this help message.",
+          "edit": "Open the user configuration file in the default editor.",
+          "remove": "Delete the user configuration files (prompts for confirmation).",
+          "lang": "Set the application language. Supported locales:"
+        },
+        "footer": "{{ .LocaleList }}"
+      },
+      "hello": {
+        "usage": "Usage: bitecli hello [options]",
+        "description": "Prints a customizable greeting. Templated string substitution: {{ .Greeting }}",
+        "flags": {
+          "help": "Show this help message.",
+          "name": "The name to greet."
+        }
+      }
+    }
+  }
+}