binary-collections 2.0.11 → 2.0.13

package/binaries/ycw.cjs

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+
+/**
+ * Built-in Node.js modules:
+ *
+ * - child_process:
+ *   Used to launch external scripts/programs.
+ *
+ * - path:
+ *   Safely handles file paths across operating systems.
+ *
+ * - fs:
+ *   Used to check whether files exist.
+ */
+const { spawnSync } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+const which = require('which');
+const { isWindows } = require('../src/utils/isWindows.js');
+
+/**
+ * __dirname
+ *   Absolute directory path of this launcher script.
+ *
+ * __filename
+ *   Absolute path of this launcher file itself.
+ *
+ * base
+ *   Filename without extension.
+ *
+ * Example:
+ *   File = "/tools/mytool.js"
+ *
+ *   binDir = "/tools"
+ *   base   = "mytool"
+ */
+const binDir = __dirname;
+const base = path.basename(__filename, path.extname(__filename));
+
+/**
+ * Determine which script extensions to search for
+ * based on the current operating system.
+ *
+ * Windows:
+ *   .cmd
+ *   .bat
+ *   .ps1
+ *   .vbs
+ *
+ * Linux/macOS:
+ *   .sh
+ *   executable file without extension
+ */
+const candidates = process.platform === 'win32' ? ['.cmd', '.bat', '.ps1', '.vbs'] : ['.sh', ''];
+
+/**
+ * Search for the first matching script
+ * in the same directory as this launcher.
+ *
+ * Example:
+ *   If base = "mytool"
+ *
+ *   Windows checks:
+ *     mytool.cmd
+ *     mytool.bat
+ *     mytool.ps1
+ *     mytool.vbs
+ *
+ *   Linux/macOS checks:
+ *     mytool.sh
+ *     mytool
+ */
+let found = null;
+
+for (const ext of candidates) {
+  const script = path.join(binDir, base + ext);
+  const exists = fs.existsSync(script);
+  // console.log(`Checking for ${script}: ${exists ? 'found' : 'not found'}`);
+  if (exists) {
+    found = script;
+    break;
+  }
+}
+
+/**
+ * If no matching script was found,
+ * try check if `bash` is available and if so, check for a .sh script.
+ */
+if (!found) {
+  try {
+    spawnSync('bash', ['--version'], { stdio: 'ignore' });
+    const bashScript = [path.join(binDir, base), path.join(binDir, base + '.sh')].find((script) =>
+      fs.existsSync(script)
+    );
+    if (bashScript) {
+      found = bashScript;
+    }
+  } catch {
+    // bash is not available, do nothing
+  }
+}
+
+/**
+ * If no matching script was found,
+ * print an error and exit with failure code 1.
+ */
+if (!found) {
+  console.error(`No script found for ${base} in ${binDir}`);
+  process.exit(1);
+}
+
+/**
+ * Detect special script types
+ * that require a shell/interpreter.
+ */
+const isPs1 = found.endsWith('.ps1');
+const isCmd = found.endsWith('.cmd');
+const isUnixShell = found.endsWith('.sh') || path.extname(found) === '';
+
+/**
+ * cmd
+ *   The executable program to launch.
+ *
+ * args
+ *   Arguments passed to the executable.
+ */
+let cmd, args;
+
+/**
+ * PowerShell scripts:
+ *
+ * Run through powershell.exe because .ps1 files
+ * are not directly executable like binaries.
+ *
+ * Flags:
+ *   -NoProfile
+ *     Prevent loading user profile scripts.
+ *
+ *   -ExecutionPolicy Bypass
+ *     Allow script execution even if policy blocks it.
+ *
+ *   -File
+ *     Specifies the script to execute.
+ *
+ * process.argv.slice(2)
+ *   Forward all user-provided command-line arguments.
+ */
+if (isPs1) {
+  cmd = 'powershell.exe';
+
+  args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', found, ...process.argv.slice(2)];
+
+  /**
+   * CMD batch files:
+   *
+   * Run through cmd.exe using:
+   *   /c
+   * which means:
+   *   "execute command and terminate"
+   */
+} else if (isCmd) {
+  cmd = 'cmd.exe';
+
+  args = ['/c', found, ...process.argv.slice(2)];
+
+  /**
+   * Other scripts:
+   *
+   * Usually:
+   *   - shell scripts (.sh)
+   *   - executable binaries
+   *
+   * These can be executed directly.
+   */
+} else if (isUnixShell) {
+  // Capture shebang scripts (no extension) and .sh scripts
+  const shebang = fs.readFileSync(found, 'utf8').split('\n')[0].trim();
+  const interpreter = shebang.startsWith('#!')
+    ? shebang
+        .slice(2)
+        .trim()
+        .replace(/^\/usr\/bin\/env\s+/, '')
+        .replace(/^\/bin\/env\s+/, '')
+        .replace(/^\/usr\/bin\//, '')
+        .replace(/^\/bin\//, '')
+    : null;
+
+  if (interpreter) {
+    const resolvedOrNull = which.sync(interpreter, { nothrow: true });
+    if (!resolvedOrNull) {
+      if (['bash', 'sh'].includes(interpreter) && isWindows()) {
+        const locationsToCheck = [
+          'C:\\Program Files\\Git\\usr\\bin',
+          'C:\\Program Files\\Git\\bin',
+          'C:\\Program Files (x86)\\Git\\usr\\bin',
+          'C:\\msys64\\usr\\bin',
+          'C:\\msys64\\bin',
+          'C:\\cygwin64\\bin',
+          'C:\\cygwin\\bin',
+          'C:\\MinGW\\bin',
+          'C:\\MinGW\\msys\\1.0\\bin'
+        ];
+        for (const location of locationsToCheck) {
+          const potentialPath = path.join(location, 'bash.exe');
+          if (fs.existsSync(potentialPath)) {
+            cmd = potentialPath;
+            args = [found, ...process.argv.slice(2)];
+            break;
+          }
+        }
+      }
+    } else {
+      cmd = resolvedOrNull || interpreter;
+      args = [found, ...process.argv.slice(2)];
+    }
+  } else {
+    cmd = found;
+    args = process.argv.slice(2);
+  }
+} else {
+  cmd = found;
+  args = process.argv.slice(2);
+}
+
+console.log(
+  `Executing: ${path.isAbsolute(cmd) ? path.relative(process.cwd(), cmd) : cmd} ${args
+    .map((f) => {
+      if (path.isAbsolute(f)) return path.relative(process.cwd(), f);
+      return f;
+    })
+    .join(' ')}`
+);
+
+/**
+ * Execute the selected script synchronously.
+ *
+ * stdio: "inherit"
+ *   Shares the current terminal with the child process,
+ *   so stdout/stderr/input behave normally.
+ *
+ * spawnSync waits until the child process exits.
+ */
+const result = spawnSync(cmd, args, {
+  stdio: 'inherit'
+});
+
+/**
+ * Exit using the same exit code
+ * returned by the child process.
+ *
+ * If result.status is null/undefined,
+ * default to exit code 1.
+ */
+process.exit(result.status ?? 1);

package/docs-src/binary-collections.md

@@ -0,0 +1,34 @@
+## Binary Collections (Main Dispatcher)
+
+The main entry point that dynamically finds and executes other scripts by name.
+
+### Usage
+
+```bash
+npx --legacy-peer-deps -y binary-collections <script-name> [...args]
+```
+
+### Subcommands
+
+| Subcommand | Description |
+|------------|-------------|
+| `list` | List all available scripts |
+| `<script-name>` | Find and execute a script by name |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+npx --legacy-peer-deps -y binary-collections list
+npx --legacy-peer-deps -y binary-collections git-diff -s
+npx --legacy-peer-deps -y binary-collections del-node-modules --force
+npx --legacy-peer-deps -y binary-collections find-node-modules
+```
+
+### Development
+
+When developing locally, use `bc <commandName>` (`bin/bc` on Unix or `bin/bc.cmd` on Windows). Its usage is the same as `binary-collections <commandName>`.
+
+### Source
+
+See [`src/binary-collections.cjs`](../src/binary-collections.cjs) & [`bin/bc`](../bin/bc)

package/docs-src/changelog.md

@@ -0,0 +1,26 @@
+## Changelog Generator
+
+Generates a `CHANGELOG.md` file from git commit history, grouped by version bumps.
+
+### Usage
+
+```bash
+changelog
+```
+
+### Description
+
+- Analyzes git commit history looking for version bumps
+- Groups commits by version
+- Skips dependabot and irrelevant commits
+- Outputs the original git log to `tmp/original.md` for reference
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+
+### Source
+
+See [`src/changelog.cjs`](../src/changelog.cjs)

package/docs-src/clean-github-actions-caches.md

@@ -10,17 +10,106 @@ npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/
 
 # use yarn dlx
 yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches
+
+# keep the first 3 cache key segments as the grouping prefix
+clean-github-actions-caches --prefix-depth 3
 ```
 
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `clean-github-actions-cache`
+- `clear-github-actions-cache`
+- `clear-github-actions-caches`
+- `clear-gh-caches`
+
+
 ### Features
 - Authenticates using `ACCESS_TOKEN` or `GITHUB_TOKEN` from your `.env` file
-- Groups caches by prefix and deletes all but the latest for each group
+- Groups caches by the first N key segments split on `-` or `_` and deletes all but the latest for each group
 - Operates on the current repository (origin remote) and matches the working directory of your terminal
 - Safe: Only deletes caches older than the most recent per prefix
+- Accepts `--repo owner/repo` to target a specific repository and `--prefix-depth <n>` to control grouping
 
 ### Environment Setup
 1. Add `ACCESS_TOKEN` or `GITHUB_TOKEN` to your `.env` file
 2. Ensure you have access to the repository's cache management
 
 ### Source
-See [`src/clean-github-actions-caches.cjs`](../src/clean-github-actions-caches.cjs)
+See [`src/clean-github-actions-caches.cjs`](../src/clean-github-actions-caches.cjs) & [`src/clean-github-actions-caches-cli.cjs`](../src/clean-github-actions-caches-cli.cjs)
+
+### Github CI Examples
+
+```yaml
+name: Clean GitHub Actions Cache
+
+on:
+  # Trigger this workflow when the specified workflows complete (e.g., after build and test workflows)
+  workflow_run:
+    workflows:
+      - Node.js Package Build
+      - Node.js Package Test
+    types:
+      - completed
+
+  # Allow manual triggering of this workflow from the GitHub Actions UI
+  workflow_dispatch:
+
+  # Uncomment the following lines to enable scheduled cache cleaning (e.g., every hour)
+  # schedule:
+  #   - cron: '0 * * * *'
+
+  # Uncomment the following lines to enable cache cleaning on pushes to the master branch
+  # push:
+  #   branches:
+  #     - master
+
+  # Allow this workflow to be called by other workflows, passing the ACCESS_TOKEN secret
+  workflow_call:
+    secrets:
+      ACCESS_TOKEN:
+        required: true
+
+concurrency:
+  group: clean-cache
+  cancel-in-progress: true
+
+jobs:
+  clean-cache:
+    # if: contains(github.repository, 'php-proxy-hunter')
+    runs-on: windows-latest
+
+    env:
+      PIP_CACHE_DIR: "${{ github.workspace }}/project/tmp/pip"
+      NUITKA_CACHE_DIR: "${{ github.workspace }}/project/tmp/nuitka-cache"
+      NODE_OPTIONS: "--max_old_space_size=4096"
+      YARN_ENABLE_IMMUTABLE_INSTALLS: false
+      ACCESS_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+      YARN_CHECKSUM_BEHAVIOR: update
+
+    steps:
+      - name: 📥 Checkout Repository
+        uses: actions/checkout@v6
+        with:
+          token: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+
+      - name: 🐍 Setup Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.11"
+          architecture: "x64"
+
+      - name: 🟢 Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 20.x
+
+      - name: 🧹 Clean GitHub Actions Cache ${{ github.event.workflow_run.head_sha }}
+        env:
+          GH_TOKEN: ${{ secrets.ACCESS_TOKEN || secrets.GITHUB_TOKEN }}
+        run: |
+          npx --legacy-peer-deps -y binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz clean-github-actions-caches --repo ${{ github.repository }} --sha ${{ github.event.workflow_run.head_sha }}
+        shell: bash
+```

package/docs-src/copy-move-file.md

@@ -0,0 +1,59 @@
+## Copy & Move File
+
+Copies or moves files/directories via CLI.
+
+### Usage
+
+```bash
+copy <src> <dest>
+move <src> <dest>
+````
+
+### Behavior
+
+* If `src` is a **file** and `dest` is a **directory**, the file will be placed inside that directory using its original filename.
+* If `src` is a **file** and `dest` is a **file path**, it will be copied/moved directly to that path.
+* If `src` is a **directory**, the entire directory will be copied/moved into the destination.
+
+### Aliases
+
+The copy command is available under several aliases (all invoke the same CLI):
+
+* `copy` (default)
+* `node-copy`
+* `copy-file`
+
+The move command is available under several aliases (all invoke the same CLI):
+
+* `move` (default)
+* `node-move`
+* `move-file`
+
+### Options
+
+| Option       | Description       |
+| ------------ | ----------------- |
+| `-h, --help` | Show help message |
+
+### Examples
+
+```bash
+# file → file
+copy file.txt backup/file.txt
+move file.txt backup/file.txt
+
+# file → directory (auto-append filename)
+copy file.txt backup/
+move file.txt backup/
+
+# directory → directory
+copy ./src ./dist
+move ./src ./dist
+```
+
+### Source
+
+See [`src/file/copy-cli.mjs`](../src/file/copy-cli.mjs),
+[`src/file/copy.mjs`](../src/file/copy.mjs),
+[`src/file/move-cli.mjs`](../src/file/move-cli.mjs),
+[`src/file/move.mjs`](../src/file/move.mjs)

package/docs-src/del-gradle.md

@@ -0,0 +1,17 @@
+## Gradle Build Cleaner
+
+Deletes Gradle `build/` directories.
+
+### Usage
+
+```bash
+del-gradle
+```
+
+### Description
+
+Searches for `build.gradle` files and deletes the adjacent `build/` directories, ignoring `node_modules` and `vendor` directories.
+
+### Source
+
+See [`src/del-gradle.js`](../src/del-gradle.js)

package/docs-src/del-ps.md

@@ -0,0 +1,28 @@
+## Process Management
+
+Terminate processes quickly by name or type across platforms.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `del-ps <process-name>` | Kill processes by command name (cross-platform) |
+| `kill-process <name>` | Kill process by name (Unix `killall`) |
+| `nodekill` | Kill all Node.js processes |
+| `javakill` | Kill all Java processes (Windows `taskkill`) |
+
+### Usage
+
+```bash
+# Kill processes by name
+del-ps <process-name>
+
+# Kill specific types
+kill-process <name>    # Unix: uses killall
+nodekill               # Kill all node.exe processes
+javakill               # Kill all java.exe processes (Windows)
+```
+
+### Source
+
+See [`src/del-ps.js`](../src/del-ps.js) and shell wrappers in [`bin/`](../bin/)

package/docs-src/downloader.md

@@ -0,0 +1,62 @@
+# Downloader
+
+Downloads files from URLs over HTTP/HTTPS to the local filesystem. Uses `axios` with streaming to efficiently write downloaded content directly to disk, and supports up to 10 redirects.
+
+## Usage
+
+```bash
+downloader <url> [output-path]
+```
+
+### Aliases
+
+This command is available under several aliases (all invoke the same CLI):
+
+- `downloader` (default)
+- `download`
+- `download-file`
+- `file-downloader`
+- `fetch-file`
+
+### Arguments
+
+| Argument      | Description                             |
+| :------------ | :-------------------------------------- |
+| `url`         | File URL to download (required)         |
+| `output-path` | Optional destination path on disk       |
+
+### Options
+
+| Flag           | Description       |
+| :------------- | :---------------- |
+| `-h`, `--help` | Show help message |
+
+### Behavior
+
+- If no `output-path` is provided, the filename is derived from the URL's pathname (e.g., `https://example.com/file.zip` saves as `file.zip` in the current directory).
+- If the URL path ends with `/` or has no filename segment, the default name `downloaded-file` is used.
+- The output path is resolved to an absolute path, and any missing parent directories are created automatically.
+
+### Examples
+
+Download to the current directory (filename auto-derived from URL):
+
+```bash
+downloader https://example.com/file.zip
+```
+
+Download and save with a custom filename:
+
+```bash
+downloader https://example.com/file.zip downloads/custom.zip
+```
+
+Using an alias:
+
+```bash
+fetch-file https://example.com/data.json ./data/input.json
+```
+
+## Source
+
+See [`src/downloader-cli.cjs`](../src/downloader-cli.cjs).

package/docs-src/env-helpers.md

@@ -0,0 +1,29 @@
+## Environment Helpers
+
+Set `NODE_ENV` and run a command in the configured environment.
+
+### Commands
+
+| Command | Description |
+|---------|-------------|
+| `dev <command>` | Sets `NODE_ENV=development` and runs the command |
+| `prod <command>` | Sets `NODE_ENV=production` and runs the command |
+| `empty` | No-op utility placeholder |
+
+### Usage
+
+```bash
+dev <command> [args...]
+prod <command> [args...]
+```
+
+### Examples
+
+```bash
+dev node server.js
+prod npm start
+```
+
+### Source
+
+See [`bin/dev`](../bin/dev) & [`bin/prod`](../bin/prod)

package/docs-src/find-node-modules.md

@@ -0,0 +1,17 @@
+## Find Node Modules
+
+Locates all `node_modules` directories within a project.
+
+### Usage
+
+```bash
+find-node-modules
+```
+
+### Description
+
+Finds and prints all `node_modules` directories under the current working directory.
+
+### Source
+
+See [`src/find-node-modules.cjs`](../src/find-node-modules.cjs) & [`src/find-node-modules-cli.js`](../src/find-node-modules-cli.js)

package/docs-src/git-diff.md

@@ -0,0 +1,33 @@
+## Git Diff Utility
+
+Enhanced diff functionality for repository inspection. Saves diffs to temp files and optionally generates conventional commit prompts.
+
+### Usage
+
+```bash
+git-diff [options] [file]
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `-h, --help` | Show help message |
+| `-s, -S, --staged-only` | Show all staged diffs |
+| `-u, --unstaged <file>` | Show unstaged diff for a specific file |
+| `-u, --unstaged` | Show all unstaged diffs |
+| `--ai` | Generate commit message with ChatGPT |
+
+### Examples
+
+```bash
+git-diff FILE              # Show staged diff of a file
+git-diff --staged-only     # Show all staged diffs
+git-diff --unstaged FILE   # Show unstaged diff of a file
+git-diff --unstaged        # Show all unstaged diffs
+git-diff --ai              # Generate commit message with ChatGPT
+```
+
+### Source
+
+See [`src/git-diff.js`](../src/git-diff.js) & [`src/git-diff-cli.js`](../src/git-diff-cli.js)