@tertium/hlpr 0.1.15 → 0.2.0

package/README.md

@@ -1,6 +1,6 @@
 # hlpr
 
-A CLI utility for running shell scripts with variable substitution.
+A CLI utility for running shell scripts with variable substitution and TypeScript-based commands.
 
 ## Installation
 
@@ -26,20 +26,87 @@ hlpr git fodd
 hlpr hello world
 hlpr ssh init dir
 
+# TypeScript commands (nested structure)
+hlpr file rename <directory> <style> [--dry|-n]
+
 # Continue execution even if commands fail
 hlpr -f ssh init dir
 ```
 
+## Available Commands
+
+### Shell Script Commands
+
+Shell scripts support variable substitution using `{{variable}}` syntax.
+
+- `git fodd` - Git command
+- `hello world` - Hello world example
+- `ssh init dir` - SSH initialization
+
+### TypeScript Commands
+
+TypeScript commands are implemented as `.ts` files and run directly with Bun.
+
+#### file rename
+
+Recursively rename files and folders according to a specific case style.
+
+**Supported styles:**
+
+- `title_underscore` - Title_Case_With_Underscores
+- `snake` - snake_case_lowercase
+- `kebab` - kebab-case-lowercase
+- `camel` - camelCaseLowerFirst
+- `pascal` - PascalCaseUpperFirst
+- `upper` - UPPER_CASE_WITH_UNDERSCORES
+- `lower` - lower_case_with_underscores
+
+**Examples:**
+
+```bash
+# Dry run (preview changes without applying)
+hlpr file rename ./my-project kebab --dry
+hlpr file rename ./src snake -n
+
+# Apply changes
+hlpr file rename ./my-project kebab
+hlpr file rename ./docs pascal
+```
+
+**Features:**
+
+- ✅ Recursive directory traversal
+- ✅ Extension preservation (e.g., `file-name.md` core name only)
+- ✅ Leading dot file support (e.g., `.gitignore`)
+- ✅ Case-only rename handling (Windows compatibility)
+- ✅ Conflict resolution (adds `_N` suffix)
+- ✅ Dry-run mode (`--dry` or `-n`)
+
+See `commands/file/rename/README.md` for detailed documentation.
+
 ## How It Works
 
+### Shell Scripts
+
 1. The command `hlpr hello world` looks for a script at `commands/hello/world.sh`
 2. If the script contains variables like `{{name}}`, you'll be prompted to enter values
 3. Each line of the script is executed with the variables replaced
 
+### TypeScript Commands
+
+1. The command `hlpr file rename` looks for a script at `commands/file/rename/rename.ts`
+2. Arguments are passed directly to the TypeScript module
+3. The module is executed with Bun runtime
+
 ## Directory Structure
 
 ```
 commands/
+├── file/
+│   └── rename/
+│       ├── rename.ts
+│       ├── rename.test.ts
+│       └── README.md
 ├── git/
 │   └── fodd.sh
 ├── hello/
@@ -53,22 +120,50 @@ commands/
 
 ## Adding Your Own Scripts
 
+### Shell Scripts
+
 1. Create a directory structure in `commands/<category>/`
 2. Add your `.sh` script files
 3. Use `{{variable}}` syntax for user inputs
 
 Example script (`commands/hello/world.sh`):
+
 ```bash
 echo "Hello World, {{name}}"
 ```
 
+### TypeScript Commands
+
+1. Create a nested directory structure in `commands/<category>/<command>/`
+2. Add your TypeScript file named `<command>.ts`
+3. Implement CLI argument parsing and logic
+4. Optionally add tests in `<command>.test.ts`
+
+Example structure:
+
+```text
+commands/
+└── file/
+    └── rename/
+        ├── rename.ts      # Main implementation
+        ├── rename.test.ts # Tests
+        └── README.md      # Documentation
+```
+
 ## Command Naming
 
 The utility maps command arguments to script files:
+
+**Shell Scripts:**
+
 - `hlpr git fodd` → runs `commands/git/fodd.sh`
 - `hlpr hello world` → runs `commands/hello/world.sh`
 - `hlpr ssh init dir` → runs `commands/ssh/initdir.sh`
 
+**TypeScript Commands:**
+
+- `hlpr file rename <args>` → runs `commands/file/rename/rename.ts`
+
 ## Error Handling
 
 By default, the utility stops execution if any command fails. Use the `-f` flag to continue execution despite failures:
@@ -99,4 +194,4 @@ npm link
 
 ## License
 
-MIT
+MIT

package/index.js

@@ -1,6 +1,3 @@
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 // src/index.ts
 import { readFile } from "node:fs/promises";
 import { exec } from "node:child_process";
@@ -8,10 +5,12 @@ import * as path from "node:path";
 import * as fs from "node:fs";
 import * as readline from "node:readline";
 import * as os from "node:os";
-var __dirname = "/home/runner/work/tertium-hlpr/tertium-hlpr/src";
+import { fileURLToPath } from "node:url";
 async function getVersion() {
   try {
-    const packagePath = path.join(path.dirname(path.dirname(__dirname)), "package.json");
+    const __filename2 = fileURLToPath(import.meta.url);
+    const __dirname2 = path.dirname(__filename2);
+    const packagePath = path.join(path.dirname(__dirname2), "package.json");
     const packageJson = JSON.parse(await readFile(packagePath, "utf-8"));
     return packageJson.version;
   } catch (error) {
@@ -87,13 +86,51 @@ async function main() {
   try {
     const category = commandArgs[0];
     const restArgs = commandArgs.slice(1);
-    const scriptName = restArgs.join("");
-    const scriptDir = path.dirname(path.dirname(__dirname));
-    const scriptPath = path.join(scriptDir, "commands", category, `${scriptName}.sh`);
-    if (!fs.existsSync(scriptPath)) {
-      console.error(`Script not found: ${scriptPath}`);
+    const __filename2 = fileURLToPath(import.meta.url);
+    const __dirname2 = path.dirname(__filename2);
+    const scriptDir = __dirname2;
+    let scriptPath;
+    let isTypeScriptCommand = false;
+    if (restArgs.length > 0) {
+      const subcategory = restArgs[0];
+      const nestedTsPath = path.join(scriptDir, "commands", category, subcategory, `${subcategory}.ts`);
+      if (fs.existsSync(nestedTsPath)) {
+        scriptPath = nestedTsPath;
+        isTypeScriptCommand = true;
+      }
+    }
+    if (!isTypeScriptCommand) {
+      const tsPath = path.join(scriptDir, "commands", category, `${category}.ts`);
+      if (fs.existsSync(tsPath)) {
+        scriptPath = tsPath;
+        isTypeScriptCommand = true;
+      }
+    }
+    if (!isTypeScriptCommand && restArgs.length > 0) {
+      const scriptName = restArgs.join("");
+      scriptPath = path.join(scriptDir, "commands", category, `${scriptName}.sh`);
+      if (!fs.existsSync(scriptPath)) {
+        console.error(`Script not found: ${scriptPath}`);
+        process.exit(1);
+      }
+    }
+    if (!scriptPath) {
+      console.error(`Command not found. Usage: hlpr ${category} <args>`);
       process.exit(1);
     }
+    if (isTypeScriptCommand) {
+      const tsArgs = restArgs.length > 0 && restArgs[0] && fs.existsSync(path.join(scriptDir, "commands", category, restArgs[0])) ? process.argv.slice(4) : process.argv.slice(3);
+      const finalCommand = `bun "${scriptPath}" ${tsArgs.join(" ")}`;
+      console.log(`Executing TypeScript command: ${finalCommand}`);
+      const success2 = await executeCommand(finalCommand, {});
+      if (!success2 && !forceFlag) {
+        console.error("Command failed, stopping execution.");
+        process.exit(1);
+      }
+      console.log("Command completed successfully!");
+      rl.close();
+      return;
+    }
     const scriptContent = await readFile(scriptPath, "utf-8");
     const variableRegex = /{{([^}]+)}}/g;
     const variables = {};
@@ -128,7 +165,7 @@ async function main() {
     rl.close();
   }
 }
-if (__require.main == __require.module) {
+if (import.meta.url.startsWith("file:") && process.argv[1] && import.meta.url.endsWith(process.argv[1].replace(/\\/g, "/"))) {
   main();
 }
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tertium/hlpr",
-  "version": "0.1.15",
+  "version": "0.2.0",
   "description": "Windows and *Nix utility for typical programming activity",
   "author": "Vitalii Balabanov",
   "email": "tertiumnon@gmail.com",
@@ -9,13 +9,13 @@
   "scripts": {
     "build": "bun build ./src/index.ts --outfile ./index.js --target node",
     "prepublishOnly": "npm run build",
-    "release:minor": "node node_modules/@tertium/shared-js-configs-and-types/scripts/release.js minor",
-    "release:patch": "node node_modules/@tertium/shared-js-configs-and-types/scripts/release.js patch",
-    "release:major": "node node_modules/@tertium/shared-js-configs-and-types/scripts/release.js major",
+    "release:minor": "node node_modules/@tertium/js/scripts/release.js minor",
+    "release:patch": "node node_modules/@tertium/js/scripts/release.js patch",
+    "release:major": "node node_modules/@tertium/js/scripts/release.js major",
     "prepare": "husky"
   },
   "devDependencies": {
-    "@tertium/shared-js-configs-and-types": "^0.14.0",
+    "@tertium/js": "^0.16.0",
     "@types/node": "^22.13.10",
     "husky": "^9.1.7",
     "typescript": "^5.8.3"
@@ -23,6 +23,11 @@
   "bin": {
     "hlpr": "./bin/hlpr.js"
   },
+  "files": [
+    "bin",
+    "index.js",
+    "package.json"
+  ],
   "keywords": [
     "cli",
     "utility",

package/.github/workflows/publish.yml

@@ -1,35 +0,0 @@
-name: Publish Package
-
-on:
-  push:
-    branches:
-      - main
-
-jobs:
-  publish:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-
-      - name: Install Bun
-        run: curl -fsSL https://bun.sh/install | bash
-
-      - name: Add Bun to PATH
-        run: echo "$HOME/.bun/bin" >> $GITHUB_PATH
-
-      - name: Use Node.js
-        uses: actions/setup-node@v4
-        with:
-          node-version: "22"
-          registry-url: "https://registry.npmjs.org/"
-
-      - name: Install dependencies
-        run: bun install
-
-      - name: Install dependencies
-        run: bun run build
-
-      - name: Publish to npm (with Bun)
-        run: npm publish --access public
-        env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.husky/pre-commit

@@ -1,6 +0,0 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
-echo "Running build before commit..."
-bun run build
-git add bin/hlpr.js

package/.vscode/settings.json

@@ -1,3 +0,0 @@
-{
-  "cSpell.words": ["hlpr"]
-}

package/commands/git/fodd.sh

@@ -1 +0,0 @@
-git fetch origin develop:develop

package/commands/git/precommit.sh

@@ -1,3 +0,0 @@
-echo "Running build before commit..."
-bun run build
-git add bin/

package/commands/hello/world.sh

@@ -1 +0,0 @@
-echo "Hello World, {{name}}"

package/commands/nvm/install.sh

@@ -1 +0,0 @@
-curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

package/commands/nvm/lts.sh

@@ -1,2 +0,0 @@
-nvm install --lts
-nvm use --lts

package/commands/ssh/init-dir.sh

@@ -1,6 +0,0 @@
-mkdir ~/.ssh
-touch ~/.ssh/known_hosts
-touch ~/.ssh/config
-chmod 700 ~/.ssh
-chmod 644 ~/.ssh/known_hosts
-chmod 644 ~/.ssh/config

package/src/index.ts

@@ -1,179 +0,0 @@
-import { readFile } from "node:fs/promises";
-import { exec } from "node:child_process";
-import * as path from "node:path";
-import * as fs from "node:fs";
-import * as readline from "node:readline";
-import * as os from "node:os";
-
-// Get package version from package.json
-async function getVersion(): Promise<string> {
-  try {
-    const packagePath = path.join(path.dirname(path.dirname(__dirname)), 'package.json');
-    const packageJson = JSON.parse(await readFile(packagePath, 'utf-8'));
-    return packageJson.version;
-  } catch (error) {
-    console.error('Error reading package.json:', error);
-    return '0.0.0'; // Fallback version
-  }
-}
-
-// Detect shell type
-function detectShell(): string {
-  const isWindows = os.platform() === "win32";
-  if (isWindows) {
-    return "powershell";
-  }
-  return "bash"; // Default to bash for Unix-like systems
-}
-
-// Parse command line arguments
-const args = process.argv.slice(2);
-let forceFlag = false;
-let commandArgs: string[] = [];
-
-// Check for -f flag
-if (args[0] === "-f") {
-  forceFlag = true;
-  commandArgs = args.slice(1);
-} else {
-  commandArgs = args;
-}
-
-// Create readline interface for user input
-const rl = readline.createInterface({
-  input: process.stdin,
-  output: process.stdout
-});
-
-// Prompt for user input
-function prompt(question: string): Promise<string> {
-  return new Promise((resolve) => {
-    rl.question(question, (answer) => {
-      resolve(answer);
-    });
-  });
-}
-
-// Execute a command with variable substitution
-async function executeCommand(command: string, variables: Record<string, string>): Promise<boolean> {
-  // Replace variables in the command
-  let processedCommand = command;
-  for (const [key, value] of Object.entries(variables)) {
-    processedCommand = processedCommand.replace(new RegExp(`{{${key}}}`, 'g'), value);
-  }
-
-  return new Promise((resolve) => {
-    console.log(`Executing: ${processedCommand}`);
-    const childProcess = exec(processedCommand);
-    
-    if (childProcess.stdout) {
-      childProcess.stdout.on("data", (data: string) => {
-        console.log(data.toString().trim());
-      });
-    }
-    
-    if (childProcess.stderr) {
-      childProcess.stderr.on("data", (data: string) => {
-        console.error(data.toString().trim());
-      });
-    }
-    
-    childProcess.on("exit", (code: number | null) => {
-      if (code === 0) {
-        resolve(true);
-      } else {
-        console.error(`Command failed with exit code ${code}`);
-        resolve(false);
-      }
-    });
-  });
-}
-
-export async function main() {
-  // Check for version flag
-  if (commandArgs[0] === "--version" || commandArgs[0] === "-v") {
-    const version = await getVersion();
-    console.log(`hlpr version ${version}`);
-    process.exit(0);
-  }
-  
-  if (commandArgs.length === 0) {
-    console.error("Please provide a command. Example: hlpr ssh init-dir");
-    process.exit(1);
-  }
-
-  try {
-    // Get the category (first argument) and the rest of the command
-    const category = commandArgs[0];
-    const restArgs = commandArgs.slice(1);
-    
-    // Join the rest of the arguments without hyphens
-    const scriptName = restArgs.join("");
-    
-    // Get the directory where the hlpr script is installed
-    const scriptDir = path.dirname(path.dirname(__dirname));
-    const scriptPath = path.join(scriptDir, "commands", category, `${scriptName}.sh`);
-    
-    // Check if the script exists
-    if (!fs.existsSync(scriptPath)) {
-      console.error(`Script not found: ${scriptPath}`);
-      process.exit(1);
-    }
-
-    // Read the script content
-    const scriptContent = await readFile(scriptPath, "utf-8");
-    
-    // Extract variables from the script (anything in {{variable}})
-    const variableRegex = /{{([^}]+)}}/g;
-    const variables: Record<string, string> = {};
-    const uniqueVars = new Set<string>();
-    
-    let match;
-    while ((match = variableRegex.exec(scriptContent)) !== null) {
-      uniqueVars.add(match[1]);
-    }
-    
-    // Prompt for each variable
-    for (const varName of uniqueVars) {
-      const value = await prompt(`Enter ${varName}: `);
-      variables[varName] = value;
-    }
-    
-    // Create a temporary script with variables substituted
-    let processedScript = scriptContent;
-    for (const [key, value] of Object.entries(variables)) {
-      processedScript = processedScript.replace(new RegExp(`{{${key}}}`, 'g'), value);
-    }
-    
-    const tempScriptPath = path.join(path.dirname(scriptPath), `_temp_${path.basename(scriptPath)}`);
-    fs.writeFileSync(tempScriptPath, processedScript);
-    
-    // Execute the temporary script with appropriate shell
-    const shell = detectShell();
-    const command = shell === "powershell" 
-      ? `powershell -File "${tempScriptPath}"` 
-      : `bash "${tempScriptPath}"`;
-    const success = await executeCommand(command, {});
-    
-    // Clean up the temporary script
-    fs.unlinkSync(tempScriptPath);
-    
-    // If command failed and force flag is not set, exit
-    if (!success && !forceFlag) {
-      console.error("Command failed, stopping execution.");
-      process.exit(1);
-    }
-    
-    console.log("Command completed successfully!");
-  } catch (error) {
-    console.error("Error:", error);
-    process.exit(1);
-  } finally {
-    rl.close();
-  }
-}
-
-// If this file is run directly, execute main
-if (require.main === module) {
-  main();
-}

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2020",
-    "module": "CommonJS",
-    "moduleResolution": "node",
-    "esModuleInterop": true,
-    "outDir": "./bin",
-    "rootDir": "./",
-    "strict": true,
-    "declaration": false,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true
-  },
-  "include": ["src/**/*"],
-  "exclude": ["node_modules", "dist"]
-}