binary-collections 2.0.10 → 2.0.12

package/lib/ps/index.js

@@ -1,253 +0,0 @@
-var ChildProcess = require("child_process");
-var IS_WIN = require("./isWin").default;
-var TableParser = require("./table-parser");
-/**
- * End of line.
- * Basically, the EOL should be:
- * - windows: \r\n
- * - *nix: \n
- * But i'm trying to get every possibilities covered.
- */
-var EOL = /(\r\n)|(\n\r)|\n|\r/;
-var SystemEOL = require("os").EOL;
-// ps-node
-/**
- * Execute child process
- * @type {Function}
- * @param {String[]} args
- * @param {Function} callback
- * @param {Object=null} callback.err
- * @param {Object[]} callback.stdout
- */
-var Exec = (module.exports =
-    exports =
-        function (args, callback) {
-            var spawn = ChildProcess.spawn;
-            // on windows, if use ChildProcess.exec(`wmic process get`), the stdout will gives you nothing
-            // that's why I use `cmd` instead
-            if (IS_WIN) {
-                var CMD = spawn("cmd");
-                var stdout = "";
-                var stderr = null;
-                CMD.stdout.on("data", function (data) {
-                    stdout += data.toString();
-                });
-                CMD.stderr.on("data", function (data) {
-                    if (stderr === null) {
-                        stderr = data.toString();
-                    }
-                    else {
-                        stderr += data.toString();
-                    }
-                });
-                CMD.on("exit", function () {
-                    var beginRow;
-                    stdout = stdout.split(EOL);
-                    // Find the line index for the titles
-                    stdout.forEach(function (out, index) {
-                        if (out && typeof beginRow == "undefined" && out.indexOf("CommandLine") === 0) {
-                            beginRow = index;
-                        }
-                    });
-                    // get rid of the start (copyright) and the end (current pwd)
-                    stdout.splice(stdout.length - 1, 1);
-                    stdout.splice(0, beginRow);
-                    callback(stderr, stdout.join(SystemEOL) || false);
-                });
-                CMD.stdin.write("wmic process get ProcessId,ParentProcessId,CommandLine \n");
-                CMD.stdin.end();
-            }
-            else {
-                if (typeof args === "string") {
-                    args = args.split(/\s+/);
-                }
-                const child = spawn("ps", args);
-                stdout = "";
-                stderr = null;
-                child.stdout.on("data", function (data) {
-                    stdout += data.toString();
-                });
-                child.stderr.on("data", function (data) {
-                    if (stderr === null) {
-                        stderr = data.toString();
-                    }
-                    else {
-                        stderr += data.toString();
-                    }
-                });
-                child.on("exit", function () {
-                    if (stderr) {
-                        return callback(stderr.toString());
-                    }
-                    else {
-                        callback(null, stdout || false);
-                    }
-                });
-            }
-        });
-/**
- * Query Process: Focus on pid & cmd
- * @param query
- * @param {String|String[]} query.pid
- * @param {String} query.command RegExp String
- * @param {String} query.arguments RegExp String
- * @param {String|array} query.psargs
- * @param {Function} callback
- * @param {Object=null} callback.err
- * @param {Object[]} callback.processList
- * @return {Object}
- */
-exports.lookup = function (query, callback) {
-    /**
-     * add 'lx' as default ps arguments, since the default ps output in linux like "ubuntu", wont include command arguments
-     */
-    var exeArgs = query.psargs || ["lx"];
-    var filter = {};
-    var idList;
-    // Lookup by PID
-    if (query.pid) {
-        if (Array.isArray(query.pid)) {
-            idList = query.pid;
-        }
-        else {
-            idList = [query.pid];
-        }
-        // Cast all PIDs as Strings
-        idList = idList.map(function (v) {
-            return String(v);
-        });
-    }
-    if (query.command) {
-        filter["command"] = new RegExp(query.command, "i");
-    }
-    if (query.arguments) {
-        filter["arguments"] = new RegExp(query.arguments, "i");
-    }
-    if (query.ppid) {
-        filter["ppid"] = new RegExp(query.ppid);
-    }
-    return Exec(exeArgs, function (err, output) {
-        if (err) {
-            return callback(err);
-        }
-        else {
-            var processList = parseGrid(output);
-            var resultList = [];
-            processList.forEach(function (p) {
-                var flt;
-                var type;
-                var result = true;
-                if (idList && idList.indexOf(String(p.pid)) < 0) {
-                    return;
-                }
-                for (type in filter) {
-                    flt = filter[type];
-                    result = flt.test(p[type]) ? result : false;
-                }
-                if (result) {
-                    resultList.push(p);
-                }
-            });
-            callback(null, resultList);
-        }
-    });
-};
-/**
- * Kill process
- * @param pid
- * @param {Object|String} signal
- * @param {String} signal.signal
- * @param {number} signal.timeout
- * @param next
- */
-exports.kill = function (pid, signal, next) {
-    //opts are optional
-    if (arguments.length == 2 && typeof signal == "function") {
-        next = signal;
-        signal = undefined;
-    }
-    var checkTimeoutSeconds = (signal && signal.timeout) || 30;
-    if (typeof signal === "object") {
-        signal = signal.signal;
-    }
-    try {
-        process.kill(pid, signal);
-    }
-    catch (e) {
-        return next && next(e);
-    }
-    var checkConfident = 0;
-    var checkTimeoutTimer = null;
-    var checkIsTimeout = false;
-    function checkKilled(finishCallback) {
-        exports.lookup({ pid: pid }, function (err, list) {
-            if (checkIsTimeout)
-                return;
-            if (err) {
-                clearTimeout(checkTimeoutTimer);
-                if (finishCallback)
-                    finishCallback(err);
-            }
-            else if (list.length > 0) {
-                checkConfident = checkConfident - 1 || 0;
-                checkKilled(finishCallback);
-            }
-            else {
-                checkConfident++;
-                if (checkConfident === 5) {
-                    clearTimeout(checkTimeoutTimer);
-                    if (finishCallback)
-                        finishCallback();
-                }
-                else {
-                    checkKilled(finishCallback);
-                }
-            }
-        });
-    }
-    if (next)
-        checkKilled(next);
-    checkTimeoutTimer =
-        next &&
-            setTimeout(function () {
-                checkIsTimeout = true;
-                next(new Error("Kill process timeout"));
-            }, checkTimeoutSeconds * 1000);
-};
-/**
- * Parse the stdout into readable object.
- * @param {String} output
- */
-function parseGrid(output) {
-    if (!output) {
-        return [];
-    }
-    return formatOutput(TableParser.parse(output));
-}
-/**
- * format the structure, extract pid, command, arguments, ppid
- * @param data
- * @return {Array}
- */
-function formatOutput(data) {
-    var formatedData = [];
-    data.forEach(function (d) {
-        var pid = (d.PID && d.PID[0]) || (d.ProcessId && d.ProcessId[0]) || undefined;
-        var cmd = d.CMD || d.CommandLine || d.COMMAND || undefined;
-        var ppid = (d.PPID && d.PPID[0]) || (d.ParentProcessId && d.ParentProcessId[0]) || undefined;
-        if (pid && cmd) {
-            var command = cmd[0];
-            var args = "";
-            if (cmd.length > 1) {
-                args = cmd.slice(1);
-            }
-            formatedData.push({
-                pid: pid,
-                command: command,
-                arguments: args,
-                ppid: ppid
-            });
-        }
-    });
-    return formatedData;
-}

package/tmp/typedoc/readme.md

@@ -1,320 +0,0 @@
-# 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.