#cli #parallel #shell

app parallel-sh

Execute commands in parallel

12 releases

0.1.12 Apr 12, 2023
0.1.11 Dec 24, 2022
0.1.8 Sep 20, 2022
0.1.7 Jul 8, 2022
0.1.2 Apr 30, 2021

#61 in Concurrency

47 downloads per month

MIT license

14KB
257 lines

parallel-sh

Crates.io CI GitHub license

parallel-sh was heavily inspired by Rust Parallel (parallel) parallelizing 'otherwise non-parallel command-line tasks.' But instead of trying to recreate the full functionality of GNU Parallel parallel-sh will simply execute (lines of) commands in the platform's preferred shell ('sh -c' on Unix systems, and 'powershell.exe -c' on Windows) in separate threads.

What to expect:

  • Output (stdout and stderr) of each child process is stored and printed only after the child exits.
  • There is some simple logging and some runtime metric (via -v, -vv or -vvv) available.
  • The whole crate is tiny, <300 lines of code (w/ ~25% command line argument parsing), and can quickly be modified to meet more complex requirements.

What is not part of parallel-sh:

  • There are no replacement strings (e.g. '{}') or input tokens. Commands will be executed as provided by argument, file or via stdin.
  • Command sources will not be 'linked'. Arguments will be processed by preference:
    1. If ARGS are found, --file option and stdin are ignored.
    2. If --file is provided anything on stdin is ignored.
    3. Only when there are no command arguments and no '--file' option is found, any lines on stdin are treated as commands to execute.
  • There is no '--pipe'. Stdin is not inherited from the parent and any attempt by the child processes to read from the stdin stream will result in the stream immediately closing.

If you need any of these to be part of your parallelizing tool please check GNU Parallel or Rust Parallel.

Most of the effects of these features can be achieved by processing the commands before passing them to parallel-sh.

Options

parallel-sh 0.1.1
Execute commands in parallel

USAGE:
    parallel-sh [FLAGS] [OPTIONS] [clijobs]...

FLAGS:
        --dry-run          Perform a trial run, only print what would be done (with -vv)
        --halt-on-error    Stop execution if an error occurs in any thread
    -h, --help             Prints help information
    -q, --quiet            Do not print `parallel-sh` warnings
    -v, --verbose          Sets the level of verbosity
    -V, --version          Prints version information

OPTIONS:
    -f, --file <FILE>       Read commands from file (one command per line)
    -l, --log <FILE>        Log output to file
    -j, --jobs <THREADS>    Number of parallel executions

ARGS:
    <clijobs>...

Preference

  1. Pass commands as arguments:

    parallel-sh "sleep 2 && echo first" "sleep 1 && echo second"
    
  2. Pass a file with one command (-line) per line:

    parallel-sh -f /tmp/commands
    
    $ cat /tmp/commands
    sleep 2 && echo first
    sleep 1 && echo second
    
  3. Pass commands via stdin:

    echo -e 'sleep 2 && echo first\nsleep 1 && echo second' |parallel-sh
    

Dependencies

~2.2–3MB
~55K SLoC