toolz 0.0.0

package/README.md

@@ -0,0 +1,54 @@
+# toolz
+
+[![npm version](https://img.shields.io/npm/v/toolz.svg)](https://www.npmjs.com/package/toolz)
+[![npm downloads](https://img.shields.io/npm/dm/toolz.svg)](https://www.npmjs.com/package/toolz)
+
+Various bash utilities for starting servers.
+
+## Installation
+
+```bash
+npm install -g toolz
+```
+
+## Usage
+
+### `toolz tee <file>`
+
+Tee the input to stdout and a file, without ansi escape codes.
+
+**Example:**
+
+```bash
+some-command | toolz tee output.log
+```
+
+### `toolz port <ports>`
+
+Get an available port.
+
+`<ports>` can be a single port, a range of ports, or a comma-separated list of ports.
+
+**Examples:**
+
+```bash
+toolz port 8080
+toolz port 8080-8090
+toolz port 8080,8081,8082
+```
+
+### `toolz concur <commands...>`
+
+Run commands concurrently. This is a wrapper around the `concurrently` package.
+
+**Example:**
+
+```bash
+toolz concur "npm run server" "npm run client"
+```
+
+This is equivalent to:
+
+```bash
+concurrently "npm run server" "npm run client"
+```

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+commander_1.program
+    .name('toolz')
+    .description('Bash utilities for starting servers')
+    .version('0.0.0');
+commander_1.program
+    .command('tee')
+    .description(`Tee the input to stdout and a file, without ansi escape codes`)
+    .argument('<file>', 'File to write the stripped output to')
+    .action(async (file) => void (await Promise.resolve().then(() => require('./tee'))).tee(file));
+commander_1.program
+    .command('port')
+    .description('Get an available port')
+    .argument('<ports>', 'Port or range of ports to check (e.g., 8080, 8080-8090, 8080,8081,8082)')
+    .action(async (ports) => {
+    let check = [];
+    if (ports.includes('-')) {
+        const start = parseInt(ports.split('-')[0], 10);
+        const end = parseInt(ports.split('-')[1], 10);
+        if (start > end)
+            throw new Error('Invalid port range');
+        if (end - start > 1000)
+            throw new Error('Port range too large');
+        check = Array.from({ length: end - start + 1 }, (_, i) => i + start);
+    }
+    else if (ports.includes(','))
+        check = ports.split(',').map((p) => parseInt(p, 10));
+    else
+        check = [parseInt(ports, 10)];
+    const port = await (await Promise.resolve().then(() => require('./port'))).port({ check });
+    process.stdout.write(`${port}\n`);
+});
+commander_1.program
+    .command('concur')
+    .description('Run commands concurrently (same as "concurrently" package)')
+    .argument('<commands...>', 'commands to run')
+    .allowUnknownOption()
+    .action(async (commands = []) => {
+    const { concur } = await Promise.resolve().then(() => require('./concur'));
+    try {
+        await concur(commands);
+    }
+    catch (e) {
+        process.exit(1);
+    }
+});
+commander_1.program.parse(process.argv);
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";;;AAEA,yCAAoC;AAEpC,mBAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,qCAAqC,CAAC;KAClD,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,mBAAO;KACJ,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,+DAA+D,CAAC;KAC5E,QAAQ,CAAC,QAAQ,EAAE,sCAAsC,CAAC;KAC1D,MAAM,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE,CAAC,KAAK,CAAC,2CAAa,OAAO,EAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAE1E,mBAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,uBAAuB,CAAC;KACpC,QAAQ,CACP,SAAS,EACT,yEAAyE,CAC1E;KACA,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,EAAE;IAC9B,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,KAAK,GAAG,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QACvD,IAAI,GAAG,GAAG,KAAK,GAAG,IAAI;YAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;QAChE,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,GAAG,KAAK,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;IACvE,CAAC;SAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAC5B,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;;QAClD,KAAK,GAAG,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,CAAC,2CAAa,QAAQ,EAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,IAAI,IAAI,CAAC,CAAC;AACpC,CAAC,CAAC,CAAC;AAEL,mBAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4DAA4D,CAAC;KACzE,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;KAC5C,kBAAkB,EAAE;KACpB,MAAM,CAAC,KAAK,EAAE,WAAqB,EAAE,EAAE,EAAE;IACxC,MAAM,EAAE,MAAM,EAAE,GAAG,2CAAa,UAAU,EAAC,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,mBAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/concur.d.ts

@@ -0,0 +1,2 @@
+export declare const concur: (cmds: string[]) => Promise<void>;
+//# sourceMappingURL=concur.d.ts.map

package/dist/concur.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concur.d.ts","sourceRoot":"","sources":["../src/concur.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,GAAU,MAAM,MAAM,EAAE,kBAU1C,CAAC"}

package/dist/concur.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.concur = void 0;
+const child_process_1 = require("child_process");
+const concur = async (cmds) => {
+    return new Promise((resolve, reject) => {
+        const child = (0, child_process_1.spawn)('npx', ['concurrently', ...cmds], { stdio: 'inherit' });
+        child.on('close', (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`concurrently exited with code ${code}`));
+        });
+        child.on('error', reject);
+    });
+};
+exports.concur = concur;
+//# sourceMappingURL=concur.js.map

package/dist/concur.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concur.js","sourceRoot":"","sources":["../src/concur.ts"],"names":[],"mappings":";;;AAAA,iDAAsC;AAE/B,MAAM,MAAM,GAAG,KAAK,EAAE,IAAc,EAAE,EAAE;IAC7C,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAA,qBAAK,EAAC,KAAK,EAAE,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;QAE5E,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAC;gBAAE,OAAO,EAAE,CAAC;;gBACrB,MAAM,CAAC,IAAI,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAVW,QAAA,MAAM,UAUjB"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/port.d.ts

@@ -0,0 +1,7 @@
+export declare const port: (o: {
+    check: number[];
+} | {
+    from: number;
+    to: number;
+}) => Promise<number>;
+//# sourceMappingURL=port.d.ts.map

package/dist/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,GACf,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,oBAItD,CAAC"}

package/dist/port.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.port = void 0;
+const get_port_1 = require("get-port");
+const port = async (o) => {
+    const port = 'check' in o ? o.check : (0, get_port_1.portNumbers)(o.from, o.to);
+    return await (0, get_port_1.default)({ port });
+};
+exports.port = port;
+//# sourceMappingURL=port.js.map

package/dist/port.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.js","sourceRoot":"","sources":["../src/port.ts"],"names":[],"mappings":";;;AAAA,uCAAgD;AAEzC,MAAM,IAAI,GAAG,KAAK,EACvB,CAAqD,EACrD,EAAE;IACF,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAA,sBAAW,EAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;IAChE,OAAO,MAAM,IAAA,kBAAO,EAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AACjC,CAAC,CAAC;AALW,QAAA,IAAI,QAKf"}

package/dist/tee.d.ts

@@ -0,0 +1,2 @@
+export declare const tee: (file: string) => void;
+//# sourceMappingURL=tee.d.ts.map

package/dist/tee.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tee.d.ts","sourceRoot":"","sources":["../src/tee.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,GAAG,GAAI,MAAM,MAAM,SAQ/B,CAAC"}

package/dist/tee.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tee = void 0;
+const fs_1 = require("fs");
+const util_1 = require("util");
+const tee = (file) => {
+    const writeStream = (0, fs_1.createWriteStream)(file);
+    process.stdin.on('data', (data) => {
+        const str = data.toString('utf8');
+        process.stdout.write(str);
+        writeStream.write((0, util_1.stripVTControlCharacters)(str));
+    });
+    process.stdin.on('end', () => writeStream.end());
+};
+exports.tee = tee;
+//# sourceMappingURL=tee.js.map

package/dist/tee.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tee.js","sourceRoot":"","sources":["../src/tee.ts"],"names":[],"mappings":";;;AAAA,2BAAuC;AACvC,+BAAgD;AAEzC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAE;IAClC,MAAM,WAAW,GAAG,IAAA,sBAAiB,EAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,WAAW,CAAC,KAAK,CAAC,IAAA,+BAAwB,EAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AARW,QAAA,GAAG,OAQd"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "toolz",
+  "version": "0.0.0",
+  "description": "Various bash utilities for starting servers",
+  "scripts": {
+    "prepublishOnly": "npm run build && npm test",
+    "build": "rm -rf dist && tsc -b",
+    "postbuild": "chmod +x dist/cli.js",
+    "test": "node --import tsx --test",
+    "test:watch": "npm test -- --watch"
+  },
+  "files": [
+    "dist/"
+  ],
+  "main": "dist/index.js",
+  "bin": "dist/cli.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./*": {
+      "import": "./dist/*.js",
+      "require": "./dist/*.js",
+      "types": "./dist/*.d.ts"
+    }
+  },
+  "keywords": [],
+  "author": "Moshe Kolodny",
+  "license": "MIT",
+  "type": "commonjs",
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "commander": "^14.0.2",
+    "concurrently": "^9.2.1",
+    "get-port": "^7.1.0",
+    "wait-on": "^9.0.3"
+  },
+  "directories": {
+    "test": "test"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kolodny/toolz.git"
+  },
+  "types": "./dist/index.d.ts",
+  "bugs": {
+    "url": "https://github.com/kolodny/toolz/issues"
+  },
+  "homepage": "https://github.com/kolodny/toolz#readme"
+}