# batch-exec-cli

**Repository Path**: wwdragon/batch-exec-cli

## Basic Information

- **Project Name**: batch-exec-cli
- **Description**: Efficiently iterate through directories and execute commands with progress display
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-04-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# batch-exec-cli

高效批量命令执行工具，能够遍历目录内所有直接子目录并执行命令。

## 功能特性

- 🚀 高效遍历目标目录的所有直接子目录, 默认并行执行
- 📁 支持绝对路径和相对路径
- 🚫 可配置忽略目录（支持 `.gitignore` 风格的模式匹配）
- 📊 提供执行摘要和失败目录列表
- 🔧 跨平台支持（Windows、macOS、Linux）
- 💬 详细的 verbose 输出模式
- 🎨 彩色高亮输出，便于识别目录路径和命令
- ⏳ 实时进度条显示，带旋转动画和执行时间
- ✨ 精美的输出格式和摘要展示

## 安装

```bash
npm install -g batch-exec-cli
```

或者克隆项目后本地安装：

```bash
git clone <repository-url>
cd batch-exec-cli
npm install
npm link
```

## 使用方法

### 基本用法

```bash
batch-exec <目录> <命令> [参数...]
```

### 示例

在 `./my-projects` 目录下的所有子目录中执行 `git pull`：

```bash
batch-exec ./my-projects git pull
```

在 `./my-projects` 目录下的所有子目录中更新 lodash 依赖：

```bash
batch-exec ./my-projects npm update lodash -S
```

列出所有子目录的内容：

```bash
batch-exec ./repos ls -la
```

### 选项

| 选项                | 别名 | 描述                                           |
| ------------------- | ---- | ---------------------------------------------- |
| `-s, --skip <文件>` |      | 指定忽略文件路径（默认：`./.batchexecignore`） |
| `-v, --verbose`     |      | 显示详细输出                                   |
| `--no-progress`     |      | 禁用进度条显示                                 |
| `--no-parallel`     |      | 禁用并行执行, 按顺序执行                       |
| `-h, --help`        |      | 显示帮助信息                                   |

### 使用自定义忽略文件

```bash
batch-exec --skip ./custom-ignore.txt ./repos git status
```

### 禁用进度条

```bash
batch-exec --no-progress ./my-projects npm install
```

### 显示详细输出

```bash
batch-exec -v ./my-projects git status
```

## 输出示例

### 普通模式（带进度条）

```
⠋ [████████████████████████████░░] 85% (17/20) [5s]
```

### 摘要展示

```
═══════════════════════════════════════════════════════════════
📊 Execution Summary
═══════════════════════════════════════════════════════════════
  Total directories: 20
  Successful:        18
  Failed:            2

❌ Failed directories:
  • project1: Error: Command failed
  • project3: Error: Permission denied
═══════════════════════════════════════════════════════════════
```

## .batchexecignore 文件格式

与 `.gitignore` 文件格式完全相同：

```
node_modules
dist
build
.git
.idea
.vscode
*.tmp
temp-*
```

## API 使用

你也可以作为库使用：

```javascript
import { batchExecute } from 'batch-exec-cli';

const results = await batchExecute('./my-projects', 'git', ['pull'], {
  verbose: false,
  showProgress: true
});

console.log(results);
```

## 许可证

MIT