batch-file-ops v1.0.0A

Immutable. This exact content never changes and is served at /api/v1/blob/bc50e1b40ba3f88e.

---
name: batch-file-ops
version: 1.0.0
type: tool
author: Lukas Geiger
created: 2026-03-12
updated: 2026-03-12
description: Batch file operations (delete, move, copy, list) with glob patterns. CLI tool for efficient filesystem operations. Zero dependencies.

standalone: true
anthropic_compatible: true
bach_compatible: true
bach_origin: true
category: utilities
tags: [batch, file-ops, glob, cli, filesystem, cleanup]
language: de
status: active
visibility: public
dependencies: {'tools': [], 'services': [], 'protocols': [], 'python': []}
provenance: {'origin': 'bach', 'origin_path': 'system/tools/batch_file_ops.py', 'origin_version': '1.0.0', 'origin_repo': 'github.com/ellmos-ai/bach', 'last_sync_from_origin': '2026-03-12', 'last_sync_to_origin': None, 'local_changes_since_sync': False}
---
<img src="banner.png" width="100%" alt="batch-file-ops banner">

# batch_file_ops - Batch-Dateioperationen

CLI-Tool fuer effiziente Batch-Operationen auf Dateien mit Glob-Patterns.
Unterstuetzt: delete, move, copy, list. Zero Dependencies (nur Python stdlib).

---

## Aktionen

| Aktion | Beschreibung |
|--------|-------------|
| `delete` | Dateien nach Pattern loeschen |
| `move` | Dateien nach Pattern verschieben |
| `copy` | Dateien nach Pattern kopieren |
| `list` | Dateien nach Pattern auflisten |

## CLI Usage

```bash
python batch_file_ops.py <aktion> <quelle> [<ziel>] --pattern "<glob>" [--dry-run] [--recursive]
```

### Argumente

| Argument | Beschreibung |
|----------|-------------|
| `aktion` | `delete`, `move`, `copy` oder `list` |
| `quelle` | Quellordner |
| `ziel` | Zielordner (nur fuer `move` und `copy`) |
| `--pattern`, `-p` | Glob-Pattern (z.B. `*.py`, `TOOLS_*.py`) - Standard: `*` |
| `--dry-run`, `-n` | Nur anzeigen, nichts aendern |
| `--recursive`, `-r` | Rekursiv in Unterordnern suchen |

---

## Beispiele

```bash
# Alle Python-Dateien in einem Ordner auflisten
python batch_file_ops.py list /pfad/zum/ordner --pattern "*.py"

# Alle .tmp Dateien loeschen (erst Dry-Run!)
python batch_file_ops.py delete /pfad/zum/ordner --pattern "*.tmp" --dry-run
python batch_file_ops.py delete /pfad/zum/ordner --pattern "*.tmp"

# Dateien verschieben
python batch_file_ops.py move /quelle /ziel --pattern "*.txt"

# Dateien kopieren (rekursiv)
python batch_file_ops.py copy /quelle /ziel --pattern "*.md" --recursive

# Pattern-Beispiele
python batch_file_ops.py delete /pfad --pattern "TOOLS_*.py"
python batch_file_ops.py list /pfad --pattern "backup_202?-*"
```

---

## Hinweise

- **Dry-Run zuerst:** Bei `delete` und `move` immer erst `--dry-run` verwenden
- **Glob-Patterns:** Nutzt Python `pathlib.glob()` / `pathlib.rglob()`
- **Windows-kompatibel:** Automatisches UTF-8 Output-Encoding
- **Nur Dateien:** Ordner werden uebersprungen (nur Dateien werden bearbeitet)