binary-collections 2.0.8 → 2.0.10

package/tmp/typedoc/readme.md

@@ -0,0 +1,320 @@
+# Binary Collections
+A comprehensive toolkit of Node.js CLI utilities for streamlining development workflows. Includes tools for git operations, dependency management, build processes, automation, and more.
+
+## Features
+
+- 🧹 **Cleanup Tools**: Remove node_modules, yarn caches, gradle builds
+- 🔄 **Git Utilities**: Submodule management, repository purging, diff tools
+- 📦 **Build Tools**: NPM script runners, package management utilities
+- ⚡ **Development Helpers**: Process management, environment setup tools
+
+## Installation
+
+### Clone Repository
+```bash
+git clone -b master https://github.com/dimaslanjaka/bin bin
+```
+
+### NPM Installation
+```bash
+# Install locally
+npm install binary-collections
+
+# Install globally
+npm install binary-collections -g
+
+# Install from release archive
+npm install binary-collections@https://github.com/dimaslanjaka/bin/raw/master/releases/bin.tgz
+```
+
+### Direct run
+
+```bash
+# Yarn berry
+yarn dlx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz <command-name>
+
+# NPX
+npx binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz <command-name>
+```
+
+## VS Code Setup
+
+Create `https://github.com/dimaslanjaka/bin/blob/master/.vscode/settings.json` to add binary tools to your PATH:
+
+```jsonc
+{
+  "terminal.integrated.env.linux": {
+    "PATH": "${env:PATH}:${workspaceFolder}/node_modules/.bin:${workspaceFolder}/bin"
+  },
+  "terminal.integrated.env.windows": {
+    "PATH": "${env:PATH};${workspaceFolder}\\node_modules\\.bin;${workspaceFolder}\\bin"
+  },
+  "terminal.integrated.profiles.windows": {
+    "PowerShell": {
+      "source": "PowerShell",
+      "icon": "terminal-powershell"
+    },
+    "Command Prompt": {
+      "path": [
+        "${env:windir}\\Sysnative\\cmd.exe",
+        "${env:windir}\\System32\\cmd.exe"
+      ],
+      "args": [],
+      "icon": "terminal-cmd"
+    },
+    "Git Bash": {
+      "source": "Git Bash"
+    },
+    "Cygwin": {
+      "path": "C:\\cygwin64\\bin\\bash.exe",
+      "args": ["--login", "-i"],
+      "env": {
+        "CHERE_INVOKING": "1"
+      }
+    }
+  },
+  "terminal.integrated.defaultProfile.windows": "Command Prompt"
+}
+```
+
+## Available Tools
+
+### Quick Reference
+
+| Category         | Commands                                                                 | Description                                      |
+|------------------|-------------------------------------------------------------------------|--------------------------------------------------|
+| **Git**          | `git-purge`, `git-diff`, `git-fix`, `git-reduce-size`                   | Git repository management and optimization        |
+| **Submodules**   | `submodule`, `submodule-install`, `submodule-remove`, `submodule-token` | Git submodule operations                         |
+| **NPM Scripts**  | `nrs`, `run-s`, `run-series`, `npm-run-series`                          | Run npm scripts in series with pattern matching   |
+| **Package Mgmt** | `yarn-reinstall`, `pkg-resolutions-updater`, `pkg-res-updater`          | Yarn/package resolutions management utilities     |
+| **Node.js Dev**  | `find-node-modules`, `find-nodemodules`, `dev`, `prod`, `empty`         | Node.js development helpers                      |
+| **Process Mgmt** | `kill-process`, `nodekill`, `javakill`, `del-ps`                        | Process management and termination               |
+| **File System**  | `rmfind`, `rmpath`, `rmx`, `print-tree`, `dir-tree`                     | File system operations                           |
+| **Cleanup**      | `del-nodemodules`, `del-yarncaches`, `del-gradle`                       | Cache and build directory cleanup                |
+| **GitHub Actions**| `clean-github-actions-caches`, `clean-github-actions-cache`, `clear-github-actions-cache`, `clear-github-actions-caches`, `clear-gh-caches` | Remove old GitHub Actions caches, keep only latest |
+
+---
+#### Binary List Generation & Source Code
+
+The list of available binaries and utilities is auto-generated by the build script ([`https://github.com/dimaslanjaka/bin/blob/master/build.mjs`](https://github.com/dimaslanjaka/bin/blob/master/build.mjs)).
+- All CLI tools and binaries are collected from the `bin/`, `lib/`, and other relevant folders.
+- The build process updates the `bin` field in `https://github.com/dimaslanjaka/bin/blob/master/package.json` to reflect all available executables.
+- Source code for utilities is located in the `src/` folder.
+
+To update the binary list, run:
+```bash
+yarn run build
+# or
+node build.mjs
+```
+This scans the project and updates `package.json` with all available binaries. The list may change as files are added or removed.
+
+See also:
+- [Binary executables](https://github.com/dimaslanjaka/bin/tree/master/bin)
+- [Library modules](https://github.com/dimaslanjaka/bin/tree/master/lib)
+- [Package configuration](https://github.com/dimaslanjaka/bin/blob/master/package.json)
+
+### Git Tools
+
+#### Git Repository Purge
+Clean and optimize git repositories by pruning reflogs:
+```bash
+git-purge
+```
+![Git purge screenshot](https://github.com/dimaslanjaka/bin/assets/12471057/2805c54e-28a7-491d-b381-de2593a854b3)
+
+#### Git Diff Utility
+Enhanced git diff functionality:
+```bash
+git-diff
+```
+
+#### Git Fix Utility
+Comprehensive Git configuration fixer for cross-platform development (replaces `git-fix-encoding`):
+```bash
+git-fix                          # Apply all fixes
+git-fix --lf-only                # Force LF line endings only
+git-fix --permissions            # Ignore file permissions only
+git-fix --normalize              # Normalize existing files only
+git-fix --user                   # Configure Git user from environment
+git-fix --user NAME EMAIL        # Configure Git user with specific values
+git-fix --user --update-remote   # Also update remote URL to match user
+git-fix --user NAME EMAIL --update-remote  # Configure user and update remote URL
+```
+Features:
+- Forces LF line endings (`core.autocrlf = false`)
+- Ignores file permission changes (`core.filemode = false`)
+- Sets pull strategy to false (prevents auto-rebase)
+- Normalizes existing line endings
+- Creates/updates `.gitattributes` with proper line ending rules
+- Configures Git user from environment variables or CLI arguments
+- **Non-interactive:** All configuration is now argument-driven; no interactive prompts
+- `--update-remote` flag: Update remote URL to match the configured user (for HTTPS remotes)
+
+User Configuration:
+- Environment variables: `GITHUB_USER`, `GITHUB_EMAIL`
+- CLI arguments take precedence over environment variables
+- Use `--update-remote` to update the remote URL with the configured user
+- Examples:
+  ```bash
+  git-fix --user "John Doe" "john@example.com"  # Use CLI args
+  git-fix --user --update-remote                 # Use env vars and update remote
+  git-fix --user "Jane" "jane@example.com" --update-remote  # CLI args and update remote
+  GITHUB_USER="Jane" GITHUB_EMAIL="jane@example.com" git-fix --user  # Use env vars
+  ```
+
+#### Git Repository Size Reducer
+Reduce git repository size by cleaning up history:
+```bash
+git-reduce-size
+```
+
+#### Submodule Management
+- **`submodule`** - General submodule operations
+- **`submodule-install`** - Install and setup submodules
+- **`submodule-remove`** - Remove git submodules with interactive selection
+- **`submodule-token`** - Manage submodule tokens
+
+![Submodule remover screenshot](https://github.com/user-attachments/assets/659c2fa3-f12f-45cb-a66f-aed3807e0023)
+
+
+### NPM Script Runner
+
+**Binaries**: `nrs`, `run-s`, `run-series`, `npm-run-series`
+
+Run multiple npm scripts in series with pattern matching support.
+
+#### Options
+| Flag                | Description                                 |
+|---------------------|---------------------------------------------|
+| `--yarn`            | Use `yarn run <script-name>` instead of npm |
+| `--verbose`, `-v`   | Enable verbose output                       |
+
+#### Example
+Execute all scripts matching the pattern `namescript:**`:
+```json
+{
+  "name": "package-name",
+  "version": "0.0.0",
+  "private": true,
+  "scripts": {
+    "namescript:xx": "echo xx",
+    "namescript:xxx": "echo xxx",
+    "namescript:xxxx": "echo xxxx",
+    "namescript:xxxxx": "echo xxxxx",
+    "namescript": "nrs --yarn=true --verbose=true \"namescript:**\""
+  },
+  "license": "ISC"
+}
+```
+
+### Package Management Tools
+
+#### Yarn Package Reinstaller
+Reinstall yarn packages with dependency type flags:
+```bash
+yarn-reinstall <packageName> [--dev|-D|--peer|-P|--optional|-O]
+```
+
+#### Package Resolutions Manager
+Manage package resolutions in package.json (aliases: `pkg-resolutions-updater`, `pkg-res-updater`):
+```bash
+pkg-resolutions-updater
+pkg-res-updater
+```
+
+### Node.js Development Tools
+
+#### Node Modules Finder
+Find all node_modules directories in a project:
+```bash
+find-node-modules      # Library function
+find-node-modules-cli  # CLI tool
+find-nodemodules       # Alias
+```
+
+#### Development Environment Helpers
+- **`dev`** - Development environment setup
+- **`prod`** - Production environment setup
+- **`empty`** - Empty utility tool
+
+### Process Management Tools
+
+#### Process Killers
+Kill processes by name or pattern:
+```bash
+kill-process    # General process killer
+nodekill        # Kill Node.js processes
+javakill        # Kill Java processes (Windows)
+del-ps          # Kill processes by command name
+```
+
+#### File System Tools
+- **`rmfind`** - Find and remove files
+- **`rmpath`** - Remove from PATH
+- **`rmx`** - Remove executable files
+
+### Cleanup Tools
+
+#### GitHub Actions Cache Cleaner
+[See full documentation](https://github.com/dimaslanjaka/bin/blob/master/docs-src/clean-github-actions-caches.md).
+
+#### Node Modules Cleaner
+Remove node_modules directories recursively:
+```bash
+del-nodemodules        # Primary command
+del-node-modules       # Alternative
+clean-nodemodule       # Legacy
+clean-nodemodules      # Legacy
+```
+![Node modules cleaner screenshot](https://github.com/dimaslanjaka/bin/assets/12471057/f03e5b51-1808-4e82-a474-0dd3c7eab5fe)
+
+#### Yarn Cache Cleaner
+Clear yarn cache directories:
+```bash
+del-yarncaches         # Primary command
+del-yarn-caches        # Alternative
+```
+
+#### Gradle Build Cleaner
+Delete gradle build folders:
+```bash
+del-gradle
+```
+
+#### Free ChatGPT automation tool
+
+[See full documentation](https://github.com/dimaslanjaka/bin/blob/master/docs-src/free-chatgpt.md)
+
+## Troubleshooting
+
+### Submodule Installation Issues
+If you encounter the following error:
+```log
+fatal: 'origin/<branch>' is not a commit and a branch '<branch>' cannot be created from it
+fatal: unable to checkout submodule '<folder>/<submodule>'
+```
+**Solution**: Delete `.git/modules` directory before running `submodule-install`.
+
+#### Complete Submodule Setup Example
+```bash
+echo "Initializing submodules..."
+git submodule init
+git submodule foreach "git submodule init"
+
+echo "Syncing submodules..."
+git submodule sync
+git submodule foreach "git submodule sync"
+
+echo "Updating submodules..."
+npx --yes rimraf .git/modules
+npx --yes binary-collections@https://raw.githubusercontent.com/dimaslanjaka/bin/master/releases/bin.tgz submodule-install
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the terms specified in the LICENSE file.

package/bin/bash-dummy

@@ -1,56 +0,0 @@
-#!/usr/bin/env bash
-
-# put these on top of file
-
-(set -o igncr) 2>/dev/null && set -o igncr; # cygwin encoding fix
-
-# absolute path working directory
-basecwd=${PWD}
-# base script directory
-basedir=`dirname "$0"`
-# absolute path script directory
-SCRIPT_DIR=$(cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd)
-# get script path
-SCRIPT=$(realpath "$0")
-SCRIPTPATH=$(dirname "$SCRIPT")
-
-# Detect Cygwin or MinGW
-case "$(uname)" in
-  *CYGWIN*)
-    basedir=$(cygpath -w "$basedir")
-    # make cygwin bin as priority
-    export PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-  *MINGW*)
-    # make mingw bin as priority
-    export PATH="/mingw64/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-esac
-
-# parse and export .env file (dotenv)
-if [ -f ".env" ]; then
-  # Export the vars in .env into your shell:
-  export $(egrep -v '^#' .env | xargs)
-fi
-
-# write a function
-fresh(){
-   # t stores $1 argument passed to fresh()
-   t=$1
-   echo "fresh(): \$0 is $0"
-   echo "fresh(): \$1 is $1"
-   echo "fresh(): \$t is $t"
-   echo "fresh(): total args passed to me $#"
-   echo "fresh(): all args (\$@) passed to me -\"$@\""
-   echo "fresh(): all args (\$*) passed to me -\"$*\""
-}
-
-# invoke the function with total 3 arguments
-echo "**** calling fresh() with params ****"
-fresh Tomato Onion Paneer
-
-echo ""
-
-# pass cli arguments to function params
-echo "**** calling fresh() pass cli arguments into params ****"
-fresh "$@"

package/bin/bash-dummy.cmd

@@ -1,25 +0,0 @@
-@echo off
-
-SETLOCAL enableExtensions enableDelayedExpansion
-
-rem my malfunction keyboard 56^%
-rem execute bash file with cygwin from batch script https://stackoverflow.com/a/43300782/6404439
-
-set scriptDirPath=%~dp0
-set terminalCwd=%CD%
-set cygwinBinPath=c:\cygwin64\bin\
-set minttyBin=%cygwinBinPath%mintty
-set bashBin=%cygwinBinPath%bash
-
-rem to inspect terminal output
-rem c:\cygwin64\bin\mintty -h always /bin/bash -l /cygdrive/c/path/to/bash-script
-rem run bash in the current console window
-rem C:\cygwin64\bin\bash -l c:\path\to\your\script
-rem run bash in new window (mintty)
-rem C:\cygwin64\bin\mintty /bin/bash -l c:\path\to\your\script
-
-rem %minttyBin% -h always /bin/bash -l %scriptDirPath%bash-dummy
-
-%bashBin% -l %scriptDirPath%bash-dummy Hello World
-
-ENDLOCAL

package/bin/dir-tree.cmd

@@ -1,7 +0,0 @@
-@echo off
-setlocal
-set SCRIPT_DIR=%~dp0
-
-echo Running script: %~f0
-
-node "%SCRIPT_DIR%..\lib\print-directory-tree.cjs" %*

package/bin/git-diff

@@ -1,4 +0,0 @@
-#!/usr/bin/env bash
-SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-
-node "$SCRIPT_DIR/../lib/git-diff.cjs" "$@"

package/bin/git-diff.cmd

@@ -1,7 +0,0 @@
-@echo off
-setlocal
-set SCRIPT_DIR=%~dp0
-
-echo Running script: %~f0
-
-node "%SCRIPT_DIR%..\lib\git-diff.cjs" %*

package/bin/git-fix

@@ -1,36 +0,0 @@
-#!/usr/bin/env bash
-
-# put these on top of file
-
-(set -o igncr) 2>/dev/null && set -o igncr; # cygwin encoding fix
-
-# absolute path working directory
-basecwd=${PWD}
-# base script directory
-basedir=`dirname "$0"`
-# absolute path script directory
-SCRIPT_DIR=$(cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd)
-# get script path
-SCRIPT=$(realpath "$0")
-SCRIPTPATH=$(dirname "$SCRIPT")
-
-# Detect Cygwin or MinGW
-case "$(uname)" in
-  *CYGWIN*)
-    basedir=$(cygpath -w "$basedir")
-    # make cygwin bin as priority
-    export PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-  *MINGW*)
-    # make mingw bin as priority
-    export PATH="/mingw64/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-esac
-
-# parse and export .env file (dotenv)
-if [ -f ".env" ]; then
-  # Export the vars in .env into your shell:
-  export $(egrep -v '^#' .env | xargs)
-fi
-
-node "$basedir/../lib/git-fix.cjs" "$@"

package/bin/git-fix.cmd

@@ -1,7 +0,0 @@
-@echo off
-setlocal
-set SCRIPT_DIR=%~dp0
-
-echo Running script: %~f0
-
-node "%SCRIPT_DIR%..\lib\git-fix.cjs" %*

package/bin/rmpath

@@ -1,70 +0,0 @@
-#!/usr/bin/env bash
-
-# put these on top of file
-
-(set -o igncr) 2>/dev/null && set -o igncr; # cygwin encoding fix
-
-# absolute path working directory
-basecwd=${PWD}
-# base script directory
-basedir=`dirname "$0"`
-# absolute path script directory
-SCRIPT_DIR=$(cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd)
-# get script path
-SCRIPT=$(realpath "$0")
-SCRIPTPATH=$(dirname "$SCRIPT")
-
-# Detect Cygwin or MinGW
-case "$(uname)" in
-  *CYGWIN*)
-    basedir=$(cygpath -w "$basedir")
-    # make cygwin bin as priority
-    export PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-  *MINGW*)
-    # make mingw bin as priority
-    export PATH="/mingw64/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-esac
-
-# parse and export .env file (dotenv)
-if [ -f ".env" ]; then
-  # Export the vars in .env into your shell:
-  export $(egrep -v '^#' .env | xargs)
-fi
-
-# fast huge folder deleter
-
-if [ -z "$1" ]; then
-    echo "You need to provide a file or folder path"
-    exit
-fi
-
-# delete single file
-if [ -f "$1" ]; then
-  rm -rf "$1"
-  exit
-fi
-
-if [ ! -d "$1" ]; then
-  echo "$1 not found"
-  exit
-fi
-
-vowels=( a i u e o A I U E O )
-for letter in {{a..z},{A..Z}}; do
-    for vowel in "${vowels[@]}"; do
-      toBeDeleted=( "$1/.${letter}*" "$1/@${letter}*" "$1/${letter}*" "$1/@${letter}${vowel}*" "$1/.${letter}${vowel}*" "$1/${letter}${vowel}*" )
-      for fpath in "${toBeDeleted[@]}"; do
-        echo "deleting ${fpath}"
-        rm -rf $fpath or echo "cannot delete $fpath" &
-      done
-    done
-done
-
-wait
-
-echo "cleaning $1"
-rm -rf $1 &
-
-wait

package/bin/submodule-install.txt

@@ -1,118 +0,0 @@
-#!/usr/bin/env bash
-
-# put these on top of file
-
-(set -o igncr) 2>/dev/null && set -o igncr; # cygwin encoding fix
-
-# absolute path working directory
-basecwd=${PWD}
-# base script directory
-basedir=`dirname "$0"`
-# absolute path script directory
-SCRIPT_DIR=$(cd -- "$( dirname -- "${BASH_SOURCE[0]}" )" &> /dev/null && pwd)
-# get script path
-SCRIPT=$(realpath "$0")
-SCRIPTPATH=$(dirname "$SCRIPT")
-
-# Detect Cygwin or MinGW
-case "$(uname)" in
-  *CYGWIN*)
-    basedir=$(cygpath -w "$basedir")
-    # make cygwin bin as priority
-    export PATH="/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-  *MINGW*)
-    # make mingw bin as priority
-    export PATH="/mingw64/bin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:$PATH"
-    ;;
-esac
-
-# parse and export .env file (dotenv)
-if [ -f ".env" ]; then
-  # Export the vars in .env into your shell:
-  export $(egrep -v '^#' .env | xargs)
-fi
-
-# auto clone all submodules, prevent not-matched hash
-# set ACCESS_TOKEN=github_personal_tokens
-# usages: sh folder_this_repo/submodule-install
-
-# set default root
-export ROOT="$(git rev-parse --show-toplevel)"
-
-while test $# -gt 0; do
-  case "$1" in
-    -h|--help)
-      echo "$package - attempt to install submodules"
-      echo " "
-      echo "$package [options] application [arguments]"
-      echo " "
-      echo "options:"
-      echo "-h, --help                show brief help"
-      echo "-o, --output-dir=DIR      specify a directory to install submodules"
-      exit 0
-      ;;
-    -cwd)
-      shift
-      if test $# -gt 0; then
-        export ROOT=$1
-      else
-        echo "no output dir specified"
-        exit 1
-      fi
-      shift
-      ;;
-    --cwd*)
-      export ROOT=`echo $1 | sed -e 's/^[^=]*=//g'`
-      shift
-      ;;
-    *)
-      break
-      ;;
-  esac
-done
-
-echo "installing submodules at $ROOT"
-
-git -C "${REPO_PATH}" config -f .gitmodules --get-regexp '^submodule\..*\.path$' |
-    while read -r KEY MODULE_PATH
-    do
-        # relative module path from root
-        RELATIVE_MODULE_PATH="${ROOT}/${MODULE_PATH}"
-        # cd git root dir
-        cd ${ROOT}
-        # If the module's path exists, remove it.
-        # This is done b/c the module's path is currently
-        # not a valid git repo and adding the submodule will cause an error.
-        if [ -d "${RELATIVE_MODULE_PATH}" ]; then
-            echo "deleting ${RELATIVE_MODULE_PATH}"
-            rm -rf "${RELATIVE_MODULE_PATH}"
-        fi
-
-        NAME="$(echo "${KEY}" | sed 's/^submodule\.\(.*\)\.path$/\1/')"
-
-        url_key="$(echo "${KEY}" | sed 's/\.path$/.url/')"
-        branch_key="$(echo "${KEY}" | sed 's/\.path$/.branch/')"
-
-        URL="$(git config -f .gitmodules --get "${url_key}")"
-        BRANCH="$(git config -f .gitmodules --get "${branch_key}" || echo "master")"
-
-        git -C "${REPO_PATH}" submodule add --force -b "${BRANCH}" --name "${NAME}" "${URL}" "${MODULE_PATH}" || echo "cannot add submodule ${MODULE_PATH}"
-
-        repo=${URL#"https://github.com/"}
-        URL_WITH_TOKEN="https://${ACCESS_TOKEN}@github.com/${repo}"
-
-        echo "apply token for ${repo} at ${MODULE_PATH} branch ${BRANCH}"
-        GIT_MODULES="${RELATIVE_MODULE_PATH}/.gitmodules"
-        cd "${RELATIVE_MODULE_PATH}"
-        git remote set-url origin "${URL_WITH_TOKEN}"
-        git fetch --all
-        git pull origin "${BRANCH}" -X theirs
-        if [ -f "${GIT_MODULES}" ];
-        then
-          echo "${MODULE_PATH} has submodules"
-          sh "${SCRIPT}" -cwd ${RELATIVE_MODULE_PATH}
-        fi
-    done
-
-git -C "${REPO_PATH}" submodule update --init --recursive