binary-collections 2.0.10 → 2.0.11

package/binaries/py

@@ -0,0 +1,111 @@
+#!/bin/bash
+set -euo pipefail
+
+# --------------------------------------------------
+# Detect OS and normalize platform
+# --------------------------------------------------
+UNAME="$(uname -s 2>/dev/null || echo unknown)"
+
+case "$UNAME" in
+  Linux*)   PLATFORM="linux" ;;
+  Darwin*)  PLATFORM="macos" ;;
+  CYGWIN*|MINGW*|MSYS*) PLATFORM="windows" ;;
+  *)
+    echo "Unsupported OS: $UNAME"
+    exit 1
+    ;;
+esac
+
+# --------------------------------------------------
+# Resolve paths
+# --------------------------------------------------
+SCRIPT_DIR="$(dirname "$(realpath "$0")")"
+CWD="$(dirname "$SCRIPT_DIR")"
+
+if [ ! -d "$CWD" ]; then
+  echo "Directory $CWD does not exist."
+  exit 1
+fi
+
+# Prefer venv over .venv
+if [ -d "$CWD/venv" ] || [ ! -d "$CWD/.venv" ]; then
+  VENV_PATH="$CWD/venv"
+else
+  VENV_PATH="$CWD/.venv"
+fi
+
+USER="www-data"
+
+# --------------------------------------------------
+# Helpers
+# --------------------------------------------------
+ensure_python3_shim_unix() {
+  if [ -f "$VENV_PATH/bin/python" ] && [ ! -f "$VENV_PATH/bin/python3" ]; then
+    echo "Creating python3 symlink..."
+    ln -s python "$VENV_PATH/bin/python3"
+  fi
+}
+
+ensure_python3_shim_windows() {
+  if [ -f "$VENV_PATH/Scripts/python.exe" ] && [ ! -f "$VENV_PATH/Scripts/python3.exe" ]; then
+    echo "Creating python3.exe shim..."
+    cp "$VENV_PATH/Scripts/python.exe" "$VENV_PATH/Scripts/python3.exe"
+  fi
+}
+
+resolve_python_bin_unix() {
+  if [ -x "$VENV_PATH/bin/python3" ]; then
+    echo "$VENV_PATH/bin/python3"
+  else
+    echo "$VENV_PATH/bin/python"
+  fi
+}
+
+resolve_python_bin_windows() {
+  if [ -x "$VENV_PATH/Scripts/python3.exe" ]; then
+    echo "$VENV_PATH/Scripts/python3.exe"
+  else
+    echo "$VENV_PATH/Scripts/python.exe"
+  fi
+}
+
+# --------------------------------------------------
+# Platform logic
+# --------------------------------------------------
+case "$PLATFORM" in
+  linux|macos)
+    if [ ! -d "$VENV_PATH" ] || [ ! -f "$VENV_PATH/bin/activate" ]; then
+      echo "Creating virtual environment..."
+      python3 -m venv "$VENV_PATH"
+      echo "Virtual environment created."
+    fi
+
+    ensure_python3_shim_unix
+
+    PYTHON_BIN="$(resolve_python_bin_unix)"
+
+    # Optional permissions fix (Linux + nginx only)
+    if [ "$PLATFORM" = "linux" ] && command -v nginx >/dev/null; then
+      if command -v sudo >/dev/null; then
+        sudo -n chown -R "$USER:$USER" "$VENV_PATH" >/dev/null 2>&1 || true
+        sudo -n chmod 755 "$VENV_PATH/bin"/* >/dev/null 2>&1 || true
+      fi
+    fi
+
+    "$PYTHON_BIN" "$@"
+    ;;
+
+  windows)
+    if [ ! -d "$VENV_PATH" ] || [ ! -f "$VENV_PATH/Scripts/activate" ]; then
+      echo "Creating virtual environment..."
+      python3.exe -m venv "$VENV_PATH"
+      echo "Virtual environment created."
+    fi
+
+    ensure_python3_shim_windows
+
+    PYTHON_BIN="$(resolve_python_bin_windows)"
+    "$PYTHON_BIN" "$@"
+    ;;
+
+esac

package/binaries/py.cjs

@@ -0,0 +1,178 @@
+#!/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");
+
+/**
+ * __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);
+
+  if (fs.existsSync(script)) {
+    found = script;
+    break;
+  }
+}
+
+/**
+ * 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");
+
+/**
+ * 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 {
+  cmd = found;
+  args = process.argv.slice(2);
+}
+
+/**
+ * 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/binaries/py.cmd

@@ -0,0 +1,49 @@
+@echo off
+setlocal enabledelayedexpansion
+
+REM Get the directory of the batch file
+set "SCRIPT_DIR=%~dp0"
+set "SCRIPT_DIR=%SCRIPT_DIR:~0,-1%"
+
+REM Move up one level to get <project> root
+for %%i in ("%SCRIPT_DIR%") do set "CWD=%%~dpi"
+set "CWD=%CWD:~0,-1%"
+
+REM Prefer venv over .venv for virtual environment path
+set "VENV_DIR=%CWD%\venv"
+set ".VENV_DIR=%CWD%\.venv"
+set "VENV_PATH=%VENV_DIR%"
+if not exist "%VENV_PATH%" (
+    if exist "%CWD%\.venv" (
+        set "VENV_PATH=%CWD%\.venv"
+    )
+)
+set "VENV_SCRIPTS=%VENV_PATH%\Scripts"
+
+REM Check if venv exists
+if not exist "%VENV_PATH%" (
+    echo Creating virtual environment...
+    call python -m venv "%VENV_PATH%"
+    if errorlevel 1 (
+        echo Failed to create virtual environment.
+        exit /b 1
+    )
+    echo Virtual environment created.
+)
+
+REM Ensure python3.exe shim exists
+if exist "%VENV_SCRIPTS%\python.exe" (
+    if not exist "%VENV_SCRIPTS%\python3.exe" (
+        echo Creating python3.exe shim...
+        copy "%VENV_SCRIPTS%\python.exe" "%VENV_SCRIPTS%\python3.exe" >nul
+        echo python3.exe shim created.
+    )
+)
+
+REM Activate the virtual environment
+call "%VENV_SCRIPTS%\activate.bat"
+
+REM Run python with all forwarded arguments
+call python %*
+
+endlocal

package/binaries/rmfind.cjs

@@ -1,43 +1,178 @@
 #!/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");
 
+/**
+ * __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));
 
-// Define possible script extensions by platform
+/**
+ * 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);
+
   if (fs.existsSync(script)) {
     found = script;
     break;
   }
 }
 
+/**
+ * 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 isSh = found.endsWith(".sh") || (found === found && process.platform !== "win32");
 
+/**
+ * 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 {
   cmd = found;
   args = process.argv.slice(2);
 }
 
-const result = spawnSync(cmd, args, { stdio: "inherit" });
+/**
+ * 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/binaries/rmx.cjs

@@ -1,43 +1,178 @@
 #!/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");
 
+/**
+ * __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));
 
-// Define possible script extensions by platform
+/**
+ * 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);
+
   if (fs.existsSync(script)) {
     found = script;
     break;
   }
 }
 
+/**
+ * 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 isSh = found.endsWith(".sh") || (found === found && process.platform !== "win32");
 
+/**
+ * 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 {
   cmd = found;
   args = process.argv.slice(2);
 }
 
-const result = spawnSync(cmd, args, { stdio: "inherit" });
+/**
+ * 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);