🍺 Run —


License
MIT

Documentation

🍺 Run —

Run is a command-line tool that executes commands in multiple directories concurrently.

Bench

Command: Time:
find -iname .git -execdir ls \;
real    0m17.340s
user    0m6.214s
sys     0m9.138s
Run -P .git -C ls
real    0m8.480s
user    0m0.046s
sys     0m0.046s
find -iname .git -execdir git status \;
real    1m19.070s
user    0m5.385s
sys     0m7.357s
Run -P .git -C 'git status'
real    0m26.170s
user    0m0.030s
sys     0m0.046s

🚀 Installation

cargo install prun

🛠️ Usage

Run can be used with various options:

🍺 Run —

Usage: Run [OPTIONS] --Command <COMMAND> <PATTERN>

Arguments:
  <PATTERN>  🔍 Pattern — [default: .]

Options:
  -F, --File               📝 File —
  -P, --Parallel           ⏩ Parallel —
  -R, --Root <ROOT>        📂 Root — [default: .]
  -E, --Exclude <EXCLUDE>  🚫 Exclude — [default: "node_modules .git target dist vendor"]
  -C, --Command <COMMAND>  🖥️ Command —
  -h, --help               Print help
  -V, --version            Print version
Run .git -C 'git fetch upstream'

This command will fetch from upstream for all .git repositories inside the current directory. It essentially replaces the following command:

find -iname .git -type d -execdir git fetch upstream \;

Options

--Command or -C:

The command to execute:

Run .git -C 'git status'

or multiple commands:

Run .git -C 'git status' -C 'git add .' -C 'git commit'

--File or -F:

Limit execution to files matching a certain pattern:

Run -F astro.config.ts -C 'npx astro add @playform/compress'

--Root or -R:

Set the current working directory to a different folder (default is .):

Run -R D:\Developer .git -C 'git fetch upstream'

--Parallel or -P:

Run commands in parallel (default is sequential):

Run -P -R D:\Developer .git -C 'git fetch upstream'

--Exclude:

Exclude certain files or directories (defailt is node_modules .git target dist vendor)

--Pattern:

Specify a custom pattern for matching

Dependencies

Run relies on several Rust crates to provide its functionality:

  • clap (v4.5.17) - A powerful and flexible command-line argument parser. The "derive" feature is used to simplify the creation of command-line interfaces through derive macros.

  • walkdir (v2.5.0) - Provides an efficient and cross-platform way to recursively traverse directories. This is useful for filesystem operations and searching.

  • futures (v0.3.30) - Offers abstractions for asynchronous programming in Rust. It's used in conjunction with tokio to handle asynchronous operations effectively.

  • rayon (v1.10.0) - Enables easy parallelism for data-parallel tasks. It's used to parallelize CPU-bound operations, improving performance on multi-core systems.

  • tokio (v1.40.0) - An asynchronous runtime for Rust, providing essential building blocks for writing reliable asynchronous applications. The "full" feature set is used to enable all tokio functionality.

  • num_cpus (v1.16.0) - A small crate that determines the number of CPUs on the current system. This is useful for optimizing parallel workloads.

  • once_cell (v1.19.0) - Provides a way to perform lazy static initialization. It's often used for global variables or singletons that need to be initialized only once.

These dependencies work together to provide a robust, efficient, and user-friendly command-line tool capable of handling parallel and asynchronous operations while efficiently traversing filesystems.

Changelog

See CHANGELOG.md for a history of changes to this CLI.