batch-exec-cli 1.2.1 → 1.3.0

package/README.md

@@ -1,10 +1,10 @@
-# batch-exec
+# batch-exec-cli
 
 高效批量命令执行工具，能够遍历目录内所有直接子目录并执行命令。
 
 ## 功能特性
 
-- 🚀 高效遍历目标目录的所有直接子目录
+- 🚀 高效遍历目标目录的所有直接子目录, 默认并行执行
 - 📁 支持绝对路径和相对路径
 - 🚫 可配置忽略目录（支持 `.gitignore` 风格的模式匹配）
 - 📊 提供执行摘要和失败目录列表
@@ -17,14 +17,14 @@
 ## 安装
 
 ```bash
-npm install -g batch-exec
+npm install -g batch-exec-cli
 ```
 
 或者克隆项目后本地安装：
 
 ```bash
 git clone <repository-url>
-cd batch-exec
+cd batch-exec-cli
 npm install
 npm link
 ```
@@ -64,6 +64,7 @@ batch-exec ./repos ls -la
 | `-s, --skip <文件>` |      | 指定忽略文件路径（默认：`./.batchexecignore`） |
 | `-v, --verbose`     |      | 显示详细输出                                   |
 | `--no-progress`     |      | 禁用进度条显示                                 |
+| `--no-parallel`     |      | 禁用并行执行, 按顺序执行                       |
 | `-h, --help`        |      | 显示帮助信息                                   |
 
 ### 使用自定义忽略文件
@@ -128,7 +129,7 @@ temp-*
 你也可以作为库使用：
 
 ```javascript
-import { batchExecute } from 'batch-exec';
+import { batchExecute } from 'batch-exec-cli';
 
 const results = await batchExecute('./my-projects', 'git', ['pull'], {
   verbose: false,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "batch-exec-cli",
-  "version": "1.2.1",
-  "description": "Efficiently iterate through directories and execute commands with progress display",
+  "version": "1.3.0",
+  "description": "Efficiently iterate through directories and execute commands with progress display and parallel execution",
   "type": "module",
   "main": "src/index.js",
   "bin": {
@@ -11,6 +11,9 @@
     "test": "echo 'Tests require Node.js >= 18.0.0 with --test support'",
     "lint": "eslint src/ test/"
   },
+  "files": [
+    "src"
+  ],
   "keywords": [
     "batch-exec",
     "batchexec",

package/src/cli.js

@@ -10,7 +10,7 @@ $.verbose = false;
 
 async function main() {
   const argv = minimist(process.argv.slice(2), {
-    boolean: ['v', 'verbose', 'h', 'help', 'no-progress'],
+    boolean: ['v', 'verbose', 'h', 'help', 'no-progress', 'no-parallel'],
     string: ['s', 'skip'],
     alias: {
       s: 'skip',
@@ -45,6 +45,7 @@ async function main() {
     console.log(bold('\n🚀 Batch Executor\n'));
     console.log(`Target directory: ${cyan(targetDir)}`);
     console.log(`Command: ${yellow(command)} ${args.join(' ')}`);
+    console.log(`Parallel mode: ${argv.parallel === false ? red('Disabled') : green('Enabled')}`);
     if (skipPaths.length > 0) {
       console.log(`Skipping directories: ${gray(skipPaths.join(', '))}`);
     }
@@ -55,7 +56,8 @@ async function main() {
     const results = await batchExecute(targetDir, command, args, {
       skipPaths,
       verbose: argv.verbose,
-      showProgress: argv.progress !== false
+      showProgress: argv.progress !== false,
+      parallel: argv.parallel !== false
     });
 
     printSummary(results);
@@ -67,7 +69,7 @@ async function main() {
 
 function printHelp() {
   console.log(`
-${bold('Batch Executor')} ${dim('v1.1.0')}
+${bold('Batch Executor')} ${dim('v1.3.0')}
 
 ${cyan('Usage:')} batch-exec [options] <directory> <command> [args...]
 
@@ -82,12 +84,14 @@ ${magenta('Options:')}
   -s, --skip <file>  Ignore file path (default: ./.batchexecignore)
   -v, --verbose      Show verbose output
       --no-progress  Disable progress bar
+      --no-parallel  Disable parallel execution (use sequential mode)
   -h, --help         Show this help message
 
 ${green('Examples:')}
   ${green('batch-exec')} ./my-projects git pull
   ${green('batch-exec')} ./my-projects npm update lodash -S
   ${green('batch-exec')} --skip ./custom-ignore.txt ./repos ls -la
+  ${green('batch-exec')} --no-parallel ./my-projects npm install
 `);
 }
 

package/src/index.js

@@ -1,5 +1,5 @@
 import path from 'path';
-import { $, cd } from 'zx';
+import { $, within, cd } from 'zx';
 import { parseIgnoreFile } from './ignoreParser.js';
 import { listDirectSubdirectories } from './directoryLister.js';
 import { cyan, red, ProgressBar, clearLine } from './utils/colors.js';
@@ -7,8 +7,55 @@ import { cyan, red, ProgressBar, clearLine } from './utils/colors.js';
 export { parseIgnoreFile };
 export { listDirectSubdirectories };
 
+async function executeInDirectory(subdirPath, command, args, verbose) {
+  try {
+    if (verbose) {
+      console.log(`=== Executing in: ${cyan(subdirPath)} ===`);
+    }
+
+    let result;
+
+    await within(async () => {
+      cd(subdirPath);
+      if (verbose) {
+        result = await $`${command} ${args}`;
+      } else {
+        result = await $`${command} ${args}`.quiet();
+      }
+      if (verbose) {
+        console.log(`${cyan(subdirPath)}: `, result.stdout);
+        if (result.stderr) {
+          console.error(`${cyan(subdirPath)}: `, result.stderr);
+        }
+      }
+    });
+
+    return {
+      success: true,
+      stdout: result.stdout,
+      stderr: result.stderr
+    };
+  } catch (error) {
+    if (verbose) {
+      console.error(red(`Error in ${cyan(subdirPath)}: ${error.message}`));
+      if (error.stdout) {
+        console.log(`${cyan(subdirPath)}: `, error.stdout);
+      }
+      if (error.stderr) {
+        console.error(`${cyan(subdirPath)}: `, error.stderr);
+      }
+    }
+    return {
+      success: false,
+      error: error.message,
+      stdout: error.stdout || '',
+      stderr: error.stderr || ''
+    };
+  }
+}
+
 export async function batchExecute(targetDir, command, args, options = {}) {
-  const { skipPaths = [], verbose = false, showProgress = true } = options;
+  const { skipPaths = [], verbose = false, showProgress = true, parallel = true } = options;
 
   const absoluteTargetDir = path.resolve(targetDir);
 
@@ -22,60 +69,54 @@ export async function batchExecute(targetDir, command, args, options = {}) {
     progressBar.start();
   }
 
-  for (let i = 0; i < subdirs.length; i++) {
-    const subdir = subdirs[i];
-    const subdirPath = path.join(absoluteTargetDir, subdir);
+  if (parallel) {
+    const promises = subdirs.map(async (subdir, index) => {
+      const subdirPath = path.join(absoluteTargetDir, subdir);
+      const result = await executeInDirectory(subdirPath, command, args, verbose);
 
-    try {
-      if (verbose) {
-        console.log(`=== Executing in: ${cyan(subdirPath)} ===`);
+      if (progressBar) {
+        progressBar.increment();
       }
 
-      let result;
+      return { directory: subdir, ...result };
+    });
 
-      cd(subdirPath);
+    const resolvedResults = await Promise.all(promises);
 
-      if (verbose) {
-        result = await $`${command} ${args}`;
-      } else {
-        result = await $`${command} ${args}`.quiet();
-      }
-
-      results.push({
-        directory: subdir,
-        success: true,
-        stdout: result.stdout,
-        stderr: result.stderr
-      });
-
-      if (verbose) {
-        console.log(result.stdout);
-        if (result.stderr) {
-          console.error(result.stderr);
-        }
-      }
-    } catch (error) {
-      results.push({
-        directory: subdir,
-        success: false,
-        error: error.message,
-        stdout: error.stdout || '',
-        stderr: error.stderr || ''
-      });
-
-      if (verbose) {
-        console.error(red(`Error in ${cyan(subdir)}: ${error.message}`));
-        if (error.stdout) {
-          console.log(error.stdout);
-        }
-        if (error.stderr) {
-          console.error(error.stderr);
-        }
+    for (const subdir of subdirs) {
+      const result = resolvedResults.find(r => r.directory === subdir);
+      if (result) {
+        results.push(result);
       }
     }
-
-    if (progressBar) {
-      progressBar.update(i + 1);
+  } else {
+    for (let i = 0; i < subdirs.length; i++) {
+      const subdir = subdirs[i];
+      const subdirPath = path.join(absoluteTargetDir, subdir);
+      const result = await executeInDirectory(subdirPath, command, args, verbose);
+
+      results.push({ directory: subdir, ...result });
+
+      // if (verbose) {
+      //   if (result.success) {
+      //     console.log(result.stdout);
+      //     if (result.stderr) {
+      //       console.error(result.stderr);
+      //     }
+      //   } else {
+      //     console.error(red(`Error in ${cyan(subdir)}: ${result.error}`));
+      //     if (result.stdout) {
+      //       console.log(result.stdout);
+      //     }
+      //     if (result.stderr) {
+      //       console.error(result.stderr);
+      //     }
+      //   }
+      // }
+
+      if (progressBar) {
+        progressBar.update(i + 1);
+      }
     }
   }
 

package/.batchexecignore

@@ -1,9 +0,0 @@
-# Directories to ignore
-node_modules
-dist
-build
-.git
-.idea
-.vscode
-*.tmp
-temp-*

package/CHANGELOG.md

@@ -1,13 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
-
-### [1.2.1](https://github.com/chandq/batch-exec/compare/v1.2.0...v1.2.1) (2026-03-01)
-
-## 1.2.0 (2026-03-01)
-
-
-### Features
-
-* add colors highlight 240bf16
-* add progress display by using --no-progress 320a372

package/test/cli.test.js

@@ -1,70 +0,0 @@
-import { describe, it, beforeEach, afterEach } from 'node:test';
-import assert from 'node:assert';
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import { $ } from 'zx';
-
-describe('CLI Integration', () => {
-  let tempDir;
-  let testProjectsDir;
-
-  beforeEach(async () => {
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'batch-exec-cli-test-'));
-    testProjectsDir = path.join(tempDir, 'test-projects');
-
-    await fs.mkdir(testProjectsDir);
-    await fs.mkdir(path.join(testProjectsDir, 'project1'));
-    await fs.mkdir(path.join(testProjectsDir, 'project2'));
-    await fs.mkdir(path.join(testProjectsDir, 'node_modules'));
-
-    await fs.writeFile(path.join(tempDir, '.batchexecignore'), 'node_modules');
-  });
-
-  afterEach(async () => {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  });
-
-  it('should show help message with --help', async () => {
-    const result = await $`node ${path.join(process.cwd(), 'src/cli.js')} --help`;
-    assert(result.stdout.includes('Usage:'));
-    assert(result.stdout.includes('batch-exec'));
-  });
-
-  it('should execute command in subdirectories', async () => {
-    const result = await $`node ${path.join(process.cwd(), 'src/cli.js')} ${testProjectsDir} echo test`;
-    assert(result.stdout.includes('Summary:'));
-    assert(result.stdout.includes('Total directories: 2'));
-  });
-
-  it('should respect .batchexecignore file', async () => {
-    const result = await $`node ${path.join(process.cwd(), 'src/cli.js')} ${testProjectsDir} pwd`;
-    assert(result.stdout.includes('Total directories: 2'));
-    assert(!result.stdout.includes('node_modules'));
-  });
-
-  it('should work with custom ignore file using --skip', async () => {
-    const customIgnore = path.join(tempDir, 'custom-ignore');
-    await fs.writeFile(customIgnore, 'project1\nnode_modules');
-
-    const result = await $`node ${path.join(
-      process.cwd(),
-      'src/cli.js'
-    )} --skip ${customIgnore} ${testProjectsDir} pwd`;
-    assert(result.stdout.includes('Total directories: 1'));
-    assert(!result.stdout.includes('project1'));
-  });
-
-  it('should show verbose output with --verbose', async () => {
-    const result = await $`node ${path.join(process.cwd(), 'src/cli.js')} --verbose ${testProjectsDir} echo hello`;
-    assert(result.stdout.includes('Target directory:'));
-    assert(result.stdout.includes('Command:'));
-  });
-
-  it('should fail with error message when missing arguments', async () => {
-    await assert.rejects($`node ${path.join(process.cwd(), 'src/cli.js')}`, error => {
-      assert(error.stderr.includes('Missing required arguments'));
-      return true;
-    });
-  });
-});

package/test/directoryLister.test.js

@@ -1,68 +0,0 @@
-import { describe, it, beforeEach, afterEach } from 'node:test';
-import assert from 'node:assert';
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import { listDirectSubdirectories } from '../src/directoryLister.js';
-
-describe('directoryLister', () => {
-  let tempDir;
-
-  beforeEach(async () => {
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'batch-exec-test-'));
-    
-    await fs.mkdir(path.join(tempDir, 'dir1'));
-    await fs.mkdir(path.join(tempDir, 'dir2'));
-    await fs.mkdir(path.join(tempDir, 'node_modules'));
-    await fs.mkdir(path.join(tempDir, '.git'));
-    
-    await fs.writeFile(path.join(tempDir, 'file1.txt'), 'content');
-    await fs.writeFile(path.join(tempDir, 'file2.js'), 'content');
-  });
-
-  afterEach(async () => {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  });
-
-  describe('listDirectSubdirectories', () => {
-    it('should list only direct subdirectories', async () => {
-      const subdirs = await listDirectSubdirectories(tempDir);
-      assert.deepStrictEqual(subdirs.sort(), ['.git', 'dir1', 'dir2', 'node_modules'].sort());
-    });
-
-    it('should skip directories matching patterns', async () => {
-      const subdirs = await listDirectSubdirectories(tempDir, ['node_modules', '.git']);
-      assert.deepStrictEqual(subdirs, ['dir1', 'dir2']);
-    });
-
-    it('should skip directories with wildcard patterns', async () => {
-      const subdirs = await listDirectSubdirectories(tempDir, ['dir*']);
-      assert.deepStrictEqual(subdirs.sort(), ['.git', 'node_modules'].sort());
-    });
-
-    it('should return sorted directory names', async () => {
-      const subdirs = await listDirectSubdirectories(tempDir);
-      assert.deepStrictEqual(subdirs, subdirs.slice().sort());
-    });
-
-    it('should throw error for non-existent directory', async () => {
-      await assert.rejects(
-        listDirectSubdirectories(path.join(tempDir, 'non-existent')),
-        { message: /Directory not found/ }
-      );
-    });
-
-    it('should throw error for file path', async () => {
-      await assert.rejects(
-        listDirectSubdirectories(path.join(tempDir, 'file1.txt')),
-        { message: /Not a directory/ }
-      );
-    });
-
-    it('should work with relative paths', async () => {
-      const relativePath = path.relative(process.cwd(), tempDir);
-      const subdirs = await listDirectSubdirectories(relativePath);
-      assert.deepStrictEqual(subdirs.sort(), ['.git', 'dir1', 'dir2', 'node_modules'].sort());
-    });
-  });
-});

package/test/ignoreParser.test.js

@@ -1,93 +0,0 @@
-import { describe, it, beforeEach, afterEach } from 'node:test';
-import assert from 'node:assert';
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import { parseIgnoreFile, shouldSkipDirectory } from '../src/ignoreParser.js';
-
-describe('ignoreParser', () => {
-  let tempDir;
-
-  beforeEach(async () => {
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'batch-exec-test-'));
-  });
-
-  afterEach(async () => {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  });
-
-  describe('parseIgnoreFile', () => {
-    it('should parse ignore file correctly', async () => {
-      const ignoreFilePath = path.join(tempDir, '.testignore');
-      await fs.writeFile(ignoreFilePath, `
-# This is a comment
-node_modules
-dist/
-*.tmp
-test-*
-
-# Another comment
-build
-      `.trim());
-
-      const patterns = await parseIgnoreFile(ignoreFilePath);
-      assert.deepStrictEqual(patterns, [
-        'node_modules',
-        'dist/',
-        '*.tmp',
-        'test-*',
-        'build'
-      ]);
-    });
-
-    it('should return empty array for non-existent file', async () => {
-      const patterns = await parseIgnoreFile(path.join(tempDir, 'non-existent'));
-      assert.deepStrictEqual(patterns, []);
-    });
-
-    it('should return empty array for null or undefined', async () => {
-      const patterns1 = await parseIgnoreFile(null);
-      const patterns2 = await parseIgnoreFile(undefined);
-      assert.deepStrictEqual(patterns1, []);
-      assert.deepStrictEqual(patterns2, []);
-    });
-  });
-
-  describe('shouldSkipDirectory', () => {
-    it('should return false when no patterns provided', () => {
-      assert.strictEqual(shouldSkipDirectory('dir1', []), false);
-      assert.strictEqual(shouldSkipDirectory('dir1', null), false);
-      assert.strictEqual(shouldSkipDirectory('dir1', undefined), false);
-    });
-
-    it('should match exact directory names', () => {
-      assert.strictEqual(shouldSkipDirectory('node_modules', ['node_modules']), true);
-      assert.strictEqual(shouldSkipDirectory('dist', ['node_modules']), false);
-    });
-
-    it('should match directory names with trailing slash', () => {
-      assert.strictEqual(shouldSkipDirectory('dist', ['dist/']), true);
-      assert.strictEqual(shouldSkipDirectory('node_modules', ['dist/']), false);
-    });
-
-    it('should match wildcard patterns', () => {
-      assert.strictEqual(shouldSkipDirectory('test-123', ['test-*']), true);
-      assert.strictEqual(shouldSkipDirectory('test-abc', ['test-*']), true);
-      assert.strictEqual(shouldSkipDirectory('other', ['test-*']), false);
-    });
-
-    it('should match extension wildcards', () => {
-      assert.strictEqual(shouldSkipDirectory('file.tmp', ['*.tmp']), true);
-      assert.strictEqual(shouldSkipDirectory('test.tmp', ['*.tmp']), true);
-      assert.strictEqual(shouldSkipDirectory('test.txt', ['*.tmp']), false);
-    });
-
-    it('should match any of the patterns', () => {
-      const patterns = ['node_modules', 'dist/', '*.tmp'];
-      assert.strictEqual(shouldSkipDirectory('node_modules', patterns), true);
-      assert.strictEqual(shouldSkipDirectory('dist', patterns), true);
-      assert.strictEqual(shouldSkipDirectory('test.tmp', patterns), true);
-      assert.strictEqual(shouldSkipDirectory('src', patterns), false);
-    });
-  });
-});

package/test/index.test.js

@@ -1,70 +0,0 @@
-import { describe, it, beforeEach, afterEach } from 'node:test';
-import assert from 'node:assert';
-import fs from 'fs/promises';
-import path from 'path';
-import os from 'os';
-import { batchExecute } from '../src/index.js';
-
-describe('batchExecute', () => {
-  let tempDir;
-
-  beforeEach(async () => {
-    tempDir = await fs.mkdtemp(path.join(os.tmpdir(), 'batch-exec-test-'));
-    
-    await fs.mkdir(path.join(tempDir, 'dir1'));
-    await fs.mkdir(path.join(tempDir, 'dir2'));
-    await fs.mkdir(path.join(tempDir, 'skip-me'));
-  });
-
-  afterEach(async () => {
-    await fs.rm(tempDir, { recursive: true, force: true });
-  });
-
-  it('should execute command in all subdirectories', async () => {
-    const results = await batchExecute(tempDir, 'pwd', []);
-    
-    assert.strictEqual(results.length, 3);
-    
-    results.forEach(result => {
-      assert.strictEqual(result.success, true);
-    });
-  });
-
-  it('should skip specified directories', async () => {
-    const results = await batchExecute(tempDir, 'pwd', [], {
-      skipPaths: ['skip-me']
-    });
-    
-    assert.strictEqual(results.length, 2);
-    
-    const dirs = results.map(r => r.directory);
-    assert.deepStrictEqual(dirs.sort(), ['dir1', 'dir2'].sort());
-  });
-
-  it('should capture command output', async () => {
-    const results = await batchExecute(tempDir, 'echo', ['hello']);
-    
-    results.forEach(result => {
-      assert.strictEqual(result.success, true);
-      assert(result.stdout.includes('hello'));
-    });
-  });
-
-  it('should handle command failures gracefully', async () => {
-    const results = await batchExecute(tempDir, 'this-command-does-not-exist', []);
-    
-    results.forEach(result => {
-      assert.strictEqual(result.success, false);
-      assert(result.error);
-    });
-  });
-
-  it('should work with multiple arguments', async () => {
-    const results = await batchExecute(tempDir, 'echo', ['hello', 'world']);
-    
-    results.forEach(result => {
-      assert.strictEqual(result.success, true);
-      assert(result.stdout.includes('hello world'));
-    });
-  });
-});