For Each

Apply a command to multiple files and directories with ForEach

# Remove all temporary files from home
foreach --file --mask "*.tmp" ~ rm

# List all files and directories in current directory
foreach . echo

# List current Git branch for all projects
foreach --directory ~/projects "cd <file> && git status | grep branch"

# Change all Windows line endings to Unix (CRLF to LF)
foreach --file --recursive ~/projects dos2unix

# Change all tabs to spaces in PHP source files
foreach --file --mask "*.php" --recursive ~/projects/myproject "expand -i -t 4 <file> | sponge <file>"

How it works

• Takes a path to directory optionally with a mask
• Applies command for each file or directory in this path

Options

Option | Description --- | --- -d, --directory | Apply command only to directories -f, --file | Apply command only to files -r, --recursive | Search recursively -m, --mask | Search mask, applied only to search results --include-dot-directories | Look inside directories with names started with dot - ".git", ".idea" etc. Ignoring these directories by default. --include-directories-ignored-by-git | Do not use ".gitignore" rules. By default we skip all directories mentioned in ".gitignore".

Getting Started

To use this tool, you need NodeJS.

sudo npm install -g @nex_otaku/foreach

Usage

foreach path/to/directory your-action

Features

• Recursive search is supported
• Respects ".gitignore" rules
• Skips directories with dot - ".git", ".idea" etc
• Search can be limited to files or to directories
• Search by mask

To Be Done

• Continue after failed commands
• Remember last 10 commands
• Input from file
• Dry run mode

License

• MIT license
• Copyright 2021 © Nex Otaku.