<img src="../banner.png" width="100%" alt="batch-file-ops banner">

日本語 — batch-file-ops の公式日本語版。

batch_file_ops - バッチファイル操作 (日本語)

globパターンを使用してファイルに対して効率的なバッチ操作を実行するCLIツール。 対応アクション: delete、move、copy、list。依存関係なし（Python標準ライブラリのみ）。

---

アクション

アクション	説明
delete	パターンに一致するファイルを削除
move	パターンに一致するファイルを移動
copy	パターンに一致するファイルをコピー
list	パターンに一致するファイルを一覧表示

CLI の使用方法

python batch_file_ops.py <action> <source> [<target>] --pattern "<glob>" [--dry-run] [--recursive]

引数

引数	説明
action	delete、move、copy、または list
source	ソースディレクトリ
target	ターゲットディレクトリ（move および copy のみ）
--pattern, -p	Glob パターン（例: *.py、TOOLS_*.py） - デフォルト: *
--dry-run, -n	プレビューのみ、変更は実行しない
--recursive, -r	サブディレクトリ内を再帰的に検索

---

例と使用方法

# ディレクトリ内のすべてのPythonファイルを一覧表示
python batch_file_ops.py list /path/to/directory --pattern "*.py"

# すべての .tmp ファイルを削除（最初に dry-run で確認！）
python batch_file_ops.py delete /path/to/directory --pattern "*.tmp" --dry-run
python batch_file_ops.py delete /path/to/directory --pattern "*.tmp"

# ファイルを移動
python batch_file_ops.py move /source /target --pattern "*.txt"

# ファイルをコピー（再帰的）
python batch_file_ops.py copy /source /target --pattern "*.md" --recursive

# パターンの例
python batch_file_ops.py delete /path --pattern "TOOLS_*.py"
python batch_file_ops.py list /path --pattern "backup_202?-*"

---

注意事項

• 最初に Dry-run を実行: delete および move では、必ず最初に --dry-run を使用してください
• Glob パターン: Python の pathlib.glob() / pathlib.rglob() を使用
• Windows 対応: 自動 UTF-8 出力エンコーディング
• ファイルのみ: ディレクトリはスキップされます（ファイルのみが処理されます）