binary-collections 2.0.10 → 2.0.11

package/binaries/submodule-token.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/test-cjs

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+
+# Run Jest while forwarding all arguments
+npx jest \
+  --runInBand \
+  --forceExit \
+  --testTimeout=120000 \
+  --testPathIgnorePatterns="\\.mjs$" \
+  --detectOpenHandles \
+  "$@"

package/binaries/test-cjs.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/test-cjs.cmd

@@ -0,0 +1,11 @@
+@echo off
+
+:: Run the specific Jest test file while ignoring .mjs files.
+:: Use caret (^) for line continuation in Windows CMD.
+npx jest ^
+  --runInBand ^
+  --forceExit ^
+  --testTimeout=120000 ^
+  --testPathIgnorePatterns="\\.mjs$" ^
+  --detectOpenHandles ^
+  %*

package/binaries/yarn-clean

@@ -0,0 +1,32 @@
+#!/usr/bin/env bash
+
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+CURRENT_FILE_PATH="$(realpath "$0")"
+echo "Current file path: $CURRENT_FILE_PATH"
+
+CANDIDATES=(
+  "$SCRIPT_DIR/../bin/yarn-clean.py"
+  "$SCRIPT_DIR/../binaries/yarn-clean.py"
+)
+
+TARGET=""
+
+for f in "${CANDIDATES[@]}"; do
+  if [[ -f "$f" ]]; then
+    TARGET="$f"
+    break
+  fi
+done
+
+if [[ -z "$TARGET" ]]; then
+  echo "Error: yarn-clean.py not found in expected locations:" >&2
+  printf ' - %s\n' "${CANDIDATES[@]}" >&2
+  exit 1
+fi
+
+echo "Using script: $TARGET"
+
+python "$TARGET" "$@"

package/binaries/yarn-clean.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/yarn-clean.cmd

@@ -0,0 +1,30 @@
+@echo off
+setlocal enabledelayedexpansion
+
+REM Get directory of this .bat file
+set "SCRIPT_DIR=%~dp0"
+
+echo Current file path: %~f0
+
+set "TARGET="
+
+set "CANDIDATE1=%SCRIPT_DIR%..\bin\yarn-clean.py"
+set "CANDIDATE2=%SCRIPT_DIR%..\binaries\yarn-clean.py"
+
+if exist "%CANDIDATE1%" (
+    set "TARGET=%CANDIDATE1%"
+) else if exist "%CANDIDATE2%" (
+    set "TARGET=%CANDIDATE2%"
+)
+
+if "%TARGET%"=="" (
+    echo Error: yarn-clean.py not found in expected locations:
+    echo  - %CANDIDATE1%
+    echo  - %CANDIDATE2%
+    exit /b 1
+)
+
+echo Using script: %TARGET%
+
+REM Run Python script with all arguments
+python "%TARGET%" %*